BluebulbAPI
    API reference/Payments received
    GET

    List payments received

    Rolling out
    GET{baseUrl}/api/payins

    Returns payments into your sub-wallets, newest first.

    This endpoint is part of an API release that is still rolling out. Fields and endpoints marked Rolling out may not be available on your account yet.

    Authentication

    Send your API key and a request signature on every call. Requests must also come from an IP address on your allowlist — see Authentication.

    Headers

    x-api-key
    required
    string
    Your API key, <appId>.<secret>. See Authentication.
    X-Signature
    required
    string
    Base64 RSA-SHA256 signature of the request. See Request signing.
    X-Signature-Timestamp
    required
    string
    Unix time in milliseconds used in the signature. Must be within 5 minutes of Orbita's clock.

    Query parameters

    page
    optional
    integer
    Page number, starting at 1. Defaults to 1.
    limit
    optional
    integer
    Items per page. Defaults to 20.
    virtualAccountId
    optional
    string (uuid)
    Only payments into this sub-wallet.
    startDate
    optional
    date
    Only payments on or after this date, e.g. 2026-09-01.
    endDate
    optional
    date
    Only payments on or before the end of this date.
    minAmount
    optional
    number
    Only payments of at least this amount.
    maxAmount
    optional
    number
    Only payments of at most this amount.

    Behaviour

    startDate and endDate can be used on their own or together. There's no sorting.

    Response

    data.items is an array of payments; data.meta describes the page. Every response is wrapped in the standard envelope.

    items[].id
    string (uuid)
    Payment ID.
    items[].virtualAccountId
    string (uuid)
    ID of the sub-wallet that was paid into.
    items[].amount
    number
    Amount received.
    items[].currency
    string
    Always ngn.
    items[].payerName
    string | null
    Name on the account that paid, when the bank provides it.
    items[].payerAccountNumber
    string | null
    Account number that paid, when the bank provides it.
    items[].payerBankName
    string | null
    Bank that paid from, when the bank provides it.
    items[].providerReference
    string
    The bank's reference for the payment. Unique per payment, and the same value as reference in the funding webhook.
    items[].status
    string
    completed once the amount has been credited to your NGN balance; pending while it's being credited; failed if it couldn't be.
    items[].resultingWalletBalance
    number | null
    Your NGN balance straight after this payment was credited.
    items[].createdAt
    string (datetime)
    When the payment arrived.
    meta.totalItems
    integer
    Total records matching the filters.
    meta.itemsPerPage
    integer
    The limit applied.
    meta.totalPages
    integer
    Total pages available.
    meta.currentPage
    integer
    The page returned.

    Errors

    No endpoint-specific errors. See Responses & errors for errors every endpoint can return.