---
title: "Get documentary risk signals"
method: GET
path: "/api/v1/company/{slug}/risk-signals"
tags: ["Companies", "Risk Signals"]
---

# Get documentary risk signals

`GET /api/v1/company/{slug}/risk-signals`

## Request

- Base URL: `https://openmercantil.es`
- URL: `https://openmercantil.es/api/v1/company/{slug}/risk-signals`
- Auth: none declared
- TypeScript: <https://skmtc.dev/openmercantil/apis/openmercantil-public-api/docs/api/v1/company/:slug/risk-signals/get.ts> (a function with typed inputs; its response is checked against the schema)

Return only documentary signals whose exact dataset and negative-claim surface are authorized by the active source catalog. Other integrated sources are omitted without implying absence of the underlying fact. CENDOJ judgment text, OpenSanctions, AEPD and any unknown dataset are not exposed unless a future version records a field-specific public decision. Appearance never implies guilt, infringement, responsibility or current liability.

## Path parameters

- `slug` string, required

## Response `200`

Risk signals with disclaimers

- object
  - `slug` string
  - `signals_count` integer
  - `signals` object[]
    - `type` 'aepd_sanction' | 'cnmc_sanction' | 'concurso' | 'aeat_moroso' | 'cendoj_judgment' | 'opensanctions' | 'other'
    - `source_slug` string
    - `source_url` string
    - `date` string, date
    - `summary` string
    - `confidence` 'high' | 'medium' | 'low'
    - `homonymy_warning` boolean
    - `disclaimer` string
  - `source_catalog_version` string
  - `policy_scope` string
  - `_legal_notice` string

## Other responses

- `404`: Resource not found
- `429`: Rate limit exceeded
- `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`: 1 warning, 40 info
  - removed the optional property `signals/items/source` from the response with the `200` status
  - api operation id `getCompanyBySlugRiskSignals` was added
  - added the non-success response with the status `429`
  - added the non-success response with the status `503`
  - …37 more

[Operation history](https://skmtc.dev/openmercantil/apis/openmercantil-public-api/changes/api/v1/company/:slug/risk-signals/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)