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
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.
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.