GENESIS API

Open Data / OAuth Advanced HTTPS
Varies by plan (check documentation)

Overview

The GENESIS API provides access to official statistical data from the Federal Statistical Office of Germany (Destatis). It uses OAuth authentication and returns data such as population, economy, and environment statistics. It is valuable for researchers and developers building data-driven applications focused on Germany.

💡

Beginner Tip

Register for a free account at destatis.de to receive OAuth credentials. Use the /data/tablefile endpoint to download a specific table by its code, which you can find in the GENESIS online database.

Available Data

GENESIS data via REST API
JSON-formatted response data
Requires OAuth authentication

Example Response

JSON Response
{
  "status": "success",
  "data": {
    "result": "Data from GENESIS",
    "description": "Federal Statistical Office Germany",
    "timestamp": "2025-01-15T10:00:00Z"
  }
}

Field Reference

Status Contains the status code and description indicating whether the request succeeded.
Parameter Echoes back the parameters used in the request for confirmation.
Object Metadata about the returned dataset including name and label.
Data Array of data rows from the requested statistical table.
Header Column headers describing each field in the data rows.

Implementation Example

const url = "https://www.destatis.de/EN/Service/OpenData/";
// Replace headers or query params with the values required by this API.
const response = await fetch(url, {
  headers: {
  "Authorization": "Bearer YOUR_API_KEY"
  }
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

Common Errors & Troubleshooting

401 Unauthorized OAuth token is missing, expired, or incorrectly formatted.
Re-authenticate using the token endpoint and ensure you include Bearer YOUR_TOKEN in the Authorization header.
Invalid table code error The table code you specified does not exist in the GENESIS database.
Browse the GENESIS online database at www-genesis.destatis.de to find valid table codes.
Response in unexpected format The API can return data in multiple formats (CSV, JSON, XLSX) and defaults may vary.
Explicitly set the format parameter to json in your request to ensure consistent parsing.

Matrix Score Breakdown

🌐 Reachability 0/30
⚡ Speed 5/20
🔒 Security 15/15
🛠 Developer XP 3/20
✓ Reliability 0/15

Partially tested on Apr 5, 2026

Technical Specifications

Auth OAuth
HTTPS REQUIRED
CORS UNKNOWN
Category Open Data
Difficulty Advanced
Verified: 2026-04-04

Similar APIs

View All →