### Principales données disponibles

| Donnée                | Exemple                                   |
| --------------------- | ----------------------------------------- |
| Nom_etablissement     | Collège Jean Jaurès                       |
| Type_etablissement    | Collège                                   |
| Statut_public_prive   | Public                                    |
| Adresse_1             | Esplanade La Noria                        |
| Code_Postal           | 34360                                     |
| Code_Commune          | 34245                                     |
| Nom_Commune           | Saint-Chinian                             |
| Code_département      | 34                                        |
| Voie                  | Professionnelle ; Générale ; Technlogique |
| Téléphone             | 0000000000                                |
| Mail                  | etablissement@mail.fr                     |
| Restauration          | 0 ; 1                                     |
| Section               | Européenne, Internationale ; Sport        |
| Education prioritaire | (null) ; REP ; REP+                       |
| SIREN_SIRET           | 19011011400013                            |
| Nombre d'élèves       | 545                                       |
| Date_ouverture        | 15 avril 1975                             |
| état                  | OUVERT                                    |
| ministère_tutelle     | MINISTERE DE L'EDUCATION NATIONALE        |


L’API annuaire de l’Education Nationale donne accès aux caractéristiques et aux informations de contact des établissements de l'Éducation nationale.

### A quoi sert l'API annuaire de l’Education Nationale ?

L'annuaire contient les données de plus de 66000 établissements scolaires, qu'ils soient publics ou privés : écoles, collèges, lycées, établissements régionaux d'enseignement adapté (EREA), services administratifs, ou bien d'information et orientation.

L'API permet de rechercher des établissements sur un territoire, d'obtenir une sélection par type d'établissement, et d'accéder à leurs coordonnées de contact.


Accédez aux données de l’annuaire des établissements de l'Education Nationale

ONISEP

Annuaire de l’Education Nationale

### Que contient l'API calendrier scolaire ?

L'API permet d'intégrer (sur un site web ou une application) les dates des vacances scolaires des différentes zones et pour toutes les académies.

👉 Le départ en vacances a lieu après la classe des jours indiqués, et la reprise des cours s'effectue le matin des jours indiqués.

### Principales données disponibles

| Donnée                | Exemple                                   |
| --------------------- | ----------------------------------------- |
| Description           | Vacances d'été                            |
| Population            | "Enseignants" ou "élèves"                 |
| Date de début         | 7 juillet 2023                            |
| Date de fin           | 1 septembre  2023                         |
| Académie              | Lille                                     |
| Zone                  | Zone B                                    |
| Année scolaire        | 2022-2023                                 |


L’API calendrier scolaire permet d'accéder aux dates de début et de fin des vacances scolaires pour l'année scolaire en cours.


Intégrez le calendrier scolaire officiel sur votre site ou application

API calendrier scolaire

