Social Security Administration (SSA) Developer Support
Application Programming Interface (API) for
OASDI Benefit Payments by State
Background
In May 2013, the White House passed Executive Order 13642, Making Open and Machine Readable data the New Default for Government Information. Implementation information is in OMB Memorandum M-13-13, Open Data Policy - Managing Information as an Asset. We continue to advance open data by making data available in multiple formats to respond to customer needs. For example, we released code and tool instructions to help users sort over 1500 assets in our enterprise data inventory. We have also used geospatial aspects of public data for mapping, with tools that also provide JSON and application programming interfaces (API).
Description
The OASDI Benefit Payments by State API is a web service that provides yearly data, by state, for the Social Security beneficiary population - people receiving Old-Age, Survivors, and Disability Insurance (OASDI) benefits.
API users can download the entire data asset, or query (call), the asset for selected return of data. Choices include basic program data on the number of beneficiaries in current payment status, by state, type of benefit, and sex. Social Security has this OASDI dataset with a map publicly available. The Digital Government Strategy web page also shows our APIs.
Functionality
We used the Esri ArcGIS Online platform to provide the data as a RESTful API (also called Feature Service). Click the "API Endpoint" below to review data fields and to start using the API. There is an "API reference" at the top right corner of each page for additional information about using this service. If users want a machine-readable return, the tool will deliver a return in JSON format.
Sample API Call and Response
Get OASDI Benefiit Payments by State data for the State of Georgia (the response data is at the bottom of the page).
This link points to a sample call made using the Esri REST interface for obtaining a response in HTML format. In the sample call, we provided a text input for the fields - "Where", "Out Fields", and "Format". In this example, we selected all information for the state of Georgia. To learn more about querying the Feature Service, read ArcGIS Rest API - Query Feature Service.
