> ## Documentation Index
> Fetch the complete documentation index at: https://doc.fluximmo.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Découvrir le service de géocodage

> Métadonnées et capacités du service public BAN/BANO opéré par Fluximmo.

## À quoi ça sert

`GET /getCapabilities` est l'endpoint de **discovery** du service de géocodage : il retourne les métadonnées du service (versions disponibles, indices interrogeables, opérations supportées, limites). C'est utile pour :

* Vérifier qu'une version d'index donnée est en ligne avant de lancer un batch.
* Construire des outils internes qui s'adaptent dynamiquement aux capacités du service.
* Diagnostic et monitoring.

**Transparence** : ce service expose la **Base Adresse Nationale (BAN/BANO)** publique française (`api-adresse.data.gouv.fr`) opérée par Fluximmo.

## Exemple

<CodeGroup>
  ```bash curl theme={null}
  curl "https://geo.fluximmo.io/getCapabilities"
  ```

  ```python Python theme={null}
  import requests
  print(requests.get("https://geo.fluximmo.io/getCapabilities", timeout=10).json())
  ```

  ```javascript Node theme={null}
  const resp = await fetch("https://geo.fluximmo.io/getCapabilities");
  console.log(await resp.json());
  ```
</CodeGroup>

## Liens utiles

* [Géocodage direct](/api-geocoding-reference/search/recherche-par-géocodage-direct)
* [Géocodage inverse](/api-geocoding-reference/reverse/recherche-par-géocodage-inverse)


## OpenAPI

````yaml get /getCapabilities
openapi: 3.1.1
info:
  title: Service de géocodage
  description: API du service de géocodage 2.0 de l'IGN.
  contact:
    email: contact.geoservices@ign.fr
  version: 2.0.0
  license:
    name: Licence ouverte 2.0
    url: https://www.etalab.gouv.fr/licence-ouverte-open-licence
servers:
  - url: https://geo.fluximmo.io
security: []
tags:
  - name: getCapabilities
    description: Découverte du service
  - name: search
    description: Géocodage direct (recherche)
  - name: reverse
    description: Géocodage inverse
  - name: batch
    description: Géocodage par lot synchrone
  - name: batch-async
    description: Géocodage par lot asynchrone
paths:
  /getCapabilities:
    get:
      tags:
        - getCapabilities
      summary: Découvrir le service
      description: >-
        Découvrir le service: les opérations possibles, les ressources
        disponibles et les options proposées.
      operationId: getCapabilities
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Getcapabilities'
        '404':
          description: Not found
components:
  schemas:
    Getcapabilities:
      type: object
      properties:
        info:
          type: object
          properties:
            name:
              type: string
            url:
              type: string
            description:
              type: string
        api:
          type: object
          properties:
            name:
              type: string
              example: rest
            version:
              type: string
              example: 0.0.0
        operations:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
              description:
                type: string
              url:
                type: string
              methods:
                type: array
                items:
                  type: string
                  enum:
                    - GET
                    - POST
                    - PUT
                    - DELETE
              parameters:
                type: array
                items:
                  type: object
                  properties:
                    name:
                      type: string
                    in:
                      type: string
                    description:
                      type: string
                    required:
                      type: boolean
                    default:
                      description: default value
                    schema:
                      type: object
                      properties:
                        type:
                          type: string
                        example:
                          type: string
                    example:
                      type: string
        indexes:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
              description:
                type: string
              fields:
                type: array
                items:
                  type: object
                  properties:
                    name:
                      type: string
                    description:
                      type: string
                    type:
                      type: string
                    queryable:
                      type: boolean
                    filter:
                      type: boolean
                    values:
                      type: array
                      items:
                        description: allowed value

````