Web API: Get Training Program Details

Training Program Details

The 'Training Programs Details' API enables developers to input a location and get a list of Training Programs and other related information.

About this data

The API provides search results for Training Programs Details based on a details id entered. This data is found in the Local Training Finder on www.CareerOneStop.org. For more information on the data, go to the tool's help page.

Resource URL

https://api.careeronestop.org/v2/training/program/{userId}/{detailID}

Example Code

using System;

using System.Net.Http;

using System.Net.Http.Headers;

using System.Threading.Tasks;

using System.Collections.Specialized;

using System.Linq;

namespace CareerOneStopAPISample

{

    class Program

    {

        static void Main(string[] args)

        {

            CreateRequest().Wait();

        }

        private static async Task CreateRequest()

        {

            var qs = new NameValueCollection();

            qs["radius"] = "value";                       

           

            var uri = new UriBuilder(Uri.UriSchemeHttps, "api.careeronestop.org")

            {

                Path = "/v2/training/program/{userId}/{detailID}",

                Query = string.Join("&", qs.AllKeys.Select(key => key + "=" + Uri.EscapeUriString(qs[key])))

            };

           

            using (var http = new HttpClient())

            {

                http.DefaultRequestHeaders.Accept.Clear();

                http.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", "Your API Token");

                http.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));

                var response = await http.GetAsync(uri.Uri).ConfigureAwait(false);

                if (response.IsSuccessStatusCode)

                {

                    var result = await response.Content.ReadAsStringAsync().ConfigureAwait(false);

                }

            }

        }

    }

}
import java.io.IOException;

import java.net.URI;

import java.net.URISyntaxException;

import org.apache.http.HttpEntity;

import org.apache.http.client.methods.CloseableHttpResponse;

import org.apache.http.client.methods.HttpGet;

import org.apache.http.client.utils.URIBuilder;

import org.apache.http.impl.client.CloseableHttpClient;

import org.apache.http.impl.client.HttpClients;

import org.apache.http.util.EntityUtils;

public class CareerOneStopAPISample {

    public static void main(String[] args) throws IOException, URISyntaxException {

    URI uri = new URIBuilder()

        .setScheme("https")

        .setHost("api.careeronestop.org")

        .setPath("/v2/training/program/{userId}/{detailID}")

                .setParameter("radius", "value")

        .build();

    CloseableHttpResponse response = null;

    HttpGet httpGet = null;

    try {

        CloseableHttpClient httpClient = HttpClients.createDefault();

        httpGet = new HttpGet(uri);

        httpGet.setHeader("Content-Type","application/json");

        httpGet.setHeader("Authorization", "Bearer Your API Token");

        response = httpClient.execute(httpGet);

        HttpEntity entity = response.getEntity();

        System.out.println(EntityUtils.toString(entity));

    } finally {

        if(httpGet != null) httpGet.releaseConnection();

        if(response != null) response.close();

    }

   }

}

Request Parameters

Refer to the following table for a list of the required and optional request parameters. All parameter names and values are case sensitive. Important: You must provide all required parameters. Submitting an empty request does not return all possible results; an empty request returns an error.

Parameter Name Value Required? Description
userId
String
Yes This value is the unique UserID provided during the CareerOneStop Web API registration process.
Details id
String
Yes This value accepts a program details id.
enableMetaData
boolean
optional Use this parameter to determine whether to include MetaData in the response. True- Include metadata False - exclude metadata (default)
 

Response Structure