Seules les administrations et certaines sociétés sont habilitées à publier leurs annonces sur l'API Engagement.
En revanche, il vous est possible de consulter les annonces sur [JeVeuxAider.gouv.fr](https://www.jeveuxaider.gouv.fr/) ou [le portail Service Civique](https://www.service-civique.gouv.fr/jeunes-volontaires/?gclsrc=aw.ds)

<Button href="/rechercher-api">Rechercher une autre API</Button>


Si vous êtes une collectivité ou une administration, vous pouvez remplir une demande d’habilitation à l’API Engagement vous-même pour l'entité que vous représentez.

C'est cette demande d'habilitation qui vous permet à la fois de poster des annonces, ou de diffuser un flux d'annonces.

<NextSteps />
<Button href="https://doc.api-engagement.beta.gouv.fr/getting-started/create-your-account">Demander un accès</Button>


Les entreprises peuvent publier des annonces et les diffuser via l'API Engagement.

<NextSteps />
<Button href="https://doc.api-engagement.beta.gouv.fr/getting-started/create-your-account">Demander un accès</Button>


Les éditeurs de logiciels peuvent publier des annonces et les diffuser via l'API Engagement.

<NextSteps is_editeur />
<Button href="https://doc.api-engagement.beta.gouv.fr/getting-started/create-your-account">Demander un accès</Button>


### Données accessibles dans l'API

L'API Engagement permet de publier les données suivantes pour chaque annonce :

Les champs requis :

| Champ          | Description                            |
| -------------- | -------------------------------------- |
| title          | Titre de votre mission                 |
| description    | La description de votre mission        |
| clientId       | L'identifiant interne de votre mission |
| applicationUrl | L'url vers votre annonce               |

Les champs générés par l'API :

L'api génère automatiquement les champs suivant :

- publisherId :
- publisherName
- publisherLogo
- publisherUrl :
- statusCode ( ACCEPTED OR REFUSED )
- statusComment : Un commentaire sur le pourquoi la mission a été refusée
- createdAt : La date de creation de la mission
- updatedAt : La date de la dernière mise a jour de la mission

Les champs optionnels

| Champ                     | Description                                                                         |
| ------------------------- | ----------------------------------------------------------------------------------- |
| organizationUrl           | L'url de l'organisation qui cherche un bénévole                                     |
| organizationId            | ID unique de l'organisation qui la distingue des autres organisations de votre flux |
| organizationFullAddress   | L'adresse complete de l'organisation                                                |
| organizationType          | Association type ( 1901, 1905, ou autre)                                            |
| organizationDescription   | Description de l'organisation                                                       |
| postedAt                  | Date a laquelle la mission a été postée                                             |
| startAt                   | Date de début de la mission                                                         |
| endAt                     | Date de fin de la mission                                                           |
| adresse                   | Adresse de la mission.                                                              |
| postalCode                | Code postale de la mission                                                          |
| departmentName            | Nom du département de la mission                                                    |
| departmentCode            | Code du département (ex : 84)                                                       |
| reducedMobilityAccessible | Is accessible to mobility reduced people                                            |
| openToMinors              | Is available for 16+ years old                                                      |
| city                      | Ville de la mission                                                                 |
| region                    | Région de la mission                                                                |
| region                    | Pays de la mission. Valeur par défaut : France                                      |
| region                    | Longitude et latitude de la mission                                                 |
| country                   | L'url vers votre annonce                                                            |
| location                  | L'url vers votre annonce                                                            |
| places                    | Nombre de places restantes non attribuées : Valeur par défaut :1                    |
| domain                    | Domaine de la mission.                                                              |
| activity                  | l'activité faite lors de la mission                                                 |
| remote                    | Si la mission est en présentiel, a distance ou flexible ( no, possible, full )      |

### En savoir plus

Pour obtenir plus d'informations sur l'API Engagement, [contactez l’équipe](mailto:contact@api-engagement.beta.gouv.fr)


L'API Engagement permet aux organisations de publier et diffuser des annonces de bénévolat et de volontariat.

### A quoi sert l’API Engagement ?

L’API Engagement facilite la diffusion des missions de bénévolat et de volontariat partout en France. C’est un service public numérique gratuit qui permet aux plateformes d’engagement publiques et privées de mettre en commun leurs missions. L'API permet ainsi d'augmenter la visibilité des annonces et le taux d’occupation des places offertes aux potentiels bénévoles et volontaires.

Concrètement, chaque plateforme peut intégrer l’API pour diffuser ses missions vers les autres plateformes partenaires d'une part, et récupérer les missions disponibles sur les autres plateformes selon des critères spécifiques comme la localisation, le domaine d’action, etc. Le tableau de bord de l’API permet à chaque partenaire de configurer les flux de missions entrant/sortant et de mesurer la contribution de chaque plateforme en missions et en trafic.


Accéder aux missions de bénévolat et de volontariat partout en France

DINUM

API Engagement

L’usage de cette API est **uniquement reservé aux acteurs publics**. En tant que particulier, vous ne pouvez pas y accéder.

<Button href="/rechercher-api">Rechercher une autre API</Button>


L’usage de cette API est **uniquement reservé aux acteurs publics**.

<Button href="/rechercher-api">Rechercher une autre API</Button>


Cette API, délivrée par le Ministère de l'éducation nationale, permet de vérifier si un particulier est scolarisé au primaire, au collège ou au lycée, et savoir s'il est boursier.
Votre service utilisera d'autres API ? Retrouvez les données de cette API dans le bouquet d'API distribué par la DINUM [API Particulier](les-api/api-particulier).

### Périmètre

#### Particuliers concernés :

Cette API concerne les ✅ élèves du primaire, du collège et du lycée.
Une large majorité d’établissements sont concernés :
- ✅ établissements publics ;
- ✅ établissements privés sous contrat ;
- ✅ lycées militaires et lycées maritimes ;
- ✅ une partie des formations à distance du CNED.

Concernant le statut boursier des élèves : seules les bourses sur critères sociaux à l’échelle nationale sont couvertes par l’API. Par ailleurs, les bourses ne concernent que les collégiens et lycéens.

Les établissements suivants ne sont pas couverts par l’API :
- ❌ établissements privés hors contrat ;
- ❌ lycées agricoles ;
- ❌ instruction dans la famille.

####  Périmètre géographique :
- ✅ France métropolitaine
- ✅ DROM-COM

#### Actualisation de la donnée 

Cette API délivre les informations de l’année scolaire en cours et bientôt de l’année scolaire à venir (N+1).
Les données du premier degré (primaire) sont mises à jour en temps réel. Les données du second degré (collèges et lycées) sont mises à jour quotidiennement toutes les nuits.
Les informations, même si elles évoluent principalement lors de la rentrée scolaire en septembre, peuvent changer en cours d’année (déménagements, etc.).

⚠️ Attention, si un élève est indiqué “non-boursier” avant mi-octobre, il ne faut pas prendre en compte cette information. Le statut non-boursier est véritablement fiable à partir de mi-octobre.


### Modalités d'appel
Cette API propose une modalité d’appel avec les données d’identité, tous les paramètres sont obligatoires : 
- Nom, prénom,
- sexe et date de naissance de l’élève,
- code UAI de l’établissement
- année scolaire souhaitée.

### Données

Cette API indique si l’élève est scolarisé et sous quel statut pour l’année scolaire en cours et bientôt N+1. Le statut boursier ainsi que l’échelon de bourse est également précisé le cas échéant.

Informations renvoyées en JSON : 

| Nom         | Description                                                                                                              |
| ----------- | ------------------------------------------------------------------------------------------------------------------------ |
| Information sur l'élève     | Le nom, prénom, sexe, date de naissance de l'élève. <br/>La recherche s'effectue avec les données entrées en paramètre. Si les nom ou prénom sont incomplets en entrée, ils sont retournés complets en retour. |
| Code UAI de l'établissement | Code d'unité administrative immatriculée (code UAI) de l'établissement où est scolarisé l'élève. <br/>Ce code unique inscrit au répertoire national des établissements est composé de 7 chiffres et d'une lettre ; les trois premiers chiffres correspondent au numéro de département de l'établissement. Pour retrouver facilement le code UAI d'un établissement à partir d' informations plus facilement connues des usagers (commune, code postal, etc.), vous pouvez utiliser l'[API "Annuaire de l'éducation nationale"](/les-api/api-annuaire-education).<br/>NB : L'établissement 0861288H (CNED Direction générale) n'existe pas dans l'API annuaire de l'éducation nationale, il faudra donc compléter la liste des établissements avec une ligne CNED à laquelle sera associée le code UAI qui sera en passé en entrée. |
| Année scolaire      | Année scolaire de l'élève au format AAAA-AAAA ou AAAA (AAAA= 2023 pour l'année scolaire 2023-2024)   |
| Est scolarisé        | True / False : indique si l'élève est scolarisé dans l'établissement. |
| Est boursier        | True / False : indique si l'élève est boursier dans l'établissement. <br/>Les bourses concernent uniquement les élèves des collèges et lycées. NB : Si le statut boursier est à "false" avant mi-octobre, cela ne signifie pas forcément que l'élève n'est pas boursier. Il peut s'agir d'un faux négatif lié à une absence de l'information en base. <br/>Pour en savoir plus consulter <External href="https://particulier.api.gouv.fr/catalogue/education_nationale/statut_eleve_scolarise#faq_entry_answer_1_api_particulier_endpoint_education_nationale_statut_eleve_scolarise">la fiche métier</External>.|
| Niveau de bourse        | exemple : 1 : indique l'échelon de la bourse de l'élève. <br/>Est à "null" quand "est_boursier" est "false". Les bourses concernent uniquement les élèves des collèges et lycées. Il existe trois échelons de bourses pour les collégiens (1 à 3) et six échelons pour les lycéens (1 à 6), correspondant aux montants reçus par l'élève pour l'année scolaire. Pour en savoir plus, consulter <External href="https://particulier.api.gouv.fr/catalogue/education_nationale/statut_eleve_scolarise#faq_entry_answer_2_api_particulier_endpoint_education_nationale_statut_eleve_scolarise">la fiche métier</External>.  |
| Code statut de l'élève  | Indique le statut sous lequel l'élève est scolarisé dans l'établissement. <br/>Les valeurs sont susceptibles d'évoluer : ST : Scolaire, il s'agit du statut de base renvoyé pour près de 95% des élèves / AP : Apprenti / CQ : Contrat de qualification / FC : Formation continue / ED : Enseignement à distance / IN : Candidat individuel / FQ : Stagiaire de la formation Professionnelle / SC : Scolaire ou formation initiale / CP : Contrat de professionnalisation. / NC : Non connu ou non communiqué. |
| Libellé statut de l'élève        | Exemple : SCOLAIRE : Libellé du statut sous lequel l'élève est scolarisé dans l'établissement.|


