# List publications

> Scheduled posts, drafts, and past publications in a profile.

Canonical: <https://www.tryadeli.com/docs/api/posts/list-publications>

`GET https://app.tryadeli.com/api/v1/publications`

Authorization: `Bearer <API key>` — see [Authentication](https://www.tryadeli.com/docs/authentication)

Lists publications in one profile. With `status=scheduled` they are listed
soonest first, which makes this the way to see what is scheduled; every other
listing is newest first. A post waiting in a scheduled publication also appears
in [List posts](https://www.tryadeli.com/docs/api/posts/list-posts) with `status: "scheduled"`.

**Query parameters**

| Name        | Type      | Required | Description                                                                                        |
| ----------- | --------- | -------- | -------------------------------------------------------------------------------------------------- |
| `status`    | `string`  |          | scheduled, draft, queued, processing, published, partial, failed, or canceled. Optional.           |
| `platform`  | `string`  |          | Only publications with an account on this platform.                                                |
| `accountId` | `uuid`    |          | Only publications that post from this account. It names its profile, so profileId can be left out. |
| `profileId` | `uuid`    |          | Required unless you pass accountId. If you pass both, they must agree.                             |
| `cursor`    | `string`  |          | nextCursor from the previous page.                                                                 |
| `limit`     | `integer` |          | 1–100 publications per page. Defaults to 25.                                                       |

## Request examples

**cURL**

```bash
curl "https://app.tryadeli.com/api/v1/publications?profileId=00000000-0000-4000-8000-000000000001&status=scheduled" \
  -H "Authorization: Bearer $ADELI_API_KEY"
```

**JavaScript**

```javascript
const response = await fetch("https://app.tryadeli.com/api/v1/publications?profileId=00000000-0000-4000-8000-000000000001&status=scheduled", {
  headers: {
    Authorization: `Bearer ${process.env.ADELI_API_KEY}`,
  },
});
console.log(await response.json());
```

**Python**

```python
import os

import requests

response = requests.get(
    "https://app.tryadeli.com/api/v1/publications",
    headers={"Authorization": f"Bearer {os.environ['ADELI_API_KEY']}"},
    params={
        "profileId": "00000000-0000-4000-8000-000000000001",
        "status": "scheduled",
    },
)
print(response.json())
```

## Responses

### 200

```json
{
  "publications": [
    {
      "id": "00000000-0000-4000-8000-000000000020",
      "profileId": "00000000-0000-4000-8000-000000000001",
      "status": "scheduled",
      "progress": 0,
      "scheduledFor": "2026-11-13T12:30:00.000Z",
      "timeZone": "America/New_York",
      "canceledAt": null,
      "statusUrl": "/api/v1/publications/00000000-0000-4000-8000-000000000020",
      "createdAt": "2026-11-10T15:00:00.000Z",
      "updatedAt": "2026-11-10T15:00:00.000Z",
      "completedAt": null,
      "targets": [
        { "id": "00000000-0000-4000-8000-000000000021", "platform": "instagram", "accountId": "00000000-0000-0000-0000-000000000010", "status": "queued", "attempts": 0, "result": null, "error": null }
      ]
    }
  ],
  "nextCursor": null
}
```

### 400

```json
{
  "error": {
    "code": "invalid_request",
    "message": "Invalid publication filter",
    "details": [{ "code": "invalid_value", "path": ["status"], "message": "Invalid option: expected one of \"scheduled\"|\"draft\"|\"queued\"|\"processing\"|\"published\"|\"partial\"|\"failed\"|\"canceled\"" }]
  }
}
```
