List Pix Recurrences with pagination

​
Query Parameters
  • recurrence
    Type: string enum

    Recurrence frequency filter.

    values
    • WEEKLY
    • BIWEEKLY
    • MONTHLY
  • 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
  • */*
Request Example for get/api/v1/pix-schedules/recurrences
curl 'http://localhost/api/v1/pix-schedules/recurrences?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",
      "recurrence": "MONTHLY",
      "startDate": "2026-04-30",
      "recurrenceEndDate": "2027-04-30",
      "nextExecutionDate": "2026-05-30",
      "lastExecutionDate": "2026-04-30",
      "totalInstallments": 12
    }
  ],
  "totalItems": 1,
  "page": 1,
  "size": 1,
  "totalPages": 1,
  "hasNext": true
}

Query completed successfully