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

# List Content

> List Content Studio articles for syndication to an external CMS

Content Studio articles are AI-generated, brand-aware pieces of content. This read-only endpoint lists articles so you can pull finished content into an external CMS (for example via an automation workflow). The list returns metadata only — fetch the [article detail](/developers/endpoints/content/get) for the full markdown body.

<Note>
  Defaults to `status=LIVE` so you only get published-ready articles. Pass `status` explicitly to list drafts or archived items.
</Note>

<ParamField header="Authorization" type="string" required>
  Bearer token. Example: `Bearer qw-api-xxx`
</ParamField>

### Path Parameters

<ParamField path="brandId" type="string" required>
  The unique identifier of the brand
</ParamField>

### Query Parameters

<ParamField query="status" type="string" default="LIVE">
  Filter by status: `DRAFT`, `GENERATING`, `LIVE`, `ARCHIVED`
</ParamField>

<ParamField query="articleType" type="string">
  Filter by type: `INFORMATIONAL`, `COMPARISON`, `HOW_TO`, `LISTICLE`, `REVIEW`, `CASE_STUDY`, `NEWS`, `OPINION`, `OTHER`
</ParamField>

<ParamField query="limit" type="number" default="50">
  Maximum number of articles to return (max: 100)
</ParamField>

<ParamField query="offset" type="number" default="0">
  Pagination offset
</ParamField>

<ParamField query="sort" type="string" default="updatedAt">
  Field to sort by: `createdAt`, `updatedAt`, `publishedAt`, `title`, `wordCount`
</ParamField>

<ParamField query="order" type="string" default="desc">
  Sort order: `asc` or `desc`
</ParamField>

### Response

<ResponseField name="success" type="boolean">
  Indicates if the request was successful
</ResponseField>

<ResponseField name="pagination" type="object">
  <Expandable title="Pagination info">
    <ResponseField name="total" type="number">Total number of articles matching filters</ResponseField>
    <ResponseField name="count" type="number">Number of articles in this response</ResponseField>
    <ResponseField name="limit" type="number">Maximum items per page</ResponseField>
    <ResponseField name="offset" type="number">Number of items skipped</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="articles" type="array">
  <Expandable title="Article object">
    <ResponseField name="id" type="string">Article ID (use with the detail endpoint)</ResponseField>
    <ResponseField name="title" type="string">Article title</ResponseField>
    <ResponseField name="slug" type="string">URL slug or `null`</ResponseField>
    <ResponseField name="description" type="string">Short description or `null`</ResponseField>
    <ResponseField name="articleType" type="string">Article type</ResponseField>
    <ResponseField name="status" type="string">`DRAFT`, `GENERATING`, `LIVE` or `ARCHIVED`</ResponseField>
    <ResponseField name="wordCount" type="number">Word count of the generated content</ResponseField>
    <ResponseField name="finalUrl" type="string">Published URL (if set by you) or `null`</ResponseField>
    <ResponseField name="publishedAt" type="string">Publish timestamp (ISO 8601) or `null`</ResponseField>
    <ResponseField name="generatedAt" type="string">Content generation timestamp (ISO 8601) or `null`</ResponseField>
    <ResponseField name="createdAt" type="string">Creation timestamp (ISO 8601)</ResponseField>
    <ResponseField name="updatedAt" type="string">Last update timestamp (ISO 8601)</ResponseField>
  </Expandable>
</ResponseField>

### Example Request

```bash theme={null}
curl -X GET "https://www.qwairy.co/api/v1/brands/cm1234567890abcdef/content?status=LIVE&limit=20" \
  -H "Authorization: Bearer qw-api-your-token-here"
```

### Example Response

```json theme={null}
{
  "success": true,
  "pagination": {
    "total": 12,
    "count": 1,
    "limit": 20,
    "offset": 0
  },
  "articles": [
    {
      "id": "art_abc123",
      "title": "How to choose the right solution in 2026",
      "slug": "how-to-choose-the-right-solution-2026",
      "description": "A practical buyer's guide.",
      "articleType": "HOW_TO",
      "status": "LIVE",
      "wordCount": 1480,
      "finalUrl": "https://mybrand.com/blog/how-to-choose",
      "publishedAt": "2026-05-10T09:00:00.000Z",
      "generatedAt": "2026-05-08T14:22:00.000Z",
      "createdAt": "2026-05-08T13:50:00.000Z",
      "updatedAt": "2026-05-10T09:00:00.000Z"
    }
  ]
}
```