Skip to Content
CareerOneStop
Technical Information
API Explorer American Job Centers Apprenticeships Boards and Committees Certifications Employment Patterns Job Description Writer Jobs Labor Market Information Licenses Locations Occupations Occupations Reports Professional Associations ReEntry Programs Salaries Skills Gaps Skills Matcher State Resources Tools and Technology Training Unemployment Youth Programs

Get Occupation Details

GET
/v1/occupation/{userId}/{keyword}/{location}
Parameters
string


api token is required field
string


userId is required field
string

ex: Registered Nurses (ONET Title) or 29-1141.00 (ONET Code)

keyword is required field
string

City, State (Reston,Va) or State (VA) or Zipcode (20191) or National data (US, 0)

location is required field
boolean

ex: true or false

boolean

ex: true or false

boolean

ex: true or false

boolean

ex: true or false

boolean

ex: true or false

boolean

ex: true or false

boolean

ex: true or false

boolean

ex: true or false

boolean

ex: true or false

boolean

ex: true or false

boolean

ex: true or false

boolean

ex: true or false

boolean

ex: true or false

boolean

ex: true or false

boolean

ex: true or false

  TECHNICAL INFORMATION

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["training"] = "value";                        
            qs["interest"] = "value";                        
            qs["videos"] = "value";                        
            qs["tasks"] = "value";                        
            qs["dwas"] = "value";                        
            qs["wages"] = "value";                        
            qs["alternateOnetTitles"] = "value";                        
            qs["projectedEmployment"] = "value";                        
            qs["ooh"] = "value";                        
            qs["stateLMILinks"] = "value";                        
            qs["relatedOnetTitles"] = "value";                        
            qs["skills"] = "value";                        
            qs["knowledge"] = "value";                        
            qs["ability"] = "value";                        
            qs["trainingPrograms"] = "value";                        
            
            var uri = new UriBuilder(Uri.UriSchemeHttps, "api.careeronestop.org")
            {
                Path = "/v1/occupation/{userId}/{keyword}/{location}",
                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", "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("/v1/occupation/{userId}/{keyword}/{location}")
                .setParameter("training", "value")
                .setParameter("interest", "value")
                .setParameter("videos", "value")
                .setParameter("tasks", "value")
                .setParameter("dwas", "value")
                .setParameter("wages", "value")
                .setParameter("alternateOnetTitles", "value")
                .setParameter("projectedEmployment", "value")
                .setParameter("ooh", "value")
                .setParameter("stateLMILinks", "value")
                .setParameter("relatedOnetTitles", "value")
                .setParameter("skills", "value")
                .setParameter("knowledge", "value")
                .setParameter("ability", "value")
                .setParameter("trainingPrograms", "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 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();
	}
   }
}


