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

# Get an establishment

> One establishment by SIRET, with the name of its company. Next: GET /v1/companies/{siren} for the company.



## OpenAPI

````yaml https://api.gabin.ai/v1/openapi.json get /v1/establishments/{siret}
openapi: 3.1.0
info:
  title: Gabin API
  version: 1.0.0
  description: >-
    French company and real-estate data for builders: companies (SIRENE, RNE),
    establishments, officers, annual accounts, buildings (BDNB), parcels,
    addresses, zones, multi-criteria search, vector tiles, reference data.
    Guides: https://docs.gabin.ai.


    **Authentication.** Every endpoint except `/v1/health` and
    `/v1/openapi.json` requires `Authorization: Bearer <key>`: an API key
    (`gab_live_…`, created at https://gabin.ai/compte/api) or an OAuth access
    token (`gat_…`, MCP connectors).


    **Limits (free plan).** 60 weighted requests per minute and 5,000 units per
    UTC day per account. A request weighs 1 unless its endpoint states
    otherwise. Every response carries `X-RateLimit-Limit`,
    `X-RateLimit-Remaining`, `X-RateLimit-Reset`, `X-Quota-Remaining` and
    `X-Request-Id`.


    **Responses.** Success: `{ "data": …, "meta": { … } }`. Lists are paginated
    by an opaque cursor (`meta.page.next_cursor`, up to 100 per page and 10,000
    results per query). Errors: `{ "error": { "code", "message", "docs_url" }
    }`. Dates are ISO 8601, amounts in euros, areas in m², coordinates WGS84
    `[lon, lat]`.


    **Data rules.** Companies under SIRENE partial diffusion are returned
    without the person's name, street address, position or building. Officers
    come from public registers only (name, first names, month and year of birth,
    mandates), without contact details. No contact data is exposed.
  contact:
    name: Gabin
    url: https://gabin.ai
servers:
  - url: https://api.gabin.ai
security:
  - bearerAuth: []
tags:
  - name: Companies
    description: >-
      Companies (SIRENE legal units): search with filters, profile,
      establishments, officers, annual accounts.
  - name: Establishments
    description: Establishments (SIRENE), by SIRET.
  - name: Officers
    description: >-
      Company officers from public registers (RNE): search by name, mandates,
      relationships.
  - name: Reference data
    description: >-
      Values accepted by the filters: NAF activities, legal form families,
      headcount ranges.
  - name: Account
    description: 'The account behind the API key: plan, limits, remaining quota.'
  - name: Meta
    description: Service status and OpenAPI document. No authentication.
  - name: Buildings
    description: >-
      French buildings (BDNB): profile, linked companies, sections (energy,
      transactions, owners, condominium, parcels, parking, permits, fiber,
      planning, market) and geographic search.
  - name: Parcels
    description: 'Cadastral parcels: boundary, area, buildings.'
  - name: Addresses
    description: >-
      Address geocoding (Base Adresse Nationale) with the BDNB building at the
      address, and named places.
  - name: Zones
    description: >-
      Cities, districts (merged IRIS), departments, and market figures of a zone
      (prices, rents, demography, income).
  - name: Search
    description: >-
      Multi-criteria search on buildings or companies in a zone: a catalog of
      fields, AND conditions, OR groups.
  - name: Tiles
    description: Vector tiles (Mapbox Vector Tile) of the gabin.ai map layers.
paths:
  /v1/establishments/{siret}:
    get:
      tags:
        - Establishments
      summary: Get an establishment
      description: >-
        One establishment by SIRET, with the name of its company. Next: GET
        /v1/companies/{siren} for the company.
      operationId: getEstablishment
      parameters:
        - name: siret
          in: path
          required: true
          description: >-
            SIRET of the establishment: 14 digits (SIREN + 5). Example:
            55210055400013.
          schema:
            type: string
            pattern: ^\d{14}$
      responses:
        '200':
          description: OK
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
            X-RateLimit-Limit:
              $ref: '#/components/headers/X-RateLimit-Limit'
            X-RateLimit-Remaining:
              $ref: '#/components/headers/X-RateLimit-Remaining'
            X-RateLimit-Reset:
              $ref: '#/components/headers/X-RateLimit-Reset'
            X-Quota-Remaining:
              $ref: '#/components/headers/X-Quota-Remaining'
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                  - meta
                properties:
                  data:
                    $ref: '#/components/schemas/EstablishmentDetail'
                  meta:
                    type: object
                    description: Empty for a single resource.
              example:
                data:
                  siret: '99910001700011'
                  siren: '999100017'
                  headquarters: true
                  trade_name: null
                  address: 12 rue Émile Zola
                  postal_code: '69100'
                  city: Villeurbanne
                  insee: '69266'
                  naf_code: 43.29A
                  created_on: '2014-03-12'
                  closed_on: null
                  active: true
                  building_id: bdnb-bg-CJ69-HW8G-PTTG
                  location:
                    - 4.8795
                    - 45.7665
                  company_name: Atelier Thermique du Rhône
                meta: {}
        '400':
          description: INVALID
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                INVALID:
                  value:
                    error:
                      code: INVALID
                      message: 'limit: Too big: expected number to be <=100'
                      docs_url: https://docs.gabin.ai/errors#invalid
        '401':
          description: UNAUTHENTICATED
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                UNAUTHENTICATED:
                  value:
                    error:
                      code: UNAUTHENTICATED
                      message: Invalid or revoked API key.
                      docs_url: https://docs.gabin.ai/errors#unauthenticated
        '404':
          description: NOT_FOUND
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                NOT_FOUND:
                  value:
                    error:
                      code: NOT_FOUND
                      message: No company with SIREN 999999999.
                      docs_url: https://docs.gabin.ai/errors#not_found
        '429':
          description: RATE_LIMITED, QUOTA_EXCEEDED
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
            Retry-After:
              $ref: '#/components/headers/Retry-After'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                RATE_LIMITED:
                  value:
                    error:
                      code: RATE_LIMITED
                      message: >-
                        Rate limit reached (60 weighted requests per minute).
                        Retry in 12 s.
                      docs_url: https://docs.gabin.ai/errors#rate_limited
                QUOTA_EXCEEDED:
                  value:
                    error:
                      code: QUOTA_EXCEEDED
                      message: >-
                        Daily quota reached (5000 units per UTC day). It resets
                        at 00:00 UTC.
                      docs_url: https://docs.gabin.ai/errors#quota_exceeded
        '503':
          description: BUSY
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
            Retry-After:
              $ref: '#/components/headers/Retry-After'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                BUSY:
                  value:
                    error:
                      code: BUSY
                      message: >-
                        The API is serving too many database requests right now.
                        Retry in 1 s.
                      docs_url: https://docs.gabin.ai/errors#busy
components:
  headers:
    X-Request-Id:
      description: Unique id of the request; quote it when contacting support.
      schema:
        type: string
    X-RateLimit-Limit:
      description: Weighted requests allowed per minute for the account.
      schema:
        type: integer
    X-RateLimit-Remaining:
      description: Weighted requests left in the current minute.
      schema:
        type: integer
    X-RateLimit-Reset:
      description: Seconds until the per-minute window resets.
      schema:
        type: integer
    X-Quota-Remaining:
      description: Units left in the daily quota (UTC day).
      schema:
        type: integer
    Retry-After:
      description: Seconds to wait before retrying.
      schema:
        type: integer
  schemas:
    EstablishmentDetail:
      type: object
      properties:
        siret:
          type: string
          description: 'SIRET: 14 digits. Example: 55210055400013.'
        siren:
          type: string
          description: SIREN of the company that owns the establishment.
        headquarters:
          type: boolean
          description: True for the registered office (siège).
        trade_name:
          description: 'Sign or trade name (enseigne) when declared. Example: "Le Comptoir".'
          type:
            - string
            - 'null'
        address:
          type: string
          description: >-
            Street address. Limited to "postal code + city" when the
            establishment is under SIRENE partial diffusion or has no street.
            Example: "12 rue Émile Zola".
        postal_code:
          description: 'Postal code. Example: "69100".'
          type:
            - string
            - 'null'
        city:
          description: 'City name. Example: "Villeurbanne".'
          type:
            - string
            - 'null'
        insee:
          description: >-
            INSEE code of the city (5 characters); null outside France. Example:
            "69266".
          type:
            - string
            - 'null'
        naf_code:
          description: >-
            NAF rev. 2 code of the establishment, may differ from the company's.
            Example: "43.29A".
          type:
            - string
            - 'null'
        created_on:
          description: Creation date (YYYY-MM-DD).
          type:
            - string
            - 'null'
        closed_on:
          description: >-
            Closing date (YYYY-MM-DD) when the establishment is closed, else
            null.
          type:
            - string
            - 'null'
        active:
          type: boolean
          description: True when the establishment is open (SIRENE state A).
        building_id:
          description: >-
            BDNB building id (batiment_groupe_id) the establishment occupies,
            when its address matches a building at street-number level. Example:
            "bdnb-bg-CJ69-HW8G-PTTG".
          type:
            - string
            - 'null'
        location:
          anyOf:
            - type: array
              prefixItems:
                - type: number
                - type: number
              items: false
              minItems: 2
              maxItems: 2
              description: 'WGS84 coordinates `[lon, lat]`. Example: [4.8795, 45.7665].'
            - type: 'null'
          description: >-
            Geocoded position `[lon, lat]` (WGS84) at street-number or street
            level; null when only the city is known.
        company_name:
          type: string
          description: >-
            Name of the company (neutral label when the company is under partial
            diffusion).
      required:
        - siret
        - siren
        - headquarters
        - trade_name
        - address
        - postal_code
        - city
        - insee
        - naf_code
        - created_on
        - closed_on
        - active
        - building_id
        - location
        - company_name
      description: An establishment and the name of its company.
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - UNAUTHENTICATED
                - FORBIDDEN
                - NOT_FOUND
                - INVALID
                - ZONE_REQUIRED
                - PAGINATION_LIMIT
                - RATE_LIMITED
                - QUOTA_EXCEEDED
                - TIMEOUT
                - BUSY
                - INTERNAL
              description: Stable machine-readable code.
            message:
              type: string
              description: Human-readable explanation, in English.
            docs_url:
              type: string
              description: Documentation page for this error code.
          required:
            - code
            - message
            - docs_url
      required:
        - error
      description: Error body. The HTTP status matches `error.code`.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API key `gab_live_…` or OAuth access token `gat_…`.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.