{"openapi":"3.0.2","info":{"title":"Genu Youth Observatory    Data API","termsOfService":"http://genu-dashboard.co/","contact":{"name":"Rlabs Development","email":"dean@rlabs.org"},"version":"4.0"},"paths":{"/healthz":{"get":{"summary":"Healthz","operationId":"healthz_healthz_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/youth-population":{"post":{"tags":["Youth Observatory 0.0 Youth Population"],"summary":"Youth Population","description":"Returns the youth_population.","operationId":"youth_population_youth_population_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AreaCountry"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/youth-observatory-neet-rate":{"post":{"tags":["Youth Observatory 0.1.1 Neet Rate"],"summary":"Youth Observatory Neet Rate","description":"Returns the youth_observatory_neet_rate.","operationId":"youth_observatory_neet_rate_youth_observatory_neet_rate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AreaCountry"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/youth-observatory-neet-number":{"post":{"tags":["Youth Observatory 0.1.2 Neet Number"],"summary":"Youth Observatory Neet Number","description":"Returns the youth_observatory_neet_number.","operationId":"youth_observatory_neet_number_youth_observatory_neet_number_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AreaCountry"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/youth-observatory-neet-gender-ratio":{"post":{"tags":["Youth Observatory 0.1 Neet Ratio"],"summary":"Youth Observatory Neet Gender Ratio","description":"Returns the youth_observatory_neet_gender_ratio.","operationId":"youth_observatory_neet_gender_ratio_youth_observatory_neet_gender_ratio_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AreaCountry"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/youth-observatory-inactivity-rate":{"post":{"tags":["Youth Observatory 3.1 Inactivity Rate"],"summary":"Youth Observatory Inactivity Rate","description":"Returns the youth_observatory_inactivity_rate.","operationId":"youth_observatory_inactivity_rate_youth_observatory_inactivity_rate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AreaCountry"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/education-training-participation":{"post":{"tags":["Youth Skills 1.1 Education Training Participation"],"summary":"Education Training Participation","description":"Returns the education_training_participation.","operationId":"education_training_participation_education_training_participation_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AreaCountry"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/youth-literacy-rate":{"post":{"tags":["Youth Skills 1.2 Youth Literacy Rate"],"summary":"Youth Literacy Rate","description":"Returns the youth_literacy_rate.","operationId":"youth_literacy_rate_youth_literacy_rate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AreaCountry"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/secondary-skills-deficit":{"post":{"tags":["Youth Skills 1.3 Secondary Skills Deficit"],"summary":"Secondary Skills Deficit","description":"Returns the secondary_skills_deficit.","operationId":"secondary_skills_deficit_secondary_skills_deficit_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AreaCountry"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/digital-skills-deficit":{"post":{"tags":["Youth Skills 1.4 Digital Skills Deficit"],"summary":"Digital Skills Deficit","description":"Returns the digital_skills_deficit.","operationId":"digital_skills_deficit_digital_skills_deficit_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AreaCountry"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/youth-employment-population-ratio":{"post":{"tags":["Youth Livelihoods 2.1 Youth Employment to Population Ratio"],"summary":"Youth Employment Population Ratio","description":"Returns the youth_employment_population_ratio.","operationId":"youth_employment_population_ratio_youth_employment_population_ratio_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AreaCountry"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/youth-underemployment-rate":{"post":{"tags":["Youth Livelihoods 2.2 Youth Under-Employment Rate"],"summary":"Youth Underemployment Rate","description":"Returns the youth_underemployment_rate.","operationId":"youth_underemployment_rate_youth_underemployment_rate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AreaCountry"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/youth-working-poverty-rate":{"post":{"tags":["Youth Livelihoods 2.3 Youth Working Poverty Rate"],"summary":"Youth Working Poverty Rate","description":"Returns the youth_working_poverty_rate.","operationId":"youth_working_poverty_rate_youth_working_poverty_rate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AreaCountry"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/youth-unemployment-rate":{"post":{"tags":["Youth Livelihoods 2.4 Youth Unemployment Rate"],"summary":"Youth Unemployment Rate","description":"Returns the youth_unemployment_rate.","operationId":"youth_unemployment_rate_youth_unemployment_rate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AreaCountry"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/global-population":{"post":{"tags":["1.1 Global Population Total"],"summary":"Get Global Population","description":"Returns the world total for the given year from `neet_population`.","operationId":"get_global_population_global_population_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/YearItem"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/country-population":{"post":{"tags":["1.2 Country Population Total"],"summary":"Get Country Population","description":"Returns the world total for the given year from `neet_population`.","operationId":"get_country_population_country_population_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CountryItem"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/neet-population":{"post":{"tags":["2.1 Need Global Population Total"],"summary":"Get Neet Population","description":"Returns the neet total for the given year from `neet_population`.","operationId":"get_neet_population_neet_population_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/YearItem"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/neet-country-population":{"post":{"tags":["2.2 Need Country Population Total"],"summary":"Get Neet Country Population","description":"Returns the neet total for the given year from `neet_population`.","operationId":"get_neet_country_population_neet_country_population_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CountryItem"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/all-countries_neet_ratio":{"post":{"tags":["3. NEET Map All Countries Rate Ratio"],"summary":"Get All Countries Neet Ratio","description":"Returns NEET rate (Total sex) for a curated list of countries for the given year.\n\nResponse shape:\n{\n  \"year\": 2025,\n  \"count\": 123,\n  \"items\": [\n    { \"country_name\": \"South Africa\", \"country_neet_ratio\": 32.1 },\n    ...\n  ]\n}","operationId":"get_all_countries_neet_ratio_all_countries_neet_ratio_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/YearItem"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/neet-rate-ratio":{"post":{"tags":["4.1 NEET Rate Ratio"],"summary":"Get Neet Rate Ratio","description":"Returns the global NEET rate ratio for the given year from `neet_rate_ratio`\nwhere ref_area.label = 'World'.","operationId":"get_neet_rate_ratio_neet_rate_ratio_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/YearItem"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/neet-country-rate-ratio":{"post":{"tags":["4.2 NEET Country Rate Ratio"],"summary":"Get Country Neet Rate Ratio","description":"Returns the country NEET rate ratio for the given year from `neet_rate_ratio`\nwhere ref_area.label = 'World'.","operationId":"get_country_neet_rate_ratio_neet_country_rate_ratio_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CountryItem"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/neet-rate":{"post":{"tags":["5.1 NEET Global Rate"],"summary":"Get Neet Rate","description":"Returns the global NEET rate breakdown (Total, Male, Female) for the given year\nfrom `neet_rate` where ref_area.label = 'World'.","operationId":"get_neet_rate_neet_rate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/YearItem"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/neet-country-rate":{"post":{"tags":["5.2 NEET Country  Rate"],"summary":"Get Neet Country Rate","description":"Returns the Country NEET rate breakdown (Total, Male, Female) for the given year\nfrom `neet_rate` where ref_area.label = 'World'.","operationId":"get_neet_country_rate_neet_country_rate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CountryItem"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/neet-country-names":{"get":{"tags":["6. NEET Country List"],"summary":"Get Neet Country Names","description":"Returns a sorted list of distinct country names from `neet_rate` for the given year.\nOptional `q` does a case-insensitive LIKE filter for autocomplete.","operationId":"get_neet_country_names_neet_country_names_get","parameters":[{"description":"Year to filter NEET data","required":false,"schema":{"title":"Year","maximum":2100.0,"minimum":1900.0,"type":"integer","description":"Year to filter NEET data","default":2025},"name":"year","in":"query"},{"description":"Optional search filter (substring match)","required":false,"schema":{"title":"Q","type":"string","description":"Optional search filter (substring match)"},"name":"q","in":"query"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"AreaCountry":{"title":"AreaCountry","required":["area_name"],"type":"object","properties":{"area_name":{"title":"Area Name","type":"string"}}},"CountryItem":{"title":"CountryItem","required":["country_name"],"type":"object","properties":{"country_name":{"title":"Country Name","type":"string"},"year":{"title":"Year","type":"string","default":"2025"}}},"HTTPValidationError":{"title":"HTTPValidationError","type":"object","properties":{"detail":{"title":"Detail","type":"array","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"title":"ValidationError","required":["loc","msg","type"],"type":"object","properties":{"loc":{"title":"Location","type":"array","items":{"type":"string"}},"msg":{"title":"Message","type":"string"},"type":{"title":"Error Type","type":"string"}}},"YearItem":{"title":"YearItem","type":"object","properties":{"year":{"title":"Year","type":"string","default":"2025"}}}}}}