# List collections

> Lists your collections, newest first, paged via limit/offset. (GET /v1/collections)

Source: https://sightradar.com/docs/api/collections/list-collections

Lists your collections, newest first, paged via limit/offset. Pass `q` to filter by a case-insensitive substring of the collection ID. Returns the matching `total` so clients can paginate accurately. Free.

### Example request

```bash
curl -X GET "https://api.sightradar.com/v1/collections" \
  -H "Authorization: Bearer $SR_API_KEY"
```

### Parameters

| Name     | In    | Type      | Description                                                                                                             |
| -------- | ----- | --------- | ----------------------------------------------------------------------------------------------------------------------- |
| `limit`  | query | `integer` |                                                                                                                         |
| `offset` | query | `integer` |                                                                                                                         |
| `q`      | query | `string`  | Case-insensitive LITERAL substring filter on collection\_id (max 100 chars; wildcard characters are matched literally). |

### Response body

| Field         | Type       | Description                                                   |
| ------------- | ---------- | ------------------------------------------------------------- |
| `collections` | `object[]` |                                                               |
| `total`       | `integer`  | Total collections matching the filter (ignores limit/offset). |
| `limit`       | `integer`  |                                                               |
| `offset`      | `integer`  |                                                               |

### Status codes

| Status | Meaning                     |
| ------ | --------------------------- |
| `200`  | Your collections.           |
| `401`  | Missing or invalid API key. |