---
search:
  tags:
    - Approvals
    - GET
seo:
  description: >-
    List approval requests. Reference for the GET /api/v1/approvals endpoint in
    the Taylorz CRM API.
sidebar:
  label: List approval requests
  badge: GET
title: List approval requests
type: openapi-operation
---
`GET /api/v1/approvals`

**Responses**

- `200` — Every request the caller may read
- `400` — The request body, query or parameters were refused
- `401` — The access token is missing, invalid or revoked
- `403` — The tenant's module is off, or the token's scope or the member's role does not permit the action
- `404` — No such record, or none the caller may read
- `413` — The request exceeds the route's body limit
- `500` — An unexpected failure

Response example, 200:

```json
[
  {
    "activeStage": -9007199254740991,
    "contentHash": "string",
    "createdAt": "2019-08-24T14:15:22Z",
    "definitionId": "string",
    "id": "string",
    "organizationId": "string",
    "recordId": "string",
    "recordRevision": 1,
    "snapshot": {
      "property1": "string",
      "property2": "string"
    },
    "stages": [
      {
        "approverUserId": "string",
        "label": "string"
      }
    ],
    "state": "pending",
    "submittedBy": "string"
  }
]
```
