O*NET Web Services

https://services.onetcenter.org/reference
Admin
O*NET Web Services is a RESTful API providing access to comprehensive career and occupation data...
Tokens:524,160
Snippets:551
Trust Score:10
Update:5 months ago
Show doc for...
Tokens:
Raw
### Get Technology Examples by O*NET-SOC Code

Source: https://services.onetcenter.org/reference/mnm/career/technology

Retrieves a list of technology examples associated with a given O*NET-SOC code. This includes software titles, whether they are considered 'hot technologies' or 'in demand', and the percentage of job postings mentioning them.

```APIDOC
## GET /mnm/careers/_[O*NET-SOC Code]_ /technology

### Description
Retrieves examples of software and technologies used in a specific career, identified by its O*NET-SOC Code. The response includes details about each technology, such as its title, whether it's a 'hot technology' or 'in demand', and its percentage relevance.

### Method
GET

### Endpoint
/mnm/careers/_[O*NET-SOC Code]_ /technology

### Parameters
#### Path Parameters
- **O*NET-SOC Code** (string) - Required - The O*NET-SOC code for the career.

#### Query String Parameters
_(none)_

### Response
#### Success Response (200)
- **code** (integer) - The UNSPSC external site commodity code.
- **title** (string) - The title of the technology group.
- **example** (list of objects) - Optional. A list of specific software examples.
  - **title** (string) - The name of the software or technology.
  - **hot_technology** (boolean) - Optional. Indicates if the technology is frequently mentioned in job postings across all occupations.
  - **in_demand** (boolean) - Optional. Indicates if the technology is frequently mentioned in job postings for the requested occupation.
  - **percentage** (integer) - Optional. The percentage of job postings that mention this technology skill.

### Response Example
```json
[
  {
    "code": 43232604,
    "title": "Computer aided design CAD software",
    "example": [
      {
        "title": "Autodesk AutoCAD Civil 3D",
        "hot_technology": true,
        "in_demand": true,
        "percentage": 16
      },
      {
        "title": "Autodesk Revit",
        "hot_technology": true,
        "in_demand": true,
        "percentage": 7
      }
    ]
  }
]
```

### Notes
- This response returns examples of the software used in a career. This data may be unavailable for some careers.
- Technologies classified as “hot technologies” are marked with `hot_technology: true`.
- Technologies classified as “in demand” are marked with `in_demand: true`.
- The `percentage` property shows the percentage of job postings that mention this technology skill.
```

--------------------------------

### Get Technology Skills Summary

Source: https://services.onetcenter.org/reference/online/occupation/summary/technology

Retrieves a summary of technology skills for a given O*NET-SOC Code. This includes categorized technology examples, with indicators for hot and in-demand skills. Pagination is supported.

