Introduction

Vemon serves public datasets through one REST API. Learn the shape once and every dataset we add answers the same way.

Current state

The production API at https://api.vemon.io is not deployed yet, and key issuing is not built. This reference describes the contract it will serve. Nothing here is reachable without a key — and nothing ever will be.

Every request needs a key

There is no unauthenticated endpoint. Keys are issued on signup: a free trial key needs no card, and paid plans issue keys the same way. One header carries it.

curl

curl "https://api.vemon.io/v1/healthcare/prices?procedure=5372&limit=3" \
  -H "Authorization: Bearer vm_live_…"

Want to see the data before you sign up? The Explorer runs in your browser against real records — 2,993 hospitals across 49 states and DC — so you can judge the data before generating a key.

Base URL

https://api.vemon.io/v1

All requests are HTTPS. HTTP is refused rather than redirected — a redirect would leak the key in the first request.

Conventions

Unknown parameters are errors
Passing a parameter we do not recognise returns 400. Silently ignoring it would let a typo return plausible but wrong rows.
Money is integer USD
No floats, no currency strings. Divide by nothing; these are whole dollars.
Summaries cover the whole match
The summary block reflects every matching row, not the page you were returned.
Sources travel with the data
Every response carries a source block naming the publisher, data year, and the caveat that applies.

What is loaded

One dataset: 63,518 Medicare outpatient charge records covering 2,993 hospitals across 49 states and DC and 68 procedure groups, data year 2024.

Medicare outpatient submitted charges. Not commercial negotiated rates.

Full provenance on the dataset page.