> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rushed.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Article by ID

> Retrieve a single article by its UUID with optional enrichment modules

## Description

Returns a single article with all base fields. Use `include` to request enrichment modules like sentiment, entities, market impact, translations, and scoring.

## Headers

<ParamField header="X-API-Key" type="string" required>
  Your Rushed API key
</ParamField>

## Path Parameters

<ParamField path="id" type="string" required>
  Article UUID
</ParamField>

## Query Parameters

<ParamField query="include" type="string">
  Comma-separated enrichment modules: `sentiment`, `market_impact`, `entities`, `translations`, `scoring`, `classification`, `meta`
</ParamField>

## Response

<ResponseField name="success" type="boolean" required>
  Always `true` on success
</ResponseField>

<ResponseField name="data" type="object" required>
  Full article object with requested enrichments
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://worker.rushed.com.br/api/articles/550e8400-e29b-41d4-a716-446655440000?include=sentiment,entities,market_impact,translations" \
    -H "X-API-Key: rsh_live_xxxxxxxxxxxx"
  ```

  ```javascript Node.js theme={null}
  const articleId = '550e8400-e29b-41d4-a716-446655440000';
  const res = await fetch(
    `https://worker.rushed.com.br/api/articles/${articleId}?include=sentiment,entities,market_impact,translations`,
    { headers: { 'X-API-Key': 'rsh_live_xxxxxxxxxxxx' } }
  );
  const { data } = await res.json();
  ```

  ```python Python theme={null}
  import requests

  res = requests.get(
      'https://worker.rushed.com.br/api/articles/550e8400-e29b-41d4-a716-446655440000',
      params={'include': 'sentiment,entities,market_impact,translations'},
      headers={'X-API-Key': 'rsh_live_xxxxxxxxxxxx'}
  )
  article = res.json()['data']
  ```
</RequestExample>

<ResponseExample>
  ```json 200 — Success (with enrichments) theme={null}
  {
    "success": true,
    "data": {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "sourceUrl": "https://reuters.com/business/petrobras-dividend",
      "sourceName": "Reuters",
      "title": "Petrobras announces record dividend payout of R$72B",
      "subtitle": "State oil company surprises market with largest-ever distribution",
      "summary": "Petrobras declared its largest-ever dividend distribution of R$72 billion, exceeding analyst expectations by 40%.",
      "publishedAt": "2026-03-28T14:30:00Z",
      "primarySector": "FIN",
      "primaryTopic": "DIV",
      "contentType": "BREAKING",
      "urgencyLevel": "HIGH",
      "isBreaking": true,
      "imageUrl": "https://reuters.com/images/petrobras.jpg",
      "language": "en",
      "sentimentScore": 0.82,
      "sentimentLabel": "MUITO_POSITIVO",
      "sentimentConfidence": 0.91,
      "marketImpactLevel": "ALTO",
      "marketImpactHorizon": "IMEDIATO",
      "marketImpactScope": "SETOR",
      "marketConfidenceLevel": "CONFIRMADO",
      "entities": [
        {
          "entityId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
          "entityType": "COMPANY",
          "canonicalName": "Petrobras",
          "ticker": "PETR4",
          "mentionCount": 12,
          "prominenceScore": 0.95,
          "sentimentTowardEntity": 0.78,
          "isInTitle": true,
          "isInLead": true
        }
      ],
      "titlePt": "Petrobras anuncia distribuicao recorde de dividendos de R$72B",
      "subtitlePt": "Petroleira estatal surpreende mercado com maior distribuicao da historia",
      "summaryPt": "A Petrobras declarou sua maior distribuicao de dividendos da historia, de R$72 bilhoes, superando as expectativas dos analistas em 40%.",
      "titleEn": "Petrobras announces record dividend payout of R$72B",
      "subtitleEn": "State oil company surprises market with largest-ever distribution",
      "summaryEn": "Petrobras declared its largest-ever dividend distribution of R$72 billion, exceeding analyst expectations by 40%."
    }
  }
  ```

  ```json 404 — Not Found theme={null}
  {
    "success": false,
    "error": "Not found",
    "statusCode": 404
  }
  ```
</ResponseExample>
