Tool

Submit apprenticeship job offers

Post and modify your apprenticeship job offers to maximize their visibility by posting them on the La bonne alternance platform and its partner sites.

💡 This API allows you to share your apprenticeship job offers for free in a secure and automated way. If you prefer to post your offers via an interface, you can use the manual offer posting form offered by La bonne alternance.

💡 The job postings published through this API must be linked to the SIRET number of the employer where the contract will be carried out. This API does not allow training centers to publish offers on behalf of their partner companies.

Using this tool requires a habilitation

To build without waiting, use a sandbox key: the habilitation is granted automatically and exchanges go to a La bonne alternance test environment. Create a sandbox key from my account

Learn more: Access and habilitations

Illustration d'une designeuse qui présente un projet sur un écran

Need this data for your project?

View the swagger

Get an API key

Request a habilitation

Data details

Contract

contract

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).

.duration

.start

.start_type

.start_is_flexible

.type

.remote

Offer

offer

A job offer is described by:

The title. Example: Web Developer.
The description. Example: Designs, develops, and implements a software application project, from the study phase to its integration, for a client or company, according to functional needs and specifications. May lead development projects. May coordinate a team.
The targeted diploma level. Example: BP, Bac, other level (Bac) qualifications.
The skills or qualities expected for the position. Example: Demonstrate autonomy; Show creativity and inventiveness; Display rigor and precision; Work well in a team.
The skills or qualities to be acquired during the apprenticeship. Example: Research, Innovation (Analyze relevant indicators on trends and customer usage; Design and develop a digital solution; Create technical documentation). New technologies (Assemble software components; Design a web application).
The conditions for entering the profession. Example: This profession is accessible with a degree from Bac+2 (BTS, DUT) to Master (MIAGE, engineering degree, professional Master, etc.) in computer science. It is also accessible with professional experience in computer science, operating systems, or an application domain. Proficiency in English (technical vocabulary) is required.
The number of positions to be filled.
List of ROME codes associated to the offer.

.access_conditions

.description

.desired_skills

.opening_count

.rome_codes

.status

.target_diploma

.title

.to_applicant_questions

.to_be_acquired_skills

Information

The ROME corresponds to the Operational Reference for Jobs and Occupations. Designed by France Travail (formerly Pôle Emploi), this reference system presents all professions grouped into profiles, organized by professional fields.

publication

A job opportunity has a life cycle: a creation date and an expiration date.

.creation

.expiration

multicast

By default, the offers posted are available on La bonne alternance and redistributed to its partner sites. You can choose to exclude the redistribution to partner sites by specifying

multicast: false

Information

When the

multicast

option is activated, the company's contact email address is not shared with partner sites. The list of shared data is available on the alternance job opportunities search page.

Workplace

workplace

Workplace is described by :

The name (brand name or, failing that, the company name) and the SIRET number of the company.
The description of the employer and/or the department where the contract will be carried out.
The company's workforce range, in terms of the number of employees.
The company's website.

.siret

.name

.description

.brand

.legal_name

.size

.website

location

Postal address of the contract execution location. If provided, it must be as precise as possible because it is used to derive the GPS coordinates of the location, via the Adresse API. If no address is provided, the address and the geolocation of the offer are derived from the company’s SIRET number.

.address

Apply

apply

This element groups the different means of application offered to candidates.

URL to redirect the candidate to apply
Phone number of the person in charge of recruitment
Email of the person in charge of recruitment. This email will not be visible to the candidate.

Need this data for your project?

View the swagger

Are you missing one or more data to meet your needs?

Tell us

Illustration d'un homme qui hausse les épaules

Sources et fournisseurs des données

La bonne alternance

Revenir à la liste

Tool

Submit apprenticeship job offers

Post and modify your apprenticeship job offers to maximize their visibility by posting them on the La bonne alternance platform and its partner sites.

Using this tool requires a habilitation

To build without waiting, use a sandbox key: the habilitation is granted automatically and exchanges go to a La bonne alternance test environment. Create a sandbox key from my account

Learn more: Access and habilitations

Need this data for your project?

View the swagger

Get an API key

Request a habilitation

Data details

Contract

contract

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).

.duration

.start

.start_type

.start_is_flexible

.type

.remote

Offer

offer

A job offer is described by:

The title. Example: Web Developer.
The description. Example: Designs, develops, and implements a software application project, from the study phase to its integration, for a client or company, according to functional needs and specifications. May lead development projects. May coordinate a team.
The targeted diploma level. Example: BP, Bac, other level (Bac) qualifications.
The skills or qualities expected for the position. Example: Demonstrate autonomy; Show creativity and inventiveness; Display rigor and precision; Work well in a team.
The skills or qualities to be acquired during the apprenticeship. Example: Research, Innovation (Analyze relevant indicators on trends and customer usage; Design and develop a digital solution; Create technical documentation). New technologies (Assemble software components; Design a web application).
The conditions for entering the profession. Example: This profession is accessible with a degree from Bac+2 (BTS, DUT) to Master (MIAGE, engineering degree, professional Master, etc.) in computer science. It is also accessible with professional experience in computer science, operating systems, or an application domain. Proficiency in English (technical vocabulary) is required.
The number of positions to be filled.
List of ROME codes associated to the offer.

.access_conditions

.description

.desired_skills

.opening_count

.rome_codes

.status

.target_diploma

.title

.to_applicant_questions

.to_be_acquired_skills

Information

publication

A job opportunity has a life cycle: a creation date and an expiration date.

.creation

.expiration

multicast

By default, the offers posted are available on La bonne alternance and redistributed to its partner sites. You can choose to exclude the redistribution to partner sites by specifying

multicast: false

Information

When the

multicast

option is activated, the company's contact email address is not shared with partner sites. The list of shared data is available on the alternance job opportunities search page.

Workplace

workplace

Workplace is described by :

The name (brand name or, failing that, the company name) and the SIRET number of the company.
The description of the employer and/or the department where the contract will be carried out.
The company's workforce range, in terms of the number of employees.
The company's website.

.siret

.name

.description

.brand

.legal_name

.size

.website

location

.address

Apply

apply

This element groups the different means of application offered to candidates.

URL to redirect the candidate to apply
Phone number of the person in charge of recruitment
Email of the person in charge of recruitment. This email will not be visible to the candidate.

Need this data for your project?

View the swagger

Are you missing one or more data to meet your needs?

Tell us

Sources et fournisseurs des données

La bonne alternance