---
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`

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.

---

[API](https://skmtc.net/openmercantil/apis/openmercantil-public-api.md) · [All operations](https://skmtc.net/openmercantil/apis/openmercantil-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openmercantil/openmercantil-public-api/revisions/996f96a11758/schema)