Response Structure 
                        {
  "OccupationDetail": [
    {
      "OnetTitle": "string",
      "OnetCode": "string",
      "OnetDescription": "string",
      "Wages": {
        "NationalWagesList": [
          {
            "RateType": "string",
            "Pct10": "string",
            "Pct25": "string",
            "Median": "string",
            "Pct75": "string",
            "Pct90": "string",
            "StFips": "string",
            "Area": "string",
            "AreaName": "string"
          }
        ],
        "StateWagesList": [
          {
            "RateType": "string",
            "Pct10": "string",
            "Pct25": "string",
            "Median": "string",
            "Pct75": "string",
            "Pct90": "string",
            "StFips": "string",
            "Area": "string",
            "AreaName": "string"
          }
        ],
        "BLSAreaWagesList": [
          {
            "RateType": "string",
            "Pct10": "string",
            "Pct25": "string",
            "Median": "string",
            "Pct75": "string",
            "Pct90": "string",
            "StFips": "string",
            "Area": "string",
            "AreaName": "string"
          }
        ],
        "WageYear": "string",
        "SocData": "string",
        "SocWageInfo": {
          "SocCode": "string",
          "SocTitle": "string",
          "SocDescription": "string"
        }
      },
      "BrightOutlook": "string",
      "Green": "string",
      "COSVideoURL": "string",
      "EducationTraining": {
        "EducationType": [
          {
            "EducationLevel": "string",
            "Value": "string"
          }
        ],
        "EducationCode": "string",
        "EducationTitle": "string",
        "ExperienceCode": "string",
        "ExperienceTitle": "string",
        "TrainingCode": "string",
        "TrainingTitle": "string",
        "OccupationTitle": "string"
      },
      "BrightOutlookCategory": "string",
      "Tasks": [
        {
          "TaskDescription": "string",
          "TaskId": "string",
          "DataValue": "string"
        }
      ],
      "Dwas": [
        {
          "DwaTitle": "string",
          "DwaId": "string",
          "DataValue": "string",
          "TaskId": "string"
        }
      ],
      "AlternateTitles": [
        "string"
      ],
      "StFips": "string",
      "Location": "string",
      "Video": [
        {
          "VideoCode": "string",
          "VideoTitle": "string",
          "VideoType": "string"
        }
      ],
      "InterestDataList": [
        {
          "ElementId": "string",
          "ElementName": "string",
          "ElementDescription": "string",
          "DataValue": "string",
          "Importance": "string"
        }
      ],
      "SocInfo": {
        "SocCode": "string",
        "SocTitle": "string",
        "SocDescription": "string"
      },
      "Projections": {
        "EstimatedYear": "string",
        "ProjectedYear": "string",
        "OccupationTitle": "string",
        "Projections": [
          {
            "StateName": "string",
            "Stfips": "string",
            "EstimatedEmployment": "string",
            "ProjectedEmployment": "string",
            "PerCentChange": "string",
            "ProjectedAnnualJobOpening": "string",
            "EstimatedYear": "string",
            "ProjectedYear": "string"
          }
        ]
      },
      "OOHs": {
        "Title": "string",
        "OOHUrl": "string"
      },
      "StateResourcesLinks": {
        "StateWebResource": [
          {
            "Title": "string",
            "Url": "string",
            "Type": "string",
            "StateName": "string"
          }
        ]
      },
      "RelatedOnetTitles": [
        {
          "Key": "string",
          "Value": "string"
        }
      ],
      "SkillsDataList": [
        {
          "ElementId": "string",
          "ElementName": "string",
          "ElementDescription": "string",
          "DataValue": "string",
          "Importance": "string"
        }
      ],
      "KnowledgeDataList": [
        {
          "ElementId": "string",
          "ElementName": "string",
          "ElementDescription": "string",
          "DataValue": "string",
          "Importance": "string"
        }
      ],
      "AbilityDataList": [
        {
          "ElementId": "string",
          "ElementName": "string",
          "ElementDescription": "string",
          "DataValue": "string",
          "Importance": "string"
        }
      ],
      "TrainingPrograms": [
        "string"
      ]
    }
  ],
  "RecordCount": 1,
  "DidYouMean": "string",
  "AutoCorrection": "string"
}
                    
                        <OccupationProfile xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/XPAND.CareerOneStop.WebApi.ViewModels">
  <AutoCorrection>string</AutoCorrection>
  <DidYouMean>string</DidYouMean>
  <OccupationDetail>
    <OccupationProfileDetail>
      <AbilityDataList>
        <DataValues>
          <DataValue>string</DataValue>
          <ElementDescription>string</ElementDescription>
          <ElementId>string</ElementId>
          <ElementName>string</ElementName>
          <Importance>string</Importance>
        </DataValues>
      </AbilityDataList>
      <AlternateTitles xmlns:d4p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <d4p1:string>string</d4p1:string>
      </AlternateTitles>
      <BrightOutlook>string</BrightOutlook>
      <BrightOutlookCategory>string</BrightOutlookCategory>
      <COSVideoURL>string</COSVideoURL>
      <Dwas>
        <Dwa>
          <DataValue>string</DataValue>
          <DwaId>string</DwaId>
          <DwaTitle>string</DwaTitle>
          <TaskId>string</TaskId>
        </Dwa>
      </Dwas>
      <EducationTraining>
        <EducationCode>string</EducationCode>
        <EducationTitle>string</EducationTitle>
        <EducationType>
          <EducationType>
            <EducationLevel>string</EducationLevel>
            <Value>string</Value>
          </EducationType>
        </EducationType>
        <ExperienceCode>string</ExperienceCode>
        <ExperienceTitle>string</ExperienceTitle>
        <OccupationTitle>string</OccupationTitle>
        <TrainingCode>string</TrainingCode>
        <TrainingTitle>string</TrainingTitle>
      </EducationTraining>
      <Green>string</Green>
      <InterestDataList>
        <DataValues>
          <DataValue>string</DataValue>
          <ElementDescription>string</ElementDescription>
          <ElementId>string</ElementId>
          <ElementName>string</ElementName>
          <Importance>string</Importance>
        </DataValues>
      </InterestDataList>
      <KnowledgeDataList>
        <DataValues>
          <DataValue>string</DataValue>
          <ElementDescription>string</ElementDescription>
          <ElementId>string</ElementId>
          <ElementName>string</ElementName>
          <Importance>string</Importance>
        </DataValues>
      </KnowledgeDataList>
      <Location>string</Location>
      <OOHs>
        <OOHUrl>string</OOHUrl>
        <Title>string</Title>
      </OOHs>
      <OnetCode>string</OnetCode>
      <OnetDescription>string</OnetDescription>
      <OnetTitle>string</OnetTitle>
      <Projections>
        <EstimatedYear>string</EstimatedYear>
        <OccupationTitle>string</OccupationTitle>
        <ProjectedYear>string</ProjectedYear>
        <Projections>
          <Projections>
            <EstimatedEmployment>string</EstimatedEmployment>
            <EstimatedYear>string</EstimatedYear>
            <PerCentChange>string</PerCentChange>
            <ProjectedAnnualJobOpening>string</ProjectedAnnualJobOpening>
            <ProjectedEmployment>string</ProjectedEmployment>
            <ProjectedYear>string</ProjectedYear>
            <StateName>string</StateName>
            <Stfips>string</Stfips>
          </Projections>
        </Projections>
      </Projections>
      <RelatedOnetTitles xmlns:d4p1="http://schemas.datacontract.org/2004/07/System.Collections.Generic">
        <d4p1:KeyValuePairOfstringstring>
          <d4p1:key>string</d4p1:key>
          <d4p1:value>string</d4p1:value>
        </d4p1:KeyValuePairOfstringstring>
      </RelatedOnetTitles>
      <SkillsDataList>
        <DataValues>
          <DataValue>string</DataValue>
          <ElementDescription>string</ElementDescription>
          <ElementId>string</ElementId>
          <ElementName>string</ElementName>
          <Importance>string</Importance>
        </DataValues>
      </SkillsDataList>
      <SocInfo>
        <SocCode>string</SocCode>
        <SocDescription>string</SocDescription>
        <SocTitle>string</SocTitle>
      </SocInfo>
      <StFips>string</StFips>
      <StateResourcesLinks>
        <StateWebResource>
          <StateWebResource>
            <StateName>string</StateName>
            <Title>string</Title>
            <Type>string</Type>
            <Url>string</Url>
          </StateWebResource>
        </StateWebResource>
      </StateResourcesLinks>
      <Tasks>
        <Task>
          <DataValue>string</DataValue>
          <TaskDescription>string</TaskDescription>
          <TaskId>string</TaskId>
        </Task>
      </Tasks>
      <TrainingPrograms xmlns:d4p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <d4p1:string>string</d4p1:string>
      </TrainingPrograms>
      <Video>
        <Video>
          <VideoCode>string</VideoCode>
          <VideoTitle>string</VideoTitle>
          <VideoType>string</VideoType>
        </Video>
      </Video>
      <Wages>
        <BLSAreaWagesList>
          <WageDetails>
            <Area>string</Area>
            <AreaName>string</AreaName>
            <Median>string</Median>
            <Pct10>string</Pct10>
            <Pct25>string</Pct25>
            <Pct75>string</Pct75>
            <Pct90>string</Pct90>
            <RateType>string</RateType>
            <StFips>string</StFips>
          </WageDetails>
        </BLSAreaWagesList>
        <NationalWagesList>
          <WageDetails>
            <Area>string</Area>
            <AreaName>string</AreaName>
            <Median>string</Median>
            <Pct10>string</Pct10>
            <Pct25>string</Pct25>
            <Pct75>string</Pct75>
            <Pct90>string</Pct90>
            <RateType>string</RateType>
            <StFips>string</StFips>
          </WageDetails>
        </NationalWagesList>
        <SocData>string</SocData>
        <SocWageInfo>
          <SocCode>string</SocCode>
          <SocDescription>string</SocDescription>
          <SocTitle>string</SocTitle>
        </SocWageInfo>
        <StateWagesList>
          <WageDetails>
            <Area>string</Area>
            <AreaName>string</AreaName>
            <Median>string</Median>
            <Pct10>string</Pct10>
            <Pct25>string</Pct25>
            <Pct75>string</Pct75>
            <Pct90>string</Pct90>
            <RateType>string</RateType>
            <StFips>string</StFips>
          </WageDetails>
        </StateWagesList>
        <WageYear>string</WageYear>
      </Wages>
    </OccupationProfileDetail>
  </OccupationDetail>
  <RecordCount>1</RecordCount>
</OccupationProfile>