List Pix Request Schedules with pagination

​

List single Pix Request Schedules filtered by optional fields. Query params: ispb, accountNumber (required), branch (required), status (optional), recurrenceId (optional - filters schedules linked to the given recurrence), senderTaxId (optional), receiverTaxId (optional), endToEndId (optional - the identifier is assigned at creation, so it matches a schedule in any state), startDate (optional), endDate (optional), page (default: 0), size (default: 50), sort (e.g. scheduledDate,desc)

Query Parameters
  • endToEndId
    Type: string
    max length:  
    32

    End-to-end identifier filter.

  • ispb
    Type: string

    Sender account ISPB.

  • accountNumber
    Type: string
    min length:  
    1
    required

    Sender account number.

  • branch
    Type: string
    min length:  
    1
    required

    Sender account branch.

  • status
    Type: string enum

    Status filter.

    values
    • ACTIVE
    • INACTIVE
    • IN_FLIGHT
    • COMPLETED
    • REJECTED
    • EXPIRED
    • PENDING
  • source
    Type: string enum

    Source filter (MANUAL or PIX_AUTOMATIC).

    values
    • MANUAL
    • PIX_AUTOMATIC
  • mandateId
    Type: string

    Mandate identifier filter.

  • senderTaxId
    Type: string

    Sender tax ID (CPF/CNPJ) filter.

  • receiverTaxId
    Type: string

    Receiver tax ID (CPF/CNPJ) filter.

  • recurrenceId
    Type: string Format: uuid

    Recurrence identifier filter.

  • startDate
    Type: string

    Start date filter (yyyy-MM-dd). Lower bound for the schedule date.

  • endDate
    Type: string

    End date filter (yyyy-MM-dd). Upper bound for the schedule date.

  • page
    Type: integer Format: int32

    Page number (0-indexed).

  • size
    Type: integer Format: int32

    Page size.

  • sort
    Type: array string[]

    Sort fields (e.g. scheduledDate,desc).

Responses
  • application/json
  • 400

    Invalid request

    Erros desta resposta

    Código interno HTTP Descrição Erro normativo Bacen
    PIX-SCH-0010 400 Invalid date format. Expected format: yyyy-MM-dd —
Request Example for get/api/v1/pix-schedules
curl 'http://localhost/api/v1/pix-schedules?accountNumber=123456789&branch=0001' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "items": [
    {
      "id": "c0a8012e-1234-5678-90ab-000000000001",
      "status": "ACTIVE",
      "createdAt": "2026-03-01T09:30:00",
      "updatedAt": "2026-03-15T12:00:00",
      "initiationMethod": "MANU",
      "priority": "NORM",
      "priorityType": "PAGAGD",
      "purpose": "IPAY",
      "amount": 150,
      "userDescription": "Gym membership",
      "sender": {
        "name": "Joao da Silva",
        "document": {
          "type": "CPF",
          "value": "12345678901"
        },
        "account": {
          "ispb": "12345678",
          "type": "CACC",
          "branch": "0001",
          "number": "12345678"
        }
      },
      "receiver": {
        "key": "+5511989450870",
        "name": "Joao da Silva",
        "document": {
          "type": "CPF",
          "value": "12345678901"
        },
        "account": {
          "ispb": "12345678",
          "type": "CACC",
          "branch": "0001",
          "number": "12345678"
        }
      },
      "source": "MANUAL",
      "scheduledDate": "2026-04-30",
      "endToEndId": "E1234567820260430143000ABC12345",
      "msgId": "M20260101000000001",
      "settledAt": "2026-06-22T14:30:00Z",
      "failureReason": "FF08",
      "recurrenceId": "c0a8012e-1234-5678-90ab-000000000002",
      "installment": 3,
      "totalInstallments": 12,
      "reconciliationId": "REC20260408001",
      "totalAmount": 150
    }
  ],
  "totalItems": 1,
  "page": 1,
  "size": 1,
  "totalPages": 1,
  "hasNext": true
}

Query completed successfully