# List approvals (https://docs-ecmrhub-v2.lucaspiera.com/docs/api/approvals/listApprovals)

## GET /functions/v1/approvals

List approvals

Approvals newest first, optionally by status. A person sees the whole company's; an OAuth connection or an API key sees only its own.

```json
{
  "operationId": "listApprovals",
  "parameters": [
    {
      "in": "query",
      "name": "status",
      "schema": {
        "type": "string",
        "enum": [
          "pending",
          "approved",
          "rejected",
          "consumed",
          "expired"
        ]
      }
    }
  ],
  "responses": {
    "200": {
      "description": "Success",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "items": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/Approval"
                }
              }
            },
            "required": [
              "items"
            ],
            "additionalProperties": false
          }
        }
      }
    },
    "default": {
      "$ref": "#/components/responses/Problem"
    }
  }
}
```

Schemas referenced as `#/components/...` are in the full contract: https://docs-ecmrhub-v2.lucaspiera.com/openapi.json