Department of State

The U.S. Department of State leads U.S. foreign policy, conducts diplomacy with foreign governments, issues U.S. passports and visas, supports U.S. citizens abroad, and publishes country-specific information and travel advisories. It operates no unified developer portal and issues no API keys, but it does serve several real, anonymous, machine-readable surfaces: the state.gov Content API at https://www.state.gov/wp-json, where 473 WordPress REST routes expose press releases, briefings, reports, biographies, bureaus and country and policy content as structured JSON with no credential; the Office of the Historian Ebook Catalog API, an OPDS Catalog 1.1 feed of the Foreign Relations of the United States series and the only surface the Department documents on a developer page of its own; a DCAT-US 3.0 open data catalog of 397 datasets at https://www.state.gov/data.json; and the Travel Advisories RSS feed. Discovery is the weak point rather than supply — none of the nine State hosts probed serves any /.well-known/ document, three of the four State APIs listed in the federal inventory have been retired without notice, and travel.state.gov and the Bureau of Consular Affairs data catalog refuse non-browser clients outright.

Department of State publishes 1 API on the APIs.io network: state.gov Content API. Tagged areas include Federal-Government, Foreign Affairs, Travel, Consular, and Visas.

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

Department of State’s developer surface includes engineering blog, authentication, developer portal, documentation, API reference, support, and 29 more developer resources.

38.1/100 thin ▬ flat Agent 26/100 agent aware Full breakdown ↓
scored 2026-09-08 · rubric v0.20.0
AccessFreemium
4 APIs 1 MCP Servers
Federal-GovernmentForeign AffairsTravelConsularVisasPassports

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-09-08 · rubric v0.20.0
Regulatory Posture applies to this provider. Its tags matched the Government & Public Sector regime, so Regulatory Posture carries 15 points of the composite. If this regime is wrong for your business, say so on your provider repo — the applicability map is public and we will correct it.
Create-or-Update Ergonomics applies to this provider. This API accepts writes, so it carries 10 points of the composite. It is scored from the published contracts themselves: whether a caller can create-or-update in one call, whether the write accepts a key the caller already holds, and whether the response says which branch ran. Without that, every write needs a search-and-branch in front of it, and the first time that check is skipped a duplicate record is created. Scored against the observed mean rather than raw — a provider at the catalog average is unchanged by this facet, not penalised by it.
The six quality facets above are damped to 75 points between them, because the conditional facet above carries the other 25. That is why each facet's contribution is shown against a damped maximum: raising a quality facet moves the composite by 75% of its nominal weight, not 100%. The full arithmetic is at apis.io/rating/.
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. Every facet and dimension name above is a link: it opens that measurement's own page — what it means, the exact checks that feed it, how the whole catalog distributes on it, and the providers at the top of it. This rating is computed from github.com/api-evangelist/department-of-state: open an issue to ask a question, or submit a pull request to add artifacts. Submit an artifact on GitHub — free → Manage your own listing — the Influence plan, $499/mo →

APIs 12

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

state.gov Content API

The Department of State runs www.state.gov on WordPress and exposes the WordPress REST API anonymously at https://www.state.gov/wp-json. Alongside the core WordPress resources t...

Office of the Historian Ebook Catalog API

A RESTful, OPDS Catalog 1.1 feed of the Foreign Relations of the United States series — the official documentary record of major U.S. foreign policy decisions — published by the...

Department of State Open Data Catalog

The Department's Project Open Data catalog, served as a single machine-readable DCAT-US 3.0 document at https://www.state.gov/data.json. 397 dataset entries covering Foreign Rel...

State Department Travel Advisories

Country-by-country travel advisories (Levels 1-4) issued by the Bureau of Consular Affairs, with RSS distribution.

Country Information Pages

Per-country pages covering entry/exit requirements, local laws, safety, health, and U.S. embassy contacts.

Smart Traveler Enrollment Program (STEP)

Voluntary enrollment system for U.S. citizens traveling or residing abroad to receive embassy alerts.

U.S. Visa Information

Reference information on nonimmigrant and immigrant visa categories, processing times, and reciprocity schedules.

