Reverse-engineered OpenAPI 3.1.0 specification for the EURES (European Employment Services) Job Search API.
This is an unofficial, community-maintained documentation project. It is not affiliated with or endorsed by the European Commission or the EURES network.
| Resource | URL |
|---|---|
| Interactive docs | rorar.github.io/EURES-API-Documentation |
| OpenAPI spec | openapi.yaml |
| Raw download | openapi.yaml (raw) |
https://europa.eu/eures/api
The specification documents 20 endpoints across 3 API services:
| Method | Path | Description |
|---|---|---|
POST | /jv-searchengine/public/jv-search/search | Search job vacancies with filters |
GET | /jv-searchengine/public/jv/id/{id} | Get full vacancy detail by ID |
GET | /jv-searchengine/public/statistics/getNumberOfJobs | Total active vacancy count |
GET | /jv-searchengine/public/statistics/getCountryStats | Vacancies by country/region |
GET | /jv-searchengine/public/statistics/getSectorStats | Vacancies by NACE sector |
GET | /jv-searchengine/public/statistics/getOccupationStats | Vacancies by ESCO occupation |
GET | /jv-searchengine/public/properties | Search engine configuration |
GET | /jv-searchengine/public/translation/enabled | Translation feature status |
GET | /jv-searchengine/public/translation/languages | Supported translation languages |
| Method | Path | Description |
|---|---|---|
GET | /shared-data-rest-api/public/reference/languages | Portal-supported languages (26) |
GET | /shared-data-rest-api/public/reference/isoLanguages | All ISO 639-1 languages (185) |
GET | /shared-data-rest-api/public/reference/countries | Covered countries (31) |
GET | /shared-data-rest-api/public/reference/nace | NACE sector classifications |
GET | /shared-data-rest-api/public/esco/supportedLanguages | ESCO-supported language codes |
POST | /shared-data-rest-api/public/esco/label/{lang} | Resolve ESCO URIs to labels |
GET | /shared-data-rest-api/public/esco/occupation/tree | Full ESCO/ISCO occupation hierarchy |
GET | /shared-data-rest-api/public/properties/public | Portal configuration |
GET | /shared-data-rest-api/public/menu/{section} | Navigation menu entries |
| Method | Path | Description |
|---|---|---|
GET | /autocomplete-repository-rest-api/public/v2.0/occupations | Occupation name autocomplete |
| Method | Path | Description |
|---|---|---|
GET | /public/security/profile | Current user profile (null when anonymous) |
curl -X POST https://europa.eu/eures/api/jv-searchengine/public/jv-search/search \
-H 'Content-Type: application/json' \
-d '{ "resultsPerPage": 5, "page": 1, "sortSearch": "MOST_RECENT", "keywords": [{"keyword": "software engineer", "specificSearchCode": "EVERYWHERE"}], "publicationPeriod": null, "occupationUris": [], "skillUris": [], "requiredExperienceCodes": [], "positionScheduleCodes": [], "sectorCodes": [], "educationAndQualificationLevelCodes": [], "positionOfferingCodes": [], "locationCodes": ["de"], "euresFlagCodes": [], "otherBenefitsCodes": [], "requiredLanguages": [], "minNumberPost": null, "sessionId": "my-session-1", "requestLanguage": "en" }'The specificSearchCode controls which fields a keyword matches against:
| Code | Searches in |
|---|---|
EVERYWHERE | All fields |
TITLE | Job title only |
DESCRIPTION | Job description only |
EMPLOYER | Employer name only |
LEGAL_ID | Employer legal identifier |
JOB_VACANCY_ID | Vacancy ID |
# Search for "Developer" in title AND "SAP" in employer name
curl -X POST https://europa.eu/eures/api/jv-searchengine/public/jv-search/search \
-H 'Content-Type: application/json' \
-d '{ "resultsPerPage": 10, "page": 1, "sortSearch": "BEST_MATCH", "keywords": [ {"keyword": "Developer", "specificSearchCode": "TITLE"}, {"keyword": "SAP", "specificSearchCode": "EMPLOYER"} ], "occupationUris": [], "skillUris": [], "requiredExperienceCodes": [], "positionScheduleCodes": [], "sectorCodes": [], "educationAndQualificationLevelCodes": [], "positionOfferingCodes": [], "locationCodes": [], "euresFlagCodes": [], "otherBenefitsCodes": [], "requiredLanguages": [], "minNumberPost": null, "publicationPeriod": null, "sessionId": "my-session-2", "requestLanguage": "de" }'# Use the base64-encoded ID from search results
curl https://europa.eu/eures/api/jv-searchengine/public/jv/id/MTAwMDEtMTAwMTEzOTMxMS1TIDE?requestLang=encurl 'https://europa.eu/eures/api/autocomplete-repository-rest-api/public/v2.0/occupations?language=en&keyword=Software&nbResults=10'# Total job count
curl https://europa.eu/eures/api/jv-searchengine/public/statistics/getNumberOfJobs
# Jobs by country (with NUTS sub-regions)
curl https://europa.eu/eures/api/jv-searchengine/public/statistics/getCountryStatsThe API uses several EU classification standards:
| System | Used for | Example |
|---|---|---|
| ESCO | Occupations & skills | http://data.europa.eu/esco/occupation/... |
| ISCO | Occupation groups | http://data.europa.eu/esco/isco/C2511 |
| NACE | Economic sectors | a through u (lowercase) |
| NUTS | Geographic regions | de (country), de1 (region), DE12B (district) |
| CEFR | Language proficiency | en(B2), de(C1) |
| EQF | Education levels | basic, bachelor, doctoral |
The EURES API uses NUTS (Nomenclature of Territorial Units for Statistics) codes for geographic regions in locationCodes filters and locationMap response fields. NUTS revisions follow a three-year cycle:
| Revision | Applicable period | Regions (NUTS 1 / 2 / 3) |
|---|---|---|
| NUTS 2021 | 2021–2023 | 92 / 242 / 1166 |
| NUTS 2024 | 2024–2026 (current) | 92 / 244 / 1165 |
| NUTS 2027 | 2027 onward | TBD |
Current status (as of April 2026):
- The EURES API currently uses NUTS 2024 codes. No action is needed until the end of 2026.
- The NUTS 2027 delegated regulation was published in 2025 and takes effect 1 January 2027. It may change, split, or merge some region codes.
- Eurostat publishes correspondence tables for mapping between revisions (available via the TERCET tool).
- When the EURES portal transitions to NUTS 2027, consumers should expect location code changes in search filters, statistics, and vacancy detail responses.
The EURES API itself does not use SDMX directly, but Eurostat's SDMX APIs are relevant for consumers enriching EURES data with labor market statistics:
| API | Base URL | Status |
|---|---|---|
| Statistics API (JSON-stat 2.0) | https://ec.europa.eu/eurostat/api/dissemination/statistics/1.0/ | Active |
| SDMX 2.1 | https://ec.europa.eu/eurostat/api/dissemination/sdmx/2.1/ | Active |
| SDMX 3.0 | https://ec.europa.eu/eurostat/api/dissemination/sdmx/3.0/ | Active |
| Catalogue API | https://ec.europa.eu/eurostat/api/dissemination/catalogue/ | Active |
Current status (as of April 2026):
- No deprecations announced. SDMX 2.1 and 3.0 are supported side-by-side with no sunset dates.
- The old bulk download facility was decommissioned in October 2023; the transition to the current dissemination API is complete.
- For new integrations, SDMX 3.0 is the forward-looking choice, but SDMX 2.1 remains fully supported.
bash scripts/generate-docs.sh -o _site
# Open _site/index.html in a browserThe documentation site is built and deployed automatically via GitHub Actions when openapi.yaml or scripts/generate-docs.sh change on main. To enable:
- Go to Settings > Pages
- Set source to GitHub Actions
Generate API clients from the OpenAPI spec using tools like openapi-generator:
# TypeScript client
npx @openapitools/openapi-generator-cli generate \
-i openapi.yaml -g typescript-fetch -o ./client
# Python client
openapi-generator generate -i openapi.yaml -g python -o ./clientThe openapi.yaml file can be imported directly into:
- Postman — Import > File >
openapi.yaml - Insomnia — Import/Export > From File
- Swagger Editor — File > Import file
- Bruno — Import Collection > OpenAPI
This documentation is provided "as-is" based on observed behavior of the public EURES portal API. It is not an official API and has no guaranteed stability, rate limits, or support.
Usage is subject to the EURES portal terms of use. It is your responsibility to ensure compliance with applicable laws and regulations.
Neither the maintainers of this project nor the EURES portal accept liability for damages or losses arising from use of this API or its documentation.