---
title: "Compose the adverse-media slice of the KYB envelope"
method: GET
path: "/api/v1/entity/{anchor}/{value}/adverse-media"
tags: ["Sugra Entity"]
---

# Compose the adverse-media slice of the KYB envelope

`GET /api/v1/entity/{anchor}/{value}/adverse-media`

Resolve an entity by `(anchor, value)` and return ONLY the `adverse_media` slice: recent news linking the entity to AML risk categories (financial crime, money laundering, fraud, corruption, bribery, sanctions evasion, terrorist financing, tax evasion). Linkage is keyword-based (entity name co-occurring with an AML risk term) and is supplementary and non-comprehensive. The GDELT GEG entity index confirms/disambiguates hits and raises `precision` (`low` keyword-only, `medium` entity recognized in the recent window, `high` the specific article was entity-extracted for this entity); `disambiguation` and `entity_match` report the confirmation state - see the slice `coverage_note`. This slice is SOFT: a data outage degrades to a null slice with `meta.partial=true` and returns 200, never 503 (the adverse path does not screen, so it cannot fail closed to 503).

## Path parameters

- `anchor` string, required — Entity anchor type (`lei` or `vat`).
- `value` string, required — Anchor value (e.g. the LEI code or the VAT number).

## Response `200`

Successful Response

- EnvelopeEntityAnchorValueAdverseMediaData
  - `data` EntityAnchorValueAdverseMediaData, required
    - `entity` EntityAnchorValueAdverseMediaEntityEntity
      - `id` string, nullable
      - `anchor` EntityAnchorValueAdverseMediaEntityAnchor
        - `lei` string, nullable
      - `name` string, nullable
      - `country` string, nullable
      - `type` string, nullable
      - `status` string, nullable
      - `field_provenance` FieldProvenance
        - `name` string, nullable
        - `country` string, nullable
        - `status` string, nullable
        - `type` string, nullable
    - `adverse_media` AdverseMedia
      - `hits` Hit[], nullable
        - `title` string, nullable
        - `url` string, nullable
        - `source` string, nullable
        - `published` string, nullable
        - `matched_terms` string[], nullable
        - `snippet` unknown
        - `entity_confirmed` boolean, nullable
      - `count` union
        - integer
        - number
      - `precision` string, nullable
      - `disambiguation` string, nullable
      - `entity_match` EntityEntityMatch
        - `recognized` boolean, nullable
        - `type` string, nullable
        - `mid` string, nullable
        - `confirmed_hits` union
          - integer
          - number
        - `ambiguous` boolean, nullable
        - `geg_partial` boolean, nullable
        - `max_salience` union
          - integer
          - number
      - `coverage_note` string, nullable
      - `partial_coverage` boolean, nullable
  - `meta` SugraMeta, required — Metadata attached to every /api/v1/* response envelope.
    - `endpoint` string, required — Requested endpoint path.
    - `data_time` string, required — ISO 8601 UTC timestamp of the source data, not of the request.
    - `response_time` string, required — ISO 8601 UTC timestamp when this response was produced.
    - `provider` string, required — API name and version.
    - `source` string, nullable — Identifier of the primary upstream source used for this response.
    - `attribution` string, nullable — Human-readable attribution mandated by an upstream source (e.g. a securities regulator or self-regulatory organization). Present only on responses whose source requires the owner and source to be clearly identified. Do not remove or alter it when using the response.
    - `fallback_used` boolean, nullable — True when the primary source failed and a fallback produced the data.
    - `fallback_chain` string[], nullable — Ordered list of sources attempted, in the order they were tried.
    - `cached` boolean, nullable — True when this response was served from the internal cache.
    - `stale` boolean, nullable — True when the cached response was returned after the upstream rate-limited or errored. Clients can use this to detect degraded data.

## Other responses

- `401` — Missing or invalid `x-api-key` header. JSON body with a stable `code` distinguishing `missing_api_key` (no header sent) from `invalid_api_key` (header sent, key not accepted); any other 401 source carries the generic `unauthorized` with its detail as `reason`. Plus `hint`. `plan` is always null on 401 - an unauthenticated request has no plan; quota exhaustion is 429, not 401.
- `422` — Validation Error
- `429` — Daily rate limit exceeded. Check `X-RateLimit-Reset` for the next window.
- `503` — Upstream source is temporarily unavailable. Retry after a short delay.

---

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