/mission

L'endpoint /mission permet de récupérer les missions qui vous sont disponibles

Récupérer des missions de vos partenaires

Récupération de toutes les missions

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

Récupérer toutes les missions de vos partenaires. A noter que vous récupérez, en plus des résultats demandés, le nombre total de résultats disponibles

Query Parameters

NameTypeDescription

departmentName

string

Filtrer sur le nom du département

country

string

Filtrer sur le pays

activity

string

Filtrer sur l'activité (cf. Les constantes). Vous pouvez en indiquer plusieurs en les séparant par une virgule ","

city

string

Filtrer sur la ville

publisher

string

Filtrer sur le partenaire. Vous pouvez en indiquer plusieurs en les séparant par une virgule ","

domain

string

Filtrer sur le domaine (cf. Les constantes). Vous pouvez en indiquer plusieurs en les séparant par une virgule ","

type

string

Filtrer sur le type

skip

number

Nombre de résultats à omettre avant de commencer à retourner les résultats.

limit

number

Nombre maximal de résultats à retourner en une seule fois.

remote

string

Filtrer sur la mission à distance ou non (cf. Les constantes).

Headers

NameTypeDescription

apikey requis

string

La clé API nécessaire à l’authentification. Les données disponibles sont définies en fonction de votre clé API.

{
    "ok": true,
    "data": [
        {
            "statusCode": "REFUSED",
            "lonlat": [],
            "_id": "5f42a726feb3744b1327da13",
            "publisherId": "5f3d744210eb3b2d05273c20",
            "publisherName": "Seb",
            "publisherUrl": "google.fr",
             "publisherLogo": "www.myurl.com/google.png",
            "createdAt": "2020-08-23T17:28:06.242Z",
            "statusComment": "Missing title",
            "__v": 0
        },
        {
            "statusCode": "ACCEPTED",
            "lonlat": [],
            "_id": "5f42e328540f817692aa5922",
            "clientId": "7d913efe-0fd3-42d0-a03b-6aeadeacd909",
            "publisherId": "5f3d744210eb3b2d05273c20",
            "__v": 1,
            "city": "Ancenis",
            "companyUrl": "https://www.benevolt.fr/association/adie-7",
            "country": "France",
            "description": "  Ancenis (44)\n  Dès que possible\n\n\nL'Adie propose un coaching personnalisé aux entrepreneurs qu'elle finance pour les aider sur 3 aspects de leur projet : le commercial, la gestion financière et la gestion administrative. \nLa mission consiste à:\n- apporter un appui personnalisé afin que les entrepreneurs soutenus par l'Adie prennent confiance en eux et deviennent autonomes dans leur métier. \n- rencontrer régulièrement les créateurs suivis. \n- effectuer un reporting des rendez-vous de suivi réalisés.\n\n\nInformations pratiques\n‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾\nAPTITUDES ET COMPETENCES:\nAisance dans la relation individuelle, empathie, capacité d'analyse \n\nPour vous aider dans ces missions, des formations et des outils vous sont proposés.\n\nFréquence : 0,5 jour par semaine - horaires souples\nDurée : Permanente\n\n\nFormation des bénévoles\n‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾\nL'Adie accompagne et forme ses bénévoles à appréhender l'approche avec le public, à comprendre les process et les dispositifs internes, à comprendre l'environnement dans lequel évolue les chefs d'entreprise, à s'accaparer les techniques d'animations ou de rendez-vous, à maîtriser les outils informatiques et les applications qu'elle utilise. Elle leur permet aussi de monter en compétences grâce à un catalogue de formation complet, animé par des professionnels dans chacune des thématiques\n\n\nMission de bénévolat publiée avec Benevolt - https://www.benevolt.fr",
            "postalCode": "44150",
            "postedAt": "2020-03-10T10:54:36.000Z",
            "publisherName": "Seb",
            "publisherUrl": "google.fr",
            "publisherLogo": "www.myurl.com/google.png",
            "region": "Loire-Atlantique",
            "title": "Bénévolat - Coaching d'entrepreneurs - Ancenis",
            "companyName": "Adie Pays De La Loire",
            "createdAt": "2020-08-23T21:56:17.736Z"
        },
        {
            "statusCode": "ACCEPTED",
            "lonlat": [],
            "_id": "5f42e328540f817692aa5940",
            "clientId": "3ea5c26c-4fc3-46c7-a560-5e4616ac173d",
            "publisherId": "5f3d744210eb3b2d05273c20",
            "__v": 1,
            "city": "Saint-Lô",
            "companyUrl": "https://www.benevolt.fr/association/croix-rouge-francaise-pays-saint-lois",
            "country": "France",
            "description": "  Saint-Lô (50)\n  Dès que possible\n\n\nEn cette période d’épidémie, la Croix-Rouge Française a besoin de renforts pour mener à bien ses activités essentielles et accompagner les plus vulnérables.\n\nLa mission consiste à apporter un renfort aux équipes de l’accueil santé social sur différentes activités en fonction des besoins au niveau local : accueillir les personnes, établir avec elles un dialogue et les orienter vers les bons interlocuteurs.\n\nAidez-nous à maintenir l’accès à la santé des plus vulnérables !\n\n\nInformations pratiques\n‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾\nLa mission s’effectuera toujours en binôme, avec l’accompagnement d’un bénévole Croix-Rouge française.\n\nPrérequis : avoir entre 18 et 69 ans et ne présenter aucune contrindication médicale.\n\n\nFormation des bénévoles\n‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾\nAccompagnement par des tuteurs, formations proposées pour chaque activités (entièrement prises en charges)\n\n\nMission de bénévolat publiée avec Benevolt - https://www.benevolt.fr",
            "postalCode": "50000",
            "postedAt": "2020-04-20T13:58:16.000Z",
            "publisherName": "Seb",
            "publisherUrl": "google.fr",
         "publisherLogo": "www.myurl.com/google.png",
            "region": "Manche",
            "title": "Bénévolat - Accueil santé social",
            "companyName": "Croix-Rouge Française - Pays Saint-Lois",
            "createdAt": "2020-08-23T21:56:17.801Z"
        }
    ],
    "total": 410,
    "limit": 3,
    "skip": 0
}

