موقع بيانات مستقل غير تابع للحكومة الأمريكية أو لأي حكومة أخرى. تحقّق من مصادر كل قسم قبل السفر.

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 →

تثبيت VisaDataHub