```APIDOC
## GET /online/occupations/_[O*NET-SOC Code]_/summary/technology_skills

### Description
Retrieves a summary of technology skills for a given O*NET-SOC Code. This includes categorized technology examples, with indicators for hot and in-demand skills. Pagination is supported.

### Method
GET

### Endpoint
https://api-v2.onetcenter.org/online/occupations/_[O*NET-SOC Code]_/summary/technology_skills

### Parameters
#### Path Parameters
- **O*NET-SOC Code** (string) - Required - The O*NET-SOC Code for the occupation.

#### Query String Parameters
- **start** (integer) - Optional - Index of the first returned result. Defaults to 1.
- **end** (integer) - Optional - Index of the last returned result. Defaults to start + 4.

### Response
#### Success Response (200)
- **start** (integer) - The starting index of the current page of results.
- **end** (integer) - The ending index of the current page of results.
- **total** (integer) - The total number of technology skills available for the occupation.
- **next** (string) - URL for the next page of results, if available.
- **hot_technology** (object) - Information about hot technologies.
  - **total** (integer) - Total count of hot technologies.
  - **href** (string) - Link to the hot technologies endpoint for this occupation.
- **in_demand_skills** (object) - Information about in-demand skills.
  - **total** (integer) - Total count of in-demand skills.
  - **href** (string) - Link to the in-demand skills endpoint for this occupation.
- **category** (list of objects) - A list of technology skill categories.
  - **code** (integer) - The unique code for the technology skill category.
  - **related** (string) - Link to related occupations for this technology skill category.
  - **title** (string) - The name of the technology skill category.
  - **example** (list of objects) - Initial examples of technologies within this category.
    - **title** (string) - The name of the technology example.
    - **href** (string) - Link to detailed information about the technology example.
    - **hot_technology** (boolean) - Indicates if this is a hot technology.
    - **in_demand** (boolean) - Indicates if this is an in-demand skill.
    - **percentage** (integer) - Percentage relevance or usage.
  - **example_more** (list of objects) - Additional examples of technologies within this category.
    - **title** (string) - The name of the technology example.
    - **href** (string) - Link to detailed information about the technology example.
    - **hot_technology** (boolean) - Indicates if this is a hot technology.
    - **in_demand** (boolean) - Indicates if this is an in-demand skill.
    - **percentage** (integer) - Percentage relevance or usage.

### Response Example
```json
{
  "start": 1,
  "end": 5,
  "total": 23,
  "next": "https://api-v2.onetcenter.org/online/occupations/17-2051.00/summary/technology_skills?start=6&end=10",
  "hot_technology": {
    "total": 24,
    "href": "https://api-v2.onetcenter.org/online/occupations/17-2051.00/hot_technology"
  },
  "in_demand_skills": {
    "total": 24,
    "href": "https://api-v2.onetcenter.org/online/occupations/17-2051.00/summary/in_demand_skills"
  },
  "category": [
    {
      "code": 43232604,
      "related": "https://api-v2.onetcenter.org/online/occupations/17-2051.00/related/technology_skills/43232604",
      "title": "Computer aided design CAD software",
      "example": [
        {
          "title": "Autodesk AutoCAD Civil 3D",
          "href": "https://api-v2.onetcenter.org/online/hot_technology/Autodesk%20AutoCAD%20Civil%203D",
          "hot_technology": true,
          "in_demand": true,
          "percentage": 16
        }
      ],
      "example_more": [
        {
          "title": "Autodesk AutoCAD",
          "href": "https://api-v2.onetcenter.org/online/hot_technology/Autodesk%20AutoCAD",
          "hot_technology": true,
          "in_demand": true,
          "percentage": 22
        }
      ]
    }
  ]
}
```
```

--------------------------------

### Example API Request for Matching Careers

Source: https://services.onetcenter.org/reference/mpp/ip/ip_careers

This is an example of how to call the careers endpoint using a string of answers from the Interest Profiler. Ensure the answers string is correctly formatted as per the Questions documentation.

```http
https://api-v2.onetcenter.org/mpp/interestprofiler/careers?answers=_[answer string]_
```

--------------------------------

### Get Technology Skills by Occupation

Source: https://services.onetcenter.org/reference/online/occupation/details/technology

Fetches technology skills details for a given O*NET-SOC Code. The response includes categorized skills, examples, and indicators for hot or in-demand technologies. Pagination is supported via 'start' and 'end' query parameters.