Rechercher parmi les missions de vos partenaires

GET https://api.api-engagement.beta.gouv.fr/v0/mission/search?[parameters]

Récupérer les missions de vos partenaires en utilisant des filtres dans les paramètres. La réponse comporte les missions ainsi que les agrégations sur les domaines

Query Parameters

NameTypeDescription

text

String

Recherche par texte dans les champs title, description, publisherName et city

size

Number

Taille des données que vous souhaitez récupérer. Utile pour la pagination.

from

Number

Définir à partir d’où vous souhaitez récupérer la donnée que vous récoltez. Utile pour la pagination

lat

Float

Latitude de la mission. Doit être utilisée avec les champs lon et distance.

lon

Float

Longitude de la mission. Doit être utilisée avec les champs lat et distance.

distance

String

Distance autour de la latitude et de la longitude. Défaut à 50km.

openToMinors

String

Vous pouvez récupérer des missions uniquement ouvertes aux mineurs. La valeur de champ peut être "yes" ou "no".

reducedMobilityAccessible

String

Vous pouvez récupérer des missions uniquement accessibles aux personnes à mobilité réduite. La valeur de champ peut être "yes" ou "no".

domain

String

Vous pouvez filtrer sur un domaine en particulier

activity

String

Vous pouvez filtrer sur une activité

departmentName

String

Vous pouvez filtrer sur un département.

sortBy

String

Vous pouvez trier les missions par date de création si vous choisissez de filtrer sur le champs createdAt. Vous pouvez également n’afficher que des missions autour d’un point donné en organisant le tri en fonction de la localisation. Nous utilisons l’IP pour proposer des missions aux alentours.

createdAt

Date

Obtenez des missions créées avant ou après certaines dates. ex : {{baseUrl}}/v0/mission/search?createdAt=gt:2021-11-10T04:24:33.866Z

publisher

String

Faites une recherche en fonction du compte annonceur. Si vous souhaitez en mentionner plusieurs, séparez leurs noms par des ","

startAt

Date

Obtenez des missions qui démarrent avant ou après certaines dates.

ex : {{baseUrl}}/v0/mission/search?startAt=gt:2021-11-10T04:24:33.866Z

remote

String

Vous pouvez récupérer des missions uniquement proposées à distance. La valeur de champ peut être "no", "possible" ou "full".

Headers

NameTypeDescription

apikey requis

String

La clé API nécessaire à l’authentification. Les données disponibles sont définies en fonction de votre clé API.

