--- title: "Group and rank profiles by facet" method: POST path: "/rankings/{rankingFacet}" tags: ["Rankings"] --- # Group and rank profiles by facet `POST /rankings/{rankingFacet}` ## Request - Base URL: `https://api.lightcast.io/uk-profiles` - URL: `https://api.lightcast.io/uk-profiles/rankings/{rankingFacet}` - Auth: OAuth 2 - Client credentials - Token URL: `https://auth.emsicloud.com/connect/token` scopes: `profiles:uk` Group and rank profiles by facet ## Path parameters - `rankingFacet` 'certifications' | 'certifications_name' | 'city' | 'city_name' | 'common_skills' | 'common_skills_name' | 'company' | 'company_name' | 'gender' | 'gender_name' | 'country' | 'jacs2' | 'jacs2_name' | 'lau1' | 'most_recent_company' | 'most_recent_company_end_date' | 'most_recent_company_start_date' | 'moves_in_most_recent_company' | 'nuts1' | 'nuts3' | 'previous_company' | 'previous_company_end_date' | 'previous_company_start_date' | 'schools' | 'schools_name' | 'skills' | 'skills_name' | 'soc1' | 'soc2' | 'soc3' | 'soc4' | 'specialized_skills' | 'specialized_skills_name' | 'title' | 'title_name' | 'years_in_current_role' | 'years_of_experience' | 'years_of_experience_in_occupation' | 'years_with_most_recent_company', 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 - `filter` union, required: An object or a list of up to 10 objects. - object[] - `educations` union: An object or list of objects describing educational credentials. Educations in a list will be ANDed together, fields within an education object will be ANDed together, values in an education field will be ORed together. Minimum educations: `1` Maximum educations: `10` *Example: Find profiles which have a Mathematical degree from Oxford or Cambridge and a Engineering degree from Kingston* ```json { "filter": { "educations": [ { "schools_name": [ "University of Oxford", "University of Cambridge" ], "jacs2_name": [ "Mathematical sciences" ] }, { "schools_name": [ "Kingston University" ], "jacs2_name": [ "Engineering" ] } ] } } ``` - object - `schools` 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 - … - `schools_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 - … - `jacs2` 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 - … - `jacs2_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). For version see [/meta](#meta). - string[] - object - … - object[] - `schools` 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 - … - `schools_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 - … - `jacs2` 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 - … - `jacs2_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). For version see [/meta](#meta). - string[] - object - … - `title` 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`). - `title_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`). - `city` 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` 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`). - `city_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`). - `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`). - `skills` 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`). - `skills_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`). - `country` string[]: 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). - `lau1` 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`). - `nuts1` 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`). - `nuts3` 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_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`). - `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_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_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_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`). - `years_with_most_recent_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). - union[] - union - string - number - object - `lower_bound` union: The lower bound (inclusive). - string - number - `upper_bound` union: The upper bound (inclusive). - string - number - `most_recent_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`). - `years_in_current_role` 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 - number - object - `lower_bound` union: The lower bound (inclusive). - string - number - `upper_bound` union: The upper bound (inclusive). - string - number - `moves_in_most_recent_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). - union[] - union - string - integer - object - `lower_bound` union: The lower bound (inclusive). - string - number - `upper_bound` union: The upper bound (inclusive). - string - number - `most_recent_company_start_date` 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`). - `most_recent_company_end_date` 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`). - `previous_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`). - `previous_company_start_date` 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`). - `previous_company_end_date` 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`). - `years_of_experience` 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 - `lower_bound` union: The lower bound (inclusive). - string - number - `upper_bound` union: The upper bound (inclusive). - string - number - `years_of_work_history` 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 - `lower_bound` union: The lower bound (inclusive). - string - number - `upper_bound` union: The upper bound (inclusive). - string - number - `years_with_previous_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). - union[] - union - string - number - object - `lower_bound` union: The lower bound (inclusive). - string - number - `upper_bound` union: The upper bound (inclusive). - string - number - `moves_in_previous_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). - union[] - union - string - integer - object - `lower_bound` union: The lower bound (inclusive). - string - number - `upper_bound` union: The upper bound (inclusive). - string - number - `gender` 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`). - `gender_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`). - `years_of_experience_in_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 - number - object - `lower_bound` union: The lower bound (inclusive). - string - number - `upper_bound` union: The upper bound (inclusive). - string - number - `include_missing` true | false: Include profiles that don't contain the requested field. - object - `educations` union: An object or list of objects describing educational credentials. Educations in a list will be ANDed together, fields within an education object will be ANDed together, values in an education field will be ORed together. Minimum educations: `1` Maximum educations: `10` *Example: Find profiles which have a Mathematical degree from Oxford or Cambridge and a Engineering degree from Kingston* ```json { "filter": { "educations": [ { "schools_name": [ "University of Oxford", "University of Cambridge" ], "jacs2_name": [ "Mathematical sciences" ] }, { "schools_name": [ "Kingston University" ], "jacs2_name": [ "Engineering" ] } ] } } ``` - object - `schools` 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 - … - `schools_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 - … - `jacs2` 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 - … - `jacs2_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). For version see [/meta](#meta). - string[] - object - … - object[] - `schools` 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 - … - `schools_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 - … - `jacs2` 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 - … - `jacs2_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). For version see [/meta](#meta). - string[] - object - … - `title` 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`). - `title_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`). - `city` 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` 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`). - `city_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`). - `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`). - `skills` 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`). - `skills_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`). - `country` string[]: 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). - `lau1` 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`). - `nuts1` 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`). - `nuts3` 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_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`). - `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_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_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_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`). - `years_with_most_recent_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). - union[] - union - string - number - object - `lower_bound` union: The lower bound (inclusive). - string - number - `upper_bound` union: The upper bound (inclusive). - string - number - `most_recent_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`). - `years_in_current_role` 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 - number - object - `lower_bound` union: The lower bound (inclusive). - string - number - `upper_bound` union: The upper bound (inclusive). - string - number - `moves_in_most_recent_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). - union[] - union - string - integer - object - `lower_bound` union: The lower bound (inclusive). - string - number - `upper_bound` union: The upper bound (inclusive). - string - number - `most_recent_company_start_date` 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`). - `most_recent_company_end_date` 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`). - `previous_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`). - `previous_company_start_date` 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`). - `previous_company_end_date` 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`). - `years_of_experience` 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 - `lower_bound` union: The lower bound (inclusive). - string - number - `upper_bound` union: The upper bound (inclusive). - string - number - `years_of_work_history` 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 - `lower_bound` union: The lower bound (inclusive). - string - number - `upper_bound` union: The upper bound (inclusive). - string - number - `years_with_previous_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). - union[] - union - string - number - object - `lower_bound` union: The lower bound (inclusive). - string - number - `upper_bound` union: The upper bound (inclusive). - string - number - `moves_in_previous_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). - union[] - union - string - integer - object - `lower_bound` union: The lower bound (inclusive). - string - number - `upper_bound` union: The upper bound (inclusive). - string - number - `gender` 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`). - `gender_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`). - `years_of_experience_in_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 - number - object - `lower_bound` union: The lower bound (inclusive). - string - number - `upper_bound` union: The upper bound (inclusive). - string - number - `include_missing` true | false: Include profiles that don't contain the requested field. - `rank` object, required - `by` 'profiles' | 'unique_schools' | 'unique_companies' | 'significance': Some metrics may be approximations for performance reasons. *Note: `significance` rankings cannot be done on schools or jacs2 facets* - `limit` integer: Unlimited rankings (passing a maximum of `0`) are not valid for job titles, cities, companies, skills, schools, and certifications facets. - `extra_metrics` string[]: In addition to 'by' metric, calculate these metrics for each ranked group. Some metrics may be approximations for performance reasons. - `min_profiles` integer: Require ranked items to have at least this many profiles matching the filter. *Default is `10` for `significance` rankings, `1` for all other rankings* - `include` union[]: This field does not affect totals matched by the request query, it only filters the items returned in the ranking. - union - string - integer - `exclude` union[]: This field does not affect totals matched by the request query, it only filters the items returned in the ranking. - union - string - integer ## Response `200` OK - object - `data` object, required - `totals` object, required - `profiles` integer - `unique_companies` integer - `unique_schools` integer - `median_years_of_experience_in_occupation` number, nullable - `median_years_with_most_recent_company` number, nullable - `median_years_in_current_role` number, nullable - `median_moves_in_most_recent_company` number, nullable - `ranking` object, required - `facet` string, required - `rank_by` 'profiles' | 'unique_companies' | 'unique_schools' | 'significance', required - `limit` integer, required - `buckets` object[], required - `name` union, required - string - integer - number - `profiles` integer - `unique_companies` integer - `unique_schools` integer - `significance` number - `median_years_of_experience_in_occupation` number, nullable - `median_years_with_most_recent_company` number, nullable - `median_years_in_current_role` number, nullable - `median_moves_in_most_recent_company` number, nullable ## 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)