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.
The product ID is a UUID (v4) used to identify the Z.ro product configuration.
The product target user ID is a UUID (v4) used to identify what user account this request must be executed. Require: 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": "2025-10-22",
"value": 100,
"cancellation_reason": "REQUESTED_BY_RECEIVER",
"created_at": "2025-10-22T18:41:31.654Z",
"updated_at": "2025-10-22T18:41:31.654Z"
}
If any required params are missing or has invalid format or type.