Récupérer des missions

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

Rechercher des missions

get

https://api.api-engagement.beta.gouv.frhttps://api.bac-a-sable.api-engagement.beta.gouv.frhttp://localhost:3002

/v0/mission

Retourne les missions diffusées par vos partenaires, filtrées selon vos critères. Les résultats sont limités aux partenaires autorisés pour votre clé API.

Les paramètres "activity", "city", "clientId", "country", "departmentName", "domain", "organizationRNA", "organizationStatusJuridique", "publisher", "remote" et "type" acceptent une valeur unique ou un tableau de valeurs (ex. "?domain=sante&domain=education").

Authorizations

ApiKeyAuth

x-api-keystringRequired

Clé API fournie par l'équipe API Engagement

Query parameters

limitinteger · max: 10000Optional

Nombre de résultats (défaut 25, max 10 000)

Default: 25

skipintegerOptional

Décalage pour la pagination

Default: 0

keywordsstringOptional

Recherche textuelle (titre, description, organisation)

Example: cuisine solidaire

domainone ofOptional

Domaine d'action

Example: sante

stringOptional

or

string[]Optional

activityone ofOptional

Activité proposée

stringOptional

or

string[]Optional

typeone ofOptional

Type d'engagement : benevolat, volontariat_service_civique, volontariat_sapeurs_pompiers

stringOptional

or

string[]Optional

remoteone ofOptional

Modalité de télétravail : no, possible, full

stringOptional

or

string[]Optional

latnumber · doubleOptional

Latitude (requis avec "lon" pour la recherche géographique)

Example: 48.8566

lonnumber · doubleOptional

Longitude (requis avec "lat" pour la recherche géographique)

Example: 2.3522

distancestringOptional

Rayon de recherche géographique (ex. 25km, 50km). Défaut : 50km

Example: 25km

cityone ofOptional

Filtre par ville

stringOptional

or

string[]Optional

departmentNameone ofOptional

Filtre par département

Example: Rhône

stringOptional

or

string[]Optional

countryone ofOptional

Filtre par pays

stringOptional

or

string[]Optional

clientIdone ofOptional

Filtre par identifiant client

stringOptional

or

string[]Optional

publisherone ofOptional

Filtre sur les identifiants de partenaires diffuseurs

stringOptional

or

string[]Optional

organizationRNAone ofOptional

Filtre par numéro RNA de l'organisation

stringOptional

or

string[]Optional

organizationStatusJuridiqueone ofOptional

Filtre par forme juridique de l'organisation

stringOptional

or

string[]Optional

openToMinorsstring · enumOptional

Missions ouvertes aux mineurs uniquement

Possible values:

reducedMobilityAccessiblestring · enumOptional

Missions accessibles PMR uniquement

Possible values:

snustring · enumOptional

Missions Service National Universel uniquement

Possible values:

startAtstringOptional

Filtre sur la date de début (ex. >2024-01-01, <2024-12-31)

createdAtstringOptional

Filtre sur la date de création (ex. >2024-01-01)

Responses

200

Liste de missions

application/json

okbooleanOptionalExample: true

totalintegerOptional

Nombre total de résultats correspondants

Example: 1234

limitintegerOptionalExample: 25

skipintegerOptionalExample: 0

400

Paramètres invalides

application/json

401

Clé API manquante ou invalide

application/json

get

/v0/mission

HTTPcURLJavaScriptPython

GET /v0/mission HTTP/1.1
Host: api.api-engagement.beta.gouv.fr
x-api-key: YOUR_API_KEY
Accept: */*

{
  "ok": true,
  "total": 1234,
  "limit": 25,
  "skip": 0,
  "data": [
    {
      "id": "64a1b2c3d4e5f6789abc0001",
      "clientId": "mission-bénévolat-2024-001",
      "publisherId": "5f5931496c7ea514150a818f",
      "statusCode": "ACCEPTED",
      "title": "Animateur bénévole en maison de retraite",
      "applicationUrl": "https://example.org/missions/001/postuler",
      "domain": "sante",
      "activities": [
        "animation",
        "accompagnement"
      ],
      "audience": [
        "seniors",
        "personnes-isolees"
      ],
      "remote": "no",
      "schedule": "2 heures par semaine le samedi matin",
      "places": 5,
      "openToMinors": "yes",
      "reducedMobilityAccessible": "yes",
      "addresses": [
        {
          "street": "12 rue de la Paix",
          "zip": "75001",
          "city": "Paris",
          "department": "75",
          "departmentName": "Paris",
          "region": "Île-de-France",
          "country": "France",
          "location": {
            "lat": 48.8698,
            "lon": 2.3303
          }
        }
      ],
      "organizationName": "Croix-Rouge française",
      "organizationRNA": "W751206979",
      "organizationSiren": "775672272",
      "organizationSiret": "77567227221138",
      "organizationUrl": "https://www.croix-rouge.fr",
      "createdAt": "2024-01-15T09:00:00.000Z",
      "updatedAt": "2024-03-01T14:30:00.000Z",
      "_id": "text",
      "activity": "text",
      "publisherName": "text",
      "publisherUrl": "https://example.com",
      "publisherLogo": "https://example.com",
      "domainLogo": "https://example.com",
      "postedAt": "2026-03-28T17:35:37.736Z",
      "duration": 1,
      "snu": true,
      "snuPlaces": 1,
      "location": {
        "lat": 1,
        "lon": 1
      }
    }
  ]
}