Application Programming Interface

for

OASDI Beneficiaries by Total Population Data

Background

In May 2013, the White House passed Executive Order 13642Making 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 Beneficiaries by Total Population 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 by state, for beneficiaries as a percentage of the total resident population and of the population aged 65 or older. Social Security has this 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 Beneficiaries by Total Population data for the State of Arkansas (scroll down the query page to see response data).

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 Arkansas.  To learn more about querying the Feature Service, read ArcGIS Rest API - Query Feature Service section.


API Name:   OASDI Beneficiaries by Total Population

Endpoint:  http://services6.arcgis.com/zFiipv75rloRP5N4/ArcGIS/rest/services/OASDI_2015/FeatureServer/2

Full Data in JSON Format:   OASDI Beneficiaries by Total Population as JSON