> ## Documentation Index
> Fetch the complete documentation index at: https://docs.goatpay.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar autorizações PIX Automático

> Paginação e filtros por status e cliente.

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET 'https://api.goatpay.com.br/v1/pix-automatic/authorizations/list?offset=0&limit=10&status=ACTIVE' \
    -H 'X-API-Key: gp_live_SUA_CHAVE'
  ```
</RequestExample>

<ResponseExample>
  ```json Success theme={null}
  {
    "success": true,
    "message": "Autorizações PIX Automático listadas",
    "data": {
      "object": "list",
      "hasMore": false,
      "totalCount": 1,
      "limit": 10,
      "offset": 0,
      "data": [{
      "id": "a33047b1-fb19-4b68-9373-a7ba8a8162aa",
      "status": "ACTIVE",
      "frequency": "MONTHLY",
      "contractId": "CONTRACT-123",
      "value": 99.9,
      "startDate": "2026-06-01",
      "customerId": "clx_customer",
      "description": "Assinatura mensal",
      "dateCreated": "2026-05-31T10:00:00.000Z"
    }]
    },
    "requestId": "req_abc"
  }
  ```
</ResponseExample>

### Parâmetros de query

<ParamField query="offset" type="number">
  Índice inicial (padrão 0).
</ParamField>

<ParamField query="limit" type="number">
  Itens por página (máx. 100).
</ParamField>

<ParamField query="status" type="string">
  CREATED, ACTIVE, CANCELLED, REFUSED, EXPIRED.
</ParamField>

<ParamField query="customerId" type="string">
  ID do cliente.
</ParamField>