Récupérer des missions

Récupérer toutes les missions de vos partenaires avec des filtres précis

GET https://api.api-engagement.beta.gouv.fr/v0/mission

Vous pouvez retrouver le modèle de données des missions ici

Query Parameters

Name	Type	Description
activity	string	Filtrer sur l'activité. Vous pouvez en indiquer plusieurs en les séparant par une virgule ","
city	string	Filtrer sur la ville. Vous pouvez en indiquer plusieurs en les séparant par une virgule ","
clientId	string	Filtrer sur les identifiants partenaires des mission. Vous pouvez en indiquer plusieurs en les séparant par une virgule ","
country	string	Filtrer sur le pays
createdAt	gt:Date / lt:Date	Filtrer sur la date de création de la mission Ex: "gt:2021-11-10T04:24:33.866Z"
departmentName	string	Filtrer sur le nom du département. Vous pouvez en indiquer plusieurs en les séparant par une virgule ","
distance	string	Distance autour de la latitude et de la longitude. Il est possible de preciser l'unité avec "m" ou "km". Défaut à "50km" Ex: "5km","5000m"
domain	string	Filtrer sur le domaine. Vous pouvez en indiquer plusieurs en les séparant par une virgule ","
keywords	string	Chercher par un keyword a dans les champs title, organizationName, publisherName et city
limit	number	Nombre maximal de résultats à retourner en une seule fois.
lat	number	Filtrer par localisation autour dans un cercle de rayon distance avec cette latitude, nécessite lon
lon	number	Filtrer par localisation autour dans un cercle de rayon distance avec cette longitude, nécessite lat
organizationRNA	string	Filtrer sur l'organisation. Vous pouvez en indiquer plusieurs en les séparant par une virgule ","
organizationStatusJuridique	string	Filtrer sur la forme juridique de l'organisation. Vous pouvez en indiquer plusieurs en les séparant par une virgule ","
openToMinors	string	Filtrer sur l'ouverture aux mineurs. "yes" ou "no"
publisher	string	Filtrer sur le partenaire. Vous pouvez en indiquer plusieurs en les séparant par une virgule ","
remote	string	Filtrer sur la mission à distance ou non.
reducedMobilityAccessible	string	Filtrer sur l'accessibilité aux personnes à mobilité réduite. "yes" ou "no"
skip	number	Nombre de résultats à omettre avant de commencer à retourner les résultats.
startAt	gt:Date / lt:Date	Filtrer sur la date de début de la mission Ex: "gt:2021-11-10T04:24:33.866Z"
type	string	Filtrer sur le type

Headers

Name	Type	Description
x-api-key requis	string	La clé API nécessaire à l’authentification. Les données disponibles sont définies en fonction de votre clé API.

200 OK

{
    "ok": true,
    "total": 65,
    "data": [
        {
            "_id": "mission_id",
            "clientId": "12345",
            "activity": "mentorat-parrainage",
            "addresses": [
                {
                    "street": "Saint-Paul",
                    "city": "Saint-Paul",
                    "postalCode": "97411",
                    "departmentName": "La Réunion",
                    "departmentCode": "974",
                    "region": "La Réunion",
                    "country": "FR",
                    "location": {
                        "lat": -21.0097,
                        "lon": 55.2697
                    },
                    "geoPoint": {
                        "type": "Point",
                        "coordinates": [
                            55.2697,
                            -21.0097
                        ],
                        "_id": "_id"
                    },
                    "geolocStatus": "ENRICHED_BY_PUBLISHER",
                    "_id": "_id"
                }
            ],
            "applicationUrl": "https://api.api-engagement.beta.gouv.fr/r/mission_id/publisher_id",
            "audience": [
                "children",
                "any_public"
            ],
            "closeToTransport": "no",
            "createdAt": "2021-05-11T09:07:59.000Z",
            "deleted": false,
            "deletedAt": null,
            "description": "Description de la mission",
            "descriptionHtml": "<p>Description de la mission</p>",
            "domain": "education",
            "domainLogo": "https://api-engagement-bucket.s3.fr-par.scw.cloud/img/generique.jpeg",
            "endAt": null,
            "lastSyncAt": "2025-03-05T14:01:21.576Z",
            "metadata": "",
            "openToMinors": "no",
            "organizationActions": [],
            "organizationBeneficiaries": [],
            "organizationCity": "organization_city",
            "organizationClientId": "6789",
            "organizationDescription": "",
            "organizationFullAddress": "organization_address",
            "organizationId": "organization_id",
            "organizationLogo": "organization_logo",
            "organizationName": "organization_name",
            "organizationPostCode": "organization_postcode",
            "organizationRNA": "W1234567890",
            "organizationReseaux": [],
            "organizationSiren": "",
            "organizationStatusJuridique": "Association",
            "organizationType": "",
            "organizationUrl": "organization_url",
            "places": 4,
            "postedAt": "2021-05-11T09:07:59.000Z",
            "priority": "",
            "publisherId": "publisher_id",
            "publisherLogo": "publisher_logo",
            "publisherName": "publisher_name",
            "publisherUrl": "publisher_url",
            "reducedMobilityAccessible": "no",
            "remote": "no",
            "schedule": "1 heure",
            "snu": false,
            "snuPlaces": null,
            "softSkills": [],
            "startAt": "2020-11-16T08:00:00.000Z",
            "statusCode": "ACCEPTED",
            "statusComment": "",
            "statusCommentHistoric": [
                {
                    "status": "ACCEPTED",
                    "comment": "",
                    "date": "2024-10-07T07:01:48.188Z",
                    "_id": "_id"
                }
            ],
            "tags": [
                "tag_1"
            ],
            "tasks": [],
            "title": "Titre de la mission",
            "updatedAt": "2025-03-05T14:02:34.758Z"
        },
        [...]
    ]
}

400 Bad Request

{
    "ok": false,
    "code": "INVALID_QUERY",
    "message": {
        "issues": [
            {
                "received": "true",
                "code": "invalid_enum_value",
                "options": [
                    "yes",
                    "no"
                ],
                "path": [
                    "openToMinors"
                ],
                "message": "Invalid enum value. Expected 'yes' | 'no', received 'true'"
            }
        ],
        "name": "ZodError"
    }
}

401 Unauthorized

Unauthorized

500 Internal Server Error

{
    "ok": false,
    "code": "SERVER_ERROR"
}