Rechercher dans les missions

Rechercher dans les missions de vos partenaires avec des filtres précis. A noter que vous récupérez des facets sur certains champs.

Rechercher des missions avec facettes

get

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

/v0/mission/search

Identique à "GET /v0/mission" mais retourne également des facettes (agrégations) sur les domaines, activités et départements pour faciliter la construction de filtres dynamiques.

Authorizations

ApiKeyAuth

x-api-keystringRequired

Clé API fournie par l'équipe API Engagement

Query parameters

limitinteger · max: 10000OptionalDefault: 25

skipintegerOptionalDefault: 0

keywordsstringOptional

domainone ofOptional

stringOptional

or

string[]Optional

activityone ofOptional

stringOptional

or

string[]Optional

typeone ofOptional

stringOptional

or

string[]Optional

remoteone ofOptional

stringOptional

or

string[]Optional

latnumber · doubleOptional

lonnumber · doubleOptional

distancestringOptional

departmentNameone ofOptional

stringOptional

or

string[]Optional

openToMinorsstring · enumOptionalPossible values:

reducedMobilityAccessiblestring · enumOptionalPossible values:

Responses

200

Liste de missions avec facettes

application/json

okbooleanOptionalExample: true

totalintegerOptionalExample: 1234

400

Paramètres invalides

application/json

401

Clé API manquante ou invalide

application/json

get

/v0/mission/search

HTTPcURLJavaScriptPython

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

{
  "ok": true,
  "total": 1234,
  "hits": [
    {
      "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-28T16:27:15.489Z",
      "duration": 1,
      "snu": true,
      "snuPlaces": 1,
      "location": {
        "lat": 1,
        "lon": 1
      }
    }
  ],
  "facets": {
    "domains": [
      {
        "key": "text",
        "doc_count": 1
      }
    ],
    "activities": [
      {
        "key": "text",
        "doc_count": 1
      }
    ],
    "departmentName": [
      {
        "key": "text",
        "doc_count": 1
      }
    ]
  }
}