1. Companies
Graph Swiss API
  • Introduction
  • Quickstart
  • Authentication
  • Base URL
  • Errors
  • Request ID
  • Conventions
  • API
    • Health
      • Liveness probe
    • Companies
      • Search companies
        POST
      • AI-powered company search
        POST
      • Get company by ID
        GET
      • Get company journal summaries
        GET
      • Get full SHAB journal texts
        GET
      • Get detailed company report
        GET
    • 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
    • StockSymbol
    • Error
    • StockQuote
    • Company
    • StockPrice
    • CompanyDetail
    • StockHistoryValue
    • Code
    • StockHistory
    • CompanyWithRelations
    • StockEod
    • CompanyListPage
    • StockProfile
    • Person
    • StockIncomeStatement
    • ShabJournal
    • StockBalanceSheet
    • PersonCompanyLink
    • StockCashFlow
    • PersonWithCompanies
    • StockFinancials
    • PersonListPage
    • StockKeyExecutive
  1. Companies

Get company by ID

GET
/api/companies/{id}
Returns the full company record together with associated persons, recent SHAB journals,
and classification codes (CPV, BKP, eBKP-H, eBKP-T, NPK, OAG).

Request

Authorization
API Key
Add parameter in header
X-API-Key
Example:
X-API-Key: ********************
or
Path Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET '/api/companies/12345' \
--header 'X-API-Key: <api-key>'

Responses

🟢200
application/json
Company with related data.
Body

Example
{
    "success": true,
    "data": {
        "company": {
            "id": 0,
            "name": "string",
            "uid": "string",
            "status": "string",
            "legalform": "string",
            "location": "string",
            "canton": "string",
            "address": "string",
            "office": "string",
            "purpose": "string",
            "capital": "string",
            "additionaladdresses": [
                "string"
            ],
            "previousnames": [
                "string"
            ],
            "registerdate": "2019-08-24",
            "website": "string",
            "size": "string",
            "typeofservices": [
                "string"
            ],
            "isbiddingconsortium": true,
            "slug": "string"
        },
        "persons": [
            {
                "property1": "string",
                "property2": "string"
            }
        ],
        "journals": [
            {
                "property1": "string",
                "property2": "string"
            }
        ],
        "cpvCodes": [
            {
                "code": "45000000",
                "label": "Construction work"
            }
        ],
        "bkpCodes": [
            {
                "code": "45000000",
                "label": "Construction work"
            }
        ],
        "ebkphCodes": [
            {
                "code": "45000000",
                "label": "Construction work"
            }
        ],
        "ebkptCodes": [
            {
                "code": "45000000",
                "label": "Construction work"
            }
        ],
        "npkCodes": [
            {
                "code": "45000000",
                "label": "Construction work"
            }
        ],
        "oagCodes": [
            {
                "code": "45000000",
                "label": "Construction work"
            }
        ]
    }
}
🟠400BadRequest
🟠401Unauthorized
🟠402PaymentRequired
🟠404NotFound
🟠429TooManyRequests
🔴502UpstreamError
Modified at 2026-05-01 06:16:37
Previous
AI-powered company search
Next
Get company journal summaries
Built with