---
title: "Search rankings"
method: POST
path: "/rankings/{rankingDimension}"
tags: ["Rankings"]
---

# Search rankings

`POST /rankings/{rankingDimension}`

Filter for specific items in a dataset.

## Path parameters

- `rankingDimension` string, required

## Query parameters

- `accountId` string

## Request body

- object
  - `filter` object, required
    - `academic_unit` object — 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). Not all accounts will have this field, check [meta](#get-account-account_id-meta) filters and facets for availability.
    - `academic_unit_name` object — 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). Not all accounts will have this field, check [meta](#get-account-account_id-meta) filters and facets for availability.
    - `academic_subunit` object — 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). Not all account will have this field, check [meta](#get-account-account_id-meta) filters and facets for availability.
    - `academic_subunit_name` object — 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). Not all accounts will have this field, check [meta](#get-account-account_id-meta) filters and facets for availability.
    - `campus` object — 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). Not all accounts will have this field, check [meta](#get-account-account_id-meta) filters and facets for availability.
    - `campus_name` object — 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). Not all accounts will have this field, check [meta](#get-account-account_id-meta) filters and facets for availability.
    - `country` string[]
    - `country_name` string[]
    - `city` object — 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).
    - `city_name` object — 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).
    - `county_name` object — 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).
    - `fips_name` object — 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).
    - `msa_name` object — 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).
    - `state_name` object — 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).
    - `title` object — 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).
    - `title_name` object — 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).
    - `onet` object — 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).
    - `onet_name` object — 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).
    - `soc2` object — 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).
    - `soc2_name` object — 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).
    - `soc3` object — 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).
    - `soc3_name` object — 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).
    - `soc4` object — 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).
    - `soc4_name` object — 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).
    - `soc5` object — 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).
    - `soc5_name` object — 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).
    - `company` object — 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).
    - `company_name` object — 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).
    - `schools` object — 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).
    - `schools_name` object — 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).
    - `naics2_name` object — 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).
    - `naics3_name` object — 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).
    - `naics4_name` object — 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).
    - `naics5_name` object — 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).
    - `naics6_name` object — 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).
    - `lot_specialized_occupation_name` object — 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).
    - `lot_occupation` object — 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).
    - `lot_occupation_name` object — 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).
    - `lot_occupation_group_name` object — 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).
    - `lot_career_area_name` object — 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).
    - `skills` object — 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).
    - `skills_name` object — 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).
    - `cip2` object — 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).
    - `cip2_name` object — 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).
    - `cip6` object — 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).
    - `cip6_name` object — 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).
    - `program` object — 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).
    - `program_name` object — 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).
    - `inst_gradyear` object — `start` and `end` may be omitted to make them unbounded.
      - `start` union
        - string
        - integer
      - `end` union
        - string
        - integer
    - `degree_level` object — 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).
    - `degree_level_name` object — 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).
    - `loc_status` object — 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).
    - `loc_status_name` object — 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).
    - `emp_status` object — 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).
    - `race` object — 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).
    - `ethnicity` object — 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).
    - `gender` object — 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).
    - `age_grad_band` object — 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).
    - `race_name` object — 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).
    - `ethnicity_name` object — 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).
    - `gender_name` object — 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).
    - `age_grad_band_name` object — 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).
    - `education_status` object — 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).
    - `education_status_name` object — 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).
    - `emp_status_name` object — 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).
    - `additional_education_name` object — 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).
    - `additional_education` object — 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).
    - `nsc_completion_date` object — 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).
    - `nsc_degree_level_name` object — 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).
    - `nsc_degree_level_title_name` object — 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).
    - `nsc_degree_level_title` object — 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).
    - `nsc_degree_level` object — 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).
    - `nsc_end_date` object — 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).
    - `nsc_enroll_status_name` object — 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).
    - `nsc_enroll_status` object — 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).
    - `nsc_enrollment_level_name` object — 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).
    - `nsc_enrollment_level` object — 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).
    - `nsc_institution_ipeds_name` object — 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).
    - `nsc_institution_ope_id` object — 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).
    - `nsc_institution_school_category_name` object — 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).
    - `nsc_institution_school_category` object — 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).
    - `nsc_institution_school_name` object — 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).
    - `nsc_institution_school_state_name` object — 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).
    - `nsc_institution_school_state` object — 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).
    - `nsc_institution_school_type_name` object — 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).
    - `nsc_institution_school_type` object — 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).
    - `nsc_prior_completion_date` object — 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).
    - `nsc_prior_degree_level_name` object — 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).
    - `nsc_prior_degree_level_title_name` object — 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).
    - `nsc_prior_degree_level_title` object — 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).
    - `nsc_prior_degree_level` object — 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).
    - `nsc_prior_end_date` object — 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).
    - `nsc_prior_enroll_status_name` object — 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).
    - `nsc_prior_enroll_status` object — 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).
    - `nsc_prior_enrollment_level_name` object — 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).
    - `nsc_prior_enrollment_level` object — 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).
    - `nsc_prior_institution_ipeds_name` object — 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).
    - `nsc_prior_institution_ope_id` object — 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).
    - `nsc_prior_institution_school_category_name` object — 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).
    - `nsc_prior_institution_school_category` object — 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).
    - `nsc_prior_institution_school` object — 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).
    - `nsc_prior_institution_school_name` object — 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).
    - `nsc_prior_institution_school_state_name` object — 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).
    - `nsc_prior_institution_school_state` object — 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).
    - `nsc_prior_institution_school_type_name` object — 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).
    - `nsc_prior_institution_school_type` object — 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).
    - `nsc_prior_program_cip_name` object — 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).
    - `nsc_prior_program_cip` object — 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).
    - `nsc_prior_start_date` object — 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).
    - `nsc_program_cip_name` object — 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).
    - `nsc_program_cip` object — 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).
    - `nsc_start_date` object — 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).
    - `nsc_subsequent_completion_date` object — 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).
    - `nsc_subsequent_degree_level_name` object — 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).
    - `nsc_subsequent_degree_level_title_name` object — 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).
    - `nsc_subsequent_degree_level_title` object — 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).
    - `nsc_subsequent_degree_level` object — 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).
    - `nsc_subsequent_end_date` object — 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).
    - `nsc_subsequent_enroll_status_name` object — 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).
    - `nsc_subsequent_enroll_status` object — 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).
    - `nsc_subsequent_enrollment_level_name` object — 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).
    - `nsc_subsequent_enrollment_level` object — 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).
    - `nsc_subsequent_institution_ipeds_name` object — 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).
    - `nsc_subsequent_institution_ope_id` object — 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).
    - `nsc_subsequent_institution_school_category_name` object — 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).
    - `nsc_subsequent_institution_school_category` object — 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).
    - `nsc_subsequent_institution_school` object — 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).
    - `nsc_subsequent_institution_school_name` object — 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).
    - `nsc_subsequent_institution_school_state_name` object — 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).
    - `nsc_subsequent_institution_school_state` object — 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).
    - `nsc_subsequent_institution_school_type_name` object — 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).
    - `nsc_subsequent_institution_school_type` object — 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).
    - `nsc_subsequent_program_cip_name` object — 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).
    - `nsc_subsequent_program_cip` object — 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).
    - `nsc_subsequent_start_date` object — 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).
    - `nsc_match_status` boolean — This filters to alumni that are matched with NSC data.
    - `is_job_after_grad_year` boolean — This indicates whether a profile's current job started after graduation. Not all accounts will have this field, check [meta](#get-account-account_id-meta) filters and facets for availability.
    - `is_highest_level_award` boolean — This filters to profiles that represent the highest and the most recent awarded degree. Not all accounts will have this field, check [meta](#get-account-account_id-meta) filters and facets for availability.
    - `match_status` boolean — This filters to alumni that are matched to a profile.
    - `match_score` object — This filters to alumni that are matched to a match score range
      - `lower_bound` number
      - `upper_bound` number
    - `nsc_prior_is_completion` boolean — This filters to alumni that are matched to a profile.
    - `nsc_has_prior` boolean — This filters to alumni that are matched to a profile.
    - `nsc_subsequent_is_completion` boolean — This filters to alumni that are matched to a profile.
    - `nsc_has_subsequent` boolean — This filters to alumni that are matched to a profile.
    - `bucketed_career_events` union
      - object — An object or list of objects describing career events. Career events in a list will be ANDed together, fields within a bucketed_career_events object will be ANDed together, values in an bucketed_career_events field will be ORed together.
        - `organization` object — 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).
        - `event_type` object — 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).
        - `sequence_order_number` object — 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).
        - `high_level_grouping` object — 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).
        - `low_level_grouping` object — 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).
        - `career_events_event_in_field` boolean — This filters to alumni that were in field for this event.
      - object[] — An object or list of objects describing career events. Career events in a list will be ANDed together, fields within a bucketed_career_events object will be ANDed together, values in an bucketed_career_events field will be ORed together.
        - `organization` object — 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).
        - `event_type` object — 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).
        - `sequence_order_number` object — 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).
        - `high_level_grouping` object — 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).
        - `low_level_grouping` object — 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).
        - `career_events_event_in_field` boolean — This filters to alumni that were in field for this event.
    - `career_events` union
      - object — An object or list of objects describing career events. Career events in a list will be ANDed together, fields within an career_events object will be ANDed together, values in an career_events field will be ORed together.
        - `organization` object — 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).
        - `event_type` object — 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).
        - `sequence_order_number` object — 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).
        - `high_level_grouping` object — 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).
        - `low_level_grouping` object — 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).
        - `career_events_event_in_field` boolean — This filters to alumni that were in field for this event.
      - object[] — An object or list of objects describing career events. Career events in a list will be ANDed together, fields within an career_events object will be ANDed together, values in an career_events field will be ORed together.
        - `organization` object — 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).
        - `event_type` object — 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).
        - `sequence_order_number` object — 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).
        - `high_level_grouping` object — 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).
        - `low_level_grouping` object — 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).
        - `career_events_event_in_field` boolean — This filters to alumni that were in field for this event.
  - `rank` object, required
    - `by` string, required — Some metrics may be approximations for performance reasons.
    - `limit` integer — Unlimited rankings (passing a maximum of `0`) are not valid for job titles, cities, companies, skills, 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.
    - `minProfiles` integer — Require ranked items to have at least this many profiles matching the filter.
    - `order` 'asc' | 'desc'
    - `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
      - `alumni` integer, required
      - `collectionCount` integer
      - `average` number
      - `median` number
      - `percentile` integer
      - `unique` integer
    - `ranking` object, required
      - `ranking_dimension` string, required
      - `rank_by` 'alumni' | 'uniqueSchools' | 'uniqueCompanies', required
      - `limit` integer, required
      - `buckets` object[], required
        - `key` union, required
          - string
          - integer
        - `value` union, required
          - string
          - integer
        - `alumni` integer
        - `uniqueSchools` integer
        - `uniqueCompanies` integer
        - `employedInField` integer
        - `averageWage` number
        - `estimatedWage` number
        - `resideInRegion` integer

## Other responses

- `400` — bad request
- `404` — requested resource not found

---

[API](https://skmtc.net/lightcast/apis/alumni-pathways-2-0.md) · [All operations](https://skmtc.net/lightcast/apis/alumni-pathways-2-0/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lightcast/alumni-pathways-2-0/revisions/fc66b9877391/schema)