{
  "api": "The Dwell Data API",
  "version": "v1",
  "docs": "https://the-dwell.com/api",
  "data_as_of": "2026-11-10",
  "data_as_of_label": "Nov 10, 2026",
  "data_pulled_at": "2026-11-11T14:47:33.427Z",
  "generated_at": "2026-11-11T18:41:17.936Z",
  "attribution": "Credit The Dwell (the-dwell.com) with a visible link to the page the figure came from; every record carries its page_url.",
  "name": "The Dwell Data API",
  "description": "Free JSON for every number published on The Dwell (the-dwell.com): friction board, port complexes, ship queue, at anchor, truck index, busiest ports, empty share, what ports import, vessel dwell, box and rail dwell. U.S. port congestion data: the plain-English congestion board for importers.",
  "publisher": {
    "name": "The Dwell",
    "url": "https://the-dwell.com"
  },
  "auth": "none",
  "cors": "*",
  "format": "application/json; charset=utf-8",
  "license": "Free to use and republish with attribution; no key or sign-up. The underlying figures are public records from the agencies named in each series' provenance; The Dwell collects, checks and publishes them.",
  "update_policy": "Static files rebuilt every time the site rebuilds with new data. data_as_of in each response is the newest observation it holds; data_pulled_at is when the site last pulled its sources.",
  "counts": {
    "series": 16,
    "stats": 14
  },
  "sections": [
    {
      "key": "friction",
      "label": "Friction board",
      "series": 1,
      "example": "https://the-dwell.com/api/v1/series/friction/import-friction.json"
    },
    {
      "key": "port",
      "label": "Port complexes",
      "series": 3,
      "example": "https://the-dwell.com/api/v1/series/port/la-long-beach.json"
    },
    {
      "key": "waiting",
      "label": "Ship queue",
      "series": 3,
      "example": "https://the-dwell.com/api/v1/series/waiting/all-us.json"
    },
    {
      "key": "anchored",
      "label": "At anchor",
      "series": 1,
      "example": "https://the-dwell.com/api/v1/series/anchored/all-coasts.json"
    },
    {
      "key": "pti",
      "label": "Truck index",
      "series": 2,
      "example": "https://the-dwell.com/api/v1/series/pti/la-long-beach.json"
    },
    {
      "key": "busiest",
      "label": "Busiest ports",
      "series": 1,
      "example": "https://the-dwell.com/api/v1/series/busiest/us-container-ports.json"
    },
    {
      "key": "empty",
      "label": "Empty share",
      "series": 1,
      "example": "https://the-dwell.com/api/v1/series/empty/us-container-ports.json"
    },
    {
      "key": "imports",
      "label": "What ports import",
      "series": 1,
      "example": "https://the-dwell.com/api/v1/series/imports/los-angeles.json"
    },
    {
      "key": "dwell",
      "label": "Vessel dwell",
      "series": 1,
      "example": "https://the-dwell.com/api/v1/series/dwell/us-average.json"
    },
    {
      "key": "boxdwell",
      "label": "Box and rail dwell",
      "series": 2,
      "example": "https://the-dwell.com/api/v1/series/boxdwell/los-angeles-import-containers.json"
    }
  ],
  "endpoints": [
    {
      "method": "GET",
      "path": "/api/v1/index.json",
      "url": "https://the-dwell.com/api/v1/index.json",
      "description": "What this API is, its license and attribution, the sections it covers, and every endpoint."
    },
    {
      "method": "GET",
      "path": "/api/v1/latest.json",
      "url": "https://the-dwell.com/api/v1/latest.json",
      "description": "The newest reading of every data page on The Dwell (16 series): the headline value as the site shows it, the newest point of each charted line with its date, whether it is current, and links to its page and full history."
    },
    {
      "method": "GET",
      "path": "/api/v1/stats.json",
      "url": "https://the-dwell.com/api/v1/stats.json",
      "description": "The 14 headline numbers on the the-dwell.com/stats page, each as a quotable sentence with its data date and a ready-made citation."
    },
    {
      "method": "GET",
      "path": "/api/v1/series/{section}/{slug}.json",
      "url": "https://the-dwell.com/api/v1/series/port/la-long-beach.json",
      "description": "Everything behind one data page: every charted point (date + value), the historical band where the page draws one, the page's tables exactly as shown, its source and citation. Find each series_url in latest.json."
    },
    {
      "method": "GET",
      "path": "/api/v1/openapi.json",
      "url": "https://the-dwell.com/api/v1/openapi.json",
      "description": "A machine-readable OpenAPI 3.1 description of these endpoints."
    }
  ]
}
