GENESIS · Authentication Profile

GENESIS Authentication

Authentication

GENESIS secures its APIs with apiKey across 2 declared security schemes, as derived from its OpenAPI definitions.

Open DataPublic APIs
Methods: apiKey Schemes: 2 OAuth flows: API key in: header

Security Schemes

username / password apiKey
· in: header (username, password)
personal API token apiKey
· in: header (username)

Source

Authentication Profile

Raw ↑
generated: '2026-11-11'
method: searched
source: https://genesis.destatis.de/datenbank/online/docs/GENESIS-Webservices_Introduction.pdf
docs: https://genesis.destatis.de/datenbank/online/docs/GENESIS-Webservices_Introduction.pdf
summary:
  types:
  - apiKey
  api_key_in:
  - header
  registration_required: true
  note: >-
    TWO DIFFERENT ACCESS MODELS, and the destatis.de open-data page describes only the first. The
    GENESIS-Online web interface (https://genesis.destatis.de/datenbank/online) "can be used free of
    charge and without registering" under Data Licence Germany - Attribution - Version 2.0
    (https://www.destatis.de/EN/Service/OpenData/api-webservice.html). The GENESIS web service
    (RESTful/JSON API, https://genesis.destatis.de/genesisWS/rest/2020/...) does NOT accept anonymous
    calls: "Free registration in GENESIS-Online is required to use the web service. Each request
    requires username and password" (Webservice interface (API) modal, served in
    https://genesis.destatis.de/datenbank/online/environment.json). Registration is free. The contract
    (openapi/_original/genesis-openapi.json) declares no securitySchemes; credentials are modelled as
    `username` / `password` header parameters on every operation.
schemes:
- name: username / password
  type: apiKey
  in: header
  parameter: username, password
  sources:
  - openapi/_original/genesis-openapi.json
  - https://genesis.destatis.de/datenbank/online/docs/GENESIS-Webservices_Introduction.pdf
  description: >-
    User Guide "Web Services" v5.1 s2.1.3: "With the exception of the whoami service, authentication
    is required for every request. This can be done via the combined entry of user name/email and
    password or via the personal token." Account data travel as HTTP header fields (form-urlencoded
    body also accepted). Only POST is served: "The SOAP/XML interface as well as GET methods of the
    RESTful/JSON interface have been switched off" (15.07.2025).
  how_to_obtain: Free registration on GENESIS-Online (https://genesis.destatis.de/datenbank/online#modal=register).
- name: personal API token
  type: apiKey
  in: header
  parameter: username
  sources:
  - https://genesis.destatis.de/datenbank/online/docs/GENESIS-Webservices_Introduction.pdf
  description: >-
    s2.1.3: "A personal API token is displayed in the 'Webservice (API)' modal after logging in to the
    web interface. The token can be used in requests instead of the user name/email. It is no longer
    necessary to enter a password when using the token." 32 characters. Regenerating it invalidates the
    old one immediately. profile/removeresult, profile/password and job=true requests still require
    user name and password.
  how_to_obtain: Log in to GENESIS-Online and open the "Webservice interface (API)" modal.
evidence:
- request: GET https://genesis.destatis.de/genesisWS/rest/2020/helloworld/logincheck (no credentials)
  observed: '2026-11-11'
  http_status: 405
  detail: GET is switched off, as the documentation says.
- request: POST https://genesis.destatis.de/genesisWS/rest/2020/catalogue/tables (no credentials; selection=12411*, language=en)
  observed: '2026-11-11'
  http_status: 401
  detail: '{"Code":15,"Content":"You are not allowed to call this service or the header of your request does
    not contain all the necessary information so that your access data cannot be recognised.","Type":"ERROR"}'
- request: POST https://genesis.destatis.de/genesisWS/rest/2020/helloworld/logincheck (no credentials)
  observed: '2026-11-11'
  http_status: 200
  detail: '{"Status":"You have been logged in and out successfully! ...","Username":"GAST"} -- an uncredentialed
    logincheck is answered as the built-in guest user (the contract''s header defaults are GAST/GAST), but
    the guest is refused by the data services (Code 15 above). No credentials were tried.'
anonymous_routes_observed:
- POST /rest/2020/helloworld/logincheck (answers as guest "GAST"; tests nothing about data access)
- POST /rest/2020/helloworld/whoami (documented as the one method needing no authentication; not called)

Work with this as data

Every security artifact here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for security posture

4 MCP tools reach this
  • find_securityBrowse and filter every security artifact in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This security artifact
curl "https://apis.io/api/v1/security/genesis-authentication"
All security posture
curl "https://apis.io/api/v1/security?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.