### Modalités d'utilisation des scopes

Lors de votre demande d'habilitation, vous aurez à sélectionner un ou plusieurs scopes selon votre cas d'usage.
Cette API comprend trois périmètres d'accès : 

| Nom du scope        | Données accessibles  |                                                                                           
| ----------- | --------------------------------------- |
| Scolarité     | état_scolarité + statut_scolaire |
| état_boursier | boursier oui/non |
| niveau_bourse| échelon de la bourse|



Statut scolarisé et statut boursier d'un élève du primaire, collège ou lycée.

Direction Interministérielle du Numérique

API scolarité de l'élève

L’API données ouvertes de <External href='https://data.education.gouv.fr/'>l’Éducation Nationale</External> est une API ouverte à tous, qui permet d’accéder à l’ensemble du catalogue de jeux de données publiés sur le portail Open data.

### A quoi sert l’API données ouvertes de l’Éducation Nationale

L’API met à disposition l’ensemble des jeux de données publics (non restreints) du catalogue de jeux de données du portail.

Cette API est en accès libre. Elle permet à tout le monde de :

- Réutiliser les jeux de données publics du portail données ouvertes de l’Éducation Nationale
- Bénéficier des données mises à jour directement via l’API qui « appelle » les données du catalogue

### Données disponibles

