Code list

This tutorial will show you how to use the USAJOBS Code List API to obtain code values used by the search APIs. The base URL for the Search API is: https://data.usajobs.gov/api/codelist/[endpoint].

Agency Subelements

The Agency Subelements endpoint returns a list of agencies and the corresponding organization code. The code value in each list item is used to filter search results using the Organization parameter.

var request = require('request');    
            
request({     
    url: 'https://data.usajobs.gov/api/codelist/agencysubelements',
    method: 'GET' 
}, function(error, response, body) {     
    var data = JSON.parse(body); 
});

$ curl https://data.usajobs.gov/api/codelist/agencysubelements

Result (JSON):
{
    "CodeList": [{         
        "ValidValue": [             
            {                 
                "Code": "LP00",                 
                "Value": "Government Publishing Office",                 
                "LastModified": "2015-03-10T00:00:00",                 
                "IsDisabled": "No"             
            },             
            ...         
        ],         
        "id": "AgencySubElement"     
    }],     
    "DateGenerated": "2015-04-05T18:55:44.3995692-04:00" 
}

Occupational Series

The Occupational Series endpoint returns a list of job categories and the corresponding job category code. The code value in each list item is used to filter search results using the JobCategoryCode parameter.

var request = require('request');    
            
request({     
    url: 'https://data.usajobs.gov/api/codelist/occupationalseries',
    method: 'GET' 
}, function(error, response, body) {     
    var data = JSON.parse(body); 
});

$ curl https://data.usajobs.gov/api/codelist/occupationalseries

Result (JSON):
{
    "CodeList": [{         
        "ValidValue": [             
            {                 
                "Code": "0308",                                                           
                "Value": "Records & Information Management",                                                           
                "LastModified": "2015-04-24T00:00:00",                                                          
                "IsDisabled": "No"             
            },             ,
            ...         
        ],         
        "id": "OccupationalSeries"     
    }],     
    "DateGenerated": "2015-04-05T18:55:44.3995692-04:00" 
}

Pay Plans

The Pay Plans endpoint returns a list of pay plans and the corresponding pay plan code.

var request = require('request');    
            
request({     
    url: 'https://data.usajobs.gov/api/codelist/payplans',
    method: 'GET' 
}, function(error, response, body) {     
    var data = JSON.parse(body); 
});

$ curl https://data.usajobs.gov/api/codelist/payplans

Result (JSON):
{
    "CodeList": [{         
        "ValidValue": [             
            {                 
                "Code": "IM",                                                           
                "Value": "Incident Management",                                                           
                "LastModified": "2015-11-16T13:54:25.87",                                                           
                "IsDisabled": "No"             
            },             
            ...         
        ],         
        "id": "PayPlans"     
    }],     
    "DateGenerated": "2015-04-05T18:55:44.3995692-04:00" 
}

Postal Codes

The Postal Codes endpoint returns a list of postal code values.

var request = require('request');    
            
request({     
    url: 'https://data.usajobs.gov/api/codelist/postalcodes',
    method: 'GET' 
}, function(error, response, body) {     
    var data = JSON.parse(body); 
});

$ curl https://data.usajobs.gov/api/codelist/postalcodes

Result (JSON):
{
    "CodeList": [{         
        "ValidValue": [             
            {                 
                "Code": "11358",                                                           
                "RefLocID": 109953,                                                           
                "City": "Auburndale",                                                           
                "USCounty": "Queens County",                                                           
                "CountrySubdivision": "NY",                                                           
                "Country": "US",                                                           
                "LastModified": "2015-11-16T13:54:25.87",                                                           
                "IsDisabled": "No"                
            },             
            ...         
        ],         
        "id": "PostalCode"     
    }],     
    "DateGenerated": "2015-04-05T18:55:44.3995692-04:00" 
}

Geographic Locations Codes

The Geographic Locations endpoint returns a list of geographic location values.

var request = require('request');    
            
request({     
    url: 'https://data.usajobs.gov/api/codelist/geoloccodes',
    method: 'GET' 
}, function(error, response, body) {     
    var data = JSON.parse(body); 
});

$ curl https://data.usajobs.gov/api/codelist/geoloccodes

Result (JSON):
{
    "CodeList": [{         
        "ValidValue": [             
            {                 
                "Code": "530539053",                               
                "City": "Dupont",                               
                "USCounty": "Pierce County",                               
                "CountrySubdivision": "WA",                               
                "Country": "US",                               
                "LastModified": "2014-03-10T00:00:00",                               
                "IsDisabled": "No"                
            },             
            ...         
        ],         
        "id": "GeoLocCode"     
    }],     
    "DateGenerated": "2015-04-05T18:55:44.3995692-04:00" 
}

Countries

The Countries endpoint returns a list of countries.

var request = require('request');    
            
request({     
    url: 'https://data.usajobs.gov/api/codelist/countries',
    method: 'GET' 
}, function(error, response, body) {     
    var data = JSON.parse(body); 
});

$ curl https://data.usajobs.gov/api/codelist/countries

Result (JSON):
{
    "CodeList": [{         
        "ValidValue": [             
            {                 
                "Code": "TL",                 
                "Value": "Timor-Leste",                 
                "LastModified": "2012-12-02T00:00:00",                 
                "IsDisabled": "No"               
            },             
            ...         
        ],         
        "id": "CountryCode"     
    }],     
    "DateGenerated": "2015-04-05T18:55:44.3995692-04:00" 
}

Country Subdivisions

The Country Subdivisions endpoint returns a list of states, provinces or territories within countries.

var request = require('request');    
            
request({     
    url: 'https://data.usajobs.gov/api/codelist/countrysubdivisions',
    method: 'GET' 
}, function(error, response, body) {     
    var data = JSON.parse(body); 
});

$ curl https://data.usajobs.gov/api/codelist/countrysubdivisions

Result (JSON):
{
    "CodeList": [{         
        "ValidValue": [             
            {                 
                "Code": "UT",                 
                "Value": "Utah",                 
                "ParentCode": "US",                 
                "LastModified": "2011-07-08T00:00:00",                 
                "IsDisabled": "No"               
            },             
            ...         
        ],         
        "id": "CountrySubdivisionCode"     
    }],     
    "DateGenerated": "2015-04-05T18:55:44.3995692-04:00" 
}