---
title: "List posts"
description: "Paginated list of your posts with per-account delivery results, filterable by status, platform and text."
section: "API reference"
url: https://dravo.dev/docs/api/posts/list
---
# List posts

Paginated list of your posts with the per-account delivery results, filterable by
status, platform and free text. Uses keyset pagination (`cursor` / `next_cursor`).

#### `GET /v1/posts`

Paginated history of posts with per-account delivery results.

**Auth:** API key (`dra_…`) or dashboard JWT

| Field | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `status` | query | string | no | Filter: queued, processing, published, partial, failed, canceled, scheduled. |
| `platform` | query | string | no | Filter by platform. |
| `q` | query | string | no | Full-text search on post text. |
| `limit` | query | int | no | Page size, 1 to 100 (default 50). |
| `cursor` | query | string | no | Keyset pagination cursor from next_cursor. |

Response `200`: A page of posts.

```json
{
  "items": [
    {
      "id": "post_2a7f93",
      "status": "published",
      "text": "Shipping Dravo…",
      "platforms": [
        "x",
        "linkedin"
      ],
      "results": [
        {
          "platform": "x",
          "status": "published",
          "platform_post_id": "1890…",
          "platform_post_url": "https://x.com/i/status/1890…",
          "warnings": []
        }
      ],
      "created_at": "2026-06-23T10:15:30Z"
    }
  ],
  "next_cursor": null,
  "total": 1
}
```