{
    "total": 14,
    "hits": [
        {
            "publisherId": "5f592d415655a711feb4460e",
            "publisherName": "Benevolt",
            "publisherUrl": "https://www.benevolt.fr",
            "publisherLogo": "https://apicivique.s3.eu-west-3.amazonaws.com/app/publishers/5f592d415655a711feb4460e/Benevolt-rouge-OK.png",
            "lastSyncAt": "2021-12-11T16:33:43.807Z",
            "applicationUrl": "http://localhost:8080/r/61950ae01206b80750da9fd1/5f5931496c7ea514150a818f",
            "statusCode": "ACCEPTED",
            "statusComment": "",
            "clientId": "benevolt-5fccf265-7b54-4abc-a1b8-0dc08ad85927",
            "title": "Responsable communication association de foot ⚽️",
            "description": "🏡 Mission réalisable à domicile ou à📍 Piré-sur-Seiche (35)\n📅 Dès que possible\n\n\nDans le cadre du projet club de la SEICHE FC , nous recherchons des personnes\nayant des connaissances et un savoir faire, dans le domaine de la gestion\ninformatique . Son rôle et sa fonction : Il ou elle sera en charge du site Web\ndu club , afin d'alimenter un contenue,ainsi que les informations clés pour\naméliorer l'attractivité du club ,et ainsi communiquer sur différent support ,\nsa place sera au sein d'une équipe déjà former et capable de l'aider dans sa\nnouvelle prise de fonction\n\n\n\nInformations pratiques\n\n‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾\n\nDisponible , rigoureux , Dynamique vous aurez toute vôtre place au sein de ce\nnouveau club conviviale et familiale , vous ferez ainsi partis du projet de\ndéveloppement de la structure,dans un ultime but,d'obtenir ensemble la\ndistinction de labellisation espoir du club\n\nFréquence : de septembre à juin 2022\nDurée : 2h / semaines\n\n\n\nInformations sur l'association\n\n‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾\n\nLa SEICHE FC est né de la fusion des 3 clubs d'es commune suivantes : \"Amanlis ,\nBoistrudan et Piré sur seiche\". Elle à pour objectif d'offrir la pratique du\nfoot pour tous ,de valoriser et de mieux faire connaitre le rôle sociétal et\ncitoyen du football. De développer des actions innovantes et ainsi rappeler les\nvertus éducatives du football..\n\n\nFormation des bénévoles\n\n‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾\n\nL'accompagnement du bénévole sera notre 1er engagement vis à vis de celui-ci ,\nde lui faire découvrir l'ambiance chaleureuse et familiale du club tout en lui\noffrant la possibilité de se former à la fonction de dirigeant si celui-ci le\ndésire . Il sera libre de choisir sa fonction , et ainsi nous garantirons une\nentente et une communication solide afin de voir pérenniser son engagement au\nsein de LA SEICHE FC",
            "tasks": [],
            "audience": [],
            "soft_skills": [],
            "organizationName": "La Seiche Football Club",
            "organizationUrl": "https://www.benevolt.fr/association/la-seiche-fc?utm_source=api_engagement&utm_campaign=api_engagement_apply",
            "organizationFullAddress": "8 Rue de Vitre, Piré-sur-Seiche, 35150 Piré-sur-Seiche",
            "organizationCity": "Piré-Chancé",
            "organizationPostCode": "35150",
            "organizationDescription": "La SEICHE FC est né de la fusion des 3 clubs d'es commune suivantes : \"Amanlis , Boistrudan et Piré sur seiche\". Elle à pour objectif d'offrir la pratique du foot pour tous ,de valoriser et de mieux faire connaitre le rôle sociétal et citoyen du football. De développer des actions innovantes et ainsi rappeler les vertus éducatives du football..",
            "associationTags": [],
            "postedAt": "2020-07-03T10:41:59.000Z",
            "priority": "low",
            "metadata": "",
            "adresse": "8 Rue de Vitre, Piré-sur-Seiche, 35150 Piré-sur-Seiche",
            "postalCode": "35150",
            "departmentName": "Ille-et-Vilaine",
            "departmentCode": "35",
            "city": "Piré-sur-Seiche",
            "region": "Bretagne",
            "country": "FR",
            "domain": "sport",
            "domainLogo": "https://apicivique.s3.eu-west-3.amazonaws.com/missions/7_2.jpg",
            "activity": "informatique",
            "location": {
                "lon": -1.496184,
                "lat": 48.000592
            },
            "remote": "possible",
            "deleted": "no",
            "createdAt": "2021-11-17T14:00:00.647Z",
            "updatedAt": "2021-12-11T16:58:47.043Z"
        }
    ],
    "facets": {
        "departmentName": [
            {
                "key": "Ille-et-Vilaine",
                "doc_count": 11
            },
            {
                "key": "Côtes-d'Armor",
                "doc_count": 3
            }
        ],
        "activities": [
            {
                "key": "encadrement-d-equipes",
                "doc_count": 3
            },
            {
                "key": "animation",
                "doc_count": 2
            },
            {
                "key": "accueil-de-public",
                "doc_count": 1
            },
            {
                "key": "communication",
                "doc_count": 1
            },
            {
                "key": "comptabilite-finance",
                "doc_count": 1
            },
            {
                "key": "gestion-recherche-des-partenariats",
                "doc_count": 1
            },
            {
                "key": "informatique",
                "doc_count": 1
            },
            {
                "key": "logistique",
                "doc_count": 1
            },
            {
                "key": "responsabilites-associatives",
                "doc_count": 1
            },
            {
                "key": "taches-administratives",
                "doc_count": 1
            }
        ],
        "domains": [
            {
                "key": "sport",
                "doc_count": 14
            }
        ]
    }
}

