---
title: "Get extracted BORME facts for a company"
method: GET
path: "/api/v1/empresa/{slug}/facts"
tags: ["Companies", "BORME"]
---

# Get extracted BORME facts for a company

`GET /api/v1/empresa/{slug}/facts`

## Request

- Base URL: `https://openmercantil.es`
- URL: `https://openmercantil.es/api/v1/empresa/{slug}/facts`
- Auth: one of:
  - none
  - API key in header `X-API-Key`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/openmercantil/apis/openmercantil-public-api/docs/api/v1/empresa/:slug/facts/get.ts> (a function with typed inputs; its response is checked against the schema)

Return structured facts extracted from BORME publications grouped by type (appointments, removals, capital changes, etc.). Spanish-friendly alias of /company.

## Path parameters

- `slug` string, required

## Query parameters

- `limit` integer

## Headers

- `If-None-Match` string

## Response `200`

Grouped facts

- CompanyFactsResponse
  - `slug` string, required
  - `count` integer, required
  - `has_more` boolean, required
  - `facts` BormeFact[], required
    - `fact_type` string
    - `publish_date` string, nullable
    - `event_date` string, nullable
    - `text_value` string, nullable
    - `person_name` string, nullable
    - `role` string, nullable
    - `source_url` string, uri, nullable
  - `summary` object, required: Closed summary derived from the same hash-attested company report as the returned facts.
    - `total_facts` integer, required
    - `first_seen` string, date, nullable, required
    - `last_seen` string, date, nullable, required
    - `types` object, required: Counts keyed by the documented BORME fact_type.
  - `attribution` string
  - `source` 'borme', required
  - `sync_date` string, date-time

## Other responses

- `304`: The attested facts report and exact limit have not changed.
- `400`: Invalid request
- `404`: Resource not found
- `422`: The query is lexically valid but outside a documented numeric or length bound, or uses an unsupported indexed combination.
- `429`: Rate limit exceeded
- `500`: The bounded operation failed without exposing internal exception details.
- `503`: The public read failed closed because its legal source catalog, subject classification, bounded projection, database helper or required artifact is unavailable. Clients must not infer an empty result.

## Changes

- **2026-07-26** `996f96a11758`: 53 info
  - api operation id `getEmpresaBySlugFacts` was added
  - the endpoint scheme security `apiKey` was added to the API
  - the endpoint scheme security `bearerAuth` was added to the API
  - added the new optional `header` request parameter `If-None-Match`
  - …49 more

[Operation history](https://skmtc.dev/openmercantil/apis/openmercantil-public-api/changes/api/v1/empresa/:slug/facts/get.md)

---

[API](https://skmtc.dev/openmercantil/apis/openmercantil-public-api.md) - [All operations](https://skmtc.dev/openmercantil/apis/openmercantil-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/openmercantil/apis/openmercantil-public-api/revisions/601ff6123c86?raw)