Invoice Desk
    Invoice Desk
    • Getting Started
    • Static Data
      • List currencies
        GET
      • List countries
        GET
      • List states
        GET
      • List cities
        GET
      • StaticDataController_testError
        GET
    • Company
      • List companies
        GET
      • Add Company
        POST
      • Update Company
        PATCH
      • Fetch details of a company by ID
        GET
      • Delete a company
        DELETE
      • Get all payments for a company
        GET
    • Client
      • List clients
        GET
      • Add client
        POST
      • Update a client
        PATCH
      • Remove client
        DELETE
      • Get client details
        GET
    • Invoice
      • List invoices
        GET
      • Create invoice
        POST
      • Get invoice by ID
        GET
      • Update invoice
        PATCH
      • Delete a specific invoice
        DELETE
      • Import invoices
        POST
      • Export invoice
        GET
      • Send invoice
        POST
    • Invoice Payments
      • Record payment for invoice
      • Get payments for invoice
    • Product
      • List products
      • Add product
      • Update a product
      • Remove a product
    • Account
      • Get account details
      • Update account details
    • Project
      • List projects
      • Create a project
      • Get project by ID
      • Update a project
      • Remove a project
    • Company Settings
      • Create a new tax
      • Get company invoice settings
    • Timesheet
      • Get time entries for a project
      • Create a timesheet
      • Update
      • Delete
    • Role
      • List roles
    • User Profile
      • Fetch auth user profile
      • Update user profile

    Static Data

    Invoice Desk provides a set of static data endpoints that return standardized reference information such as currencies, countries, states, and cities. These endpoints are useful for building location-aware features, populating dropdowns in forms, and ensuring consistency across user workflows.
    Since this data rarely changes, it can be safely cached on the client side, reducing unnecessary API calls and improving application performance.
    For Frontend Developers
    Use these endpoints to dynamically populate form elements like country and state selectors, currency pickers, and address inputs. Caching the results locally or in memory (e.g., using SWR or Zustand) is recommended to keep interactions fast and smooth.
    Typical use cases include:
    Pre-filling user profile forms
    Location selectors during account or invoice creation
    Currency dropdowns for multi-currency invoicing
    For Backend Developers
    These endpoints can be used to validate or enrich incoming data from clients and ensure uniformity across services. You can also pre-load this data into your own cache/store to minimize latency for high-throughput systems.
    Common backend use cases:
    Validating user-submitted data (e.g., ensuring city-state-country combinations are valid)
    Populating UI metadata via your own API layer
    Supporting localized business logic (e.g., country-specific tax rules)
    Modified at 2025-05-14 07:25:35
    Previous
    Getting Started
    Next
    List currencies
    Built with