1. Persons
Graph Swiss API
  • Introduction
  • Quickstart
  • Authentication
  • Base URL
  • Errors
  • Request ID
  • Conventions
  • API
    • Health
      • Liveness probe
    • 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
        POST
      • Get person by ID
        GET
    • 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. Persons

Search persons

POST
/api/persons/search
Full-text search across Swiss persons. Returns a paginated list of result rows.

Request

Authorization
API Key
Add parameter in header
X-API-Key
Example:
X-API-Key: ********************
or
Body Params application/jsonRequired

Example
{
    "query": "Hans Müller",
    "limit": 20,
    "offset": 0
}

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 POST '/api/persons/search' \
--header 'X-API-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "query": "Hans Müller",
    "limit": 20,
    "offset": 0
}'

Responses

🟢200
application/json
Paginated persons.
Body

Example
{
    "success": true,
    "data": {
        "total": 0,
        "items": [
            {
                "id": 9876,
                "name": "Hans Müller",
                "firstname": "Hans",
                "middlename": "string",
                "lastname": "Müller",
                "nationally": "CH",
                "gender": "M",
                "born_city": "string",
                "residence": "Zürich",
                "type": 0,
                "unparsed": "string",
                "slug": "string",
                "status": "string"
            }
        ]
    }
}
🟠400BadRequest
🟠401Unauthorized
🟠402PaymentRequired
🟠429TooManyRequests
🔴502UpstreamError
Modified at 2026-05-01 06:16:37
Previous
Get detailed company report
Next
Get person by ID
Built with