Jobs

For work too large for a single request: batch matrices across many codes and hospitals, and exports without a row limit.

API reference

New batch matrix

Every hospital and code pair gets a row, including pairs with no rate on file, with the market median beside each hospital's own figures.

Code system

Format

Codes (comma, space or line separated; up to 5,000)

Hospitals (IDs or names, one per line; up to 500)

New export with no row limit

The same options as the export builder, run in the background without the 50,000-row limit.

Source

Format

Code system

Codes (comma separated, up to 200) or a CPT family

States (comma separated, optional)

Payer contains (optional)

Your jobs

Job	Kind	Details	Status	Rows	Files

The same job through the API

curl -X POST "https://data.soro.health/v1/jobs" \
  -H "Authorization: Bearer $SORO_API_KEY" -H "Content-Type: application/json" \
  -d '{"kind":"batch","spec":{"system":"CPT","codes":["99213","27447"],"hospitals":["morristown-medical-center"],"format":"csv"}}'
# -> 202 {"object":"job","id":"job_…","status":"queued"}   then poll GET /v1/jobs/{id}

This needs a key with the write:jobs scope. POST /v1/exports takes export builder options directly. In a finished job, each result.files[].url is a link that lasts 10 minutes and is created fresh each time you read the job. Webhooks subscribed to job.completed are notified whenever a job finishes.