Récupération de missions dont l'ID est connu

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

Cette méthode vous permet de récupérer une mission via son ID

Path Parameters

NameTypeDescription

id

String

Identifiant de la mission

{
    "ok": true,
    "data": {
        "_id": "xxxxxxxxxxxxxxx",
        "activity": "animation",
        "applicationUrl": "https://api.api-engagement.beta.gouv.fr/r/xxxxxxxxxxxxxxx",
        "clientId": "xxxxxxxxxxxxxxx",
        "description": "Béziers (34)\nDès que possible\n\n\nNous vous proposons d’animer des séances sensibilisations dans les classes, du\nprimaire au lycée, grâce à nos outils pédagogiques !\n\nVous transmettez aux élèves des clés de compréhension sur la faim dans le monde\nen leur faisant découvrir un pays et une culture (entre autres à l’aide d’un\nfilm). Vous leur donnez envie de se mobiliser à leur niveau!\n\nC’est un moment interactif avec les élèves permettant d’échanger un maximum avec\neux tout en leur apportant les informations importantes du projet !\n\n\n\nInformations pratiques\n\n‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾\n\nUne formation sur les programmes d’Action contre la Faim ainsi que sur le\ndéroulement des séances de sensibilisation sera proposée en Janvier/Février\n(date et horaires à confirmer). Les bénévoles doivent être disponibles au moins\n½ journée en semaine sur la période du 7 mars au 23 avril 2022.\n\nLes séances de sensibilisation se déroule dans le département de l'Hérault.\n\nDurée : Minimum 1/2 journée\n\n\n\nInformations sur l'association Action Contre La Faim Jeunesse - Toulouse\n\n‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾\n\nFondée en France en 1979, Action contre la Faim est une organisation non\ngouvernementale,\napolitique, non confessionnelle, sans but lucratif. Sa mission est de sauver des\nvies en éliminant la faim par la prévention, la détection et le traitement de la\nsous-nutrition. Notre organisation mène une réponse coordonnée dans près de 50\npays.\n\nNotre priorité est d’agir concrètement sur le terrain et témoigner sur le sort\ndes populations.\n\n\nFormation des bénévoles\n\n‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾\n\nEn France, les opérations d’Action contre la Faim sont orientées sur la\nsensibilisation et la mobilisation. Action contre la Faim forme les bénévoles\naux messages importants et fournit tous les supports nécessaires. Dans certains\ndépartements (Haute-Garonne, Hérault,...), les bénévoles sont organisés en\ngroupes locaux, les délégations. Ils agissent ensemble et portent des projets\nlocaux.",
        "domain": "humanitaire",
        "domainLogo": "https://apicivique.s3.eu-west-3.amazonaws.com/missions/6_2.jpg",
        "metadata": "",
        "organizationUrl": "https://benevole.actioncontrelafaim.org/association/action-contre-la-faim-jeunesse-toulouse?utm_source=api_engagement&utm_campaign=api_engagement_apply",
        "organizationName": "Action Contre La Faim Jeunesse - Toulouse",
        "organizationFullAddress": "1 Place du Capitole, 31000 Toulouse",
        "organizationDescription": "Fondée en France en 1979, Action contre la Faim est une organisation non gouvernementale,\napolitique, non confessionnelle, sans but lucratif. Sa mission est de sauver des vies en éliminant la faim par la prévention, la détection et le traitement de la sous-nutrition. Notre organisation mène une réponse coordonnée dans près de 50 pays. \n\nNotre priorité est d’agir concrètement sur le terrain et témoigner sur le sort des populations.",
        "organizationType": "1901",
        "places": 1,
        "postedAt": "2022-01-13T15:34:46.000Z",
        "priority": "high",
        "remote": "no",
        "startAt": "2024-04-23T13:30:20.950Z",
        "title": "Interventions en milieu scolaire",
        "deleted": false,
        "deletedAt": null,
        "lastSyncAt": "2024-04-23T13:30:20.677Z",
        "publisherId": "xxxxxxxxxxxxxxx",
        "publisherName": "Action contre la Faim",
        "publisherLogo": "https://api-engagement-bucket.s3.fr-par.scw.cloud/publishers/62432692651de907c463e29b/logo",
        "publisherUrl": "https://benevole.actioncontrelafaim.org",
        "statusCode": "ACCEPTED",
        "updatedAt": "2021-04-23T13:30:20.950Z",
        "country": "FR",
        "location": {
            "lon": 3.21613,
            "lat": 43.3433
        },
        "address": "34500 Béziers",
        "city": "Béziers",
        "postalCode": "34500",
        "departmentCode": "34",
        "departmentName": "Hérault",
        "region": "Occitanie",
        "createdAt": "2021-06-16T07:51:53.216Z",
        "associationSiren": null,
        "associationRNA": null,
        "associationSources": [
            "Benevolt"
        ],
        "associationName": "Action Contre La Faim Jeunesse - Toulouse",
        "associationReseaux": [],
        "associationId": "xxxxxxxxx",
        "snu": false,
        "descriptionHtml": "   Béziers (34)<br>   Dès que possible<br><br><br>Nous vous proposons d’animer des séances sensibilisations dans les classes, du primaire au lycée, grâce à nos outils pédagogiques !\n\nVous transmettez aux élèves des clés de compréhension sur la faim dans le monde en leur faisant découvrir un pays et une culture (entre autres à l’aide d’un film). Vous leur donnez envie de se mobiliser à leur niveau!\n\nC’est un moment interactif avec les élèves permettant d’échanger un maximum avec eux tout en leur apportant les informations importantes du projet !<br><br><p><strong>Informations pratiques</strong></p><p>‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾</p>Une formation sur les programmes d’Action contre la Faim ainsi que sur le déroulement des séances de sensibilisation sera proposée en Janvier/Février (date et horaires à confirmer). Les bénévoles doivent être disponibles au moins ½ journée en semaine sur la période du 7 mars au 23 avril 2022.\n\nLes séances de sensibilisation se déroule dans le département de l&#039;Hérault.<br><br>Durée : Minimum 1/2 journée<br><br><p><strong>Informations sur l&#039;association Action Contre La Faim Jeunesse - Toulouse</strong></p><p>‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾</p>Fondée en France en 1979, Action contre la Faim est une organisation non gouvernementale,\napolitique, non confessionnelle, sans but lucratif. Sa mission est de sauver des vies en éliminant la faim par la prévention, la détection et le traitement de la sous-nutrition. Notre organisation mène une réponse coordonnée dans près de 50 pays. \n\nNotre priorité est d’agir concrètement sur le terrain et témoigner sur le sort des populations.<br><p><strong>Formation des bénévoles</strong></p><p>‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾</p>En France, les opérations d’Action contre la Faim sont orientées sur la sensibilisation et la mobilisation. Action contre la Faim forme les bénévoles aux messages importants et fournit tous les supports nécessaires. Dans certains départements (Haute-Garonne, Hérault,...), les bénévoles sont organisés en groupes locaux, les délégations. Ils agissent ensemble et portent des projets locaux."
    }
}

Récupération des statistiques sur les missions

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

Query Parameters

NameTypeDescription

facets

String

Facets à retourner pour enrichir vos requêtes.

ex : facets=domain,activity,publisherName

createdAt

String

La date de création. Avant (lt), après (gt) ou les deux.

ex : createdAt=gt:2022-03-25&createdAt=lt:2022-05-25

PreviousDiffuser des missions par campagneNext/mymission

Last updated