Sitio de datos independiente, sin afiliación con el gobierno de EE. UU. ni con ningún otro gobierno. Consulte las fuentes de cada sección antes de viajar.

API documentation is currently available in English and 简体中文. 简体中文 · English

DEVELOPER PLATFORM · v1

Visa and travel data for developers

Normalized JSON. Official-source provenance. Historical statistics. Clear freshness metadata.

Free evaluation access available · Commercial access: contact us · Not real-time or a government API

Start with a defined data scope

READY

US adjusted B visa refusal rates

FY2006–FY2025 · 20 fiscal years. Official numeric statistics; commercial access enabled.

BETA · evaluation only

Canada processing snapshots

One retrieved IRCC snapshot. Non-commercial evaluation only; commercial reproduction permission pending.

Other systems, US appointment waits, Passport Mobility, passport media and third-country access are deferred. No worldwide coverage claim.

Base URL
https://visadatahub.com/api/v1/

Authentication

Send your key from your server in the Authorization header. Never put it in URLs, browser scripts, mobile bundles or screenshots. All v1 endpoints, including metadata and health, require a key; only OpenAPI is public.

Authorization: Bearer YOUR_API_KEY

Keys begin vdh_live_ or vdh_test_. Issued manually, shown once and revocable. Server-to-server only; browser CORS access is not enabled.

Quickstart

curl -H "Authorization: Bearer YOUR_API_KEY" "https://visadatahub.com/api/v1/visa-statistics/us/refusal-rates?nationality=CN&from=2020&to=2025&include_sources=true"
Example response · China, FY2025
{
  "data": [
    {
      "jurisdiction_id": "united-states",
      "visa_type_id": "b",
      "nationality_country_id": "cn",
      "nationality_label": "CHINA",
      "nationality_slug": "china",
      "fiscal_year": 2025,
      "metric_type": "adjusted_b_visa_refusal_rate",
      "value": 20.21,
      "unit": "percent",
      "source_id": "us-adjusted-b-refusal",
      "period": {
        "type": "fiscal_year",
        "year": 2025
      },
      "official_updated_at": null,
      "visadatahub_checked_at": "2026-10-04T17:53:13Z",
      "retrieved_at": "2026-10-04T17:53:13Z"
    }
  ],
  "meta": {
    "api_version": "v1",
    "status": "ready",
    "dataset_id": "us-b-refusal",
    "freshness": {
      "official_updated_at": null,
      "visadatahub_checked_at": "2026-10-04T17:53:13Z",
      "retrieved_at": "2026-10-04T17:53:13Z",
      "period": {
        "type": "fiscal_year",
        "from": 2006,
        "to": 2025
      }
    },
    "pagination": {
      "limit": 1,
      "total": 1,
      "next_cursor": null
    },
    "sources": [
      {
        "source_id": "us-adjusted-b-refusal",
        "organization": "U.S. Department of State",
        "title": "Nonimmigrant B Visa Adjusted Refusal Rates by Nationality",
        "url": "https://travel.state.gov/content/travel/en/legal/visa-law0/visa-statistics/nonimmigrant-visa-statistics/nonimmigrant-b-visa-adjusted-refusal-rates-by-nationality.html"
      }
    ],
    "request_id": "vdh_req_example"
  }
}

A small static example from the existing dataset; no commercial key is embedded.

Endpoints

GET only. Stable English snake_case fields; lang=en or zh-cn changes labels only.

EndpointScope
GET /API v1 overview
GET /healthAuthenticated minimal health; no internal details
GET /metaRelease registry, definitions and freshness
GET /countriesStable country IDs and optional translated labels
GET /datasetsDataset registry alias of /meta
GET /countries/{country_id}One country by stable ID
GET /visa-systemsReleased visa systems only
GET /visa-typesReleased visa type IDs
GET /sourcesOfficial source links; no copyrighted media
GET /processing-timesCanada published estimates; non-commercial evaluation only
GET /processing-times/canadaCanada processing snapshot BETA, not appointment waits
GET /history/processing-times/canadaCanada immutable retrieved snapshots; currently one snapshot
GET /visa-statistics/united-statesUS adjusted B visa refusal statistics FY2006–2025
GET /visa-statistics/us/refusal-ratesUS refusal statistics alias

Filtering and pagination

limit=1…100 · cursor · include_sources=true · lang=en|zh-cn

Follow meta.pagination.next_cursor until null. Cursors are tied to results and invalidated by data or filter changes. Metrics support sort=value_asc or value_desc, nulls last. Metadata supports sort=default only.

Canada: application_type=visitor-outside-canada|supervisa|study|work, applying_from=CN or country ID, from/to=YYYY-MM-DD. US: nationality=CN, from/to=fiscal year (2006–2025). Unknown/repeated parameters return 400.

Limits & errors

Default evaluation: 500 total requests, at most 500 per UTC calendar month, 10 per minute; expires after 14 days. Other limits agreed manually. All admitted authenticated requests, including 304 and parameter errors, consume quota.

Read X-RateLimit-Remaining and X-Quota-Remaining. A 429 includes Retry-After seconds; use backoff. ETag / If-None-Match supports authenticated 304; cache privately and revalidate.

400invalid_parameter
401missing_api_key / invalid_api_key
403revoked_api_key / expired_api_key / data_unavailable
404not_found
405method_not_allowed
429rate_limit_exceeded / quota_exceeded
500internal_error
503data_unavailable
{
  "error": {
    "code": "invalid_parameter",
    "message": "limit must be 1–100."
  },
  "request_id": "vdh_req_example"
}

Freshness & sources

official_updated_at: authority update date. visadatahub_checked_at: our successful check. retrieved_at: snapshot retrieval. These are distinct. Unknown dates and missing values are null, never silently 0. period identifies statistical coverage. include_sources=true returns source organizations and URLs.

Adjusted refusal rates are not personal approval probabilities; negative historical adjusted values are preserved. Canada processing estimates are not interview waits; one snapshot cannot establish a trend. API reads validated local files, with no government fetch during requests.

Data & sources →

API terms

Independent informational service, unaffiliated with the US or other governments. No uptime or decision guarantee. Data and access may change; official authorities remain final. Respect quotas; no abuse, key sharing or access-control bypass. Redistribution/resale requires explicit permission in your access agreement; retain source attribution. Source links do not grant third-party content rights. Canada BETA is non-commercial evaluation only until commercial rights are confirmed.

Usage aggregates key ID, endpoint family, hour, status and latency. Logs store no raw keys or request parameters. Anti-abuse identifiers are daily salted hashes with minute counters removed after a few minutes. Usage buckets retained for 90 days. Privacy

Request access

Free evaluation access available. Commercial API: contact us. Submit an “API Access Request” through the existing contact flow with:

  • Name, company and business email
  • Use case and datasets required
  • Expected monthly requests
  • Commercial, academic or personal use
Contact us for API access →

Instalar VisaDataHub