U.S. Passport Services

Public-facing passport application, renewal, and status-check resources from the Bureau of Consular Affairs.

Foreign Affairs Manual (FAM) and Handbook (FAH)

Department-wide policy and procedural manuals issued by the Office of Directives Management.

ConsularLookout (CLASS)

Government-internal name-check system used during visa and passport adjudication. Referenced here for completeness; no public API.

eCASE Enterprise Case Management

State Department-wide enterprise case-management platform. Internal system; referenced here for organizational completeness.

State Department Open Data on data.gov

Public datasets published by the State Department through the federal open-data catalog.

Scroll for all 12

MCP Servers 1

Model Context Protocol servers that expose these APIs to AI agents.

Pricing Plans 1

Published pricing tiers and plan structures.

Rate Limits 1

Documented rate limits and quota policies.

Department Of State Rate Limits

0 limits

RATE LIMITS

FinOps 1

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

Semantic Vocabularies 1

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

State Context

0 classes · 5 properties

JSON-LD

Spectral Rules 1

Spectral governance rulesets for linting and validating these APIs.

Department of State API Rules

0 rules ·

SPECTRAL

JSON Schema 10

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

state_biography

28 properties

JSON SCHEMA

state_briefing

28 properties

JSON SCHEMA

state_bureau

29 properties

JSON SCHEMA

state_country

27 properties

JSON SCHEMA

state_ext_content

27 properties

JSON SCHEMA

state_people

26 properties

JSON SCHEMA

state_policy_issue

31 properties

JSON SCHEMA

state_press_release

30 properties

JSON SCHEMA

state_report

31 properties

JSON SCHEMA

state_trip_travel

27 properties

JSON SCHEMA

Scroll for all 10

Security Posture 3

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

Department Of State Authentication

none/http · 2 schemes

SECURITY

Department Of State Domain Security

TLSv1.3 · DNSSEC · DMARC

SECURITY

Department Of State Vulnerability Disclosure

Hackerone · security.txt · contact published

SECURITY

Agentic Access 1

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

Department Of State Agentic Access

158 operations · 93 acting

158 operations · 93 acting

AGENTIC

Resources

Get Started 3

Portal, sign-up, and the first successful call

Documentation 5

Reference material describing how the API behaves

Agent Surfaces 4

MCP servers, agent skills, and machine-readable catalogs

Design & Contract 5

Pagination, idempotency, versioning, errors, and events

Build 3

SDKs, sample code, and the tooling you integrate with

Access & Security 4

Authentication, authorization, and security posture

Operate 2

Status, limits, changes, and where to get help

Commercial 3

Pricing, plans, and the legal terms of use

Company 3

The organization behind the API

Other 3

Properties that don't map to a standard resource type

Source (apis.yml)

apis.yml Raw ↑
aid: department-of-state
name: Department of State
description: 'The U.S. Department of State leads U.S. foreign policy, conducts diplomacy with foreign governments, issues
  U.S. passports and visas, supports U.S. citizens abroad, and publishes country-specific information and travel advisories.
  It operates no unified developer portal and issues no API keys, but it does serve several real, anonymous, machine-readable
  surfaces: the state.gov Content API at https://www.state.gov/wp-json, where 473 WordPress REST routes expose press releases,
  briefings, reports, biographies, bureaus and country and policy content as structured JSON with no credential; the Office
  of the Historian Ebook Catalog API, an OPDS Catalog 1.1 feed of the Foreign Relations of the United States series and the
  only surface the Department documents on a developer page of its own; a DCAT-US 3.0 open data catalog of 397 datasets at
  https://www.state.gov/data.json; and the Travel Advisories RSS feed. Discovery is the weak point rather than supply — none
  of the nine State hosts probed serves any /.well-known/ document, three of the four State APIs listed in the federal inventory
  have been retired without notice, and travel.state.gov and the Bureau of Consular Affairs data catalog refuse non-browser
  clients outright.'
url: https://raw.githubusercontent.com/api-evangelist/department-of-state/main/apis.yml
deliveryModel:
  model: unknown
  open_source: false
  commercial: false
  callable_host: false
  label: Delivery model not determined — needs a product licence on record
  confidence: low
  source:
  - none
  generated: '2026-08-28'
  method: derived
