{
    "ok": true,
    "api": "humantoll/v1",
    "status": "withheld",
    "scenario": {
        "code": "S-MAX",
        "name": "Economic-embedded",
        "default": true
    },
    "run": null,
    "methodology_version": "0.1",
    "data_version": null,
    "lifecycle_phase": "production",
    "metrics": null,
    "data": {
        "name": "HumanToll REST API",
        "version": "1.0.0",
        "figures_published": false,
        "endpoints": [
            {
                "path": "/api/v1/products",
                "summary": "The product catalogue; with a published run, each product's deaths per unit and per kg"
            },
            {
                "path": "/api/v1/product/{slug}",
                "summary": "One product: both routes and both metrics, the bill of materials and the chain it reaches"
            },
            {
                "path": "/api/v1/product/{slug}/contributions",
                "summary": "What carries one figure: its breakdown by material, country, conflict, channel or industry"
            },
            {
                "path": "/api/v1/product/{slug}/explain",
                "summary": "The audit trail of one figure: every stage, each summing to the headline"
            },
            {
                "path": "/api/v1/compare",
                "summary": "Two products drawn together: the interval of their ratio, and a verdict only where it holds"
            },
            {
                "path": "/api/v1/spend",
                "summary": "EU households' spending on each consumption category: the harm in €amount, grouped against all spending"
            },
            {
                "path": "/api/v1/material/{slug}",
                "summary": "A raw material: who produces it, which products use it, and what it carries in a run"
            },
            {
                "path": "/api/v1/conflict/{slug}",
                "summary": "A scored conflict: the deaths UCDP counted, the model's attribution, and the products it reaches"
            },
            {
                "path": "/api/v1/country/{iso3}",
                "summary": "A country: the harm counted there, and the products it reaches"
            },
            {
                "path": "/api/v1/channel/{code}",
                "summary": "A harm channel: what it counts, how it is attributed, and what it reaches"
            },
            {
                "path": "/api/v1/scenarios",
                "summary": "The five attribution scenarios and their parameters"
            },
            {
                "path": "/api/v1/runs",
                "summary": "The published runs; none while figures are withheld"
            },
            {
                "path": "/api/v1/runs/{id}",
                "summary": "One published run and the verdict of each validation gate"
            },
            {
                "path": "/api/v1/methodology",
                "summary": "The versions of the methodology"
            },
            {
                "path": "/api/v1/sources",
                "summary": "The source register: every source, its licence, and the basis it is used on"
            },
            {
                "path": "/api/v1/search",
                "summary": "Find a product, material, conflict, country or channel"
            },
            {
                "path": "/api/v1/openapi.json",
                "summary": "This API as an OpenAPI 3.1 document, generated from the route table"
            }
        ],
        "rate_limit": {
            "requests": 100,
            "per": "day, per address",
            "resets": "00:00 UTC"
        },
        "access": "Free and unauthenticated. HumanToll is a research project, not a commercial service. For advanced API access, contact info@quiescence.eu.",
        "language": "English. Names are the register's; codes and slugs never change."
    },
    "withheld": [],
    "sources": [],
    "licence": null,
    "caveats": [
        "Production phase only: harm from using a product is not counted.",
        "Every figure is a floor: harm the model cannot attribute to a supply chain is not counted.",
        "Harm is statistically attributed to supply chains under stated assumptions. It is not a causal claim about any death or injury, and not a statement about any company, brand or person.",
        "Quote the interval with the figure, every time, at two significant figures. A figure graded INDICATIVE has no central value, only its range."
    ],
    "citation": "HumanToll, methodology v0.1. https://quiescence.eu/humantoll/docs/",
    "links": {
        "self": "https://quiescence.eu/humantoll/api/v1/",
        "html": "https://quiescence.eu/humantoll/docs/",
        "docs": "https://quiescence.eu/humantoll/docs/",
        "openapi": "https://quiescence.eu/humantoll/api/v1/openapi.json"
    }
}
