Skip to content

Search documentation

Try “webhook signature” or “amountUsd”. Use Tab or arrow keys to explore results.

    Open app
    Open app

    Documentation navigation

    Tokens

    Read enabled assets and the profile’s acceptance settings.

    On this page

    List token choices

    GET/v1/profiles/{profileId}/tokens

    Authentication: Bearer key · Required scope: tokens.read

    No query parameters or body. Send Authorization: Bearer with your server key. Returns 200 with {tokens: […]}.

    The response includes globally enabled tokens. on indicates the profile switch; a merchant store can further restrict these choices.

    Path parameters
    FieldDetails
    profileIdpath · required UUIDThe profile that owns your API key.

    Token response

    Token response
    FieldDetails
    chainIdintegerNetwork ID.
    tokenaddressLowercase token contract; unique only together with chainId.
    symbol, networkstringsToken symbol and configured network name.
    decimalsintegerDecimal places used to convert integer base units for display.
    onbooleanWhether the profile accepts this token. Tempo OUSD starts off by default.

    Errors

    Responses use {error: {code, message}}. Missing or invalid credentials return 401; missing scope or a different profile returns 403. Objects outside the caller’s store or mode are hidden with 404.

    Invalid values return 422 invalid_value. Rate limiting returns 429 rate_limited with Retry-After. A starting network can return 503 network_not_ready; an unexpected server error returns 500 internal.

    Forwend documentation Test first. Confirm on your server.