accessModel:
  pricing: freemium
  onboarding: unknown
  trial: false
  try_now: false
  public: false
  label: Freemium
  confidence: medium
  source:
  - plans
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/department-of-state.png
created: '2024-12-03'
modified: '2026-09-07'
type: Index
position: Producing
access: 3rd-Party
specificationVersion: '0.23'
tags:
- Federal-Government
- Foreign Affairs
- Travel
- Consular
- Visas
- Passports
tags_raw:
- Federal Government
- Foreign Affairs
- Travel
- Consular
- Visas
- Passports
common:
- type: GitHubOrg
  url: https://github.com/USStateDept
- type: Blog
  url: https://www.state.gov/blogs
- type: X
  url: https://x.com/StateDept
- type: AgenticAccess
  url: agentic-access/department-of-state-agentic-access.yml
- type: Authentication
  url: authentication/department-of-state-authentication.yml
- type: Website
  url: https://www.state.gov/
- type: DomainSecurity
  url: security/department-of-state-domain-security.yml
- type: GitHubOrganization
  url: https://github.com/usstatedept
- type: LinkedIn
  url: https://www.linkedin.com/company/statedept
- url: https://www.state.gov/
  type: Portal
- url: https://travel.state.gov/
  type: Portal
- url: https://fam.state.gov/
  type: Reference
- type: OpenAPI
  name: state.gov Content API (derived)
  url: openapi/department-of-state-state-gov-content-openapi.yml
- type: JSONSchema
  url: json-schema/_index.yml
- type: Overlay
  url: overlays/department-of-state-state-gov-content-overlay.yaml
- type: Conventions
  url: conventions/department-of-state-conventions.yml
- type: ErrorCatalog
  url: errors/department-of-state-problem-types.yml
- type: DataModel
  url: data-model/department-of-state-data-model.yml
- type: Lifecycle
  url: lifecycle/department-of-state-lifecycle.yml
- type: Conformance
  url: conformance/department-of-state-conformance.yml
- type: Packages
  url: packages/department-of-state-packages.yml
- type: MCPServer
  url: mcp/department-of-state-mcp.yml
- type: AgentSkill
  url: skills/_index.yml
- type: LLMsTxt
  url: llms/department-of-state-llms.txt
- type: RateLimits
  url: rate-limits/department-of-state-rate-limits.yml
- type: Plans
  url: plans/department-of-state-plans-pricing.yml
- type: VulnerabilityDisclosure
  url: security/department-of-state-vulnerability-disclosure.yml
- type: Security
  url: https://www.state.gov/bureau-of-diplomatic-technology/vulnerability-disclosure-policy
- type: Documentation
  url: https://history.state.gov/developer/catalog
- type: DeveloperPortal
  url: https://history.state.gov/developer
- type: APIReference
  url: https://www.state.gov/wp-json/
- type: Support
  url: https://www.state.gov/contact-us/
- type: PrivacyPolicy
  url: https://www.state.gov/privacy-policy
- type: TermsOfService
  url: https://www.state.gov/copyright-information
- type: OpenData
  url: https://www.state.gov/data.json