```APIDOC
## GET /online/occupations/_[O*NET-SOC Code]_/details/technology_skills

### Description
Retrieves a list of technology skills associated with a specific occupation, categorized and with examples. It also indicates if skills are considered 'hot technologies' or 'in demand'.

### Method
GET

### Endpoint
https://api-v2.onetcenter.org/online/occupations/_[O*NET-SOC Code]_/details/technology_skills

### Parameters
#### Path Parameters
- **O*NET-SOC Code** (string) - Required - The O*NET-SOC code for the occupation.

#### Query Parameters
- **start** (integer) - Optional - The starting index for the results. Defaults to 1.
- **end** (integer) - Optional - The ending index for the results. Defaults to start + 9.

### Response
#### Success Response (200)
- **start** (integer) - The starting index of the returned results.
- **end** (integer) - The ending index of the returned results.
- **total** (integer) - The total number of results available.
- **next** (string) - URL for the next page of results, if available.
- **hot_technology** (object) - Information about hot technologies.
  - **total** (integer) - Total count of hot technologies.
  - **href** (string) - Link to the hot technologies endpoint.
- **in_demand_skills** (object) - Information about in-demand skills.
  - **total** (integer) - Total count of in-demand skills.
  - **href** (string) - Link to the in-demand skills endpoint.
- **category** (list of objects) - A list of technology skill categories.
  - **code** (integer) - The code for the skill category.
  - **related** (string) - Link to related occupations for this technology skill.
  - **title** (string) - The name of the technology skill category.
  - **example** (list of objects) - Examples of specific technologies within the category.
    - **title** (string) - The name of the technology example.
    - **href** (string) - Link to details about the technology example.
    - **hot_technology** (boolean) - Indicates if this is a hot technology.
    - **in_demand** (boolean) - Indicates if this skill is in demand.
    - **percentage** (integer) - Percentage associated with the skill.
  - **example_more** (list of objects) - Additional examples of specific technologies within the category.
    - **title** (string) - The name of the technology example.
    - **href** (string) - Link to details about the technology example.
    - **hot_technology** (boolean) - Indicates if this is a hot technology.
    - **in_demand** (boolean) - Indicates if this skill is in demand.
    - **percentage** (integer) - Percentage associated with the skill.

### Request Example
```json
{
  "start": 1,
  "end": 10,
  "total": 23,
  "next": "https://api-v2.onetcenter.org/online/occupations/17-2051.00/details/technology_skills?start=11&end=20",
  "hot_technology": {
    "total": 24,
    "href": "https://api-v2.onetcenter.org/online/occupations/17-2051.00/hot_technology"
  },
  "in_demand_skills": {
    "total": 24,
    "href": "https://api-v2.onetcenter.org/online/occupations/17-2051.00/details/in_demand_skills"
  },
  "category": [
    {
      "code": 43232604,
      "related": "https://api-v2.onetcenter.org/online/occupations/17-2051.00/related/technology_skills/43232604",
      "title": "Computer aided design CAD software",
      "example": [
        {
          "title": "Autodesk AutoCAD Civil 3D",
          "href": "https://api-v2.onetcenter.org/online/hot_technology/Autodesk%20AutoCAD%20Civil%203D",
          "hot_technology": true,
          "in_demand": true,
          "percentage": 16
        }
      ],
      "example_more": [
        {
          "title": "Autodesk AutoCAD",
          "href": "https://api-v2.onetcenter.org/online/hot_technology/Autodesk%20AutoCAD",
          "hot_technology": true,
          "in_demand": true,
          "percentage": 22
        }
      ]
    }
  ]
}
```
```

--------------------------------

### Get Occupation Details

Source: https://services.onetcenter.org/reference/openapi.json

Retrieves detailed information about a specific occupation using its ID. Includes summary, examples, and related occupations.

```APIDOC
## GET /v1/details/occupation/{id}

### Description
Retrieves detailed information about a specific occupation, including its summary, examples, and related occupations.

### Method
GET

### Endpoint
/v1/details/occupation/{id}

### Parameters
#### Path Parameters
- **id** (string) - Required - The unique identifier for the occupation (e.g., "4.C.123456").

#### Header Parameters
- **X-API-Key** (string) - Required - Your O*NET Web Services API Key.

#### Query Parameters
- **sort** (string) - Optional - Specifies the sorting order for occupation results. Allowed values: "context", "title", "code".

### Response
#### Success Response (200)
- **start** (integer) - The starting index of the results.
- **end** (integer) - The ending index of the results.
- **total** (integer) - The total number of results available.
- **summary** (object) - Contains summary information about the occupation.
  - **id** (string) - The occupation ID.
  - **name** (string) - The name of the occupation.
  - **description** (string) - A description of the occupation.
- **occupation** (array) - An array of occupation details.
  - **href** (string) - URL to the occupation details.
  - **code** (string) - The occupation code.
  - **title** (string) - The title of the occupation.
  - **tags** (object) - Tags associated with the occupation.
    - **bright_outlook** (boolean) - Indicates if the occupation has a bright outlook.
  - **job_zone** (object) - Information about the job zone.
    - **code** (integer) - The job zone code.
    - **title** (string) - The job zone title.
  - **context** (integer) - Contextual information for the occupation.

#### Error Responses
- **401** - Unauthorized: Invalid or missing API Key.
- **422** - Parameter Error: Invalid request parameters.
```

