Get Automatic Pix Authorization by ID
GETTag: api-baas-get-by-id-pix-automatic-authorizationDescription: Retrieve the details of a pix automatic authorization by providing its ID./v1/pix/scheduled-payments/automatic-authorizations/:id
Request
Path Parameters
Authorization ID.
Header Parameters
Sender Wallet UUID (if empty, your default Wallet UUID will be settled)
The nonce ID is a UUID (v4) used to uniquely identify the request. All requests must have an identifier.
Possible values: [pt-BR, en-US]
Indicates the preferred language. Defaults to Brazilian Portuguese if unspecified.
UUID (v4) of the product that the request should use. Send it explicitly when the authenticated user has more than one product or when the integration must select a specific product. If omitted and the endpoint does not require it, the API uses the authenticated user's default product.
UUID (v4) of the user on whose behalf the request should run within the selected product. If omitted, the request runs as the authenticated user. Requires x-product-uuid.
Responses
- 200
- 400
Automatic pix authorization retrieved successfully.
- application/json
- Schema
- Example (from schema)
Schema
Authorization ID.
Possible values: [JOURNEY_1, JOURNEY_2, JOURNEY_3, JOURNEY_4]
Authorization journey
Possible values: [WEEKLY, MONTHLY, QUARTERLY, SEMI_ANNUALLY, ANNUALLY]
Authorization frequency
Authorization start date
Authorization end date
Authorization value
Authorization floor max value
Authorization beneficiary ISPB
Authorization beneficiary document
Authorization beneficiary name
Authorization owner (payer) document
Authorization debtor document
Authorization debtor name
Authorization contract number
Authorization contract description
Authorization request expiration date
Possible values: [PENDING, WAITING_APPROVAL, WAITING_REJECTION, APPROVED, REJECTED, WAITING_CANCELLATION, CANCELED, FINISHED]
Authorization status
Authorization payment max value (defined by payer)
Authorization creation date.
Authorization update date.
{
"id": "d1952c4b-9348-41ab-99a3-05b11459aded",
"journey": "JOURNEY_1",
"frequency": "MONTHLY",
"start_date": "2025-04-15",
"end_date": "2026-04-15",
"value": 100,
"floor_max_value": 50,
"beneficiary_ispb": "7219",
"beneficiary_document": "01234567890",
"beneficiary_name": "John Doe",
"owner_document": "02345678912",
"debtor_document": "03456789013",
"debtor_name": "John Wick",
"contract_number": "123456-7",
"contract_description": "Gym monthly subscription",
"request_expiration_date": "2026-03-26T14:02:59.319Z",
"status": "APPROVED",
"payment_max_value": 80,
"created_at": "2026-03-26T14:02:59.319Z",
"updated_at": "2026-03-26T14:02:59.319Z"
}
If any required params are missing or has invalid format or type.