General - Quick Start

Request API Key

In order to use the search API you will first need to obtain an API Key. To request an API Key, please go the the API Request page and fill out an application.

Make an API Call

Once you have successfully obtained an API Key through submitting an API Request Application you will be able to access the search APIs.

Note: All /codelist/ endpoints do not require an authorization key.

Now execute the following command to search all job opportunity announcements that are in the field of Information Technology Management, Occupational Series: 2210. Be sure to replace $YOUR_EMAIL with the email address you entered on the API request form and $AUTH_KEY with the authorization key sent to your email.

 curl -H 'Host: data.usajobs.gov' \
'User Agent: $YOUR_EMAIL' \
'Authorization Key: $AUTH_KEY' \
https://data.usajobs.gov/api/search?JobCategoryCode=2210