--------------------------------

### Search Technology Skills by Keyword

Source: https://services.onetcenter.org/reference/online/advanced/t2

Use this endpoint to find technology skills relevant to a given keyword or phrase. Results are paginated and sorted by relevance. The response includes a list of example technology skills, each with a title and a direct link.

```json
{
  "start": 1,
  "end": 20,
  "total": 3022,
  "next": "https://api-v2.onetcenter.org/online/technology/examples/search?keyword=construction%20management&start=21&end=40",
  "example": [
    {
      "title": "Integrated construction management software",
      "href": "https://api-v2.onetcenter.org/online/technology/examples/Integrated%20construction%20management%20software"
    },
    {
      "title": "Construction Management Software ProEst",
      "href": "https://api-v2.onetcenter.org/online/technology/examples/Construction%20Management%20Software%20ProEst"
    },
    ...
  ]
}
```

--------------------------------

### Get Apprenticeship Opportunities

Source: https://services.onetcenter.org/reference/openapi.json

Retrieves apprenticeship opportunities for a specific occupation code. This endpoint allows for pagination using 'start' and 'end' parameters.

```APIDOC
## GET /online/occupations/{code}/details/apprenticeship

### Description
Apprenticeship Opportunities occupation report. Retrieves apprenticeship opportunities for a specific occupation code. This endpoint allows for pagination using 'start' and 'end' parameters.

### Method
GET

### Endpoint
/online/occupations/{code}/details/apprenticeship

### Parameters
#### Header Parameters
- **X-API-Key** (string) - Required - O*NET Web Services API Key

#### Path Parameters
- **code** (string) - Required - O*NET-SOC code. Must match the pattern \d\d-\d\d\d\d\.\d\d.

#### Query Parameters
- **start** (integer) - Optional - Index of first returned result. Defaults to 1.
- **end** (integer) - Optional - Index of last returned result.

### Response
#### Success Response (200)
- **start** (integer) - The starting index of the returned results.
- **end** (integer) - The ending index of the returned results.
- **total** (integer) - The total number of results available.
- **prev** (string) - A URL to the previous page of results, if available.
- **next** (string) - A URL to the next page of results, if available.
- **example_title** (array) - An array of apprenticeship opportunity titles.

#### Response Example
```json
{
  "start": 1,
  "end": 10,
  "total": 25,
  "prev": "/online/occupations/17-2051.01/details/apprenticeship?start=0&end=9",
  "next": "/online/occupations/17-2051.01/details/apprenticeship?start=11&end=20",
  "example_title": [
    "Architectural Drafter",
    "Construction Drafter"
  ]
}
```
```

--------------------------------

### Example JSON Response for Matching Careers

Source: https://services.onetcenter.org/reference/mnm/ip/ip_careers

This is an example of the JSON response when querying for matching careers. It includes pagination details and a list of careers with their codes, titles, and fit levels.

```json
{
  "start": 1,
  "end": 20,
  "total": 38,
  "next": "https://api-v2.onetcenter.org/mnm/interestprofiler/careers?answers=553421321134342523523523254115342111351145453111231155343444&start=21&end=38",
  "career": [
    {
      "href": "https://api-v2.onetcenter.org/mnm/careers/27-2031.00/",
      "code": "27-2031.00",
      "title": "Dancers",
      "tags": {
        "bright_outlook": true
      },
      "fit": "Best"
    },
    {
      "href": "https://api-v2.onetcenter.org/mnm/careers/39-5094.00/",
      "code": "39-5094.00",
      "title": "Skincare Specialists",
      "tags": {
        "bright_outlook": true
      },
      "fit": "Best"
    },
    ...
  ]
}
```

--------------------------------

### O*NET API Technology Response Example

Source: https://services.onetcenter.org/reference/veterans/career/technology

