Graph Swiss API
    • Introduction
    • Quickstart
    • Authentication
    • Base URL
    • Errors
    • Request ID
    • Conventions
    • API
      • Health
        • Liveness + access probe
      • Noga
        • List NOGA classifications
        • Get NOGA entry by ID
      • Companies
        • Search companies
        • AI-powered company search
        • Get company by ID
        • Get company journal summaries
        • Get full SHAB journal texts
        • Get detailed company report
      • Persons
        • Search persons
        • Get person by ID
      • Stocks
        • List active Swiss stock symbols
        • Get real-time stock quote
        • Get current stock price
        • Get historical OHLCV data
        • Get latest end-of-day data
        • Get company profile and statistics
        • Get income statement, balance sheet, and cash flow
        • Get key executives for a stock
    • Schemas
      • Error
      • Company
      • CompanyDetail
      • Code
      • CompanyWithRelations
      • CompanyListPage
      • Person
      • ShabJournal
      • PersonCompanyLink
      • PersonWithCompanies
      • PersonListPage
      • NogaEntry
      • NogaListPage
      • StockSymbol
      • StockQuote
      • StockPrice
      • StockHistoryValue
      • StockHistory
      • StockEod
      • StockProfile
      • StockIncomeStatement
      • StockBalanceSheet
      • StockCashFlow
      • StockFinancials
      • StockKeyExecutive

    Introduction

    Welcome to Graph Swiss API — a single REST gateway for Swiss companies, persons, and stocks data, with built-in metering and end-to-end tracing.
    Every endpoint speaks JSON, returns a consistent { success, data } envelope, and carries a request ID so any failure can be traced from your client through to the upstream that produced it.

    What you can query#

    DomainHighlights
    HealthOpen liveness probe — confirms the gateway is up. No API key required.
    CompaniesSearch by query / canton / legal form, lookup by ID, journal summaries, full SHAB journal text, detailed reports.
    PersonsSearch and lookup, including each person's company associations and SHAB journal history.
    StocksActive Swiss symbols, real-time quotes and prices, OHLCV history, end-of-day data, company profiles, financial statements, key executives.
    The full endpoint reference — request and response schemas for every route — lives alongside these pages.

    How it works#

    1.
    You authenticate with an X-API-Key header on every /v1/... request.
    2.
    The gateway meters the call: it validates the key, checks your plan and rate limit, and atomically deducts the per-endpoint credit cost from your wallet.
    3.
    The gateway forwards the request to the right upstream service.
    4.
    You get back a JSON envelope plus headers that tell you the request ID, credit cost, remaining balance, and rate-limit window.
    5.
    If the upstream fails (5xx), the credits are automatically refunded.

    Three things to know#

    One key, one header. X-API-Key is the only credential you ever send.
    Credits per call. Every metered request costs a small number of credits. Headers on the response tell you exactly what was charged and what's left.
    Trace anything. Every response carries X-Request-Id. Quote it in support tickets and we can pinpoint the call instantly.

    Read these in order#

    #PageWhat it covers
    1QuickstartMake your first call in three steps
    2AuthenticationThe X-API-Key header and how credits are deducted
    3Base URLProduction URL, path layout, TLS, CORS
    4ErrorsError envelope and the full code reference
    5Request IDHow tracing works end-to-end
    6ConventionsEnvelope shape, status codes, headers, versioning

    Versioning#

    The current API version is v1. Endpoints live under a versioned path prefix (/v1/companies/..., /v1/persons/..., /v1/stocks/...); breaking changes will land under a new versioned path (/v2/...) while v1 stays available during the deprecation window.
    Modified at 2026-05-25 11:56:01
    Next
    Quickstart
    Built with