State Department website screenshot

State Department

The US Department of State provides public REST APIs for accessing consular affairs data including travel advisories by country and risk level, country travel information, passport acceptance facility locations, passport issuance statistics, and geopolitical reference data. The Consular Affairs Data API (cadataapi.state.gov) offers open, unauthenticated endpoints covering all countries with real-time travel advisory updates across four alert levels. Additional historical diplomatic records are available through the Foreign Relations of the United States (FRUS) catalog API.

State Department publishes 3 APIs on the APIs.io network: Country Information API, Passport Locations API, and Travel Advisories API. Tagged areas include US Government, Travel, Passports, Visas, and Travel Advisories.

The State Department catalog on APIs.io includes 1 JSON-LD context and 1 Spectral governance ruleset.

State Department’s developer surface includes documentation, engineering blog, and 9 more developer resources.

🌐 Visit website 📡 Source on GitHub
40.5/100 thin ▬ flat Agent 25/100 agent aware Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessFreeOpen⚡ Free to try
3 APIs
US GovernmentTravelPassportsVisasTravel AdvisoriesConsular AffairsForeign PolicyDiplomaticCountry InformationPublic Safety

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 40.5/100 · thin
Contract Quality 14.8 / 25
Developer Ergonomics 2.2 / 20
Commercial Clarity 5.8 / 20
Operational Transparency 3.4 / 13
Governance 7.0 / 12
Discoverability 7.4 / 10
Agent readiness — 25/100 · agent aware
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 0 / 10
Idempotency 0 / 9
Stable Error Semantics 0 / 8
Request/Response Examples 7 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/state-dept: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 3

Individual APIs this provider publishes, each with its own machine-readable definition.

State Department Country Information API

Detailed country-specific travel information covering transportation, entry requirements, local laws, health, safety, and embassy contacts

State Department Passport Locations API

Passport acceptance facility locations across the United States, searchable by state, ZIP code, radius, or geographic coordinates

State Department Travel Advisories API

Current US Department of State travel advisories for countries worldwide, with alert levels ranging from 1 (Exercise Normal Precautions) to 4 (Do Not Travel)

Pricing Plans 1

Published pricing tiers and plan structures.

State Dept Plans Pricing

1 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

State Dept Rate Limits

1 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

State Dept Finops

FINOPS

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

State Dept Context

3 classes · 32 properties

JSON-LD

Spectral Rules 1

Spectral governance rulesets for linting and validating these APIs.

State Department API Rules

5 rules · 3 warnings 2 info

SPECTRAL

JSON Schema 3

Standalone JSON Schema definitions for this provider's data models.

CountryTravelInformation

10 properties

JSON SCHEMA

PassportLocation

13 properties

JSON SCHEMA

TravelAdvisory

9 properties

JSON SCHEMA

Examples 2

Example request and response payloads for these APIs.

Country Travel Information Example

10 fields

EXAMPLE

Travel Advisory Example

9 fields

EXAMPLE

Security Posture 1

Authentication, domain security, vulnerability disclosure, and trust-center signals.

State Dept Domain Security

TLSv1.3 · HSTS · DNSSEC · DMARC

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

State Dept Agentic Access

10 operations

10 operations · 0 acting

AGENTIC

Resources

Documentation 1

Reference material describing how the API behaves

Documentation
Documentation

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess
AgenticAccess

Build 1

SDKs, sample code, and the tooling you integrate with

GitHubOrg
GitHubOrg

Access & Security 1

Authentication, authorization, and security posture

DomainSecurity
DomainSecurity

Operate 1

Status, limits, changes, and where to get help

RateLimits
RateLimits

Commercial 2

Pricing, plans, and the legal terms of use

Plans
Plans
 FinOps
FinOps

Company 3

The organization behind the API

Website
Website
 LinkedIn
LinkedIn
 Blog
Blog

Other 1

Properties that don't map to a standard resource type

X
X

Source (apis.yml)

apis.yml Raw ↑ 
aid: state-dept
name: State Department
description: 'The US Department of State provides public REST APIs for accessing consular affairs data including travel advisories
  by country and risk level, country travel information, passport acceptance facility locations, passport issuance statistics,
  and geopolitical reference data. The Consular Affairs Data API (cadataapi.state.gov) offers open, unauthenticated endpoints
  covering all countries with real-time travel advisory updates across four alert levels. Additional historical diplomatic
  records are available through the Foreign Relations of the United States (FRUS) catalog API.

  '
type: Index
accessModel:
  pricing: free
  onboarding: open
  trial: false
  try_now: true
  public: true
  label: Free · Open access
  confidence: medium
  source:
  - plans
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/state-dept.png
url: https://raw.githubusercontent.com/api-evangelist/state-dept/refs/heads/main/apis.yml
created: '2026-06-13'
modified: '2026-06-13'
specificationVersion: '0.19'
tags:
- US Government
- Travel
- Passports
- Visas
- Travel Advisories
- Consular Affairs
- Foreign Policy
- Diplomatic
- Country Information
- Public Safety
apis:
- aid: state-dept:state-dept-country-information-api
  name: State Department Country Information API
  description: Detailed country-specific travel information covering transportation, entry requirements, local laws, health,
    safety, and embassy contacts
  humanURL: https://cadataapi.state.gov/
  baseURL: https://cadataapi.state.gov
  tags:
  - Country Information
  properties:
  - type: OpenAPI
    url: openapi/state-dept-country-information-api-openapi.yml
  - type: Documentation
    url: https://cadataapi.state.gov/
- aid: state-dept:state-dept-passport-locations-api
  name: State Department Passport Locations API
  description: Passport acceptance facility locations across the United States, searchable by state, ZIP code, radius, or
    geographic coordinates
  humanURL: https://cadataapi.state.gov/
  baseURL: https://cadataapi.state.gov
  tags:
  - Passport Locations
  properties:
  - type: OpenAPI
    url: openapi/state-dept-passport-locations-api-openapi.yml
  - type: Documentation
    url: https://cadataapi.state.gov/
- aid: state-dept:state-dept-travel-advisories-api
  name: State Department Travel Advisories API
  description: Current US Department of State travel advisories for countries worldwide, with alert levels ranging from 1
    (Exercise Normal Precautions) to 4 (Do Not Travel)
  humanURL: https://cadataapi.state.gov/
  baseURL: https://cadataapi.state.gov
  tags:
  - Travel Advisories
  properties:
  - type: OpenAPI
    url: openapi/state-dept-travel-advisories-api-openapi.yml
  - type: Documentation
    url: https://cadataapi.state.gov/
common:
- type: AgenticAccess
  url: agentic-access/state-dept-agentic-access.yml
- type: DomainSecurity
  url: security/state-dept-domain-security.yml
- type: Website
  url: https://www.state.gov/
- type: Documentation
  url: https://cadataapi.state.gov/
- type: GitHubOrg
  url: https://github.com/USStateDept
- type: LinkedIn
  url: https://www.linkedin.com/company/statedept
- type: Blog
  url: https://www.state.gov/blogs
- type: X
  url: https://x.com/StateDept
- type: Plans
  url: plans/state-dept-plans-pricing.yml
- type: RateLimits
  url: rate-limits/state-dept-rate-limits.yml
- type: FinOps
  url: finops/state-dept-finops.yml
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com