--- title: "Job transitions matrix" method: POST path: "/transitions/{sourceFacet}/{destinationFacet}" tags: ["Transitions", "Internal"] --- # Job transitions matrix `POST /transitions/{sourceFacet}/{destinationFacet}` ## Request - Base URL: `https://api.lightcast.io/uk-profiles` - URL: `https://api.lightcast.io/uk-profiles/transitions/{sourceFacet}/{destinationFacet}` - Auth: OAuth 2 - Client credentials - Token URL: `https://auth.emsicloud.com/connect/token` scopes: `profiles:uk` Get a matrix of job transitions from facet to facet. ## Path parameters - `sourceFacet` 'company' | 'company_name' | 'lot_career_area' | 'lot_career_area_name' | 'lot_occupation' | 'lot_occupation_group' | 'lot_occupation_group_name' | 'lot_occupation_name' | 'lot_specialized_occupation' | 'lot_specialized_occupation_name' | 'soc1' | 'soc2' | 'soc3' | 'soc4', required - `destinationFacet` 'company' | 'company_name' | 'lot_career_area' | 'lot_career_area_name' | 'lot_occupation' | 'lot_occupation_group' | 'lot_occupation_group_name' | 'lot_occupation_name' | 'lot_specialized_occupation' | 'lot_specialized_occupation_name' | 'soc1' | 'soc2' | 'soc3' | 'soc4', required ## Query parameters - `uksoc_standard_version` '2020.0.0' | '2010.0.0' - `soc_version` 'uk_soc2010emsi' | 'uk_soc_2020' - `title_version` 'emsi' - `company_version` 'emsi_company' - `lot_version` string - `newTaxonomyVersions` true | false ## Request body - object - `source` object, required: Filter and limit the jobs people come from during job transitions. - `filter` object - `company` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - string[] - object - `include` string[]: List of values to include in the filter. - `exclude` string[]: List of values to exclude from the filter. - `include_op` 'and' | 'or' | 'AND' | 'OR': Logical operator used when scanning profiles for inclusive filtering; whether to filter for profiles matching any of the given values (`or`) or all of the given values (`and`). - `exclude_op` 'and' | 'or' | 'AND' | 'OR': Logical operator used when scanning profiles for exclusive filtering; whether to filter for profiles matching any of the given values (`or`) or all of the given values (`and`). - `company_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - string[] - object - `include` string[]: List of values to include in the filter. - `exclude` string[]: List of values to exclude from the filter. - `include_op` 'and' | 'or' | 'AND' | 'OR': Logical operator used when scanning profiles for inclusive filtering; whether to filter for profiles matching any of the given values (`or`) or all of the given values (`and`). - `exclude_op` 'and' | 'or' | 'AND' | 'OR': Logical operator used when scanning profiles for exclusive filtering; whether to filter for profiles matching any of the given values (`or`) or all of the given values (`and`). - `soc1` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta). - string[] - object - `include` string[]: List of values to include in the filter. - `exclude` string[]: List of values to exclude from the filter. - `include_op` 'and' | 'or' | 'AND' | 'OR': Logical operator used when scanning profiles for inclusive filtering; whether to filter for profiles matching any of the given values (`or`) or all of the given values (`and`). - `exclude_op` 'and' | 'or' | 'AND' | 'OR': Logical operator used when scanning profiles for exclusive filtering; whether to filter for profiles matching any of the given values (`or`) or all of the given values (`and`). - `soc2` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta). - string[] - object - `include` string[]: List of values to include in the filter. - `exclude` string[]: List of values to exclude from the filter. - `include_op` 'and' | 'or' | 'AND' | 'OR': Logical operator used when scanning profiles for inclusive filtering; whether to filter for profiles matching any of the given values (`or`) or all of the given values (`and`). - `exclude_op` 'and' | 'or' | 'AND' | 'OR': Logical operator used when scanning profiles for exclusive filtering; whether to filter for profiles matching any of the given values (`or`) or all of the given values (`and`). - `soc3` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta). - string[] - object - `include` string[]: List of values to include in the filter. - `exclude` string[]: List of values to exclude from the filter. - `include_op` 'and' | 'or' | 'AND' | 'OR': Logical operator used when scanning profiles for inclusive filtering; whether to filter for profiles matching any of the given values (`or`) or all of the given values (`and`). - `exclude_op` 'and' | 'or' | 'AND' | 'OR': Logical operator used when scanning profiles for exclusive filtering; whether to filter for profiles matching any of the given values (`or`) or all of the given values (`and`). - `soc4` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta). - string[] - object - `include` string[]: List of values to include in the filter. - `exclude` string[]: List of values to exclude from the filter. - `include_op` 'and' | 'or' | 'AND' | 'OR': Logical operator used when scanning profiles for inclusive filtering; whether to filter for profiles matching any of the given values (`or`) or all of the given values (`and`). - `exclude_op` 'and' | 'or' | 'AND' | 'OR': Logical operator used when scanning profiles for exclusive filtering; whether to filter for profiles matching any of the given values (`or`) or all of the given values (`and`). - `lot_career_area` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - union[] - union - string - integer - object - `include` string[]: List of values to include in the filter. - `exclude` string[]: List of values to exclude from the filter. - `include_op` 'and' | 'or' | 'AND' | 'OR': Logical operator used when scanning profiles for inclusive filtering; whether to filter for profiles matching any of the given values (`or`) or all of the given values (`and`). - `exclude_op` 'and' | 'or' | 'AND' | 'OR': Logical operator used when scanning profiles for exclusive filtering; whether to filter for profiles matching any of the given values (`or`) or all of the given values (`and`). - `lot_career_area_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - string[] - object - `include` string[]: List of values to include in the filter. - `exclude` string[]: List of values to exclude from the filter. - `include_op` 'and' | 'or' | 'AND' | 'OR': Logical operator used when scanning profiles for inclusive filtering; whether to filter for profiles matching any of the given values (`or`) or all of the given values (`and`). - `exclude_op` 'and' | 'or' | 'AND' | 'OR': Logical operator used when scanning profiles for exclusive filtering; whether to filter for profiles matching any of the given values (`or`) or all of the given values (`and`). - `lot_occupation` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - union[] - union - string - integer - object - `include` string[]: List of values to include in the filter. - `exclude` string[]: List of values to exclude from the filter. - `include_op` 'and' | 'or' | 'AND' | 'OR': Logical operator used when scanning profiles for inclusive filtering; whether to filter for profiles matching any of the given values (`or`) or all of the given values (`and`). - `exclude_op` 'and' | 'or' | 'AND' | 'OR': Logical operator used when scanning profiles for exclusive filtering; whether to filter for profiles matching any of the given values (`or`) or all of the given values (`and`). - `lot_occupation_group` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - union[] - union - string - integer - object - `include` string[]: List of values to include in the filter. - `exclude` string[]: List of values to exclude from the filter. - `include_op` 'and' | 'or' | 'AND' | 'OR': Logical operator used when scanning profiles for inclusive filtering; whether to filter for profiles matching any of the given values (`or`) or all of the given values (`and`). - `exclude_op` 'and' | 'or' | 'AND' | 'OR': Logical operator used when scanning profiles for exclusive filtering; whether to filter for profiles matching any of the given values (`or`) or all of the given values (`and`). - `lot_occupation_group_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - string[] - object - `include` string[]: List of values to include in the filter. - `exclude` string[]: List of values to exclude from the filter. - `include_op` 'and' | 'or' | 'AND' | 'OR': Logical operator used when scanning profiles for inclusive filtering; whether to filter for profiles matching any of the given values (`or`) or all of the given values (`and`). - `exclude_op` 'and' | 'or' | 'AND' | 'OR': Logical operator used when scanning profiles for exclusive filtering; whether to filter for profiles matching any of the given values (`or`) or all of the given values (`and`). - `lot_occupation_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - string[] - object - `include` string[]: List of values to include in the filter. - `exclude` string[]: List of values to exclude from the filter. - `include_op` 'and' | 'or' | 'AND' | 'OR': Logical operator used when scanning profiles for inclusive filtering; whether to filter for profiles matching any of the given values (`or`) or all of the given values (`and`). - `exclude_op` 'and' | 'or' | 'AND' | 'OR': Logical operator used when scanning profiles for exclusive filtering; whether to filter for profiles matching any of the given values (`or`) or all of the given values (`and`). - `lot_specialized_occupation` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - union[] - union - string - integer - object - `include` string[]: List of values to include in the filter. - `exclude` string[]: List of values to exclude from the filter. - `include_op` 'and' | 'or' | 'AND' | 'OR': Logical operator used when scanning profiles for inclusive filtering; whether to filter for profiles matching any of the given values (`or`) or all of the given values (`and`). - `exclude_op` 'and' | 'or' | 'AND' | 'OR': Logical operator used when scanning profiles for exclusive filtering; whether to filter for profiles matching any of the given values (`or`) or all of the given values (`and`). - `lot_specialized_occupation_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - string[] - object - `include` string[]: List of values to include in the filter. - `exclude` string[]: List of values to exclude from the filter. - `include_op` 'and' | 'or' | 'AND' | 'OR': Logical operator used when scanning profiles for inclusive filtering; whether to filter for profiles matching any of the given values (`or`) or all of the given values (`and`). - `exclude_op` 'and' | 'or' | 'AND' | 'OR': Logical operator used when scanning profiles for exclusive filtering; whether to filter for profiles matching any of the given values (`or`) or all of the given values (`and`). - `limit` integer: There will always be an `_other_` field in the response, summing up all unlisted transitions. - `destination` object, required: Filter and limit the jobs people come from during job transitions. - `filter` object - `company` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - string[] - object - `include` string[]: List of values to include in the filter. - `exclude` string[]: List of values to exclude from the filter. - `include_op` 'and' | 'or' | 'AND' | 'OR': Logical operator used when scanning profiles for inclusive filtering; whether to filter for profiles matching any of the given values (`or`) or all of the given values (`and`). - `exclude_op` 'and' | 'or' | 'AND' | 'OR': Logical operator used when scanning profiles for exclusive filtering; whether to filter for profiles matching any of the given values (`or`) or all of the given values (`and`). - `company_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - string[] - object - `include` string[]: List of values to include in the filter. - `exclude` string[]: List of values to exclude from the filter. - `include_op` 'and' | 'or' | 'AND' | 'OR': Logical operator used when scanning profiles for inclusive filtering; whether to filter for profiles matching any of the given values (`or`) or all of the given values (`and`). - `exclude_op` 'and' | 'or' | 'AND' | 'OR': Logical operator used when scanning profiles for exclusive filtering; whether to filter for profiles matching any of the given values (`or`) or all of the given values (`and`). - `soc1` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta). - string[] - object - `include` string[]: List of values to include in the filter. - `exclude` string[]: List of values to exclude from the filter. - `include_op` 'and' | 'or' | 'AND' | 'OR': Logical operator used when scanning profiles for inclusive filtering; whether to filter for profiles matching any of the given values (`or`) or all of the given values (`and`). - `exclude_op` 'and' | 'or' | 'AND' | 'OR': Logical operator used when scanning profiles for exclusive filtering; whether to filter for profiles matching any of the given values (`or`) or all of the given values (`and`). - `soc2` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta). - string[] - object - `include` string[]: List of values to include in the filter. - `exclude` string[]: List of values to exclude from the filter. - `include_op` 'and' | 'or' | 'AND' | 'OR': Logical operator used when scanning profiles for inclusive filtering; whether to filter for profiles matching any of the given values (`or`) or all of the given values (`and`). - `exclude_op` 'and' | 'or' | 'AND' | 'OR': Logical operator used when scanning profiles for exclusive filtering; whether to filter for profiles matching any of the given values (`or`) or all of the given values (`and`). - `soc3` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta). - string[] - object - `include` string[]: List of values to include in the filter. - `exclude` string[]: List of values to exclude from the filter. - `include_op` 'and' | 'or' | 'AND' | 'OR': Logical operator used when scanning profiles for inclusive filtering; whether to filter for profiles matching any of the given values (`or`) or all of the given values (`and`). - `exclude_op` 'and' | 'or' | 'AND' | 'OR': Logical operator used when scanning profiles for exclusive filtering; whether to filter for profiles matching any of the given values (`or`) or all of the given values (`and`). - `soc4` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). For version see [/meta](#meta). - string[] - object - `include` string[]: List of values to include in the filter. - `exclude` string[]: List of values to exclude from the filter. - `include_op` 'and' | 'or' | 'AND' | 'OR': Logical operator used when scanning profiles for inclusive filtering; whether to filter for profiles matching any of the given values (`or`) or all of the given values (`and`). - `exclude_op` 'and' | 'or' | 'AND' | 'OR': Logical operator used when scanning profiles for exclusive filtering; whether to filter for profiles matching any of the given values (`or`) or all of the given values (`and`). - `lot_career_area` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - union[] - union - string - integer - object - `include` string[]: List of values to include in the filter. - `exclude` string[]: List of values to exclude from the filter. - `include_op` 'and' | 'or' | 'AND' | 'OR': Logical operator used when scanning profiles for inclusive filtering; whether to filter for profiles matching any of the given values (`or`) or all of the given values (`and`). - `exclude_op` 'and' | 'or' | 'AND' | 'OR': Logical operator used when scanning profiles for exclusive filtering; whether to filter for profiles matching any of the given values (`or`) or all of the given values (`and`). - `lot_career_area_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - string[] - object - `include` string[]: List of values to include in the filter. - `exclude` string[]: List of values to exclude from the filter. - `include_op` 'and' | 'or' | 'AND' | 'OR': Logical operator used when scanning profiles for inclusive filtering; whether to filter for profiles matching any of the given values (`or`) or all of the given values (`and`). - `exclude_op` 'and' | 'or' | 'AND' | 'OR': Logical operator used when scanning profiles for exclusive filtering; whether to filter for profiles matching any of the given values (`or`) or all of the given values (`and`). - `lot_occupation` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - union[] - union - string - integer - object - `include` string[]: List of values to include in the filter. - `exclude` string[]: List of values to exclude from the filter. - `include_op` 'and' | 'or' | 'AND' | 'OR': Logical operator used when scanning profiles for inclusive filtering; whether to filter for profiles matching any of the given values (`or`) or all of the given values (`and`). - `exclude_op` 'and' | 'or' | 'AND' | 'OR': Logical operator used when scanning profiles for exclusive filtering; whether to filter for profiles matching any of the given values (`or`) or all of the given values (`and`). - `lot_occupation_group` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - union[] - union - string - integer - object - `include` string[]: List of values to include in the filter. - `exclude` string[]: List of values to exclude from the filter. - `include_op` 'and' | 'or' | 'AND' | 'OR': Logical operator used when scanning profiles for inclusive filtering; whether to filter for profiles matching any of the given values (`or`) or all of the given values (`and`). - `exclude_op` 'and' | 'or' | 'AND' | 'OR': Logical operator used when scanning profiles for exclusive filtering; whether to filter for profiles matching any of the given values (`or`) or all of the given values (`and`). - `lot_occupation_group_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - string[] - object - `include` string[]: List of values to include in the filter. - `exclude` string[]: List of values to exclude from the filter. - `include_op` 'and' | 'or' | 'AND' | 'OR': Logical operator used when scanning profiles for inclusive filtering; whether to filter for profiles matching any of the given values (`or`) or all of the given values (`and`). - `exclude_op` 'and' | 'or' | 'AND' | 'OR': Logical operator used when scanning profiles for exclusive filtering; whether to filter for profiles matching any of the given values (`or`) or all of the given values (`and`). - `lot_occupation_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - string[] - object - `include` string[]: List of values to include in the filter. - `exclude` string[]: List of values to exclude from the filter. - `include_op` 'and' | 'or' | 'AND' | 'OR': Logical operator used when scanning profiles for inclusive filtering; whether to filter for profiles matching any of the given values (`or`) or all of the given values (`and`). - `exclude_op` 'and' | 'or' | 'AND' | 'OR': Logical operator used when scanning profiles for exclusive filtering; whether to filter for profiles matching any of the given values (`or`) or all of the given values (`and`). - `lot_specialized_occupation` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - union[] - union - string - integer - object - `include` string[]: List of values to include in the filter. - `exclude` string[]: List of values to exclude from the filter. - `include_op` 'and' | 'or' | 'AND' | 'OR': Logical operator used when scanning profiles for inclusive filtering; whether to filter for profiles matching any of the given values (`or`) or all of the given values (`and`). - `exclude_op` 'and' | 'or' | 'AND' | 'OR': Logical operator used when scanning profiles for exclusive filtering; whether to filter for profiles matching any of the given values (`or`) or all of the given values (`and`). - `lot_specialized_occupation_name` union: This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering (for details see [Filtering](#filtering) above). - string[] - object - `include` string[]: List of values to include in the filter. - `exclude` string[]: List of values to exclude from the filter. - `include_op` 'and' | 'or' | 'AND' | 'OR': Logical operator used when scanning profiles for inclusive filtering; whether to filter for profiles matching any of the given values (`or`) or all of the given values (`and`). - `exclude_op` 'and' | 'or' | 'AND' | 'OR': Logical operator used when scanning profiles for exclusive filtering; whether to filter for profiles matching any of the given values (`or`) or all of the given values (`and`). - `limit` integer: There will always be an `_other_` field in the response, summing up all unlisted transitions. ## Response `200` OK - object - `data` object, required - `source` object, required - `facet` string, required - `items` union[], required - union - string - integer - `limit` integer, required - `destination` object, required - `facet` string, required - `items` union[], required - union - string - integer - `limit` integer, required - `totals` object, required - `transitions` integer, required - `transitions` array[], required - integer[] ## Other responses - `400`: Your request wasn't valid (bad parameter names or values). - `404`: The facet you requested wasn't found. --- [API](https://skmtc.dev/lightcast/apis/profiles-uk.md) - [All operations](https://skmtc.dev/lightcast/apis/profiles-uk/llms.txt) - [OpenAPI document](https://skmtc.dev/lightcast/apis/profiles-uk/revisions/562d83d43ab7?raw)