Skip to main content

List wallet transactions

GET 
/transactions

Fetch a paginated list of wallet transactions for the authenticated payer with optional filters. Results include transaction morph data and derived fields like category, reference, and narration.

Request​

Query Parameters

    type string

    Possible values: [debit, credit]

    Filter by transaction direction (maps to action dr/cr)

    category string

    Possible values: [invoice, payout]

    Filter by high-level category

    reference string

    Filter by reference (exact or partial match depending on server implementation)

    status string

    Possible values: [pending, success, failed]

    Filter by transaction status

    amount number

    Filter by amount (>= 0)

    start_date date

    Start date (ISO 8601, e.g. 2025-11-01)

    end_date date

    End date (ISO 8601, must be >= start_date)

    page integer

    Possible values: >= 1

    Default value: 1

    Page number

    per_page integer

    Possible values: [10, 20, 50, 100]

    Default value: 20

    Items per page

Responses​

Paginated list of wallet transactions

Schema
    current_page integer
    data object[]
  • Array [
    • id integer
    amount string
    currency string
    transaction_type string
    transaction_id integer
    action string

    Possible values: [dr, cr]

    created_at date-time
    updated_at date-time
    category string
    reference stringnullable
    narration string
    transaction object

    Transaction entity. Fields vary depending on transaction_type.

    property name* any

    Transaction entity. Fields vary depending on transaction_type.

  • ]
    • first_page_url string
    from integernullable
    last_page integer
    last_page_url string
    links object[]
  • Array [
    • url stringnullable
    label string
    active boolean
  • ]
    • next_page_url stringnullable
    path string
    per_page integer
    prev_page_url stringnullable
    to integernullable
    total integer
Loading...