apis:
- aid: department-of-state:state-gov-content-api
  name: state.gov Content API
  description: The Department of State runs www.state.gov on WordPress and exposes the WordPress REST API anonymously at https://www.state.gov/wp-json.
    Alongside the core WordPress resources the Department registers its own content types and taxonomies — state_press_release,
    state_briefing, state_report, state_biography, state_bureau, state_country, state_policy_issue, state_trip_travel and
    sixteen more — giving structured JSON access to press releases, press briefings, the flagship annual reports, principal
    biographies, bureau pages and country and policy landing content. 473 routes are advertised in the index; 65 read operations
    are public with no key, no registration and no quota. Write operations exist but require a Department editorial account.
    The Department publishes no OpenAPI; the description in this repo was derived mechanically from its own route index and
    OPTIONS schemas.
  humanURL: https://www.state.gov/
  baseURL: https://www.state.gov/wp-json
  tags:
  - Content
  - Press Releases
  - Reports
  - Foreign Affairs
  - WordPress
  properties:
  - type: OpenAPI
    url: openapi/department-of-state-state-gov-content-openapi.yml
  - type: APIReference
    url: https://www.state.gov/wp-json/
  - type: Authentication
    url: authentication/department-of-state-authentication.yml
  - type: Conventions
    url: conventions/department-of-state-conventions.yml
  - type: ErrorCatalog
    url: errors/department-of-state-problem-types.yml
  - type: DataModel
    url: data-model/department-of-state-data-model.yml
  - type: JSONSchema
    url: json-schema/_index.yml
  - type: Overlay
    url: overlays/department-of-state-state-gov-content-overlay.yaml
  - type: AgentSkill
    url: skills/_index.yml
  - type: Documentation
    url: https://developer.wordpress.org/rest-api/
- aid: department-of-state:historian-ebook-catalog-api
  name: Office of the Historian Ebook Catalog API
  description: A RESTful, OPDS Catalog 1.1 feed of the Foreign Relations of the United States series — the official documentary
    record of major U.S. foreign policy decisions — published by the Office of the Historian. Four documented operations (catalog
    root, all volumes in series order, ten most recent, subject browse, and Lucene free-text search) return Atom XML carrying
    acquisition links to EPUB, MOBI and PDF editions plus cover images. No registration, no API key, no authentication. This
    is the only surface the Department documents on a developer page of its own, and the source data behind it is open on
    GitHub as TEI XML.
  humanURL: https://history.state.gov/developer/catalog
  baseURL: https://history.state.gov/api/v1
  tags:
  - History
  - Publications
  - OPDS
  - Open Data
  - Foreign Affairs
  properties:
  - type: Documentation
    url: https://history.state.gov/developer/catalog
  - type: DeveloperPortal
    url: https://history.state.gov/developer
  - type: GitHubOrganization
    url: https://github.com/HistoryAtState
  - type: Support
    url: https://github.com/HistoryAtState/Feedback
  - type: SourceCode
    url: https://github.com/HistoryAtState/hsg-shell
  - type: AgentSkill
    url: skills/department-of-state-frus-ebook-catalog.md
- aid: department-of-state:open-data-catalog
  name: Department of State Open Data Catalog
  description: The Department's Project Open Data catalog, served as a single machine-readable DCAT-US 3.0 document at https://www.state.gov/data.json.
    397 dataset entries covering Foreign Relations metadata, Humanitarian Information Unit cartography, passport and visa
    statistics, and international law digests, each with distribution URLs. It is the Department's own index of what it publishes,
    and it is the document that points at the Bureau of Consular Affairs data catalog at cadatacatalog.state.gov.
  humanURL: https://catalog.data.gov/dataset?organization=state-gov
  baseURL: https://www.state.gov/data.json
  tags:
  - Open Data
  - DCAT
  - Catalog
  properties:
  - type: OpenData
    url: https://www.state.gov/data.json
  - type: Documentation
    url: https://catalog.data.gov/dataset?organization=state-gov
  - type: Conformance
    url: conformance/department-of-state-conformance.yml
- aid: department-of-state:travel-advisories
  name: State Department Travel Advisories
  description: Country-by-country travel advisories (Levels 1-4) issued by the Bureau of Consular Affairs, with RSS distribution.
  humanURL: https://travel.state.gov/content/travel/en/traveladvisories/traveladvisories.html
  baseURL: https://travel.state.gov/_res/rss/TAsTWs.xml
  tags:
  - Travel
  - Advisories
  - RSS
  properties:
  - type: Documentation
    url: https://travel.state.gov/content/travel/en/traveladvisories/traveladvisories.html
  - type: RSS
    url: https://travel.state.gov/_res/rss/TAsTWs.xml
- aid: department-of-state:country-information
  name: Country Information Pages
  description: Per-country pages covering entry/exit requirements, local laws, safety, health, and U.S. embassy contacts.
  humanURL: https://travel.state.gov/content/travel/en/international-travel/International-Travel-Country-Information-Pages.html
  tags:
  - Country
  - Travel
  properties:
  - type: Documentation
    url: https://travel.state.gov/content/travel/en/international-travel/International-Travel-Country-Information-Pages.html
