BluebulbAPI
    API reference/Quotes
    GET

    List quotes

    GET{baseUrl}/api/quotes

    Returns the active quotes on your business — special rates approved for you. Pass a quote's code as quoteCode when you create a conversion to convert at that rate.

    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.

    Behaviour

    Only quotes you can still use are returned: status active and expiresAt in the future. A quote can be used once; it drops out of this list as soon as it's used or expires.

    Request special rates from your Orbita dashboard; once approved they appear here.

    Response

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

    items[].code
    string
    Quote code. Send it as quoteCode on Create a conversion.
    items[].fromCurrency
    string
    Currency you convert from.
    items[].toCurrency
    string
    Currency you convert to.
    items[].rate
    number | null
    Raw rate you'll get (amount × rate).
    items[].status
    string
    Always active in this list.
    items[].expiresAt
    string (datetime)
    When the quote stops being usable.
    items[].createdAt
    string (datetime)
    When the quote was created.
    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

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