Skip to content
Ordinal
Esc
↑↓navigate↵open⌘Jpreview

List for a post

List all engagements (likes, comments, reposts) configured for a specific post

GET/posts/{postId}/engagements
Authorization
AuthorizationBearer token · headerrequired

API key authentication. Generate an API key from your workspace settings.

Path parameters
postIdstring<uuid>required

Post ID (UUID)

Responses
200

List of engagements

engagementsEngagement[]
Show properties
Array of Engagement
idstring<uuid>
channelEngagementChannel
Allowed:LinkedInTwitter
typeEngagementType
Allowed:LikeCommentRepost
profileIdstring<uuid>

The profile ID that will perform the engagement

copystring | null

The text content for Comment or Repost engagements. Required for Comment, optional for Repost, must not be provided for Like.

delaySecondsinteger

Delay in seconds after the post publishes. For Comment and Repost, this is the delay until the engagement fires (0 means immediate). Always 0 for Like.

min 0 · max 86400
reactionTypeLinkedInReactionType

LinkedIn reaction type for Like engagements. Only applicable when type is Like and channel is LinkedIn. Defaults to Like if not specified.

Allowed:LikeCelebrateLoveInsightfulSupportFunny
401

Unauthorized - Missing or invalid API key

codestring
messagestring
404

Not Found - Resource does not exist

codestring
messagestring
Try it
Server
Authorization
Parameters
Request
curl -X GET 'https://app.tryordinal.com/api/v1/posts/497f6eca-6276-4993-bfeb-53cbbbba6f08/engagements' \
  -H 'Authorization: Bearer YOUR_TOKEN'
Response
{
  "engagements": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440800",
      "channel": "LinkedIn",
      "type": "Like",
      "profileId": "550e8400-e29b-41d4-a716-446655440001",
      "copy": null,
      "delaySeconds": 0,
      "reactionType": "Celebrate"
    },
    {
      "id": "550e8400-e29b-41d4-a716-446655440801",
      "channel": "LinkedIn",
      "type": "Comment",
      "profileId": "550e8400-e29b-41d4-a716-446655440002",
      "copy": "Great insights! Check out our guide for more details: https://example.com/guide",
      "delaySeconds": 300
    }
  ]
}