> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dacard.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get timeline

> Read the chronological event timeline for a product, account, or cycle.

Read the chronological event timeline for a product, account, or cycle. Powers the rail's "What's cooking" feed and the audit views.

```bash theme={null}
curl -X GET "https://app.dacard.ai/api/intelligence/timeline?productId=prod_abc&since=2026-04-01" \
  -H "Authorization: Bearer $DACARD_API_KEY"
```

| Property           | Value              |
| ------------------ | ------------------ |
| **Auth**           | Required           |
| **Required scope** | Account membership |
| **Idempotent**     | Yes                |

## Query

| Field        | Type          | Required | Notes                                         |
| ------------ | ------------- | -------- | --------------------------------------------- |
| `productId`  | string        | no       | Narrow to one product.                        |
| `since`      | ISO 8601 date | no       | Defaults to 30 days ago.                      |
| `eventTypes` | comma list    | no       | Filter (e.g., `score.completed,move.landed`). |
| `limit`      | integer       | no       | Max 200. Default 50.                          |

## Response

```json theme={null}
{
  "events": [
    {
      "id": "evt_...",
      "ts": "2026-05-04T12:00:00Z",
      "type": "score.completed",
      "productId": "prod_abc",
      "summary": "Score landed at 78"
    }
  ],
  "nextCursor": null
}
```

## Errors

| Status | Code             | When         |
| ------ | ---------------- | ------------ |
| 401    | `AUTH_REQUIRED`  | No session.  |
| 500    | `INTERNAL_ERROR` | Read failed. |