List Pix Automático authorizations

Lists live upstream recurring-payment authorizations, scoped by flow + update window, projecting each onto the local authorization status.

GET /v1/pix-automatico/authorizations

List Pix Automático authorizations

cURL

curl --request GET \
  --url https://plugin-pix-direct.api.lerian.net/v1/pix-automatico/authorizations \
  --header 'Authorization: Bearer <token>'

200

{
  "authorizations": [
    {
      "authorizationGiven": true,
      "debtor": {
        "cpfCnpj": "<string>",
        "name": "<string>",
        "personType": 123
      },
      "frequency": 123,
      "idRecorrencia": "<string>",
      "localStatus": "<string>",
      "localStatusKnown": true,
      "payer": {
        "account": "<string>",
        "accountType": 123,
        "agency": "<string>",
        "cpfCnpj": "<string>",
        "ibgeCode": 123,
        "ispb": "<string>",
        "name": "<string>",
        "personType": 123
      },
      "recipient": {
        "cnpj": "<string>",
        "ispb": "<string>",
        "name": "<string>"
      },
      "stJdPi": 123,
      "stJdPiProc": 123,
      "startDate": "<string>",
      "amount": 123,
      "authorizedAt": "<string>",
      "cancellations": [
        {
          "cancelStatus": 123,
          "cancelledAt": "<string>",
          "idCancelamento": "<string>",
          "reason": 123,
          "requesterDocument": "<string>",
          "requesterType": 123,
          "errorCode": "<string>",
          "errorDesc": "<string>"
        }
      ],
      "contractDesc": "<string>",
      "contractNumber": "<string>",
      "endDate": "<string>",
      "floorMaxAmount": 123,
      "idReqJdPi": "<string>",
      "idSolicitacao": "<string>",
      "journey": 123,
      "payerMaxAmount": 123,
      "requestedAt": "<string>",
      "retry": 123,
      "situationAt": "<string>",
      "updatedAt": "<string>"
    }
  ],
  "jdPiAt": "<string>"
}

Authorizations

Authorization · string · header · required

JWT Bearer token authentication. Obtain token from /v1/login/oauth/access_token endpoint using client credentials (clientId and clientSecret).

Include token in Authorization header: Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

Token expires after 3600 seconds (1 hour).

Query Parameters

flow · integer<int64>

fluxo (0=PSP Pagador, 1=PSP Recebedor).

recipientCnpj · string

cnpjRecebedor filter (string).

payerPersonType · string

tpPessoaPagador filter (0/1; empty = no filter).

payerDocument · string

cpfCnpjPagador filter (string).

payerAgency · string

nrAgenciaPagador filter (string).

payerAccount · string

nrContaPagador filter (string).

authorizationOk · string

resultadoAutorizacao filter (true/false; empty = no filter).

stJdPiProc · string

Upstream process status filter (0..10; empty = no filter).

updatedFrom · string

dtHrAtualizacaoRecorrenciaInicio (UTC).

updatedTo · string

dtHrAtualizacaoRecorrenciaFim (UTC).

page · integer<int64>

pagina (default 1).

pageSize · integer<int64>

tamanhoPagina (default 50, max 100).

Response

200

application/json

OK

authorizations · object[] | null · required

The matching authorization snapshots.

Show child attributes

jdPiAt · string · required

Upstream response timestamp (upstream timestamp, UTC).