# Gabin

> API and MCP server for French company and real-estate data: companies, officers, buildings, parcels, addresses and zones, in JSON.

- [Gabin API and MCP](https://docs.gabin.ai/index.md): French company and real-estate data for the apps and agents you build: companies, officers, buildings, parcels, addresses and zones, in JSON.
- [Quickstart](https://docs.gabin.ai/quickstart.md): Create a Gabin account and an API key, then call the API and connect the MCP server.
- [Authentication](https://docs.gabin.ai/authentication.md): API keys for your code, OAuth 2.1 for MCP connectors. Every call to /v1 carries a Bearer token.
- [Limits](https://docs.gabin.ai/limits.md): Rate limit, daily quota, request weights, concurrency and pagination caps of the free plan.
- [Conventions](https://docs.gabin.ai/conventions.md): Response envelope, cursor pagination, totals, identifiers, formats and GeoJSON in the Gabin API.
- [Errors](https://docs.gabin.ai/errors.md): Error format and the list of Gabin API error codes, with their HTTP status and what to do.
- [Data sources and rules](https://docs.gabin.ai/data.md): Where Gabin data comes from, how buildings and companies are linked, and the rules applied to personal data.
- [Companies and officers](https://docs.gabin.ai/guides/companies.md): Search French companies by name, SIREN or filters, read a company profile, its establishments, officers and annual accounts, and use reference data as filters.
- [Buildings and parcels](https://docs.gabin.ai/guides/buildings.md): Find buildings in an area, read a building profile and its sections, list the companies that occupy or own it, and find the buildings of a company.
- [Zones and addresses](https://docs.gabin.ai/guides/zones-and-addresses.md): Geocode French addresses, find named places, browse cities, districts and departments, and read market figures and boundaries of a zone.
- [Advanced search](https://docs.gabin.ai/guides/advanced-search.md): Combine conditions on buildings, energy certificates, condominiums, owners, occupants and companies with AND and OR groups, count the results, then list them.
- [Vector tiles](https://docs.gabin.ai/guides/tiles.md): Draw Gabin map layers (buildings, parcels, owners, energy, transactions, planning…) in MapLibre GL or Mapbox GL with Mapbox Vector Tiles.
- [MCP server](https://docs.gabin.ai/mcp/overview.md): Give an AI agent read access to French companies, officers, buildings and territories through the Gabin MCP server at mcp.gabin.ai.
- [Connect a client](https://docs.gabin.ai/mcp/connect.md): Add the Gabin MCP server to Claude, Claude Code, ChatGPT, Cursor, VS Code or any MCP client, with OAuth or an API key.
- [Tools](https://docs.gabin.ai/mcp/tools.md): The 18 read-only tools of the Gabin MCP server: companies and officers, buildings and real estate, zones and addresses, multi-criteria search.
- [Search companies](https://docs.gabin.ai/api-reference/companies/search-companies.md): Companies matching a name and/or filters (activity, location, size, legal form, revenue, creation date).
- [Get a company](https://docs.gabin.ai/api-reference/companies/get-a-company.md): Profile of a company by SIREN: identity, activity, legal form, size, registered office (address, district, building), registry facts (RNE), latest accounts summary and collective procedure (BODACC).
- [List the establishments of a company](https://docs.gabin.ai/api-reference/companies/list-the-establishments-of-a-company.md): Establishments of a company, open and closed: registered office first, then open ones, newest first. Each carries its address, NAF code, dates, position and the BDNB building it occupies when its address matches one.
- [List the officers of a company](https://docs.gabin.ai/api-reference/companies/list-the-officers-of-a-company.md): Officers registered at the RNE: people (with an id for GET /v1/officers/{id}) and corporate officers (with their SIREN when known). Management first, current mandates first. Empty for a company under partial diffusion.
- [Get the annual accounts of a company](https://docs.gabin.ai/api-reference/companies/get-the-annual-accounts-of-a-company.md): Annual accounts filed at the RNE, one entry per fiscal year (up to 10, most recent first), with income statement and balance sheet items in euros, and a summary of the latest year. Many small companies file confidential or no accounts: `fiscal_years` can be empty.
- [List the buildings of a company](https://docs.gabin.ai/api-reference/companies/list-the-buildings-of-a-company.md): Buildings a company occupies (its establishments matched to a BDNB building, open or closed) and owns (land files, BDNB), merged by building: occupied and owned first, then by open establishments.
- [Get an establishment](https://docs.gabin.ai/api-reference/establishments/get-an-establishment.md): One establishment by SIRET, with the name of its company. Next: GET /v1/companies/{siren} for the company.
- [Search officers by name](https://docs.gabin.ai/api-reference/officers/search-officers-by-name.md): People holding a mandate in a French company, found by name in the RNE. Exact identities first; one company per person helps tell namesakes apart. Not paginated: refine `q` (first and last name) for more precise results. Next: GET /v1/officers/{id}.
- [Get an officer](https://docs.gabin.ai/api-reference/officers/get-an-officer.md): An officer (person) by id: mandates in every company where the same identity (name, first names, birth month) appears, and a bounded relationship graph (their companies and the other officers of those companies). Companies under partial diffusion are never linked to a person.
- [List NAF activities](https://docs.gabin.ai/api-reference/reference-data/list-naf-activities.md): NAF rev. 2 sub-classes (732), the activity level SIRENE stores, with their hierarchy and Gabin sector. Filter by words of the label or start of the code (`q`) and by section. Codes go into the `naf` filter of GET /v1/companies (divisions and sections are accepted there too).
- [Get a NAF activity](https://docs.gabin.ai/api-reference/reference-data/get-a-naf-activity.md): One NAF rev. 2 sub-class with its class, group, division, section and Gabin sector.
- [List legal form families](https://docs.gabin.ai/api-reference/reference-data/list-legal-form-families.md): Legal form families accepted by the `legal_form` filter of GET /v1/companies. Each family groups INSEE legal categories (SAS covers SAS and SASU, etc.).
- [List headcount ranges](https://docs.gabin.ai/api-reference/reference-data/list-headcount-ranges.md): INSEE headcount ranges (tranches d'effectif salarié) with their bounds. Codes go into the `headcount` filter of GET /v1/companies and appear as `headcount_range` on companies.
- [Get the current account](https://docs.gabin.ai/api-reference/account/get-the-current-account.md): The account and credential behind the bearer, the plan, the per-minute rate limit and the daily quota with what remains after this call, and today's recorded usage. Useful to check a key.
- [Service status](https://docs.gabin.ai/api-reference/meta/service-status.md): `ok` when the API and its database answer. No authentication, no quota.
- [OpenAPI document](https://docs.gabin.ai/api-reference/meta/openapi-document.md): This document: OpenAPI 3.1 description of every v1 endpoint. No authentication.
- [Search buildings in an area](https://docs.gabin.ai/api-reference/buildings/search-buildings-in-an-area.md): Buildings (BDNB) in one area, ordered by id: a bounding box (`bbox`, at most 4 km²), a circle (`lat`, `lon`, `radius` up to 1,000 m), a city (`insee`) or a district (`iris`). Optional filters: `usage`, `built_after`, `built_before`, `dpe`, `min_companies`.
- [Get a building](https://docs.gabin.ai/api-reference/buildings/get-a-building.md): Profile of a building (BDNB) by id: name of the place, addresses, city and district, use, construction year, levels, dwellings, footprint, energy class, and the number of linked companies.
- [List the companies linked to a building](https://docs.gabin.ai/api-reference/buildings/list-the-companies-linked-to-a-building.md): Companies linked to a building: occupants (an establishment located there, matched by address or position) and corporate owners (land files), merged by SIREN. Active companies first, then by name.
- [Get the energy certificates of a building](https://docs.gabin.ai/api-reference/buildings/get-the-energy-certificates-of-a-building.md): Energy performance certificates (DPE, ADEME) attached to the building in the BDNB: representative class, class distribution, housing and tertiary certificates with consumption, emissions, heating, insulation.
- [Get the property transactions of a building](https://docs.gabin.ai/api-reference/buildings/get-the-property-transactions-of-a-building.md): Property sales (DVF, DGFiP) on the building's cadastral parcels since 2014: date, nature, price, lots, land, median price per m². DVF names no party to a sale.
- [Get the corporate owners of a building](https://docs.gabin.ai/api-reference/buildings/get-the-corporate-owners-of-a-building.md): Owners of the building that are legal entities (land files: BDNB and MAJIC), the one holding the most first, with their holdings, property-manager signals, and occupants that look like the owner (`likely_owner`, an inference; sole proprietorships included under their registered name).
- [Get the condominium of a building](https://docs.gabin.ai/api-reference/buildings/get-the-condominium-of-a-building.md): Registered condominium of the building (RNIC): lots, construction period, type of manager and the professional manager (syndic) when it is a legal entity. A volunteer manager is an individual and is never named.
- [Get the cadastral parcels of a building](https://docs.gabin.ai/api-reference/buildings/get-the-cadastral-parcels-of-a-building.md): Cadastral parcels under the building, main one first, with area and GeoJSON boundary. Details of a parcel: GET /v1/parcels/{id}.
- [Get the parking of a building](https://docs.gabin.ai/api-reference/buildings/get-the-parking-of-a-building.md): Parking of the building: condominium parking lots (RNIC), garage lots (BDNB), OpenStreetMap parkings intersecting or within 50 m, EV charging stations nearby (IRVE).
- [Get the building permits of a building](https://docs.gabin.ai/api-reference/buildings/get-the-building-permits-of-a-building.md): Building permits (Sitadel) on the building's parcels, most recent first: type, status, dates, dwellings and areas created. The applicant is given only when it is a legal entity.
- [Get the fiber deployment of a building](https://docs.gabin.ai/api-reference/buildings/get-the-fiber-deployment-of-a-building.md): Fiber deployment status of the building (Arcep): status, building access points (IMB), infrastructure operator, retail offers.
- [Get the urban planning rules of a building](https://docs.gabin.ai/api-reference/buildings/get-the-urban-planning-rules-of-a-building.md): Urban planning of the building (Géoportail de l'Urbanisme): local plan zone (PLU) with its regulation, safeguard plan (PSMV), heritage easements (historic monuments and their surroundings, remarkable sites).
- [Get the market summary around a building](https://docs.gabin.ai/api-reference/buildings/get-the-market-summary-around-a-building.md): Market summary of the building's city and district: median sale price per m² and its change (DVF), rents (ANIL), population (INSEE), income (FiLoSoFi). Full series: GET /v1/zones/{level}/{code}/market.
- [Get a cadastral parcel](https://docs.gabin.ai/api-reference/parcels/get-a-cadastral-parcel.md): A cadastral parcel by id: section, number, area, GeoJSON boundary, city, district and the buildings standing on it. Owners are not listed here (corporate owners: GET /v1/buildings/{id}/owners). Parcel ids come from GET /v1/buildings/{id}/parcels or the parcels tile layer.
- [Geocode an address](https://docs.gabin.ai/api-reference/addresses/geocode-an-address.md): Geocodes a French address with the Base Adresse Nationale (public service) and returns the normalized address, its point, and, for a house-number match, the BDNB building at that point (inside it, or within 30 m). Next: GET /v1/buildings/{id}.
- [Search named places](https://docs.gabin.ai/api-reference/addresses/search-named-places.md): Named places (residences, hospitals, schools, care homes, hotels…) by name, from the BD TOPO, the condominium register and other public sources, each with its building. A city at the end narrows the search ("orangerie ecully"). Next: GET /v1/buildings/{building_id}.
- [Search cities](https://docs.gabin.ai/api-reference/zones/search-cities.md): Cities and arrondissements of Paris, Lyon and Marseille by name (prefix), postal code or INSEE code, up to 8. Next: GET /v1/zones/cities/{insee}, or use `insee` in GET /v1/buildings and GET /v1/companies.
- [Get a city](https://docs.gabin.ai/api-reference/zones/get-a-city.md): A city or arrondissement by INSEE code: name, department, main postal code, population, center. Next: its districts, GET /v1/zones/city/{insee}/market, or `insee` in GET /v1/buildings.
- [List the districts of a city](https://docs.gabin.ai/api-reference/zones/list-the-districts-of-a-city.md): Districts of a city, by name: one or several merged IRIS with a readable name. Use the `iris` code in GET /v1/buildings, GET /v1/companies or GET /v1/zones/district/{iris}/market.
- [Get a district](https://docs.gabin.ai/api-reference/zones/get-a-district.md): A district by IRIS code: its readable name and city. Next: GET /v1/buildings?iris={iris}, GET /v1/companies?iris={iris} or GET /v1/zones/district/{iris}/market.
- [List the cities of a department](https://docs.gabin.ai/api-reference/zones/list-the-cities-of-a-department.md): All cities of a department by name, with the arrondissements of Paris, Lyon and Marseille listed next to their city. Not paginated.
- [Get the market figures of a zone](https://docs.gabin.ai/api-reference/zones/get-the-market-figures-of-a-zone.md): Market and territory figures of a zone, at every level containing it: sale prices per m² by segment (DVF), most active streets, rents (ANIL), population by age and occupation (INSEE census), income (FiLoSoFi). A family missing for a zone comes back empty.
- [Get the boundary of a zone](https://docs.gabin.ai/api-reference/zones/get-the-boundary-of-a-zone.md): Simplified boundary of a zone (region, department, city, district) as a GeoJSON Polygon or MultiPolygon, WGS84, to draw it on a map or to derive a bbox.
- [List the fields of the multi-criteria search](https://docs.gabin.ai/api-reference/search/list-the-fields-of-the-multi-criteria-search.md): Catalog of the fields usable in POST /v1/search and POST /v1/search/count: id, target, type, operator, unit, accepted values, source table. Labels and descriptions are in French; ids and codes are stable.
- [Count the results of a multi-criteria search](https://docs.gabin.ai/api-reference/search/count-the-results-of-a-multi-criteria-search.md): Counts the buildings or companies matching a search (up to 100,000) and breaks them down (use, energy class, city…). Use it to refine a search before listing it with POST /v1/search.
- [Run a multi-criteria search](https://docs.gabin.ai/api-reference/search/run-a-multi-criteria-search.md): Lists the buildings or companies (registered offices) matching a search, in a stable order, paginated by cursor (pass `meta.page.next_cursor` as `cursor` with the same filters). `meta.total` is a lower bound while pages remain: POST /v1/search/count gives the total.
- [Get a vector tile](https://docs.gabin.ai/api-reference/tiles/get-a-vector-tile.md): A Mapbox Vector Tile (MVT, XYZ scheme) of a gabin.ai map layer, for MapLibre GL or Mapbox GL (send the key with `transformRequest`). 204 when the tile is empty. Feature properties are those of the gabin.ai map (ids such as `batiment_groupe_id`, `parcelle_id` open the matching endpoints).

## OpenAPI Specs

- [openapi](https://api.gabin.ai/v1/openapi.json)


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