List posts

List posts with the Wavegrain Posting API: GET /api/v1/posts. Parameters, responses and an example request.

GET /api/v1/posts is part of the Posting API. Every call needs an access key: see Authentication.

Needs the read permission.

Posts with a delivery due in the window, newest first. The window defaults to the last and the next 30 days and may be at most 100 days.

Parameters

NameInTypeRequiredNotes
fromquerystringnoStart of the window, ISO 8601 with an offset.
toquerystringnoEnd of the window (not included), ISO 8601 with an offset.
statusquery"queued" | "preparing" | "sending" | "processing" | "action_required" | "outcome_unknown" | "published" | "failed" | "cancelled" | "awaiting_confirmation"noOnly posts with a delivery in this state, or awaiting_confirmation for posts made through the API that wait for the owner's confirm.
limitqueryintegernoPosts per page, 1 to 100.
cursorquerystringnoThe nextCursor of the page before.

Example request

curl https://wavegrain.com/api/v1/posts \
  -H "Authorization: Bearer $WAVEGRAIN_KEY"

Responses

StatusMeaning
200A page of posts.
400A query parameter is not valid, or the window is too wide.
401No access key, or an unknown, revoked or expired one
403The key lacks the permission, or the account has no active plan
429Too many requests for the key or the account
500Something went wrong on Wavegrain's side; try again, and send the request id if it keeps failing.

A successful answer:

{
  "posts": [
    {
      "id": "post_V1StGXR8_Z5jdHi6B",
      "source": "api",
      "slideshowId": null,
      "title": null,
      "status": "confirmed",
      "confirmUrl": null,
      "scheduledFor": "2026-11-07T09:00:00.000Z",
      "targets": [
        {
          "accountId": "acc_4Ft7Wz",
          "accountName": "Koi Kitchen",
          "network": "instagram",
          "state": "delivered",
          "deliveryId": "dlv_9xQ2Kp",
          "reason": null
        }
      ],
      "deliveries": [
        {
          "id": "dlv_9xQ2Kp",
          "accountId": "acc_4Ft7Wz",
          "accountName": "Koi Kitchen",
          "network": "instagram",
          "status": "published",
          "label": "Published on Instagram",
          "reason": null,
          "errorCode": null,
          "scheduledFor": "2026-11-07T09:00:00.000Z",
          "automatic": false,
          "canCancel": false,
          "link": "https://www.instagram.com/p/C9xYz/"
        }
      ]
    }
  ],
  "nextCursor": null
}

More in the Posting API

Something wrong or missing? Write to support@wavegrain.com.