Skip to main content
GET
/
posts
List posts
curl --request GET \
  --url https://app.tryordinal.com/api/v1/posts \
  --header 'Authorization: Bearer <token>'
{
  "posts": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "url": "https://app.tryordinal.com/acme/posts/550e8400-e29b-41d4-a716-446655440000",
      "title": "Q4 Product Launch Announcement",
      "channels": [
        "LinkedIn",
        "Twitter"
      ],
      "status": "Scheduled",
      "publishDate": "2026-01-15",
      "publishAt": "2026-01-15T14:00:00.000Z",
      "createdAt": "2026-01-05T10:30:00.000Z",
      "updatedAt": "2026-01-05T11:45:00.000Z",
      "labels": [
        {
          "id": "550e8400-e29b-41d4-a716-446655440400",
          "name": "Marketing",
          "color": "#9333ea",
          "backgroundColor": "#f3e8ff"
        }
      ],
      "linkedIn": {
        "profile": {
          "id": "550e8400-e29b-41d4-a716-446655440001",
          "name": "John Doe",
          "detail": "johndoe"
        },
        "copy": "Excited to announce our new product launch! 🚀",
        "assets": [
          {
            "id": "550e8400-e29b-41d4-a716-446655440010",
            "name": "product-photo.jpg",
            "url": "https://cdn.tryordinal.com/assets/product-photo.jpg",
            "mimetype": "image/jpeg",
            "size": 245678,
            "width": 1920,
            "height": 1080,
            "duration": null
          }
        ]
      },
      "x": {
        "profile": {
          "id": "550e8400-e29b-41d4-a716-446655440003",
          "name": "Acme Inc",
          "detail": "@acme_inc"
        },
        "tweets": [
          {
            "copy": "Excited to announce our new product launch! 🚀",
            "assets": []
          }
        ]
      }
    }
  ],
  "nextCursor": "550e8400-e29b-41d4-a716-446655440001",
  "hasMore": true
}

Documentation Index

Fetch the complete documentation index at: https://docs.tryordinal.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

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

Query Parameters

limit
integer
default:20

Maximum number of posts to return (1-100)

Required range: 1 <= x <= 100
cursor
string<uuid>

Cursor for pagination (post ID from the last item of previous page)

ids

Fetch specific posts by IDs. Can be a single UUID or comma-separated list.

status
enum<string>

Filter by post status

Available options:
Tentative,
ToDo,
InProgress,
ForReview,
Blocked,
Finalized,
Scheduled,
Posted
channel
enum<string>

Filter by channel

Available options:
LinkedIn,
Twitter,
Instagram,
TikTok,
YouTubeShorts
linkedInProfileId
string<uuid>

Filter by LinkedIn profile ID

xProfileId
string<uuid>

Filter by X/Twitter profile ID

instagramProfileId
string<uuid>

Filter by Instagram profile ID

tikTokProfileId
string<uuid>

Filter by TikTok profile ID

youTubeProfileId
string<uuid>

Filter by YouTube channel profile ID

labelIds

Filter by label IDs (posts with any of these labels). Can be a single UUID or comma-separated list.

publishDateMin
string<date-time>

Filter posts scheduled on or after this date (ISO 8601 format)

publishDateMax
string<date-time>

Filter posts scheduled on or before this date (ISO 8601 format)

createdAtMin
string<date-time>

Filter posts created on or after this date (ISO 8601 format)

createdAtMax
string<date-time>

Filter posts created on or before this date (ISO 8601 format)

sortBy
enum<string>
default:createdAt

Field to sort by

Available options:
createdAt,
publishAt
sortOrder
enum<string>
default:desc

Sort order

Available options:
asc,
desc

Response

List of posts

posts
object[]
nextCursor
string | null

Cursor for the next page of results

hasMore
boolean

Whether there are more results