Get Automatic Pix Charge by ID
GETTag: api-baas-get-by-id-pix-automatic-chargeDescription: Retrieve the details of a pix automatic charge by providing its ID./v1/pix/scheduled-payments/automatic-charges/:id
Request
Path Parameters
Charge 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
Charge found.
- application/json
- Schema
- Example (from schema)
Schema
Charge ID.
Possible values: [PENDING_WAITING, PENDING_CONFIRMED, CREATED, CREATED_FAILED, PAID, NOT_PAID, WAITING_CANCELLATION, CANCELED, CANCELED_FAILED]
Charge status
Pix Automatic Recurrence ID
Possible values: [SCHEDULING, NEW_ATTEMPT, RESEND]
Scheduling purpose
Due date
Value
Possible values: [ACCOUNT_CLOSED, ACCOUNT_BLOCKED, RECURRENCE_CANCELED, SETTLEMENT_FAILURE, OTHER_REASON_BY_PARTICIPANT, REQUESTED_BY_PAYER, REQUESTED_BY_RECEIVER]
Cancellation reason
Charge creation date.
Charge update date.
{
"id": "d1952c4b-9348-41ab-99a3-05b11459aded",
"status": "CREATED",
"pix_automatic_recurrence_id": "595d2a52-eb0f-4b4a-954c-2379cc0f4179",
"scheduling_purpose": "SCHEDULING",
"due_date": "2026-03-26",
"value": 100,
"cancellation_reason": "REQUESTED_BY_RECEIVER",
"created_at": "2026-03-26T14:02:59.326Z",
"updated_at": "2026-03-26T14:02:59.326Z"
}
If any required params are missing or has invalid format or type.