Parmi les principaux jeux de données accessibles via cette API, on peut citer :

| Donnée                                                       | Lien vers le jeu de données                                                                                                                                            |
| ------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Annuaire de l'éducation                                      | <External href='https://data.education.gouv.fr/explore/dataset/fr-en-annuaire-education/api/'>En savoir plus</External>                                                |
| Adresse et géolocalisation des établissements d'enseignement | <External href='https://data.education.gouv.fr/explore/dataset/fr-en-adresse-et-geolocalisation-etablissements-premier-et-second-degre/api/'>En savoir plus</External> |
| Calendrier scolaire                                          | <External href='https://data.education.gouv.fr/explore/dataset/fr-en-calendrier-scolaire/api/'>En savoir plus</External>                                               |
| Taille des collèges et lycées                                | <External href='https://data.education.gouv.fr/explore/dataset/fr-en-taille-colleges-lycees/api/'>En savoir plus</External>                                            |
| Diplômes du secondaire et des formations intermédiaires      | <External href='https://data.education.gouv.fr/explore/dataset/fr-en-diplomes-etablissements-secondaire/api/'>En savoir plus</External>                                |


Découvrez les jeux de données publiques ouverts et n’hésitez pas à nous faire connaître vos réutilisations de données et créations de nouveaux services !

Enseignement supérieur, Recherche et Innovation

Le nombre d'appels API pour un utilisateur anonyme est limité à 5000 appels par adresse IP et par jour.


Ministère de l'Éducation nationale et de la Jeunesse (MENJ)

Quelles sont les API de Ministère de l'Éducation nationale et de la Jeunesse ?