Visa InterviewsResearch

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/v1

The 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.

PathsReturns
/postsConsular posts, with the State Department name, city, country and aliases
/wait-times, /wait-times/historyPublished appointment wait estimates by post and visa class, current and since November 2022
/nvc/schedulingThe IV Scheduling Status Tool month by post and category
/nvc/processingThe NVC Timeframes dates for case creation, document review and inquiries
/visa-bulletin/cutoffs, /visa-bulletin/historyFinal action and dates for filing cutoffs by category and chargeability
/uscis/processing-timesUSCIS processing times by form, category and office
/issuancesMonthly visa issuances by nationality and by post
/refusal-ratesAdjusted B visa refusal rates by nationality and fiscal year
/policies/changesDetected changes to official pages and announcements, with their review status
/impactsChanges matched to your organization's cases or students
/impact-assessmentsCheck one case or student profile against current changes without storing it
/webhooksWebhook subscriptions for change events
/exportsCSV exports of a series or of your matched records
/statusCollection 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.

Sample response, for illustration: GET /wait-times
{
  "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.

Fields are required unless marked optional. Do not include client or student names, case numbers or other personal details.

For example, the consular posts, visa categories or datasets you follow today, and where alerts or data should go. 10 to 2,000 characters.

If the form does not work for you, email support@visamind.com.