{

  "SchoolPrograms": {

    "DetailId": 129276513801,

    "CipCode": "513801",

    "CipTitle": "Registered Nursing/Registered Nurse",

    "EtaProgramName": null,

    "Format": [

      "In-person"

    ],

    "AwLevelCode": 6,

    "AwardLevel": "Bachelor's degree, usually 4 years",

    "Credential": null,

    "DataSource": "N",

    "NumberCompleted": [

      "4 years: 0"

    ],

    "OccupationsList": [

      "Nursing Instructors and Teachers, Postsecondary",

      "Registered Nurses"

    ],

    "ProgramWeeks": null,

    "ProgramHours": null,

    "ProgramDescription": null,

    "SchoolIDUnique": 500290,

    "SchoolName": "Arizona College of Nursing - Chesapeake",

    "Address": "545 Belaire Avenue",

    "City": "Chesapeake",

    "StateAbbr": "VA",

    "State": "Virginia",

    "Zip": "23320-4686",

    "Phone": "8557068382",

    "Distance": null,

    "Latitude": "36.768088",

    "Longitude": "-76.240372",

    "SchoolDescription": null

  },

  "RecordCount": 1,

  "IsAutoCorrectionUsed": false,

  "SchoolOrProgram": "P",

  "Metadata": {

    "Publisher": "CareerOneStop publishes this API (www.careeronestop.org/Developers/WebAPI/web-api.aspx)",

    "Sponsor": "U.S. Department of Labor, Employment and Training Administration",

    "LastAccessDate": "2026-05-15T10:21:30",

    "CitationSuggested": "U.S. Department of Education, National Center for Education Statistics, Integrated Postsecondary Education Data System (IPEDS) (https://nces.ed.gov/ipeds/), Institutional Characteristics, and Completions. U.S. Department of Labor, Employment and Training Administration, ETP Performance Data (www.trainingproviderresults.gov/#!/about). Find more information including data update schedules at CareerOneStop's Data Sources (https://www.careeronestop.org/Help/data-sources.aspx).",

    "DataSource": [

      {

        "DataName": "Training data from NCES IPEDS",

        "DataSourceName": "U.S. Department of Education, National Center for Education Statistics, Integrated Postsecondary Education Data System (IPEDS) (https://nces.ed.gov/ipeds/), Institutional Characteristics, and Completions",

        "DataSourceUrl": "https://nces.ed.gov/ipeds/",

        "DataLastUpdate": "October 2024",

        "DataVintageOrVersion": "Institutional Characteristics 2023-24 and Completions 2022-23",

        "DataDescription": "IPEDS is a system of 12 interrelated survey components conducted annually that gathers data from every college, university, and technical and vocational institution that participates in the federal student financial aid programs. ",

        "DataSourceCitation": "IPEDS data are from U.S. Department of Education, National Center for Education Statistics, Integrated Postsecondary Education Data System (IPEDS) (https://nces.ed.gov/ipeds/), Institutional Characteristics, and Completions"

      },

      {

        "DataName": "Training data from US DOL ETP / WIOA",

        "DataSourceName": "U.S. Department of Labor, Employment and Training Administration, ETP Performance Data (www.trainingproviderresults.gov/#!/about)",

        "DataSourceUrl": "http://www.trainingproviderresults.gov/#!/about",

        "DataLastUpdate": "July 2024",

        "DataVintageOrVersion": "2023",

        "DataDescription": "Through the Workforce Innovation and Opportunity Act (WIOA), the federal government has made training more accessible for eligible individuals determined to be in need of training. Data from TrainingProviderResults.gov, includes all training programs eligible to be funded through WIOA.",

        "DataSourceCitation": "ETP/WIOA training data are from U.S. Department of Labor, Employment and Training Administration, ETP Performance Data (www.trainingproviderresults.gov/#!/about)."

      }

    ]

  }

}

<Program

xmlns:i="http://www.w3.org/2001/XMLSchema-instance"

xmlns="http://schemas.datacontract.org/2004/07/XPAND.CareerOneStop.WebApi.ViewModels.Training.Programs">

<IsAutoCorrectionUsed>false</IsAutoCorrectionUsed>

<Metadata

xmlns:d2p1="http://schemas.datacontract.org/2004/07/XPAND.CareerOneStop.WebApi.Core.MetaData">

