BluebulbAPI
    API reference/Conversions
    GET

    List conversions

    GET{baseUrl}/api/conversions

    Returns your conversions, newest first.

    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 10.
    sort
    optional
    JSON string
    A single-key JSON object, e.g. {"createdAt":"ASC"} (URL-encoded). Sortable on any conversion field, e.g. createdAt, amount, status. Defaults to {"createdAt":"DESC"}.
    startDate
    optional
    date
    Only include records created on or after this date, e.g. 2026-09-01. Use together with endDate.
    endDate
    optional
    date
    Only include records created on or before the end of this date. Use together with startDate.
    status
    optional
    string
    Only conversions with this status.
    fromCurrency
    optional
    string
    Only conversions from this currency.
    toCurrency
    optional
    string
    Only conversions to this currency.
    reference
    optional
    string
    Conversions whose Orbita reference contains this text.

    Response

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

    items[].id
    string (uuid)
    Conversion ID.
    items[].userId
    string (uuid)
    ID of the business owner the conversion belongs to.
    items[].fromCurrency
    string
    Currency debited.
    items[].toCurrency
    string
    Currency credited.
    items[].amount
    number
    Amount debited, in fromCurrency.
    items[].convertedAmount
    number
    Amount credited, in toCurrency.
    items[].rate
    number | null
    Raw rate applied (convertedAmount = amount × rate).
    items[].status
    string
    One of processing, pending, completed, failed, refund_pending, expired. See Statuses.
    items[].reference
    string
    Orbita's reference for the conversion.
    items[].proposedCompletionTime
    string (datetime)
    When the conversion is expected to complete, based on the pair's SLA.
    items[].actualCompletionTime
    string (datetime) | null
    When it completed, or null.
    items[].payoutIntentRolling out
    object
    Status of the payout attached to this conversion, if it was created by a cross-currency payout. See below.
    items[].createdAt
    string (datetime)
    When the conversion was created.
    items[].updatedAt
    string (datetime)
    When the conversion last changed.
    meta.totalItems
    integer
    Total records matching the filters.
    meta.itemCount
    integer
    Records on this page.
    meta.itemsPerPage
    integer
    The limit applied.
    meta.totalPages
    integer
    Total pages available.
    meta.currentPage
    integer
    The page returned.

    Errors

    Errors specific to this endpoint:

    400
    Invalid startDate
    startDate or endDate isn't a valid date.

    Plus the errors every endpoint can return — authentication, signing, rate limiting and server errors. See Responses & errors.