# Get an article

One source article with its annotations, linked events and organisations.

Canonical: https://chikaraintel.com/docs/api/reference/articles/get-article

```text
GET https://api.chikaraintel.com/v1/articles/{articleReference}
```

Authentication: `Authorization: Bearer <token>`.

## Parameters

- `articleReference` (uuid, path, required) The article's reference.

## Response

The payload is under `success`.

- `reference` (uuid)
- `title` (string)
- `url` (string | null)
- `published_at` (datetime)
- `content` (string) The article text, where its licence allows.
- `offsets_unit` (string) Always `utf16`.
- `annotations` (array) Where the licence allows.
  - `reference` (uuid) The annotation's reference.
  - `type` (string) `speech`, `feedback`, `recommendation` or `review`. See [statements](/docs/concepts/statements).
  - `summary` (string) A one-line summary.
  - `text` (string | null) The verbatim passage, where the article's licence allows it.
  - `start` (integer) Start offset into the article content, in UTF-16 code units.
  - `end` (integer) End offset, in UTF-16 code units.
  - `speaker` (object) `{ kind, name, role, organisation_name, profile_reference }`. `kind` is `person` or `body`.
  - `subject` (object) `{ name, role, organisation_name, profile_reference }`.
- `events` (array) `{ reference, type }`.
- `organisations` (array) `{ reference, name }`.

## Examples

cURL:

```bash
curl -sS "https://api.chikaraintel.com/v1/articles/8e1f2a3b-c5d6-4e7f-8a9b-c0d1e2f3a4e1" \
  -H "Authorization: Bearer $CHIKARA_API_TOKEN" \
  -H "Accept: application/json"
```

JavaScript:

```javascript
const BASE = "https://api.chikaraintel.com";
const headers = {
  Authorization: `Bearer ${process.env.CHIKARA_API_TOKEN}`,
  Accept: "application/json"
};

const res = await fetch(`${BASE}/v1/articles/8e1f2a3b-c5d6-4e7f-8a9b-c0d1e2f3a4e1`, { headers });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);

const { success } = await res.json();
console.log(success);
```

Python:

```python
import os
import requests

BASE = "https://api.chikaraintel.com"
HEADERS = {
    "Authorization": f"Bearer {os.environ['CHIKARA_API_TOKEN']}",
    "Accept": "application/json",
}

res = requests.get(
    f"{BASE}/v1/articles/8e1f2a3b-c5d6-4e7f-8a9b-c0d1e2f3a4e1",
    headers=HEADERS,
    timeout=30,
)
res.raise_for_status()
print(res.json()["success"])
```

Response:

```json
{
  "status": {
    "code": 200,
    "messages": []
  },
  "success": {
    "reference": "8e1f2a3b-c5d6-4e7f-8a9b-c0d1e2f3a4e1",
    "title": "Appointment of Chief Financial Officer",
    "url": "https://www.example.com/halberd/2026/cfo-appointment",
    "published_at": "2026-08-04T07:00:00+00:00",
    "offsets_unit": "utf16",
    "annotations": [],
    "events": [
      {
        "reference": "e5f6a7b8-c9d0-4e1f-8a3b-c4d5e6f7a881",
        "type": "move"
      }
    ],
    "organisations": [
      {
        "reference": "3f2a9c1e-7b4d-4e8a-9c21-5d6e7f8a9b01",
        "name": "Halberd Industrial Group"
      }
    ]
  },
  "correlation_id": "5f0c2a9e4b7d4c1e"
}
```