### GET /api/v4/lists/{id}/items

**List items** (`list_items`). Items in the order they were added, with name, HQ country and a short description.

1¢ per successful request. API key required. Success: `200`.

#### Path parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | yes | List UUID. |

#### Query parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `limit` | integer |  |  |
| `cursor` | string |  |  |

#### Response

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `data` | array<object> | yes | The results. |
| `data[].id` | string | yes | UUID. |
| `data[].startup_id` | string \| null | yes |  |
| `data[].domain` | string | yes |  |
| `data[].name` | string \| null | yes |  |
| `data[].hq_country` | string \| null | yes |  |
| `data[].description` | string \| null | yes |  |
| `data[].added_at` | string | yes | ISO 8601 timestamp (UTC). |
| `page` | object | yes | Pagination; see the Pagination guide. |
| `page.next_cursor` | string \| null | yes | Send it back (alone, optionally with limit) for the next page; null at the end. |
| `page.total` | object |  | How many records match in total. |
| `page.total.value` | integer \| null | yes | Number of matching records; null when unknown. |
| `page.total.exact` | boolean | yes | false when value is a lower bound (≥10,000) or unknown. |
| `page.shortened` | true |  | Present when the page was cut to fit 1 MB; next_cursor continues exactly after the last row. |
| `meta.request_id` | string | yes | Request id (also in X-Request-Id). |
| `meta.cost_usd_cents` | number | yes | Charged for this request, in USD cents. |

#### Errors

| Status | Code | Meaning |
| --- | --- | --- |
| 400 | `VALIDATION_FAILED` | The request does not match the endpoint contract. |
| 401 | `UNAUTHORIZED` | The API key is missing, invalid or revoked. |
| 402 | `INSUFFICIENT_FUNDS` | The account balance cannot cover this request or job. |
| 404 | `NOT_FOUND` | The record or resource does not exist for this account. |
| 429 | `RATE_LIMITED` | Too many requests in the current window. |
| 429 | `QUOTA_EXCEEDED` | A daily or concurrency quota is used up. |
| 500 | `INTERNAL_ERROR` | An unexpected server error. |
| 503 | `SERVICE_UNAVAILABLE` | A dependency is temporarily unavailable. |

#### Example

```bash

curl -X GET 'https://startup-seeker.com/api/v4/lists/<id>/items' \
  -H "Authorization: Bearer $STARTUPSEEKER_API_KEY"

```