Endpoint Examples

/meta

Get info on taxonomies, available data years, and attribution.

`GET /meta`

Get service metadata, including taxonomies, available years of data (first and last year in which any available profiles were updated), and attribution text. Caching is encouraged, but the metadata may change weekly.

Query Parameters

Name	Type	Description
`title_version`	enum	Specify Job Title taxonomy version to use. This parameter is optional. Default: `emsi` Must be one of: `emsi`
`company_version`	enum	Specify company taxonomy version to use. This parameter is optional. Default: `emsi_company` Must be one of: `emsi_company`
`naics_version`	enum	Specify NAICS taxonomy version to use. This parameter is optional. Default: `naics_std_2017` Must be one of: `naics_std_2017`, `naics_std_2022`
`cip_version`	enum	Specify CIP taxonomy version to use. This parameter is optional. Default: `cip2020` Must be one of: `cip2010`, `cip2020`
`cip_standard_version`	enum	Specify CIP standard taxonomy version to use. This parameter is optional. Default: `2020.0.0` Must be one of: `2010.0.1`, `2020.0.0`
`new_taxonomy_versions`	enum	Use new taxonomy versions. This parameter is optional. Must be one of: `true`, `false`
`lot_version`	enum	Specify LOT taxonomy version to use. This parameter is optional. Default: `7` Must be one of: `7`, `6`

Code Examples

curl --request GET \
  --url https://api.lightcast.io/ca-profiles/meta \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'

Response Examples

