--- title: "Rank profiles by facets" method: POST path: "/rankings/{rankingFacet}" tags: ["Rankings"] --- # Rank profiles by facets `POST /rankings/{rankingFacet}` ## Request - Base URL: `https://api.lightcast.io/global-profiles` - URL: `https://api.lightcast.io/global-profiles/rankings/{rankingFacet}` - Auth: OAuth 2 - Client credentials - Token URL: `https://auth.emsicloud.com/connect/token` scopes: `profiles:global` Group and rank profiles by {rankingFacet}. ## Path parameters - `rankingFacet` 'certifications' | 'certifications_name' | 'common_skills' | 'common_skills_name' | 'company' | 'company_name' | 'gender' | 'gender_name' | 'laa_admin_area_1' | 'laa_admin_area_1_name' | 'laa_admin_area_2' | 'laa_admin_area_2_name' | 'laa_country' | 'laa_country_name' | 'laa_metro' | 'laa_metro_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' | 'market' | 'market_name' | 'most_recent_company' | 'most_recent_company_end_date' | 'most_recent_company_start_date' | 'moves_in_most_recent_company' | 'moves_in_previous_company' | 'nation' | 'nation_name' | 'occupation' | 'occupation_name' | 'onet' | 'onet_name' | 'previous_company' | 'previous_company_end_date' | 'previous_company_start_date' | 'schools' | 'schools_name' | 'skills' | 'skills_name' | 'specialized_skills' | 'specialized_skills_name' | 'title' | 'title_name' | 'years_in_current_role' | 'years_of_experience' | 'years_of_experience_in_occupation' | 'years_of_work_history' | 'years_with_most_recent_company' | 'years_with_previous_company', 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 - `filter` union, required: An object or a list of up to 10 objects. - object[] - `nation` 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. - … - `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`). - `nation_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 - `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`). - `market` 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. - … - `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`). - `market_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 - `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`). - `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. - … - `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`). - `laa_country_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 - `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`). - `laa_metro` 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. - … - `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`). - `laa_metro_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 - `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`). - `laa_admin_area_1` 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`). - `laa_admin_area_1_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`). - `laa_admin_area_2` 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`). - `laa_admin_area_2_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`). - `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). 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. - … - `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`). - `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). 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. - … - `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`). - `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 degree from Yale or Harvard* ```json { "filter": { "educations": [ { "schools_name": [ "Yale University", "Harvard University" ] } ] } } ``` - 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 - … - 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 - … - `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` 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`). - `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` 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`). - `onet` 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. - … - `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`). - `onet_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 - `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` 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_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`). - `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_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_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_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`). - `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` 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`). - `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` 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`). - `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). - 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`). - `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` 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`). - `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` 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`). - `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` 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`). - `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` 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`). - `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` 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`). - `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` 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`). - `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` 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`). - `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_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 - `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 - object - `nation` 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. - … - `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`). - `nation_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 - `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`). - `market` 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. - … - `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`). - `market_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 - `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`). - `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. - … - `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`). - `laa_country_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 - `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`). - `laa_metro` 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. - … - `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`). - `laa_metro_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 - `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`). - `laa_admin_area_1` 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`). - `laa_admin_area_1_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`). - `laa_admin_area_2` 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`). - `laa_admin_area_2_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`). - `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). 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. - … - `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`). - `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). 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. - … - `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`). - `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 degree from Yale or Harvard* ```json { "filter": { "educations": [ { "schools_name": [ "Yale University", "Harvard University" ] } ] } } ``` - 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 - … - 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 - … - `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` 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`). - `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` 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`). - `onet` 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. - … - `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`). - `onet_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 - `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` 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_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`). - `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_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_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_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`). - `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` 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`). - `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` 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`). - `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). - 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`). - `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` 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`). - `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` 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`). - `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` 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`). - `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` 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`). - `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` 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`). - `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` 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`). - `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` 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`). - `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_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 - `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 - `rank` object, required - `by` 'profiles' | 'unique_companies' | 'significance': Some metrics may be approximations for performance reasons. - `limit` integer: Unlimited rankings (passing a limit of `0`) are not valid for job companies, titles, skills, and certifications facets. Additional maximum limits: * Nested rankings: `100` - `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 - `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' | 'significance', required - `limit` integer, required - `buckets` object[], required - `name` union, required - string - integer - number - `profiles` integer - `unique_companies` 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`: 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)