---
title: "Get a document by id"
method: GET
path: "/documents/{id}"
tags: ["Content Search"]
---

# Get a document by id

`GET /documents/{id}`

## Path parameters

- `id` string, uuid, required

## Response `200`

Returns the document for this id

- DocumentResponse
  - `document` Document, required
    - `story-id` string, uuid
    - `signal-url` string
    - `regulatory-document` 'alert' | 'announcement' | 'bill' | 'circular' | 'consultation paper' | 'decision' | 'enforcement' | 'general' | 'guidance' | 'hearing' | 'interview' | 'judgement' | 'legislation' | 'letter' | 'opinion' | 'parliamentary commentary' | 'policy paper' | 'press release' | 'publication' | 'resolution' | 'sanctions' | 'speech' | 'statement' | 'tender' | 'transcript' | 'transparency' | 'warning' | 'other' — <span class="beta-tag"></span> Regulatory document categorisation
    - `entities` EntityWithMentions[], required
      - `id` string, uuid, required
      - `type` 'person' | 'organisation' | 'location' | 'substance' | 'disease' | 'product' | 'regulation', required
      - `name` string, required
      - `sentiment` 'positive' | 'negative' | 'neutral', required
      - `salient` boolean — Indicates if this entity is truly central to the content of the document
      - `salience-rank` integer — Indicates how close this entity is to the topic of discussion in the article, in relation to other entities mentioned. A lower rank means a higher salience.
      - `mentions` Mention[], required — The positions of the entity in the document
        - `position` 'content' | 'summary' | 'title' | 'quote', required
        - `sentiment` 'positive' | 'negative' | 'neutral'
    - `published-at` string, date-time, required
    - `source` Source, required
      - `id` string, uuid, required
      - `name` string, required
      - `country` string
      - `subregion` string
      - `region` string
    - `title` string, required
    - `topics` PartialTopic[], required
      - `id` string, uuid, required
      - `name` string, required
    - `categories` object
      - `iptc-media-topics` Category[]
        - `id` string, uuid, required
        - `name` string, required
    - `language` string
    - `id` string, uuid, required
    - `native-title` string — Document title in its native language (for non english content)
    - `media-type` 'online' | 'print', required

---

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