Data API documentation

Read-only JSON over the same dated, sourced dataset the site renders. Public and free within a fair-use limit. Send an x-api-key header for a higher limit and usage tracking. Every response carries attribution and each record keeps its asOf and sourceUrl.

Authentication

curl https://getvisaclock.com/api/v1/processing-times?form=i-485 \
  -H "x-api-key: vk_your_key_here"

Need a key? See the Data API plans.

Endpoints

GET/api/v1/processing-times

Query: form (slug or code), office (slug)

/api/v1/processing-times?form=i-485

GET/api/v1/visa-policy

Query: origin, destination (iso2 or slug)

/api/v1/visa-policy?origin=IN&destination=US

GET/api/v1/programs

Query: country (slug)

/api/v1/programs?country=canada

GET/api/v1/visa-bulletin

Query: (none)

/api/v1/visa-bulletin

GET/api/v1/wait-times

Query: post (slug)

/api/v1/wait-times?post=mumbai

Response shape

{
  "meta": { "attribution": "...", "generatedAt": "...", "tier": "free" },
  "data": { "count": 2, "results": [ /* records with asOf + sourceUrl */ ] }
}

Terms

Visa-policy data is adapted from Wikipedia under CC BY-SA 4.0; if you redistribute it you must keep the attribution and share-alike. USCIS and US Department of State data are public records. This is information, not legal advice.