This JSON structure represents the data returned by the technology endpoint, listing software examples for a given career code. It includes UNSPSC codes, titles, and optional details about whether a technology is 'hot' or 'in-demand'.

```json
[
  {
    "code": 43232604,
    "title": "Computer aided design CAD software",
    "example": [
      {
        "title": "Autodesk AutoCAD Civil 3D",
        "hot_technology": true,
        "in_demand": true,
        "percentage": 16
      },
      {
        "title": "Autodesk Revit",
        "hot_technology": true,
        "in_demand": true,
        "percentage": 7
      }
    ]
  },
  ...
]
```

--------------------------------

### Get Skills Summary

Source: https://services.onetcenter.org/reference/online/occupation/summary/skills

Fetches a paginated list of skills for a given occupation. The results can be controlled using 'start' and 'end' query parameters.

```APIDOC
## GET /online/occupations/_[O*NET-SOC Code]_/summary/skills

### Description
Retrieves a summary of skills for a specified occupation.

### Method
GET

### Endpoint
/online/occupations/_[O*NET-SOC Code]_/summary/skills

### Parameters
#### Path Parameters
- **O*NET-SOC Code** (string) - Required - The O*NET-SOC Code for the occupation.

#### Query String Parameters
- **start** (integer) - Optional - Index of the first returned result. Defaults to 1.
- **end** (integer) - Optional - Index of the last returned result. Defaults to start + 4.

### Response
#### Success Response (200)
- **start** (integer) - The starting index of the returned results.
- **end** (integer) - The ending index of the returned results.
- **total** (integer) - The total number of results available.
- **next** (string) - URL for the next page of results.
- **element** (list of objects) - A list of skill objects.
  - **id** (string) - The unique identifier for the skill.
  - **related** (string) - A URL to related occupations for this skill.
  - **name** (string) - The name of the skill.
  - **description** (string) - A detailed description of the skill.

### Request Example
(No request body for GET requests)

### Response Example
{
  "start": 1,
  "end": 5,
  "total": 22,
  "next": "https://api-v2.onetcenter.org/online/occupations/17-2051.00/summary/skills?start=6&end=10",
  "element": [
    {
      "id": "2.A.1.b",
      "related": "https://api-v2.onetcenter.org/online/occupations/17-2051.00/related/skills/2.A.1.b",
      "name": "Active Listening",
      "description": "Giving full attention to what other people are saying, taking time to understand the points being made, asking questions as appropriate, and not interrupting at inappropriate times."
    },
    {
      "id": "2.B.2.i",
      "related": "https://api-v2.onetcenter.org/online/occupations/17-2051.00/related/skills/2.B.2.i",
      "name": "Complex Problem Solving",
      "description": "Identifying complex problems and reviewing related information to develop and evaluate options and implement solutions."
    }
  ]
}
```

--------------------------------

### Get Tasks Summary

Source: https://services.onetcenter.org/reference/online/occupation/summary/tasks

Fetches a summary of tasks for a given O*NET-SOC Code. Results are paginated, with default values for start and end indices.

```APIDOC
## GET /online/occupations/_[O*NET-SOC Code]_/summary/tasks

### Description
Retrieves a summary of tasks for a specific occupation identified by its O*NET-SOC Code. This endpoint returns paginated results, allowing users to fetch tasks in chunks.

### Method
GET

### Endpoint
/online/occupations/_[O*NET-SOC Code]_/summary/tasks

### Parameters
#### Path Parameters
- **O*NET-SOC Code** (string) - Required - The unique O*NET-SOC Code for the occupation.

#### Query String Parameters
- **start** (integer) - Optional - Defaults to 1. The index of the first returned result.
- **end** (integer) - Optional - Defaults to start + 4. The index of the last returned result.

### Response
#### Success Response (200)
- **start** (integer) - The starting index of the returned results.
- **end** (integer) - The ending index of the returned results.
- **total** (integer) - The total number of tasks available for the occupation.
- **next** (string) - URL for the next page of results, if available.
- **task** (list of objects) - A list of task objects, where each object contains:
  - **id** (string) - The unique identifier for the task.
  - **related** (string) - A URL linking to related tasks for other occupations.
  - **title** (string) - The description of the task.

### Request Example
(No request body is applicable for GET requests)

### Response Example
```json
{
  "start": 1,
  "end": 5,
  "total": 17,
  "next": "https://api-v2.onetcenter.org/online/occupations/17-2051.00/summary/tasks?start=6&end=10",
  "task": [
    {
      "id": "19610",
      "related": "https://api-v2.onetcenter.org/online/occupations/17-2051.00/related/tasks/19610",
      "title": "Direct engineering activities, ensuring compliance with environmental, safety, or other governmental regulations."
    },
    {
      "id": "20490",
      "related": "https://api-v2.onetcenter.org/online/occupations/17-2051.00/related/tasks/20490",
      "title": "Manage and direct the construction, operations, or maintenance activities at project site."
    }
  ]
}
```
```

