# GET /api/v1/support/articles

> Search the help centre, or read one article

- Group: support
- Tier: R
- Required scope: read:support
- Docs: https://api.inleed.com/reference/support/list-support-articles

## Description

With no `articleId`: returns `{data:[{id, title, slug, keyword, category, url}], has_more, next_cursor, total}`, filtered by `search`. With an `articleId`: returns that one article plus its `body`.

## Query parameters

- `article_id` — integer. An article id from data[].id to fetch that one article with its full body. Omit to search/list instead.
- `search` — string. A search term matched against article titles and keywords, e.g. email, ssl, dns.
- `locale` — string. Restrict to one locale, e.g. sv or en.
- `limit` — integer. Page size for a collection. Range 1–100.
- `cursor` — integer. Opaque pagination cursor. Pass back the previous response’s nextCursor; stop when it is null. Minimum 0.

## Request

```bash
curl -X GET "https://mcp.inleed.com/api/v1/support/articles?article_id=1&search=example.se&locale=example.se&limit=3&cursor=1" \
  -H "Authorization: Bearer inl_live_…"
```

## Errors

- **400**  — codes: invalid_request
- **401** No token was presented, or the token is revoked, expired or unknown. — codes: unauthorized, token_expired, token_revoked
- **403** The token lacks a required scope, or this account does not own the resource. — codes: insufficient_scope, not_owned
- **404** No such resource for this account. — codes: not_found
- **422** Validation error — codes: validation_failed
- **429** The rate limit for this token is exhausted. See `Retry-After`. — codes: rate_limited
- **500** Something went wrong on our side. The failure is logged against `requestId`. — codes: internal_error

## Related

- GET /api/v1/support/articles/{article} — https://api.inleed.com/reference/support/list-support-articles-2