spoonity logo
    • API
    • Documentation
    • Support
    • Getting Started

      • Introduction
      • Authentication
      • Handling Errors
      • Webhooks
    • Workflows

      • Placing an order
      • Retrieving a list of checked-in users
      • Registering an account
      • Working with user profiles
      • Reloading an account
    • Resources

      • Billing Profile
      • Card
      • Content
      • Country & Region
      • EGift
      • OnScreen
      • Order
      • User
      • Balances & Rewards
      • Transaction History
      • Inbox
      • Spending Rules
    • Sign in

    Handling Errors

    When the API returns an error, it will include three key pieces of information: an HTTP status code, an internal tracking code, and a human-readable message.

    Error structure

    Below are some simple examples of the general structure of an error response.

    Request

    GET
    /customers/{customer_id}
    {
        "internal_code": null,
        "message": "Unauthorized",
    }
    

    Note that these error messages are samples and are not indicative of the actual error messages returned by the API.

    User-generated errors such as missing authentication headers or invalid parameters will not include an internal_code.

    HTTP 500s will include an internal_code, and it can be submitted to the Spoonity support team for further investigation.

    Localization

    Error messages will be localized to a handful of supported languages. The language returned by the message will be based on the configured system language inside the Spoonity dashboard.

    Was this page helpful?

    PreviousFiltering, Sorting, and Paging
    NextPlacing an order

    © Copyright 2026 Spoonity, Inc. All rights reserved.