Queue a Destatis extraction that is too large for a direct request

Receipt for a GENESIS table extraction. A slice GENESIS refuses with Status 98 is submitted as job=true and collected later at GET /destatis/extractions/{id}. job=true is sent only after that size gate (or when this instance already cached it for the exact code, window and contents); a slice that would have succeeded synchronously is not queued as a vendor job. Vendor job ids are not published. Long-tail admission: wait 0 s, 429 when the lane is busy. Requires DESTATIS_USERNAME and DESTATIS_PASSWORD: the API token cannot call job=true (vendor Status 12).

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢202Accepted

application/json

202 with an extraction id. Poll GET /destatis/extractions/{id}.

Bodyapplication/json

Example

{
    "data": {
        "extraction_id": "string",
        "state": "string",
        "code": "string",
        "start_year": 0,
        "end_year": 0,
        "contents": "string",
        "poll": "string",
        "table": {
            "table": "string",
            "genesis_code": "string",
            "title": "string",
            "description": "string",
            "country": "string",
            "start_year": 0,
            "end_year": 0,
            "count": 0,
            "data": [
                {
                    "period": "string",
                    "period_label": "string",
                    "subperiod": "string",
                    "measure": "string",
                    "measure_code": "string",
                    "unit": "string",
                    "value": 0,
                    "quality": "string",
                    "measure_note": "string",
                    "variant": 0,
                    "dimensions": {
                        "property1": {
                            "property1": "string",
                            "property2": "string"
                        },
                        "property2": {
                            "property1": "string",
                            "property2": "string"
                        }
                    },
                    "property1": "string",
                    "property2": "string"
                }
            ],
            "source": "string",
            "licence": "string",
            "source_note": "string",
            "classifying_requested": [
                {
                    "property1": "string",
                    "property2": "string"
                }
            ],
            "property1": "string",
            "property2": "string"
        },
        "result_removed": true,
        "source": "string",
        "source_note": "string",
        "property1": "string",
        "property2": "string"
    },
    "meta": {
        "endpoint": "/api/v1/fred/us/cpi",
        "data_time": "2026-04-16T14:30:00Z",
        "response_time": "2026-04-16T14:30:12Z",
        "provider": "Sugra API v1.0.1",
        "data_age_days": 0,
        "source": "string",
        "attribution": "string",
        "fallback_used": true,
        "fallback_chain": [
            "string"
        ],
        "cached": true,
        "stale": true,
        "stale_since": "string",
        "period": "string",
        "notes": "string"
    }
}

🟠401Unauthorized

🟠413

🟠422Parameter Error

🟠429

🔴503Service Unavailable