Department of State Developer Community
In accordance with the Digital Government Strategy, the Department of State promotes the innovative application of agency data in the public and private sectors. State.gov/developer connects developers with Application Programming Interfaces (APIs) they need to unlock government data. This page is the primary resource for developers interested in the Department’s data—we will post information about the API, API Datasets Sampler, frequently asked questions, and the ability to get and maintain API keys.
If you have ideas for APIs you'd like us to make available, we'd really like to hear from you! Click here to send us your ideas, comments, or questions.
DOS Developer Application Programming Interfaces (APIs)
Service Name: Select State.gov Data (SSD)
Service Description: SSD is a REST-based API for accessing select content and metadata posted on 2009-2017.state.gov, including:
- Information regarding the Secretary’s Travel
- U.S. Bilateral Relations fact sheets
- Daily appointment schedules
- Trafficking in Persons Reports
- How the work of the State Department benefits each U.S. State
Because the SSD API is a REST-based API, it can be accessed from a client or server-side application. You can use any programming language, because you just need to be able to make HTTP GET requests, and handle the responses that are in the form of JSON. Note: A token is not needed to begin using the API.
API Link: //2009-2017.state.gov/api/v1/docs/
Service Name: OPDS Catalog of Foreign Relations of the United States (FRUS)
Service Description: OPDS Catalog of Foreign Relations of the United States Series. This web API allows 3rd party web and application developers to integrate the live catalog into their products. It also lets end users manually add the catalog to applications that support the standard that our API is based on.
API Link: http://history.state.gov/developer/catalog
Service Name: aoprals.state.gov
Service Description: Foreign Per Diem rates by location. These rates are established monthly by the Office of Allowances as maximum U.S. dollar rates for reimbursement of U.S. Government civilians traveling on official business in foreign areas. Lodging and M&IE (Meals & Incidental Expenses) are reported separately followed by a combined daily rate.
API Link: https://explore.data.gov/developers/docs/foreign-per-diem-rates-by-location
Service Name: Current travel alerts issued by Department of State
Service Description: Travel alerts are issued to disseminate information about short-term conditions, either transnational or within a particular country, that pose significant risks to the security of U.S. citizens. Natural disasters, terrorist attacks, coups, anniversaries of terrorist events, election-related demonstrations or violence, and high-profile events such as international conferences or regional sports events are examples of conditions that might generate a Travel Alert.
Service Name: Current travel warnings issued by Department of State
Service Description: Travel Warnings are issued when long-term, protracted conditions that make a country dangerous or unstable lead the State Department to recommend that Americans avoid or consider the risk of travel to that country. A Travel Warning is also issued when the U.S. Government's ability to assist American citizens is constrained due to the closure of an embassy or consulate or because of a drawdown of its staff.
Service Name: Current worldwide caution issued by Department of State
Service Description: The Department of State issues worldwide caution to update information on the continuing threat of terrorist actions and violence against U.S. citizens and interests throughout the world.
Travel Alerts & Warnings Instructions and Tables
- Instructions in HTML format (06/17/2013): //2009-2017.state.gov/developer/210732.htm
- Geo-Political Areas in .json format (06/17/2013): geoPoliticalArea.json
- Geo-Political Regions in .json format (06/17/2013): geoPoliticalRegion.json
This one-of-a-kind app presents the full spectrum of projects underway around the globe to improve people's lives by harnessing the power of atomic technology. [iTunes | Google Play]
American English (AE)
This app consolidates State Department English language learning content in one easy-to-access location. Content includes e-books, audiobooks, music, quizzes, and the “Trace Word Soup” vocabulary game. [biNu]
This app educates and engages aspiring Foreign Service candidates and others seeking to familiarize themselves with diplomatic careers. [iTunes | Google Play]
East Asia and Pacific Media Hub
The official State Department East Asia and Pacific Media Hub app puts the latest regional policy news, videos and photos at your fingertips. [iTunes | Google Play]
This app allows international students who would like to study in the U.S. to access accurate and comprehensive information about the opportunities available to them. [iTunes | Google Play]
Model United Nations
Geared toward teachers, community leaders, and students of international affairs, this app uses step-by-step tools to engage users in the vital work of the UN. [iTunes]
For more than 60 years, State Magazine has told the stories of the people, places and events of the Department of State. [iTunes]
This app from the State Department puts the latest in foreign policy news and video at your fingertips. [iTunes]
We'd love to hear from you!
- Make a suggestion
- Submit a question about our featured services
- Check out our frequently asked questions
Keep up to date with the latest news about our developer community. Follow us!