For software and data platforms
VisaInterviews Intelligence API
A versioned REST API for products that need U.S. consular processing data. Every response names the official publication each figure came from, with the date it was published and the date we retrieved it.
API access is part of a VisaInterviews Intelligence agreement. The open CSV and JSON downloads in the dataset catalog stay free and need no key.
Base URL
https://api.visamind.com/api/vi/v1The major version is in the path. Each response also carries an api_version date in its meta block.
Authentication
Send your API key as a bearer token or in an API key header. Keys start with vik_ and are issued under an API agreement.
Authorization: Bearer vik_...
X-API-Key: vik_...Endpoint families
Paths are relative to the base URL. List endpoints return pages with a cursor.
| Paths | Returns |
|---|---|
| /posts | Consular posts, with the State Department name, city, country and aliases |
| /wait-times, /wait-times/history | Published appointment wait estimates by post and visa class, current and since November 2022 |
| /nvc/scheduling | The IV Scheduling Status Tool month by post and category |
| /nvc/processing | The NVC Timeframes dates for case creation, document review and inquiries |
| /visa-bulletin/cutoffs, /visa-bulletin/history | Final action and dates for filing cutoffs by category and chargeability |
| /uscis/processing-times | USCIS processing times by form, category and office |
| /issuances | Monthly visa issuances by nationality and by post |
| /refusal-rates | Adjusted B visa refusal rates by nationality and fiscal year |
| /policies/changes | Detected changes to official pages and announcements, with their review status |
| /impacts | Changes matched to your organization's cases or students |
| /impact-assessments | Check one case or student profile against current changes without storing it |
| /webhooks | Webhook subscriptions for change events |
| /exports | CSV exports of a series or of your matched records |
| /status | Collection status and the latest retrieval for each source |
Provenance on every response
Each response has a provenance list naming the official publication behind the data, and a limitations list stating how the figures may be read.
The State Department publishes short waits as “< 0.5 Month”. The API returns that as value_months 0.5 with bound set to “lt”, so your product can show it as under half a month.
{
"data": [
{
"post_id": "sample-post",
"measure": "student",
"observed_on": "2026-10-28",
"date_basis": "dos-published",
"value_months": 0.5,
"bound": "lt",
"unit_format": "months",
"value_status": "reported",
"published_text": "< 0.5 Month",
"version": 3,
"snapshot_id": 81234
}
],
"provenance": [
{
"snapshot_id": 81234,
"source_key": "us-visa-appointment-wait-times",
"source_name": "Global Visa Wait Times",
"authority": "U.S. Department of State",
"source_url": "https://travel.state.gov/content/travel/en/us-visas/visa-information-resources/global-visa-wait-times.html",
"license": "public-domain",
"published_at": "2026-10-28",
"retrieved_at": "2026-10-29T06:00:12Z",
"archive_captured_at": null,
"dataset_version": "2026-10-29",
"content_hash": "sha256:5f1c…"
}
],
"limitations": [
"Published estimates of the wait for an interview appointment. They are not appointment availability and do not show that a bookable slot exists.",
"DOS publishes '< 0.5 Month' for short waits; it is returned as value_months 0.5 with bound 'lt'."
],
"pagination": { "next_cursor": null, "limit": 100 },
"meta": { "api_version": "2026-11-01", "generated_at": "2026-11-01T14:00:00Z" }
}Webhooks
A webhook sends an event when a source publishes a change. Each delivery is signed with your webhook secret. The signature header carries a Unix timestamp and an HMAC.
X-VisaInterviews-Signature: t=<unix>,v1=<hmac>Reject a delivery when the signature does not match or the timestamp is old.
Exports and rate limits
CSV exports cover any series your agreement includes, and your matched records. Rate limits are set in each API agreement.
The open CSV and JSON files at /datasets remain free, with attribution, for anyone to download.
What VisaInterviews Intelligence does not do
- It does not estimate the chance that a visa will be approved. Refusal rates and issuance counts describe past volume for a whole nationality or post.
- It does not show or book appointment slots. A published wait is the State Department's estimate of the wait for an interview, and an open appointment may not exist.
- An NVC scheduling month is the month a post is scheduling most cases in a category for. It is not a queue position or an interview date for any one case.
- It is not legal advice. Alerts report what an official source published and when. The attorney or adviser on a case decides what a change means for it.
Pricing and access
Public research on this site and the open datasets stay free, with attribution. VisaInterviews Intelligence is offered through custom agreements.
Professional subscriptions and API agreements are scoped to each organization: how many cases or students you monitor, which data you need, the integrations you use and the support you expect. We do not publish prices. Use the form below to start a commercial access conversation.
Ask about API access
Tell us what your product does, which endpoints you need and roughly how many records or calls you expect. We reply by email.
If the form does not work for you, email support@visamind.com.