---
title: "Listar Autorizações de Pix Automático"
method: GET
path: "/automatic-pix/authorization"
tags: ["Authorization"]
---

# Listar Autorizações de Pix Automático

`GET /automatic-pix/authorization`

API responsável por listar as autorização de Pix Automático

## Query parameters

- `pageSize` integer, required — Quantidade de cobranças por página
- `pageNumber` integer, required — Número da página
- `contract` string — Identificador do contrato (deve ser gerenciado pelo recebedor e não pode ser reutilizado caso esteja associado a uma autorização pendente ou aprovada)

## Response `200`

Sucesso

- ListAuthorizationsResponse
  - `data` AuthorizationDataResponse
    - `id` string, uuid, required — Id da autorização do Pix Automático
    - `createdAt` string, required — Data da criação
    - `initialDate` string, required — Data do primeiro pagamento (deve respeitar um intervalo mínimo de 3 dias a partir da data atual)
    - `approvedAt` string — Data da aprovação
    - `canceledAt` string — Data de cancelamento
    - `cancellationCode` 'ACCL' | 'CPCL' | 'DCSD' | 'FRUD' | 'SLCR' | 'SLDB' | 'ERSL' | 'NRES' | 'PCFD' | 'EPDI' | 'EPDF' — Authorization Cancellation Code: - `ACCL`: Conta encerrada - `CPCL`: Encerramento de empresa - `DCSD`: Falecido - `FRUD`: Fraude - `SLCR`: Solicitado pelo usuário recebedor - `SLDB`: Solicitado pelo usuário pagador - `EPDI`: Expiração da data inicial de pagamento, a aprovação precisa ser realizada com 3 dias de antecedência para que seja possível realizar o primeiro agendamento - `EPDF`: A expiração ocorreu porque a data final foi excedida
    - `cancellationDescription` string
    - `rejectedAt` string — Data da rejeição
    - `rejectionCode` 'AC01' | 'AC04' | 'AC06' | 'AG12' | 'AM05' | 'AP01' | 'AP02' | 'AP03' | 'AP04' | 'AP05' | 'AP06' | 'AP07' | 'AP08' | 'AP09' | 'AP10' | 'AP11' | 'AP12' | 'AP13' | 'AP14' | 'AP15' | 'CH16' | 'DS27' | 'MD01' | 'MD20' | 'RC09' | 'RC10' — Authorization Rejection Code: - `AC01`: Conta não encontrada - `AC04`: Conta encerrada - `AC06`: Conta bloqueada - `AG12`: Não é permitido o envio de solicitações para conta transacional na mesma instituição - `AM05`: Solicitação previamente confirmada ou aguardando confirmação do usuário pagador - `AP01`: Rejeitado por divergência nas informações - `AP02`: Divergência no documento do usuário pagador - `AP03`: Agência não encontrada - `AP04`: Id da solicitação inválido ou não corresponde ao original - `AP05`: Status da solicitação está inconsistente - `AP06`: O número do documento do usuário destinatário está incorreto - `AP07`: Confirmação de recorrência pelo usuário pagador realizada fora do prazo - `AP08`: O primeiro pagamento imediato associado à solicitação não foi identificado - `AP09`: A confirmação da solicitação não foi identificada para permitir o cancelamento - `AP10`: O documento do solicitante de cancelamento não corresponde à identificação do usuário pagador ou recebedor - `AP11`: O identificador da instituição do pagador difere da informação contida na solicitação - `AP12`: O identificador da instituição do recebedor difere da informação contida na solicitação - `AP13`: Solicitação rejeitada pelo usuário pagador devido ao não reconhecimento pelo usuário recebedor - `AP14`: Solicitação rejeitada pelo usuário pagador por não ter interesse em utilizar o Pix Automático para o usuário recebedor - `AP15`: Solicitação indeferida pela instituição do usuário pagador que optou por não oferecer o uso do Pix Automático para clientes pessoa jurídica - `CH16`: Rejeitado pois alguma informação está incorreta - `DS27`: O participante não está registrado ou ainda não começou a operar no SPI - `MD01`: A solicitação sujeita à solicitação de cancelamento não existe - `MD20`: Solicitação de cancelamento já expirou - `RC09`: ISPB do usuário pagante participante inválido ou inexistente - `RC10`: ISPB do usuário recebedor participante inválido ou inexistente
    - `rejectionDescription` string
    - `finalDate` string — Data prevista do último pagamento
    - `link` Link
      - `rel` string
      - `href` string
      - `method` string
      - `type` string
    - `amount` number — Valor
    - `retryPolicy` 'ACCEPT_3R_7D' | 'NOT_APPLICABLE', required — Retentativa de pagamento
    - `period` 'ANNUALLY' | 'MONTHLY' | 'QUARTERLY' | 'SEMIANNUAL' | 'WEEKLY', required — Período da autorização
    - `updatedAt` string, required — Data da atualização
    - `requests` RequestResponse[]
      - `requestId` string, uuid — Id da solicitação
      - `authorizationId` string, uuid — Id da autorização do Pix Automático
      - `createdAt` string — Data da criação
      - `expirationDate` string — Data de expiração da solicitação
      - `origin` string
      - `recipient` Recipient — Dados do pagador (destinatário) - jornada 1
        - `taxId` string, required — Documento do pagador (destinatário) que receberá a solicitação da autorização por notificação push - jornada 1
        - `name` string, required — Nome do pagador (destinatário) - jornada 1
        - `personType` 'J' | 'F', required — Tipo do documento
        - `account` RecipientAccount, required — Dados da conta do pagador (destinatário) - jornada 1
          - `ispbParticipant` string, required — Código de identificação da instituição
          - `number` string, required — Número da conta com dígito
          - `branch` string — Agência bancária
      - `status` 'PROCESSING' | 'CREATED' | 'CANCELED' | 'EXPIRED' | 'APPROVED' | 'REJECTED' | 'SENT' | 'RECEIVED' — Status da solicitação por push - jornada 1
    - `status` 'PROCESSING' | 'CREATED' | 'CANCELED' | 'CANCELING' | 'EXPIRED' | 'APPROVED' | 'REJECTED' | 'FINISHED', required — Status da autorização
    - `totalInstallments` number — Total de pagamentos previstos (existirá apenas caso a autorização do Pix Automático tenha uma data final definida)
    - `payee` Payee, required — Emissor
      - `document` string
      - `fantasyName` string — Nome
      - `socialName` string — Nome
      - `bankCode` string — Código bancário
      - `bankName` string — Nome
    - `payer` Payer — Pagador
      - `name` string, required
      - `email` string, email
      - `personType` 'F' | 'J', required
      - `phoneNumber` string
      - `taxId` string, required
      - `address` Address
        - `type` 'RESIDENCIAL' | 'COMERCIAL' | 'OUTROS' | 'NATURALIDADE'
        - `zipCode` string
        - `country` string
        - `state` string
        - `city` string
        - `street` string
        - `number` string
        - `complement` string
        - `neighborhood` string
      - `deliveryMediums` string[]
    - `activation` Activation, required
      - `journeyType` 'JOURNEY_1' | 'JOURNEY_2' | 'JOURNEY_3' | 'JOURNEY_4' | 'WAITING_DEFINITION', required — Tipo de jornada da ativação
      - `txId` string
    - `origin` string, required
    - `location` Location
      - `id` string
      - `type` string
      - `taxId` string
      - `url` string
    - `qrCodeInfo` QrCodeInfo
      - `emv` string
      - `journeyType` 'JOURNEY_1' | 'JOURNEY_2' | 'JOURNEY_3' | 'JOURNEY_4' | 'WAITING_DEFINITION' — Tipo de jornada da ativação
    - `externalId` string
  - `_links` Cursor
    - `previous` object
      - `href` string
      - `method` string
      - `type` string
    - `next` object
      - `href` string
      - `method` string
      - `type` string

## Other responses

- `400` — Bad Request
- `500` — Internal Server Error

---

[API](https://skmtc.net/btgpactual/apis/folha-de-pagamentos.md) · [All operations](https://skmtc.net/btgpactual/apis/folha-de-pagamentos/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/btgpactual/folha-de-pagamentos/revisions/2a24d3da114c/schema)