--------------------------------

### Browse by Basic Skills

Source: https://services.onetcenter.org/reference/openapi.json

Retrieves a list of basic skills. Requires an API key for authentication.

```APIDOC
## GET /online/onet_data/skills_basic/

### Description
Browse by Basic Skills. This endpoint retrieves a list of basic skills.

### Method
GET

### Endpoint
/online/onet_data/skills_basic/

### Parameters
#### Header Parameters
- **X-API-Key** (string) - Required - O*NET Web Services API Key

### Response
#### Success Response (200)
- **href** (string) - Description of the skill link.
- **id** (string) - The unique identifier for the skill.
- **name** (string) - The name of the skill.
- **description** (string) - A description of the skill.
- **child** (array) - An array of child skills, if any.

#### Response Example
{
  "example": "[\n  {\n    \"href\": \"/online/onet_data/skills_basic/111/\",\n    \"id\": \"111\",\n    \"name\": \"Active Listening\",\n    \"description\": \"Giving full attention to what other people are saying, taking time to understand the points being made, asking questions as appropriate, and not interrupting at inappropriate times.\",\n    \"child\": []\n  }\n]"
```

--------------------------------

### Get Work Context Summary

Source: https://services.onetcenter.org/reference/online/occupation/summary/work_context

Fetches the work context summary for a specific occupation. Results are paginated, with default values for start and end indices.

```APIDOC
## GET /online/occupations/_[O*NET-SOC Code]_/summary/work_context

### Description
Retrieves a summary of work context descriptors for a given occupation.

### Method
GET

### Endpoint
/online/occupations/_[O*NET-SOC Code]_/summary/work_context

### Parameters
#### Path Parameters
- **O*NET-SOC Code** (string) - Required - The O*NET-SOC Code for the occupation.

#### Query Parameters
- **start** (integer) - Optional - Index of the first returned result. Defaults to 1.
- **end** (integer) - Optional - Index of the last returned result. Defaults to start + 4.

### Response
#### Success Response (200)
- **start** (integer) - The starting index of the returned results.
- **end** (integer) - The ending index of the returned results.
- **total** (integer) - The total number of results available.
- **next** (string) - URL for the next page of results, if available.
- **element** (list of objects) - A list of work context descriptors.
  - **id** (string) - The unique identifier for the work context descriptor.
  - **related** (string) - A URL linking to related occupations for this descriptor.
  - **name** (string) - The name of the work context descriptor (e.g., "E-Mail").
  - **description** (string) - A description of the work context descriptor.
  - **response** (list of objects) - Survey response data for the descriptor.
    - **percentage_of_respondents** (integer) - The percentage of respondents who selected this response.
    - **description** (string) - The description of the response (e.g., "Every day").

### Request Example
(No request body for GET requests)

### Response Example
{
  "start": 1,
  "end": 5,
  "total": 21,
  "next": "https://api-v2.onetcenter.org/online/occupations/17-2051.00/summary/work_context?start=6&end=10",
  "element": [
    {
      "id": "4.C.1.a.2.h",
      "related": "https://api-v2.onetcenter.org/online/occupations/17-2051.00/related/work_context/4.C.1.a.2.h",
      "name": "E-Mail",
      "description": "How frequently does your job require you to use E-mail?",
      "response": [
        {
          "percentage_of_respondents": 100,
          "description": "Every day"
        }
      ]
    },
    {
      "id": "4.C.1.a.2.f",
      "related": "https://api-v2.onetcenter.org/online/occupations/17-2051.00/related/work_context/4.C.1.a.2.f",
      "name": "Telephone Conversations",
      "description": "How often do you have telephone conversations in this job?",
      "response": [
        {
          "percentage_of_respondents": 90,
          "description": "Every day"
        }
      ]
    }
  ]
}
```