{
  "data": {
    "attribution": {
      "body": "Lightcast profiles are collected from various public online sources and processed/enriched to provide information such as standardized company name, occupation, skills, and geography. Lightcast performs additional filtering and processing to improve compatibility with Lightcast data.",
      "title": "Lightcast Profiles"
    },
    "earliest_year": "2018",
    "facets": [
      "cd",
      "cd_name",
      "certifications",
      "certifications_name",
      "cip2",
      "cip2_name",
      "cip4",
      "cip4_name",
      "cip6",
      "cip6_name",
      "city",
      "city_name",
      "cma",
      "cma_name",
      "common_skills",
      "common_skills_name",
      "company",
      "company_name",
      "csd",
      "csd_name",
      "edulevels",
      "edulevels_name",
      "gender",
      "gender_name",
      "grad_year",
      "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",
      "max_edulevels",
      "max_edulevels_name",
      "most_recent_company",
      "most_recent_company_end_date",
      "most_recent_company_start_date",
      "moves_in_most_recent_company",
      "moves_in_previous_company",
      "naics2",
      "naics2_name",
      "naics3",
      "naics3_name",
      "naics4",
      "naics4_name",
      "naics5",
      "naics5_name",
      "naics6",
      "naics6_name",
      "noc1",
      "noc1_name",
      "noc2",
      "noc2_name",
      "noc3",
      "noc3_name",
      "noc4",
      "noc4_name",
      "noc5",
      "noc5_name",
      "pr",
      "pr_name",
      "previous_company",
      "previous_company_end_date",
      "previous_company_start_date",
      "province",
      "province_name",
      "schools",
      "schools_ipeds",
      "schools_name",
      "skill_categories",
      "skill_categories_name",
      "skill_subcategories",
      "skill_subcategories_name",
      "skills",
      "skills_name",
      "software_skills",
      "software_skills_name",
      "specialized_skills",
      "specialized_skills_name",
      "title",
      "title_name",
      "years_in_current_role",
      "years_of_experience_in_occupation",
      "years_of_work_history",
      "years_with_most_recent_company",
      "years_with_previous_company"
    ],
    "filters": [
      "cd",
      "cd_name",
      "city",
      "city_name",
      "cma",
      "cma_name",
      "company",
      "company_name",
      "csd",
      "csd_name",
      "educations",
      "educations.cip2",
      "educations.cip2_name",
      "educations.cip4",
      "educations.cip4_name",
      "educations.cip6",
      "educations.cip6_name",
      "educations.edulevels",
      "educations.edulevels_name",
      "educations.grad_year",
      "educations.grad_year.end",
      "educations.grad_year.start",
      "educations.schools",
      "educations.schools_ipeds",
      "educations.schools_name",
      "gender",
      "gender_name",
      "keywords",
      "keywords.current_job_only",
      "keywords.query",
      "keywords.type",
      "last_updated",
      "last_updated.end",
      "last_updated.start",
      "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",
      "max_edulevels",
      "max_edulevels_name",
      "most_recent_company",
      "most_recent_company_end_date",
      "most_recent_company_end_date.lower_bound",
      "most_recent_company_end_date.upper_bound",
      "most_recent_company_start_date",
      "most_recent_company_start_date.lower_bound",
      "most_recent_company_start_date.upper_bound",
      "moves_in_most_recent_company",
      "moves_in_most_recent_company.lower_bound",
      "moves_in_most_recent_company.upper_bound",
      "moves_in_previous_company",
      "moves_in_previous_company.lower_bound",
      "moves_in_previous_company.upper_bound",
      "naics2",
      "naics2_name",
      "naics3",
      "naics3_name",
      "naics4",
      "naics4_name",
      "naics5",
      "naics5_name",
      "naics6",
      "naics6_name",
      "noc1",
      "noc1_name",
      "noc2",
      "noc2_name",
      "noc3",
      "noc3_name",
      "noc4",
      "noc4_name",
      "noc5",
      "noc5_name",
      "personal_info",
      "personal_info.email_type_name",
      "personal_info.has_email",
      "personal_info.has_phone",
      "personal_info.name",
      "personal_info.first_name",
      "personal_info.last_name",
      "personal_info.email",
      "personal_info.phone",
      "personal_info.phone_type_ddi",
      "personal_info.phone_type_name",
      "personal_info.profile_url_source_name",
      "pr",
      "pr_name",
      "previous_company",
      "previous_company_end_date",
      "previous_company_end_date.lower_bound",
      "previous_company_end_date.upper_bound",
      "previous_company_start_date",
      "previous_company_start_date.lower_bound",
      "previous_company_start_date.upper_bound",
      "province",
      "province_name",
      "skill_categories",
      "skill_categories_name",
      "skill_subcategories",
      "skill_subcategories_name",
      "skills",
      "skills_name",
      "title",
      "title_name",
      "years_in_current_role",
      "years_in_current_role.lower_bound",
      "years_in_current_role.upper_bound",
      "years_of_work_history",
      "years_of_work_history.lower_bound",
      "years_of_work_history.upper_bound",
      "years_of_experience_in_occupation",
      "years_of_experience_in_occupation.lower_bound",
      "years_of_experience_in_occupation.upper_bound",
      "years_of_work_history",
      "years_with_most_recent_company",
      "years_with_most_recent_company.lower_bound",
      "years_with_most_recent_company.upper_bound",
      "years_with_previous_company",
      "years_with_previous_company.lower_bound",
      "years_with_previous_company.upper_bound"
    ],
    "latest_year": "2025",
    "metrics": [
      "median_moves_in_most_recent_company",
      "median_years_in_current_role",
      "median_years_of_experience_in_occupation",
      "median_years_with_most_recent_company",
      "profiles",
      "significance",
      "unique_companies",
      "unique_schools"
    ],
    "pipelineVersion": "2025-08-FIX",
    "supportsAdvancedFilters": true,
    "taxonomies": {
      "area": "ca_area_sgc2021",
      "cip": "cip2020",
      "company": "emsi-company_v2.81.0",
      "lot": "7",
      "naics": "naics_std_2017",
      "noc": "ca_noc2021",
      "skills": "skillsv9.33",
      "title": "emsi_title_v5.47"
    },
    "taxonomy_versions": {
      "cip": [
        "cip2020",
        "cip2010"
      ],
      "lot": [
        "7",
        "6"
      ],
      "naics": [
        "naics_std_2017",
        "naics_std_2022"
      ]
    }
  }
}