Skip to content

List datasets

GET/v1/datasetsLive

What is loaded, how fresh it is, and where it came from.

Authentication

This endpoint requires an API key, as every endpoint does. Keys are issued on signup — the free trial needs no card. See authentication for key handling, or view the data first in the Explorer.

Discovery endpoint. Query this to find out what exists rather than hardcoding dataset ids. Reports coverage gaps explicitly — a catalog that hides its holes is worse than no catalog.

Request

curl
curl "https://api.vemon.io/v1/datasets" \
  -H "Authorization: Bearer vm_live_…"

Response

200 OK
{
  "data": [
    {
      "id": "healthcare-prices",
      "name": "Healthcare charges",
      "status": "live",
      "records": 63518,
      "facilities": 2993,
      "coverage": {
        "jurisdictions": 50,
        "states": 49,
        "includes_dc": true,
        "absent_states": ["MD"],
        "note": "MD absent: paid under state all-payer rate-setting."
      },
      "version": "2024.1",
      "source": { "data_year": 2024 }
    }
  ],
  "has_more": false
}

Errors

  • rate_limit_exceeded429

Full list on the errors page.