--------------------------------

### Get Military Career Summaries

Source: https://services.onetcenter.org/reference/online/occupation/details/military_career_summaries

Fetches military career summaries for a given O*NET-SOC Code. Results are paginated and can be filtered by start and end indices.

```APIDOC
## GET /online/occupations/_[O*NET-SOC Code]_/details/military_career_summaries

### Description
Retrieves a list of military career summaries for a specified O*NET-SOC Code. This endpoint is particularly useful for military-specific occupations (O*NET-SOC codes beginning with 55) and provides links to external career summary resources.

### Method
GET

### Endpoint
https://api-v2.onetcenter.org/online/occupations/_[O*NET-SOC Code]_/details/military_career_summaries

### Parameters
#### Path Parameters
- **O*NET-SOC Code** (string) - Required - The O*NET-SOC code for the occupation.

#### Query String Parameters
- **start** (integer) - Optional - Index of the first returned result. Defaults to 1.
- **end** (integer) - Optional - Index of the last returned result. Defaults to start + 9.

### Response
#### Success Response (200)
- **start** (integer) - The starting index of the returned results.
- **end** (integer) - The ending index of the returned results.
- **total** (integer) - The total number of available results.
- **career_summary** (list of objects) - A list of military career summaries. Each object contains:
  - **url** (string) - The URL to the detailed career summary on an external site.
  - **title** (string) - The title of the military career summary.

### Request Example
```json
{
  "start": 1,
  "end": 9,
  "total": 9,
  "career_summary": [
    {
      "url": "https://www.careersinthemilitary.com/career-detail/0006.00/",
      "title": "Air Crew Members"
    },
    {
      "url": "https://www.careersinthemilitary.com/career-detail/0012.00/",
      "title": "Aircraft Mechanics"
    }
  ]
}
```
```

--------------------------------

### Search Careers by Keyword

Source: https://services.onetcenter.org/reference/mnm/search

Use this endpoint to search for careers by a keyword, phrase, title, or O*NET-SOC code. Results are sorted by relevance and paginated.

```json
{
  "start": 1,
  "end": 20,
  "total": 61,
  "next": "https://api-v2.onetcenter.org/mnm/search?keyword=architect&start=21&end=40",
  "career": [
    {
      "href": "https://api-v2.onetcenter.org/mnm/careers/17-1011.00/",
      "code": "17-1011.00",
      "title": "Architects",
      "tags": {}
    },
    {
      "href": "https://api-v2.onetcenter.org/mnm/careers/17-3011.00/",
      "code": "17-3011.00",
      "title": "Architectural & Civil Drafters",
      "tags": {}
    },
    ...
  ]
}
```

--------------------------------

### Abilities Hierarchy Example

Source: https://services.onetcenter.org/reference/online/data/abilities

This JSON response provides the hierarchy of abilities from the O*NET Content Model. Each child property lists more-detailed elements nested under a more general category.

```json
[
  {
    "id": "1.A.1",
    "name": "Cognitive Abilities",
    "description": "Abilities that influence the acquisition and application of knowledge in problem solving",
    "child": [
      {
        "id": "1.A.1.g",
        "name": "Attentiveness",
        "description": "Abilities related to application of attention",
        "child": [
          {
            "id": "1.A.1.g.1",
            "name": "Selective Attention",
            "description": "The ability to concentrate on a task over a period of time without being distracted.",
            "href": "https://api-v2.onetcenter.org/online/onet_data/abilities/1.A.1.g.1"
          },
          ...
        ]
      },
      ...
    ]
  },
  ...
]
```
Tokens:
Raw