{
  "type": "object",
  "properties": {
    "query": {
      "description": "Recherche libre sur le titre, le code ROME, le secteur et les appellations du métier. Cherche aussi dans le libellé du secteur : « sante » suffit pour les métiers de la santé. EN: Free-text search over job title, ROME code, sector and alternative job names.",
      "type": "string"
    },
    "sectors": {
      "description": "Identifiants de secteurs d'activité, obtenus via l'outil list_job_sectors. Pour une recherche thématique simple, préférer « query ». EN: Sector identifiers, obtained from the list_job_sectors tool.",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "minSalary": {
      "description": "Salaire annuel brut minimum, en euros, comparé au premier décile du métier. EN: Minimum gross annual salary in euros, compared to the job's first decile.",
      "type": "number"
    },
    "minAccessibilityScore": {
      "description": "Borne basse du score d'accessibilité du métier, de 0 à 10 : plus il est haut, plus le métier est accessible sans longues études. Utiliser 7 ou plus pour « sans faire de longues études ». Ce score ne mesure pas un niveau de diplôme. EN: Lower bound of the job's accessibility score (0-10): the higher, the easier to enter without long studies. Use 7 or more for « without long studies ». It does not measure a diploma level.",
      "type": "number"
    },
    "tags": {
      "description": "Thèmes d'excellence du métier. Valeurs acceptées : salary (bien rémunéré), telework (télétravail possible), freelance (exerçable en indépendant), demand (métier en tension, qui recrute), ecological_impact, social_impact. EN: Job themes. Accepted values: salary, telework, freelance, demand, ecological_impact, social_impact.",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "romeCode": {
      "description": "Code ROME exact, de la forme M1805. EN: Exact ROME code, e.g. M1805.",
      "type": "string"
    },
    "limit": {
      "description": "Nombre de résultats, 1 à 20 (défaut 10). EN: Number of results, 1 to 20 (default 10).",
      "type": "number"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "identifier": {
      "type": "string",
      "description": "Slug du métier (ex. developpeur-developpeuse-informatique) ou code ROME (ex. M1805). Les slugs sont épicènes : en cas de doute, passer par search_jobs, qui sert le slug exact. EN: Job slug (e.g. developpeur-developpeuse-informatique) or ROME code (e.g. M1805). Slugs carry both gender forms: when unsure, call search_jobs first, which returns the exact slug."
    }
  },
  "required": [
    "identifier"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "userSkills": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Compétences de la personne, en clair. EN: The person's skills, in plain words."
    },
    "targetJobSlug": {
      "type": "string",
      "description": "Slug du métier visé. EN: Slug of the target job."
    }
  },
  "required": [
    "userSkills",
    "targetJobSlug"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "identifier": {
      "type": "string",
      "description": "Slug du métier de départ (ex. developpeur-developpeuse-informatique). Un code ROME est accepté mais coûte un appel de plus : préférer le slug, que search_jobs et get_job servent tous deux. EN: Slug of the starting job. A ROME code works but costs an extra call: prefer the slug, which both search_jobs and get_job return."
    },
    "limit": {
      "description": "Nombre de métiers proches, 1 à 20 (défaut 10). EN: Number of similar jobs, 1 to 20 (default 10).",
      "type": "number"
    }
  },
  "required": [
    "identifier"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "identifier": {
      "type": "string",
      "description": "Code ROME du métier (ex. J1506 pour infirmier en soins généraux) ou slug exact. Les slugs sont épicènes et souvent longs — « infirmier » seul n'existe pas, c'est « infirmier-infirmiere-en-soins-generaux-ide » : en cas de doute, appeler search_jobs d'abord, qui sert le code ROME et le slug exact. EN: ROME code (e.g. J1506 for a general-care nurse) or exact slug. Slugs carry both gender forms and are often long — « infirmier » alone does not exist: when unsure, call search_jobs first, which returns the ROME code and the exact slug."
    },
    "limit": {
      "description": "Nombre de diplômes renvoyés, 1 à 20 (défaut 12). Les statistiques du métier portent sur la totalité, pas sur cette page. EN: Number of diplomas returned, 1 to 20 (default 12). The job statistics always cover the whole job, not this page.",
      "type": "number"
    }
  },
  "required": [
    "identifier"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "q": {
      "description": "Recherche libre sur le nom du diplôme et ses codes RNCP ou RS. EN: Free-text search on the diploma name and its RNCP or RS codes.",
      "type": "string"
    },
    "type": {
      "description": "Type de diplôme. Une trentaine de valeurs, dont : cap_bep, bac, bts_btsa_btsm, but, licence, licence_pro, master, diplome_ingenieur, diplome_etat, titre_professionnel, certification_rs, doctorat. Une valeur non reconnue renvoie une erreur qui énumère la liste complète. EN: Diploma type, about thirty values including cap_bep, bac, bts_btsa_btsm, but, licence, master, diplome_ingenieur, titre_professionnel, certification_rs, doctorat. An unknown value returns an error listing every accepted value.",
      "type": "string"
    },
    "exitLevel": {
      "description": "Niveau de sortie. Valeurs acceptées : cap_bep, bac, bac_plus_1, bac_plus_2, bac_plus_3, bac_plus_4, bac_plus_5, bac_plus_6, bac_plus_7, bac_plus_8, bac_plus_9_plus, na. Noter la forme avec tirets bas : « bac+3 » n'est pas accepté. EN: Exit level. Accepted values: cap_bep, bac, bac_plus_1 through bac_plus_9_plus, na. Note the underscore form: « bac+3 » is not accepted.",
      "type": "string"
    },
    "romeCode": {
      "description": "Code ROME du métier visé, de la forme J1506, pour ne garder que les diplômes qui y mènent. EN: ROME code of the target job, e.g. J1506.",
      "type": "string"
    },
    "limit": {
      "description": "Nombre de résultats, 1 à 20 (défaut 10). EN: 1 to 20 (default 10).",
      "type": "number"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "id": {
      "type": "number",
      "description": "Identifiant numérique de la certification. EN: Numeric certification id."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "q": {
      "description": "Recherche libre sur l'intitulé de la formation et le diplôme préparé. EN: Free-text search on the programme title and the prepared diploma.",
      "type": "string"
    },
    "city": {
      "description": "Nom exact de la ville, tel que renvoyé par resolve_location. EN: Exact city name, as returned by resolve_location.",
      "type": "string"
    },
    "postalCode": {
      "description": "Code postal à cinq chiffres. Plus étroit que la ville dans les grandes agglomérations : 69003 ne ramène que le 3e arrondissement de Lyon, là que city vaut Lyon ramène toute la ville. EN: Five-digit postcode. Narrower than the city in large conurbations: 69003 returns only the 3rd arrondissement of Lyon, where city=Lyon returns the whole city.",
      "type": "string"
    },
    "department": {
      "description": "Département sous la forme « code - nom », ex. « 06 - Alpes-Maritimes », telle que renvoyée par resolve_location. Le nom seul ne ramène rien. EN: Department as « code - name », e.g. « 06 - Alpes-Maritimes », as returned by resolve_location. The name alone matches nothing.",
      "type": "string"
    },
    "region": {
      "description": "Nom de la region. EN: Region name.",
      "type": "string"
    },
    "voie": {
      "description": "Voie d'accès. Valeurs acceptées : scolaire, continue, apprentissage, contrat_pro. Pour « en alternance », utiliser apprentissage puis contrat_pro. EN: Access route. Accepted values: scolaire, continue, apprentissage, contrat_pro. For work-study, try apprentissage then contrat_pro.",
      "type": "string"
    },
    "modality": {
      "description": "Modalité de suivi. Valeurs acceptées : presentiel, partiel_distance, entierement_distance, presentiel_ou_distance. Pour « à distance », utiliser entierement_distance. EN: Delivery mode. Accepted values: presentiel, partiel_distance, entierement_distance, presentiel_ou_distance. For fully remote, use entierement_distance.",
      "type": "string"
    },
    "exitLevel": {
      "description": "Niveau de sortie du diplôme préparé. Valeurs acceptées : cap_bep, bac, bac_plus_1, bac_plus_2, bac_plus_3, bac_plus_4, bac_plus_5, bac_plus_6, bac_plus_7, bac_plus_8, bac_plus_9_plus, na. EN: Exit level of the prepared diploma. Accepted values: cap_bep, bac, bac_plus_1 through bac_plus_9_plus, na.",
      "type": "string"
    },
    "maxPrice": {
      "description": "Prix maximum en euros. Une formation en apprentissage est gratuite pour l'apprenti. EN: Maximum price in euros. Apprenticeship programmes are free for the apprentice.",
      "type": "number"
    },
    "certificationId": {
      "description": "Identifiant d'un diplôme, pour ne garder que les formations qui y préparent. EN: Diploma id, to keep only the programmes preparing for it.",
      "type": "number"
    },
    "establishmentId": {
      "description": "Identifiant d'un établissement, obtenu via search_training_centers : renvoie alors les formations de cet établissement, en ignorant les autres filtres. C'est la seule façon fiable de répondre à « quelles formations propose l'école X » — chercher le nom de l'école dans q ne marche que si ce nom est rare, et ramène sinon les formations d'autres organismes. EN: Establishment id, from search_training_centers: returns that establishment's programmes, ignoring the other filters. This is the only reliable way to answer « which programmes does school X offer » — searching the school name in q only works when that name is rare, and otherwise returns other providers' programmes.",
      "type": "number"
    },
    "romeCode": {
      "description": "Code ROME du métier visé, de la forme J1506. EN: ROME code of the target job, e.g. J1506.",
      "type": "string"
    },
    "aroundLat": {
      "description": "Latitude du centre du rayon, prise telle quelle dans la réponse de resolve_location. Toujours avec aroundLng et radiusKm. EN: Latitude of the radius centre, taken verbatim from resolve_location. Always with aroundLng and radiusKm.",
      "type": "number"
    },
    "aroundLng": {
      "description": "Longitude du centre du rayon, prise telle quelle dans la réponse de resolve_location. EN: Longitude of the radius centre, taken verbatim from resolve_location.",
      "type": "number"
    },
    "radiusKm": {
      "description": "Rayon en kilomètres, de 1 à 200 — 15 km est un bon départ, à élargir si vide. Pour « près de X » ou « autour de X », ou quand une petite ville ne donne rien : resolve_location d'abord, puis ses latitude/longitude ici. Le rayon REMPLACE city et postalCode, jamais en cumul — les résultats sont triés par distance croissante et portent distanceKm. EN: Radius in km, 1 to 200 — 15 km is a good start, widen if empty. For « near X », resolve the city first, then pass its latitude/longitude here. The radius REPLACES city and postalCode, never combined — results are sorted by distance and carry distanceKm.",
      "type": "number"
    },
    "cpfEligible": {
      "description": "Ne garder que les formations finançables par le compte personnel de formation (CPF). L'éligibilité vaut à la date du dernier import du catalogue MonCompteFormation : c'est un indice fort, jamais une garantie, et « false » signifie « absente de ce catalogue », pas « inéligible » de façon certaine. EN: Keep only programmes fundable through the French personal training account. Eligibility reflects the last import of the MonCompteFormation catalogue: a strong hint, never a guarantee, and false means « not in that catalogue », not « definitely ineligible ».",
      "type": "boolean"
    },
    "limit": {
      "description": "Nombre de résultats, 1 à 20 (défaut 10). EN: 1 to 20 (default 10).",
      "type": "number"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "id": {
      "type": "number",
      "description": "Identifiant numérique de la formation. EN: Numeric training id."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "q": {
      "description": "Recherche libre sur le nom et la ville. Un NOM d'établissement se cherche ici seul, ville incluse dans q si besoin — jamais cumulé avec les filtres city ou postalCode : la commune administrative d'un organisme diffère souvent de la ville de son enseigne, et le cumul renvoie alors un total de 0 à tort. Les filtres de lieu servent aux recherches par type ou par domaine, pas aux noms propres. EN: Free-text search on name and city. Search an establishment NAME here alone, city included in q if needed — never combined with the city or postalCode filters: an organisation's registered town often differs from the town in its brand name, and combining then wrongly returns a total of 0. Location filters serve type or domain searches, not proper names.",
      "type": "string"
    },
    "city": {
      "description": "Nom exact de la ville. Ne sert pas à retrouver un nom d'organisme — mettre alors tout dans q, jamais ici. EN: Exact city name. Never use it to find an organisation by name — put everything in q instead.",
      "type": "string"
    },
    "postalCode": {
      "description": "Code postal. Même règle que city : jamais cumulé avec un nom d'organisme dans q. EN: Postcode. Same rule as city: never alongside an organisation name in q.",
      "type": "string"
    },
    "department": {
      "description": "Département au format « code - nom », ex. « 06 - Alpes-Maritimes », telle que renvoyée par resolve_location. Le nom seul ne ramène rien. EN: Department as « code - name », e.g. « 06 - Alpes-Maritimes », as returned by resolve_location. The name alone matches nothing.",
      "type": "string"
    },
    "region": {
      "description": "Nom de la region. EN: Region name.",
      "type": "string"
    },
    "type": {
      "description": "Type d'établissement. Valeurs acceptées : organisme_formation, centre_formation_apprentis, centre_bilan_competences, etablissement_enseignement_superieur. EN: Establishment type. Accepted values: organisme_formation, centre_formation_apprentis, centre_bilan_competences, etablissement_enseignement_superieur.",
      "type": "string"
    },
    "certificationId": {
      "description": "Identifiant d'une certification : renvoie les établissements qui la préparent, en ignorant les autres filtres. EN: Certification id: returns the establishments preparing it, ignoring other filters.",
      "type": "number"
    },
    "aroundLat": {
      "description": "Latitude du centre du rayon, prise telle quelle dans la réponse de resolve_location. Toujours avec aroundLng et radiusKm. EN: Latitude of the radius centre, taken verbatim from resolve_location. Always with aroundLng and radiusKm.",
      "type": "number"
    },
    "aroundLng": {
      "description": "Longitude du centre du rayon, prise telle quelle dans la réponse de resolve_location. EN: Longitude of the radius centre, taken verbatim from resolve_location.",
      "type": "number"
    },
    "radiusKm": {
      "description": "Rayon en kilomètres, de 1 à 200 — 15 km est un bon départ, à élargir si vide. Pour « près de X » ou « autour de X », ou quand une petite ville ne donne rien : resolve_location d'abord, puis ses latitude/longitude ici. Le rayon REMPLACE city et postalCode, jamais en cumul — les résultats sont triés par distance croissante et portent distanceKm. Il sert aux recherches par type ou par domaine, pas aux noms propres : un nom d'établissement se cherche toujours dans q seul. EN: Radius in km, 1 to 200 — 15 km is a good start, widen if empty. Resolve the city first, then pass its latitude/longitude here. The radius REPLACES city and postalCode, never combined — results are sorted by distance and carry distanceKm. It serves type or domain searches, never proper names: an establishment name still goes in q alone.",
      "type": "number"
    },
    "limit": {
      "description": "Nombre de résultats, 1 à 20 (défaut 10). EN: 1 to 20 (default 10).",
      "type": "number"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "id": {
      "type": "number",
      "description": "Identifiant numerique de l etablissement. EN: Numeric establishment id."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Code postal à cinq chiffres (ex. 69003) ou nom de ville (ex. Antibes). Les deux fonctionnent, arrondissements compris : 69003 résout Lyon. EN: Five-digit postcode or city name. Both work, arrondissement codes included: 69003 resolves Lyon."
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}