# GET `/api/v1/articles/{idOrSlug}`

> Part of the `Buuk Public API` API reference.

**Get one article**

Returns the full article as Markdown, addressed by id or slug. Scope: help_center:read (any token role; viewer tokens only see published articles).

Base URL: `https://app.getbuuk.com`

## Authentication

Authentication:
  - `apiToken` — HTTP BEARER

## Parameters

- `idOrSlug` — string (path, required) — Article UUID or slug.
- `Buuk-Version` — string (header, optional) — API version to use. Omit for the current version (1). Unsupported values return 400 unsupported_api_version.

## Responses

### 200 — The article.

- `article` — object
- `id` — string·uuid
- `url` — string
- `kind` — string — enum: "help" | "guide" | "faq"
- `slug` — string
- `title` — string
- `status` — string — enum: "draft" | "published" | "archived"
- `updatedAt` — string·date-time
- `visibility` — string
- `publishedAt` — string·date-time
- `contentMarkdown` — string — Full article body as Markdown.

### 401 — Missing or invalid token.

- `error` — string — required — Stable machine-readable error code, e.g. unauthorized, forbidden, invalid_request, not_found, rate_limited.
- `details` — object — Field-level validation failures, present only for invalid_request.
- `message` — string — Human-readable problem description.

### 403 — Token lacks help_center:read.

- `error` — string — required — Stable machine-readable error code, e.g. unauthorized, forbidden, invalid_request, not_found, rate_limited.
- `details` — object — Field-level validation failures, present only for invalid_request.
- `message` — string — Human-readable problem description.

### 404 — No article matches that id or slug.

- `error` — string — required — Stable machine-readable error code, e.g. unauthorized, forbidden, invalid_request, not_found, rate_limited.
- `details` — object — Field-level validation failures, present only for invalid_request.
- `message` — string — Human-readable problem description.

### 429 — Rate limit exceeded. Retry-After header carries the wait in seconds.

- `error` — string — required — Stable machine-readable error code, e.g. unauthorized, forbidden, invalid_request, not_found, rate_limited.
- `details` — object — Field-level validation failures, present only for invalid_request.
- `message` — string — Human-readable problem description.

---

View in browser: /help/buuk/reference/c295cb4f-b4da-45c8-a58f-cfdecfddc7b0
Generated from the `Buuk Public API` reference for `buuk`.