<d2p1:CitationSuggested>U.S. Department of Education, National Center for Education Statistics, Integrated Postsecondary Education Data System (IPEDS) (https://nces.ed.gov/ipeds/), Institutional Characteristics, and Completions. U.S. Department of Labor, Employment and Training Administration, ETP Performance Data (www.trainingproviderresults.gov/#!/about). Find more information including data update schedules at CareerOneStop's Data Sources (https://www.careeronestop.org/Help/data-sources.aspx).</d2p1:CitationSuggested>

<d2p1:DataSource>

<d2p1:MetaDataSource>

<d2p1:DataDescription>IPEDS is a system of 12 interrelated survey components conducted annually that gathers data from every college, university, and technical and vocational institution that participates in the federal student financial aid programs. </d2p1:DataDescription>

<d2p1:DataLastUpdate>October 2024</d2p1:DataLastUpdate>

<d2p1:DataName>Training data from NCES IPEDS</d2p1:DataName>

<d2p1:DataSourceCitation>IPEDS data are from U.S. Department of Education, National Center for Education Statistics, Integrated Postsecondary Education Data System (IPEDS) (https://nces.ed.gov/ipeds/), Institutional Characteristics, and Completions</d2p1:DataSourceCitation>

<d2p1:DataSourceName>U.S. Department of Education, National Center for Education Statistics, Integrated Postsecondary Education Data System (IPEDS) (https://nces.ed.gov/ipeds/), Institutional Characteristics, and Completions</d2p1:DataSourceName>

<d2p1:DataSourceUrl>https://nces.ed.gov/ipeds/</d2p1:DataSourceUrl>

<d2p1:DataVintageOrVersion>Institutional Characteristics 2023-24 and Completions 2022-23</d2p1:DataVintageOrVersion>

</d2p1:MetaDataSource>

<d2p1:MetaDataSource>

<d2p1:DataDescription>Through the Workforce Innovation and Opportunity Act (WIOA), the federal government has made training more accessible for eligible individuals determined to be in need of training. Data from TrainingProviderResults.gov, includes all training programs eligible to be funded through WIOA.</d2p1:DataDescription>

<d2p1:DataLastUpdate>July 2024</d2p1:DataLastUpdate>

<d2p1:DataName>Training data from US DOL ETP / WIOA</d2p1:DataName>

<d2p1:DataSourceCitation>ETP/WIOA training data are from U.S. Department of Labor, Employment and Training Administration, ETP Performance Data (www.trainingproviderresults.gov/#!/about).</d2p1:DataSourceCitation>

<d2p1:DataSourceName>U.S. Department of Labor, Employment and Training Administration, ETP Performance Data (www.trainingproviderresults.gov/#!/about)</d2p1:DataSourceName>

<d2p1:DataSourceUrl>http://www.trainingproviderresults.gov/#!/about</d2p1:DataSourceUrl>

<d2p1:DataVintageOrVersion>2023</d2p1:DataVintageOrVersion>

</d2p1:MetaDataSource>

</d2p1:DataSource>

<d2p1:LastAccessDate>2026-05-15T10:23:56</d2p1:LastAccessDate>

<d2p1:Publisher>CareerOneStop publishes this API (www.careeronestop.org/Developers/WebAPI/web-api.aspx)</d2p1:Publisher>

<d2p1:Sponsor>U.S. Department of Labor, Employment and Training Administration</d2p1:Sponsor>

</Metadata>

<RecordCount>1</RecordCount>

<SchoolOrProgram>P</SchoolOrProgram>

<SchoolPrograms>

<Address>545 Belaire Avenue</Address>

<AwLevelCode>6</AwLevelCode>

<AwardLevel>Bachelor's degree, usually 4 years</AwardLevel>

<CipCode>513801</CipCode>

<CipTitle>Registered Nursing/Registered Nurse</CipTitle>

<City>Chesapeake</City>

<Credential i:nil="true"/>

<DataSource>N</DataSource>

<DetailId>129276513801</DetailId>

<Distance i:nil="true"/>

<EtaProgramName i:nil="true"/>

<Format

xmlns:d3p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">

<d3p1:string>In-person</d3p1:string>

</Format>

<Latitude>36.768088</Latitude>

<Longitude>-76.240372</Longitude>

<NumberCompleted

xmlns:d3p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">

<d3p1:string>4 years: 0</d3p1:string>

</NumberCompleted>

<OccupationsList

xmlns:d3p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">

<d3p1:string>Nursing Instructors and Teachers, Postsecondary</d3p1:string>

<d3p1:string>Registered Nurses</d3p1:string>

</OccupationsList>

<Phone>8557068382</Phone>

<ProgramDescription i:nil="true"/>

<ProgramHours i:nil="true"/>

<ProgramWeeks i:nil="true"/>

<SchoolDescription i:nil="true"/>

<SchoolIDUnique>500290</SchoolIDUnique>

<SchoolName>Arizona College of Nursing - Chesapeake</SchoolName>

<State>Virginia</State>

<StateAbbr>VA</StateAbbr>

<Zip>23320-4686</Zip>

</SchoolPrograms>

</Program>

Response Parameters

Name Description Type
SchoolPrograms School Programs Information Object
DetailId Program Detail Identifier(Unique ID for this record) Integer
CipCode Code for this program, from the CIP taxonomy String
CipTitle Title of this program, from the CIP taxonomy String
EtaProgramName Title of this program; only available for ETP WIOA programs. No taxonomy is used to validate, limit, enhance or in any way influence this field. String
Format Program Format(In-person,Online ,etc) Object
AwLevelCode Code associated with the award level, otherwise known as program length. Integer
AwardLevel Text corresponding to (and explaining) the AwLevelCode String
Credential Credential earned. Populated only for ETP / WIOA programs String
DataSource “W” or “Y” = source of this record is ETP WIOA String
NumberCompleted For each program length (a/k/a awardlevel), that text plus the number completed. Object
OccupationsList Occupations associated with CIP programs of this training program Object
ProgramWeeks Program Duration in Weeks Integer
ProgramHours Program Duration in Hours Integer
ProgramDescription Program Description String
SchoolIDUnique Unique school (provider) ID that you can use in Get Details endpoints (longer than “schoolId”) Integer
SchoolName Name of the training provider String
Address Street address of the provider. This and all other address fields are not necessarily the location of this particular training. String
City City String
StateAbbr State Abbreviation String
State Full state name String
Zip Zip Code String
Phone Phone Number String
Distance Distance from searched location String
Latitude Latitude Coordinate String
Longitude Longitude Coordinate String
SchoolDescription School Description String
RecordCount Count of results Integer
IsAutoCorrectionUsed Auto Correction Used Boolean
SchoolOrProgram School Or Program String
Metadata Information about the source of the API Object
Publisher Publisher of the API String
Sponsor Sponsor of the API String
LastAccessDate When the API was run, using UTC (ISO 8601) format String
CitationSuggested If you use this data, CareerOneStop suggests you use this citation. String
DataSource The data source object(s) Object
DataName Name of data String
DataSourceName Name of data source String
DataSourceUrl Url of data source String
DataLastUpdate Date when CareerOneStop last updated this data String
DataVintageOrVersion Version or vintage of the data String
DataDescription Description of the data String
DataSourceCitation Suggested citation for this data source String

Errors

Error/Status Code Description
 200
OK / Success. The request went through successfully and there is a response body.
 400
Bad Request (Request was invalid or missing parameters)
 401    
Unauthorized. This error occurs specifically when authentication is required and has failed or has not yet been provided correctly. (ex: Invalid API Token)
 404
This error will be shown in two scenarios 1) Not found - (An error occurred) and 2) Not found - (No data available)
 500
Internal Server Error. This error will occur when there is something critically wrong in the API call.