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), startDate (optional), endDate (optional), page (default: 0), size (default: 50), sort (e.g. scheduledDate,desc)

Query Parameters
  • 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
    • 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 Pattern: ^\d{4}-\d{2}-\d{2}$

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

  • endDate
    Type: string Pattern: ^\d{4}-\d{2}-\d{2}$

    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).

Headers
  • Idempotency-Key
    Type: string
    required
Responses
  • application/json
Request Example for get/api/v1/pix-schedules
curl 'http://localhost:8080/api/v1/pix-schedules?accountNumber=123456789&branch=0001' \
  --header 'Idempotency-Key: ' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "items": [
    {
      "id": "string",
      "status": "ACTIVE",
      "createdAt": "string",
      "updatedAt": "string",
      "initiationMethod": "APDN",
      "priority": "HIGH",
      "priorityType": "PAGAGD",
      "purpose": "GSCB",
      "amount": 1,
      "userDescription": "string",
      "sender": {
        "name": "string",
        "document": {
          "type": "CPF",
          "value": "string"
        },
        "account": {
          "ispb": "string",
          "type": "CACC",
          "branch": "string",
          "number": "string"
        }
      },
      "receiver": {
        "key": "string",
        "name": "string",
        "document": {
          "type": "CPF",
          "value": "string"
        },
        "account": {
          "ispb": "string",
          "type": "CACC",
          "branch": "string",
          "number": "string"
        }
      },
      "source": "MANUAL",
      "scheduledDate": "2026-07-29",
      "endToEndId": "string",
      "msgId": "string",
      "settledAt": "2026-07-29T19:28:46.582Z",
      "recurrenceId": "string",
      "installment": 1,
      "totalInstallments": 1,
      "reconciliationId": "REC-20260408-001",
      "totalAmount": 1
    }
  ],
  "totalItems": 1,
  "page": 1,
  "size": 1,
  "totalPages": 1,
  "hasNext": true
}

Query completed successfully