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

# List results

> List all stored score results across the caller's products. Cursored.

List all stored score results across the caller's products. Cursored. Use `productId` to narrow.

```bash theme={null}
curl -X GET "https://app.dacard.ai/api/results?productId=prod_abc&limit=20" \
  -H "Authorization: Bearer $DACARD_API_KEY"
```

| Property       | Value    |
| -------------- | -------- |
| **Auth**       | Required |
| **Idempotent** | Yes      |

## Query

| Field       | Type    | Required | Notes                                   |
| ----------- | ------- | -------- | --------------------------------------- |
| `productId` | string  | no       | Narrow to one product.                  |
| `cursor`    | string  | no       | Opaque cursor from a previous response. |
| `limit`     | integer | no       | Max 100. Default 20.                    |

## Response

```json theme={null}
{
  "results": [
    {
      "id": "scr_...",
      "productId": "prod_abc",
      "totalScore": 78,
      "stageName": "Scaling",
      "createdAt": "2026-04-29T08:00:00Z"
    }
  ],
  "nextCursor": "..."
}
```

## Errors

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