US adjusted B visa refusal rates
FY2006–FY2025 · 20 fiscal years. Official numeric statistics; commercial access enabled.
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
FY2006–FY2025 · 20 fiscal years. Official numeric statistics; commercial access enabled.
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 URLhttps://visadatahub.com/api/v1/
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_KEYKeys begin vdh_live_ or vdh_test_. Issued manually, shown once and revocable. Server-to-server only; browser CORS access is not enabled.
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"{
"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.
GET only. Stable English snake_case fields; lang=en or zh-cn changes labels only.
| Endpoint | Scope |
|---|---|
GET / | API v1 overview |
GET /health | Authenticated minimal health; no internal details |
GET /meta | Release registry, definitions and freshness |
GET /countries | Stable country IDs and optional translated labels |
GET /datasets | Dataset registry alias of /meta |
GET /countries/{country_id} | One country by stable ID |
GET /visa-systems | Released visa systems only |
GET /visa-types | Released visa type IDs |
GET /sources | Official source links; no copyrighted media |
GET /processing-times | Canada published estimates; non-commercial evaluation only |
GET /processing-times/canada | Canada processing snapshot BETA, not appointment waits |
GET /history/processing-times/canada | Canada immutable retrieved snapshots; currently one snapshot |
GET /visa-statistics/united-states | US adjusted B visa refusal statistics FY2006–2025 |
GET /visa-statistics/us/refusal-rates | US refusal statistics alias |
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.
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.
| 400 | invalid_parameter |
|---|---|
| 401 | missing_api_key / invalid_api_key |
| 403 | revoked_api_key / expired_api_key / data_unavailable |
| 404 | not_found |
| 405 | method_not_allowed |
| 429 | rate_limit_exceeded / quota_exceeded |
| 500 | internal_error |
| 503 | data_unavailable |
{
"error": {
"code": "invalid_parameter",
"message": "limit must be 1–100."
},
"request_id": "vdh_req_example"
}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 →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
Free evaluation access available. Commercial API: contact us. Submit an “API Access Request” through the existing contact flow with: