Register record·API·FR·GOVERNMENTVERIFIED · checked 3d ago
A
API La bonne alternance
This API, provided by the French government, gives free, real-time access to job and apprenticeship (work-study) opportunities listed on the La bonne alternance platform. It allows third-party services to query available vacancies and training offers related to apprenticeships, and to broadcast employer job postings more widely by integrating them into external tools or websites. Access requires an API key. The service is aimed at partners and developers building applications connected to apprenticeship and work-study recruitment in France.### **Pourquoi utiliser cette suite d’API ?** * Accéder gratuitement et en temps réel à l'ensemble des opportunités d'emploi et/ou de formation en alternance * Maximiser la visibilité de vos offres d’emploi en alternance en les diffusant sur la plateforme [La bonne alternance](https://labonnealte…
employmenteducation
Trust score
How is this computed?74
good
Weighted across five axes. Tap a ring for what it measures.
Data schema (72 fields)
Filterable via the API (18)
longitudelatituderadiustarget_diploma_levelromesrncpopcodepartementspartners_to_excludeididentifiant.cfdidentifiant.rncpcodeuaisiretpage_sizepage_indexinclude_archived
| Field | Type | Description |
|---|---|---|
| longitudeLongitude | number | Longitude coordinate used for the search location.Longitude coordinate used for the search location. |
| latitudeLatitude | number | Latitude coordinate used for the search location.Latitude coordinate used for the search location. |
| radius | number | Search radius, in kilometers, around the given location.Search radius, in kilometers, around the given location. |
| target_diploma_levelTarget diploma level | string | Diploma level targeted by the training or job offer.Diploma level targeted by the training or job offer. |
| romes | string | ROME occupation code(s) used to filter results.ROME occupation code(s) used to filter results. |
| rncp | string | RNCP certification code used to filter results.RNCP certification code used to filter results. |
| opco | string | Skills operator (OPCO) associated with the employer or offer.Skills operator (OPCO) associated with the employer or offer. |
| departements | array | List of French department codes used to filter results.List of French department codes used to filter results. |
| partners_to_excludePartners to exclude | array | List of partner sources to exclude from the results.List of partner sources to exclude from the results. |
| id | string | Unique identifier of the record.Unique identifier of the record. |
| identifiant.cfd | string | CFD code identifying the diploma.CFD code identifying the diploma. |
| identifiant.rncp | string | RNCP code identifying the certification.RNCP code identifying the certification. |
| code | string | Code identifying the record or entity.Code identifying the record or entity. |
| uai | string | UAI code identifying the educational institution.UAI code identifying the educational institution. |
| siretSIRET (establishment) | string | SIRET number identifying the establishment.SIRET number identifying the establishment. |
| page_sizePage size | integer | Number of results returned per page.Number of results returned per page. |
| page_indexPage index | integer | Index of the requested page of results.Index of the requested page of results. |
| include_archivedInclude archived | string | Flag indicating whether archived records should be included.Flag indicating whether archived records should be included. |
| identifiantCertification | object | Identifiers of the certification, including CFD and RNCP codes.les fiches RNCP antérieures à la réforme de 2019 ont certaines données qui ne sont pas renseignées, elles sont identifiées par le champ `rncp_anterieur_2019` à `true`. |
| intituleCertification | object | Title(s) of the certification.Title(s) of the certification. |
| base_legaleCertification | object | Creation and repeal dates of the diploma set by official decree.Dates de création et d’abrogation des diplômes crées par arrêtés |
| blocs_competencesCertification | object | Codes and titles of the skill units validated by the certification.Liste du (ou des) code (s) et intitulé(s) des blocs de compétences validés par la certification |
| convention_collectivesCertification | object | Collective labor agreements linked to the certification.Liste(s) de la ou des convention(s) collective(s) rattachées à la certification |
| domainesCertification | object | Fields or domains associated with the certification.Fields or domains associated with the certification. |
| periode_validiteCertification | object | Validity period of the CFD-RNCP certification pair.**Un couple CFD-RNCP a une période de validité** qui correspond à l’intersection de la période d’ouverture du diplôme et de la période d’activité de la fiche RNCP. Notes: Les dates sont retournées au format ISO 8601 avec le fuseau horaire Europe/Paris. |
| typeCertification | object | Type of the certification.Type of the certification. |
| continuiteCertification | object | List of CFD-RNCP pairs showing the certification's succession history.**Liste des couples CFD-RNCP assurant la continuité de la certification professionnelle.** La liste inclut à la fois les fiches remplacées et remplaçantes. Elle est ordonnée par date d'activation de la fiche RNCP et inclut la fiche courante. |
| nomCommune | string | Name of the municipality (commune).Nom de la commune |
| anciennesCommune | array<object> | Former municipalities that were merged into this one.Anciennes communes fusionnées |
| arrondissementsCommune | array<object> | Arrondissements (districts) belonging to the municipality.Arrondissements de la commune |
| departementCommune | object | Department the municipality belongs to.Département de la commune |
| regionCommune | object | Region the municipality belongs to.Région de la commune |
| academieCommune | object | Educational académie the municipality belongs to.Académie de la commune |
| localisationCommune | object | Geographic center and bounding box of the municipality, in GeoJSON.Les informations de localisations sont composés du: - Du `centre` de la commune - De la boite englobante (`bbox`) qui délimite la zone de la commune. Les champs `centre` et `bbox` sont tous les deux au format [GeoJSON](https://fr.wikipedia.org/wiki/GeoJSON) |
| mission_localeCommune | unknown | Local youth employment agency covering the municipality.Mission locale dont relève la commune |
| codeInseeDepartement | string | INSEE code identifying the department.Code INSEE du département |
| contactMissionLocale | object | Contact details of the local employment agency (mission locale).Contact de la mission locale |
| identifierJobRecruiter | object | Source partner and unique identifier of the job offer.Cet élément regroupe : - le partenaire à l'origine de l'offre d'emploi - l'identifiant unique de l'offre d'emploi au sein du système d'information La bonne alternance |
| workplaceJobRecruiter | object | Details of the workplace, including company name, SIRET, and size.Le lieu d’exécution du contrat est décrit par : - Le nom (enseigne ou à défaut, raison sociale) et le numéro SIRET de l’entreprise. - La description de l’employeur et/ou du service où s’exécutera le contrat. - La tranche effectif de l’entreprise, en nombre de salariés. - Le site web de l’entreprise |
| applyJobRecruiter | object | Application methods available for the job offer.Cet élément regroupe les différents moyens de candidature proposés aux candidats. - URL vers laquelle rediriger le candidat pour qu’il postule - Numéro de téléphone de la personne chargée du recrutement - Identifiant de l’opportunité d’emploi à utiliser pour permettre à vos usagers de candidater di |
| contractJobOfferRead | object | Contract details, including type, start date, duration, and work mode.Un contrat est décrit par : - Le type (apprentissage et/ou professionnalisation). - La date de début. - La durée. - Le mode de travail (présentiel, télétravail ou hybride). |
| offerJobOfferRead | object | Details of the job offer, including title and description.Une offre d’emploi est décrite par : - L’intitulé. Exemple : Développeur / Développeuse web. - La description. Exemple : Conçoit, développe et met au point un projet d'application informatique, de la phase d'étude à son intégration, pour un client ou une entreprise selon des besoins fonctionnels et |
| is_delegatedJobOfferRead | boolean | Indicates whether offer management is delegated to a partner training center.Indique si la gestion de l'offre est déléguée à un CFA partenaire. valeurs true | false |
| publishingJobOfferPublishing | object | Publishing information about the job offer.Informations sur la publication de l'offre d'emploi |
| urlJobOfferExport | string | Download URL for the job offer export, valid for 2 minutes.URL de l'export. le lien de téléchargement est valable pendant 2 minutes. Les offres sont au format JSON. La structure de données des offres est identique à la réponse de la [route de recherche](/fr/documentation-technique#tag/Offre-Emploi/operation/jobSearch) |
| lastUpdateJobOfferExport | string (date-time) | Date and time the export was generated.Date de l'export |
| applicant_first_nameJobApplicationWrite | string | First name of the job applicant.Prénom du candidat |
| applicant_last_nameJobApplicationWrite | string | Last name of the job applicant.Nom du candidat |
| applicant_emailJobApplicationWrite | string (email) | Email address of the job applicant.Email du candidat |
| applicant_phoneJobApplicationWrite | string | Phone number of the job applicant.Numéro de téléphone du candidat |
| applicant_attachment_nameJobApplicationWrite | string | File name of the applicant's CV.Nom du CV |
| applicant_messageJobApplicationWrite | string | Message written by the applicant.Message du candidat |
| applicant_attachment_contentJobApplicationWrite | string (byte) | Encoded content of the applicant's CV file.CV du candidat |
| recipient_idJobApplicationWrite | string | Identifier of the offer recipient, from the search results apply field.Identifiant du destinataire récupéré de `apply.recipient_id` depuis les resultas de la route de recherche. |
| statutFormation | object | Status of the training program.Statut de la formation |
| formateurFormation | object | Organization responsible for delivering the training.Formateur de la formation L'organisme formateur a pour mission de dispenser la formation |
| responsableFormation | object | Organization administratively responsible for the training.Responsable de la formation Le responsable de la formation est l'organisme qui a la responsabilité administrative de la formation Il peut s'agir d'un organisme qui n'est plus sur le référentiel des organismes de formation. Veuillez vérifier le statut de l'organisme. |
| certificationFormation | object | Certification associated with the training program.Certification de la formation |
| lieuFormation | object | Location where the training is delivered.Lieu où la formation est dispensée |
| onisepFormation | object | Information about the training sourced from ONISEP.Informations lié à la formation issues de l'ONISEP |
| modaliteFormation | object | Delivery mode of the training program.Modalité de la formation |
| contenu_educatifFormation | object | Educational content of the training program.Contenu éducatif de la formation |
| sessionsFormation | array<object> | List of scheduled sessions for the training.Liste des sessions de formation |
| etablissementOrganisme | object | Establishment details of the training organization.Etablissement de l'organisme |
| unite_legaleOrganisme | object | Legal entity details of the training organization.Unité légale de l'organisme |
| renseignements_specifiquesOrganisme | object | Specific additional information about the organization.Renseignements spécifiques |
| contactsOrganisme | array<object> | Contact details of the organization.Contacts de l'organisme |
| coordinatesGeoJsonPoint | array<unknown> | Geographic coordinates in GeoJSON point format.Geographic coordinates in GeoJSON point format. |
| labelAdresse | unknown | Full text label of the address.Libellé de l'adresse |
| code_postalAdresse | unknown | Postal code of the address.Code postal |
| communeAdresse | object | Municipality (city) of the address.Ville |
| page_countPagination | integer | Total number of pages available for the results.Nombre total de pages |
Schema captured from openapi 26 days ago.
Verification Status
Using the API
Configuration
- Base URL
- https://api.apprentissage.beta.gouv.fr/fr?utm_source=data-gouv&utm_medium=web&utm_campaign=data-gouv_api-lba
- Format
- openapi
License
Terms stated by the source (not a recognized license):
https://github.com/etalab/licence-ouverte/blob/master/LO.md
Query examples
Stored only in this browser. Runs go directly from your browser to the API — the key is never sent through our servers.
curl -s 'https://api.apprentissage.beta.gouv.fr/api/swagger.json?lang=fr' -H 'Accept: application/json'Machine-readable API description (use it to generate clients).
Machine-readable & source
Embed this badge in a README or wiki — it always shows the latest verification state and quality tier.