> ## 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. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.