# Your first call

List the posts in your workspace, which is where every other call starts.

Listing posts is the natural first call: every other post endpoint needs an id, and this is where ids come from.

```bash
curl -H "Authorization: Bearer ptr_live_..." \
  "https://api.posttar.com/v1/posts?limit=2"
```

A real response, trimmed to two posts:

```json
{
  "posts": [
    {
      "id": "8c64bee5-f756-47b7-a64a-01f5db597202",
      "status": "draft",
      "scheduledFor": null,
      "textContent": "Seu nicho pode estar amplo demais sem você perceber...",
      "projectId": "c85848ba-2881-4a2e-9bdd-841b26d07359",
      "contentFormat": "animated_audio",
      "theme": "Tres sinais de que o seu nicho esta amplo demais"
    }
  ],
  "next": "eyJjaGF2ZSI6IjIwMjYtMDktMTNUMDU6MTg6MDYuOTE4Njcz..."
}
```

## Narrowing the list

| Query parameter | What it does |
| --- | --- |
| `status` | Comma-separated: `draft,scheduled,published,failed,idea` |
| `from` and `to` | ISO dates, filtering by scheduled date |
| `projectId` | One project, when the workspace has more than one |
| `limit` | Default 25, max 100 |
| `cursor` | The `next` value from the previous response |

> With `from` or `to` the list is ordered by scheduled date, ascending. Without them it is ordered by creation, newest first. It is the same rule the app's calendar uses.