- aid: department-of-state:smart-traveler-enrollment-program
  name: Smart Traveler Enrollment Program (STEP)
  description: Voluntary enrollment system for U.S. citizens traveling or residing abroad to receive embassy alerts.
  humanURL: https://step.state.gov/
  tags:
  - Travel
  - Citizen Services
  properties:
  - type: Documentation
    url: https://step.state.gov/
- aid: department-of-state:visa-information
  name: U.S. Visa Information
  description: Reference information on nonimmigrant and immigrant visa categories, processing times, and reciprocity schedules.
  humanURL: https://travel.state.gov/content/travel/en/us-visas.html
  tags:
  - Visas
  properties:
  - type: Documentation
    url: https://travel.state.gov/content/travel/en/us-visas.html
  - type: Reference
    url: https://travel.state.gov/content/travel/en/us-visas/visa-information-resources/fees/reciprocity-by-country.html
- aid: department-of-state:passport-services
  name: U.S. Passport Services
  description: Public-facing passport application, renewal, and status-check resources from the Bureau of Consular Affairs.
  humanURL: https://travel.state.gov/content/travel/en/passports.html
  tags:
  - Passports
  properties:
  - type: Documentation
    url: https://travel.state.gov/content/travel/en/passports.html
  - type: StatusPage
    url: https://travel.state.gov/content/travel/en/passports/need-passport/status.html
- aid: department-of-state:foreign-affairs-manual
  name: Foreign Affairs Manual (FAM) and Handbook (FAH)
  description: Department-wide policy and procedural manuals issued by the Office of Directives Management.
  humanURL: https://fam.state.gov/
  tags:
  - Policy
  - Reference
  properties:
  - type: Documentation
    url: https://fam.state.gov/
- aid: department-of-state:consular-lookout-class
  name: ConsularLookout (CLASS)
  description: Government-internal name-check system used during visa and passport adjudication. Referenced here for completeness;
    no public API.
  humanURL: https://travel.state.gov/content/travel/en/legal/visa-law0.html
  tags:
  - Consular
  - Internal
  properties:
  - type: Reference
    url: https://travel.state.gov/content/travel/en/legal/visa-law0.html
- aid: department-of-state:ecase
  name: eCASE Enterprise Case Management
  description: State Department-wide enterprise case-management platform. Internal system; referenced here for organizational
    completeness.
  humanURL: https://www.state.gov/
  tags:
  - Case Management
  - Internal
  properties:
  - type: Reference
    url: https://www.state.gov/
- aid: department-of-state:state-data-gov
  name: State Department Open Data on data.gov
  description: Public datasets published by the State Department through the federal open-data catalog.
  humanURL: https://catalog.data.gov/dataset?organization=state-gov
  tags:
  - Open Data
  properties:
  - type: Documentation
    url: https://catalog.data.gov/dataset?organization=state-gov
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
x-enrichment:
  date: '2026-09-07'
  status: enriched
  artifacts_added: 18
  pass: local-v3

Work with this as data

Every provider here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for providers

9 MCP tools reach this
  • find_providersBrowse and filter every provider in the catalog.
  • get_provider_artifactsEvery artifact this provider publishes, grouped by type.
  • get_provider_operationsEvery operation across all of their OpenAPIs — one call instead of parsing every spec.
  • get_provider_toolsEvery MCP tool they ship, with the operation each wraps.
  • get_provider_evidenceHow each part of their score was established. Free — the basis for a claim should not sit behind it.
  • get_provider_ratingPRO — composite, band, trend and facet scores.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This provider
curl "https://apis.io/api/v1/providers/department-of-state"
All providers
curl "https://apis.io/api/v1/providers?limit=25"
Every operation they expose
curl "https://apis.io/api/v1/providers/department-of-state/operations?limit=25"
How their score was established
curl "https://apis.io/api/v1/providers/department-of-state/evidence"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.