---
title: "Get policy-gated sanctions dataset"
method: GET
path: "/api/v1/company/{slug}/sanctions"
tags: ["Companies", "Risk Signals"]
---

# Get policy-gated sanctions dataset

`GET /api/v1/company/{slug}/sanctions`

## Request

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

This route is fail-closed. It returns data only when the exact sanctions dataset has a valid public decision, license metadata and identity policy in the active source catalog. OpenSanctions is currently in review, so the route returns 503 without reading or serializing its payload.

## Path parameters

- `slug` string, required

## Response `200`

Sanctions list when the exact dataset is authorized

- CompanySanctionsResponse
  - `slug` string
  - `count` integer
  - `items` DocumentarySanction[]
    - `source` string, nullable
    - `date` string, nullable
    - `authority` string, nullable
    - `summary` string, nullable
    - `official_url` string, uri, nullable
    - `status` string, nullable
  - `source` string, nullable
  - `note` string, nullable

## Other responses

- `404`: Resource not found
- `429`: Rate limit exceeded
- `503`: Controlled fail-closed denial: the required dataset or legal layer is absent, invalid, unsupported or not authorized for this public surface.

## Changes

- **2026-07-26** `996f96a11758`: 9 info
  - api operation id `getCompanyBySlugSanctions` was added
  - added the non-success response with the status `404`
  - added the non-success response with the status `429`
  - added the non-success response with the status `503`
  - …5 more

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