List Payouts

List Payouts

GET {{Environment_URL}}/v1/payments/payouts

This route accepts various query params for pagination and filtering. Note that some params must be used in conjunction with other params.

The full list can be seen under PARAMS

Headers

Name	Value
Authorization	Bearer <token>

Query Params

Name	Description	Value
limit	Documents per page ∙ Min 15 | Max 100 | Default 15	15
page	Page number	0
externalId	Specific payment identifier	myid_001
amount	Value in Brazilian cents	10000
status	Operation status ∙ CREATED | AWAITING | PAID | REFUNDED | CANCELED	CREATED
rangeStart	Initial interval for operation value ∙ Must be used with rangeEnd	10000
rangeEnd	Final interval for operation value ∙ Must be used with rangeStart	15000
createdAtStart	Initial cretedAt date interval ∙ Must be used with createdAtEnd	YYYY-MM-DD
createdAtEnd	Initial cretedAt date interval ∙ Must be used with createdAtStart	YYYY-MM-DD
updatedAtStart	Initial updateAt date interval ∙ Must be used with updatedAtEnd	YYYY-MM-DD
updatedAtEnd	Final updatedAt date interval ∙ Must be used with updatedAtStart	YYYY-MM-DD

Response

200 - OK

{
    "page": 1,
    "pages": 1,
    "docsShown": 3,
    "totalDocs": 3,
    "docs": [
        {
            "id": "ab5255b6-571f-4109-b51d-fad170fa7192",
            "accountId": "acc-01k7t681w3pvqxe0svmj573j1x",
            "agentId": 1,
            "payoutTransactionId": "7804196",
            "amount": "0.18",
            "payoutMethod": "TED",
            "pixType": "UNKNOWN",
            "pixKey": null,
            "type": "SIMPLE_PAY_PLATFORM_TRANSFER",
            "name": "N/D",
            "cpf": null,
            "cnpj": "99999999999999",
            "accountNumber": "294932107",
            "branchNumber": "0001",
            "bankNumber": "450",
            "status": "COMPLETED",
            "error": null,
            "accountType": "IP",
            "proofOfPaymentUrl": "{{url}}.pdf",
            "externalId": "pfee_01k88senbrvganq7qdq0gctekn",
            "transactionEndToEndId": "E1320335420251023150265857CB4CF9",
            "originBatchId": null,
            "refundedAmount": null,
            "ownerDocument": "31625631000120",
            "createdAt": "2025-10-23T15:02:01.954Z",
            "updatedAt": "2025-10-23T15:02:22.679Z"
        },
        {
            "id": "537e99cd-9d79-4b49-9f6e-2eafd71c6a2b",
            "accountId": "acc-01k7t681w3pvqxe0svmj573j9x",
            "agentId": 1,
            "payoutTransactionId": null,
            "amount": "0.69",
            "payoutMethod": "TED",
            "pixType": "UNKNOWN",
            "pixKey": null,
            "type": "REFUND",
            "name": "Empresa testes FrenteE",
            "cpf": null,
            "cnpj": "99999999999999",
            "accountNumber": "210070036",
            "branchNumber": "0001",
            "bankNumber": "450",
            "status": "AWAITING_FUNDS",
            "error": {
                "code": "PMT_ERR_504",
                "description": "Bank provider returned unexpected error!"
            },
            "accountType": "UNKNOWN",
            "proofOfPaymentUrl": null,
            "externalId": "tnx_01k6gr366vdrj591gpc807918z",
            "transactionEndToEndId": null,
            "originBatchId": null,
            "refundedAmount": null,
            "ownerDocument": "14381132000115",
            "createdAt": "2025-10-22T17:47:00.945Z",
            "updatedAt": "2025-10-22T17:47:03.649Z"
        },
        {
            "id": "ea8b9576-8e3d-4776-8bb4-7b7719a9ac03",
            "accountId": "acc-01k7t681w3zy2yw6h9hksfz2ep",
            "agentId": 83,
            "payoutTransactionId": "7804143",
            "amount": "1",
            "payoutMethod": "PIX",
            "pixType": "UNKNOWN",
            "pixKey": "59552209099",
            "type": "SIMPLE_PAY",
            "name": "Antontio Ferreira da Silva",
            "cpf": null,
            "cnpj": null,
            "accountNumber": "183134827",
            "branchNumber": "0001",
            "bankNumber": "450",
            "status": "COMPLETED",
            "error": null,
            "accountType": null,
            "proofOfPaymentUrl": "{{url}}.pdf",
            "externalId": "FCID1761152292078-100",
            "transactionEndToEndId": "E132033542025102216589DE6AF8EFC3",
            "originBatchId": null,
            "refundedAmount": null,
            "ownerDocument": "59552209099",
            "createdAt": "2025-10-22T16:58:12.079Z",
            "updatedAt": "2025-10-22T16:58:29.975Z"
        }
    ]
}