# List views

> Returns the saved contact views you can see: your private views and your team's shared views. page below 1 or size outside 1..100 returns 400 INVALID PAGE…

`GET /v2/api/crm/views`

<Note>
**Required scope:** `CRM_READ`
</Note>

Returns the views you can see: your private views and your team's shared views.

## Query parameters

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `page` | integer | `1` | Page number, starting at 1 |
| `size` | integer | `20` | Items per page, from 1 to 100 |

See [Pagination](/docs/guides/pagination).

```json
{
  "data": [
    {
      "id": "cvw_2abc",
      "name": "Hot leads",
      "filters": [
        {
          "field": "company",
          "operator": "CONTAINS",
          "value": "Acme"
        }
      ],
      "sort": [
        {
          "field": "created_at",
          "order": "desc"
        }
      ],
      "owner_type": "USER",
      "user_id": "usr_2abc",
      "team_id": null,
      "created_at": "2026-10-23T10:00:00",
      "updated_at": "2026-10-23T10:00:00"
    }
  ],
  "pagination": {
    "page": 1,
    "size": 20,
    "total_count": 1,
    "total_pages": 1,
    "has_more": false
  }
}
```

## Errors

| Status | Code | When |
|--------|------|------|
| `400` | `INVALID_PAGE_SIZE` | `page` is below 1 or `size` is not between 1 and 100. `param` is `size` |
| `403` | `API_KEY_INSUFFICIENT_SCOPE` | The key does not hold `CRM_READ` |
