> ## Documentation Index
> Fetch the complete documentation index at: https://docs.delfinance.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Consultar ordens de split

> Busque uma ordem específica ou liste ordens por transação, página e limite.

> [!NOTE]
>
> Para o contexto completo, veja o guia [Ordens de Split de Pagamentos](https://docs.delfinance.com.br/guias/split-pagamentos/ordens.md).

Retorna uma ordem específica ou uma listagem paginada de ordens associadas à credencial autenticada.

## Headers

**x-delbank-api-key** `string` *required*

Sua API key.

## Query params

**id** `string`

Identificador da ordem a ser consultada.

**transactionId** `string`

Identificador da transação original de cash-in associada à ordem.

**page** `number` (default: 1)

Página da listagem. Padrão: `1`.

**limit** `number` (default: 10)

Quantidade de itens por página. Padrão: `10`; valores maiores que `100` são limitados a `100`.

**include** `string`

Quando definido como `metadata`, retorna os itens em `data` e os metadados de paginação em `metadata`.

## Response

**id** `number` *required*

Identificador único da ordem.

**transactionOriginalId** `string` *required*

Identificador da transação original do cash-in relacionado.

**source** `string` *required*

Origem do split: `QR_CODE` ou `ACCOUNT_CONFIGURATOIN`.

**grossAmount** `number` *required*

Valor bruto do cash-in.

**tariffAmount** `number`

Valor da tarifa cobrada antes do split, quando aplicável.

**splitBaseAmount** `number` *required*

Base do cálculo do split após as regras de tarifa.

**createdAt** `string` *required*

Data de criação da ordem em ISO 8601.

**payouts** `array`

Lista dos payouts associados a essa ordem.

```bash cURL (ordem por id) theme={null}
curl --location 'https://api.delbank.com.br/baas/api/v1/split-payments/orders?id=12345' \
--header 'x-delbank-api-key: {{apiKey}}'
```

```bash cURL (ordem por transação) theme={null}
curl --location 'https://api.delbank.com.br/baas/api/v1/split-payments/orders?transactionId=ID-DO-CASHIN' \
--header 'x-delbank-api-key: {{apiKey}}'
```

```bash cURL (listagem paginada) theme={null}
curl --location 'https://api.delbank.com.br/baas/api/v1/split-payments/orders?page=1&limit=20' \
--header 'x-delbank-api-key: {{apiKey}}'
```

```bash cURL (listagem paginada com metadata) theme={null}
curl --location 'https://api.delbank.com.br/baas/api/v1/split-payments/orders?page=1&limit=10&include=metadata' \
--header 'x-delbank-api-key: {{apiKey}}'
```

```json 200 theme={null}
{
    "id": 12345,
    "transactionOriginalId": "ID-DO-CASHIN",
    "grossAmount": 10.00,
    "tariffAmount": 0.25,
    "splitBaseAmount": 9.75,
    "source": {
        "name": "QR_CODE",
        "description": "QrCode",
        "value": 0
    },
    "createdAt": "2025-09-22T12:00:00.000Z",
    "payouts": [
        {
            "id": 12545,
            "splitOrderId": 12345,
            "beneficiary": {
                "bankIspb": "ISPBCODE",
                "bankAccountNumber": "12345",
                "bankAccountBranch": "0001",
                "holderDocument": "01234567890",
                "holderName": "Nome do beneficiário",
                "bankAccountType": "Tipo da conta bancária do beneficiário"
            },
            "transferType": {
                "name": "PIX_MANUAL",
                "description": "Pix Manual",
                "value": 2
            },
            "instructionType": {
                "name": "PERCENTAGE",
                "description": "Porcentagem",
                "value": 0
            },
            "instructionAmount": 85.00,
            "amount": 8.29,
            "paymentDate": "2025-09-22T12:00:00.000Z",
            "status": {
                "name": "SUCCESS",
                "description": "Sucesso",
                "value": 1
            },
            "transactionId": "ID-DO-SPLIT-CASHOUT",
            "endToEndId": "E2E-DO-SPLIT-CASHOUT",
            "paidAt": "2025-09-22T12:00:00.000Z",
            "createdAt": "2025-09-22T12:00:00.000Z",
            "updatedAt": "2025-09-22T12:00:00.000Z"
        }
    ]
}
```

```json 200 (listagem paginada) theme={null}
[
    {
        "id": 12345,
        "transactionOriginalId": "ID-DO-CASHIN",
        "grossAmount": 10.00,
        "tariffAmount": 0.25,
        "splitBaseAmount": 9.75,
        "source": {
            "name": "QR_CODE",
            "description": "QrCode",
            "value": 0
        },
        "createdAt": "2025-09-22T12:00:00.000Z"
    },
    {
        "id": 12346,
        "transactionOriginalId": "ID-DO-CASHIN",
        "grossAmount": 100.00,
        "tariffAmount": 0.00,
        "splitBaseAmount": 100.00,
        "source": {
            "name": "QR_CODE",
            "description": "QrCode",
            "value": 0
        },
        "createdAt": "2025-09-26T12:00:00.000Z"
    }
]
```

```json 200 (listagem paginada com metadata) theme={null}
{
    "data": [
        {
            "id": 12345,
            "transactionOriginalId": "ID-DO-CASHIN",
            "grossAmount": 10.00,
            "tariffAmount": 0.25,
            "splitBaseAmount": 9.75,
            "source": {
                "name": "QR_CODE",
                "description": "QrCode",
                "value": 0
            },
            "createdAt": "2025-09-22T12:00:00.000Z"
        },
        {
            "id": 12346,
            "transactionOriginalId": "ID-DO-CASHIN",
            "grossAmount": 100.00,
            "tariffAmount": 0.00,
            "splitBaseAmount": 100.00,
            "source": {
                "name": "QR_CODE",
                "description": "QrCode",
                "value": 0
            },
            "createdAt": "2025-09-26T12:00:00.000Z"
        }
    ],
    "metadata": {
        "pageNumber": 1,
        "pageSize": 10,
        "pageCount": 3,
        "rowCount": 21
    }
}
```

```json 400 theme={null}
{
    "errors": [
        "'id' e 'transactionId' são mutuamente exclusivos."
    ]
}
```

```json 404 theme={null}
{
    "type": "https://tools.ietf.org/html/rfc7231#section-6.5.4",
    "title": "Not Found",
    "status": 404
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.