State Assessment Data Repository

API

In addition to downloading files from the data page, you can access all repository files through our application programming interface (API). It requires no authentication and can be used to pull data directly into R, Stata, Python, or any tool that reads a CSV from a URL.

Endpoint

https://eddatacenter.org/api/data/<version>?[state=<SS>][&year=<YYYY>]

Parameters

ParameterRequiredDescription
versionRequiredDataset version. Valid versions: 3.1.
stateOptionalAny two-letter state abbreviation, including DC for the District of Columbia.
yearOptionalAny year from 1998 to 2025. Many states do not have data for all years; you will receive a 404 in that case.

Code examples

Use one of these examples to load repository data into your software of choice, or download the data directly by opening the relevant eddatacenter.org/api/data URL in your browser and importing the CSV.


You likely need to increase Stata's request timeout, as the data files may take a long time to download. You can do so with:

. set timeout1 6000

Stata 18+

Users with Stata 18 or after can use the following code to import the EDC dataset. Similar to Stata < 18 (below), users can specify three parameters for the data: Version number, state, and year. Examples are provided in the following code.
* Example 1 - load data for all states in 2024.
import delimited "https://eddatacenter.org/api/data/3.1?year=2024", clear case(preserve)

* Example 2 - load all data for Rhode Island. Note that the year parameter is blank.
import delimited "https://eddatacenter.org/api/data/3.1?state=RI", clear case(preserve)

* Example 3 - load 2024 data for Rhode Island.
import delimited "https://eddatacenter.org/api/data/3.1?year=2024&state=RI", clear case(preserve)

Stata < 18

After EDC in the code below, users must specify three ordered parameters:

  1. The Version number. Currently, EDC is using version 3.1
  2. The state name. Note that users must spell out the full state name, not the two-letter abbreviation. The exception to this is DC, which uses "DC". If users wish to select all states, use "".
  3. The year of interest. If users wish to select all years available, use "". Alternatively, users can select a single year, such as "2023".
do "https://www.eddatacenter.org/zelma.do"

* Example 1 - load data for all states in 2024. Note that the state parameter is blank.
zelma "3.1" "" "2024"

* Example 2  - load all data for Rhode Island. Note that the year parameter is blank.
zelma "3.1" "Rhode Island" ""

* Example 3  - load 2024 data for Rhode Island.
zelma "3.1" "Rhode Island" "2024"