--- 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/global-profiles` - URL: `https://api.lightcast.io/global-profiles/transitions/{sourceFacet}/{destinationFacet}` - Auth: OAuth 2 - Client credentials - Token URL: `https://auth.emsicloud.com/connect/token` scopes: `profiles:global` 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_name' | 'lot_occupation_group' | 'lot_occupation_group_name' | 'lot_specialized_occupation' | 'lot_specialized_occupation_name', required - `destinationFacet` 'company' | 'company_name' | 'lot_career_area' | 'lot_career_area_name' | 'lot_occupation' | 'lot_occupation_name' | 'lot_occupation_group' | 'lot_occupation_group_name' | 'lot_specialized_occupation' | 'lot_specialized_occupation_name', required ## Query parameters - `newTaxonomyVersions` true | false - `lot_version` '6' | '7' - `area_version` 'lf_area_2023_2' | 'lf_area_2025_1' - `area_laa_version` '1' | '2' ## Request body - object - `laa_country` 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` union[]: List of values to exclude from the filter. - union: Replace with $ref defined above when band-aid is no longer needed. - string - integer - `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`). - `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` union[]: List of values to exclude from the filter. - union: Replace with $ref defined above when band-aid is no longer needed. - … - `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` union[]: List of values to exclude from the filter. - union: Replace with $ref defined above when band-aid is no longer needed. - … - `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` union[]: List of values to include in the filter. - union - … - `exclude` union[]: List of values to exclude from the filter. - union - … - `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` union[]: List of values to exclude from the filter. - union: Replace with $ref defined above when band-aid is no longer needed. - … - `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` union[]: List of values to include in the filter. - union - … - `exclude` union[]: List of values to exclude from the filter. - union - … - `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` union[]: List of values to include in the filter. - union - … - `exclude` union[]: List of values to exclude from the filter. - union - … - `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` union[]: List of values to exclude from the filter. - union: Replace with $ref defined above when band-aid is no longer needed. - … - `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` union[]: List of values to exclude from the filter. - union: Replace with $ref defined above when band-aid is no longer needed. - … - `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` union[]: List of values to include in the filter. - union - … - `exclude` union[]: List of values to exclude from the filter. - union - … - `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` union[]: List of values to exclude from the filter. - union: Replace with $ref defined above when band-aid is no longer needed. - … - `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` union[]: List of values to exclude from the filter. - union: Replace with $ref defined above when band-aid is no longer needed. - … - `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` union[]: List of values to exclude from the filter. - union: Replace with $ref defined above when band-aid is no longer needed. - … - `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` union[]: List of values to include in the filter. - union - … - `exclude` union[]: List of values to exclude from the filter. - union - … - `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` union[]: List of values to exclude from the filter. - union: Replace with $ref defined above when band-aid is no longer needed. - … - `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` union[]: List of values to include in the filter. - union - … - `exclude` union[]: List of values to exclude from the filter. - union - … - `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` union[]: List of values to include in the filter. - union - … - `exclude` union[]: List of values to exclude from the filter. - union - … - `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` union[]: List of values to exclude from the filter. - union: Replace with $ref defined above when band-aid is no longer needed. - … - `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` union[]: List of values to exclude from the filter. - union: Replace with $ref defined above when band-aid is no longer needed. - … - `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` union[]: List of values to include in the filter. - union - … - `exclude` union[]: List of values to exclude from the filter. - union - … - `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` union[]: List of values to exclude from the filter. - union: Replace with $ref defined above when band-aid is no longer needed. - … - `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`: bad request - `404`: requested resource not found --- [API](https://skmtc.dev/lightcast/apis/profiles-global.md) - [All operations](https://skmtc.dev/lightcast/apis/profiles-global/llms.txt) - [OpenAPI document](https://skmtc.dev/lightcast/apis/profiles-global/revisions/7ff5f883b6ec?raw)