---
title: List Briefs
api: GET /brands/{brand_id}/briefs
description: "List all generated content briefs for a brand."
---

> **For AI agents:** the complete documentation index is at [llms.txt](https://docs.boringmarketing.com/llms.txt). Append `.md` to any page URL for its markdown version.

Returns all content briefs generated for a brand.

## Path parameters

<ParamField path="brand_id" type="string" required>
  The brand UUID.
</ParamField>

## Response

```json
{
  "brand_id": "brand-uuid",
  "total": 3,
  "briefs": [
    {
      "id": "brief-uuid",
      "queue_item_id": "qi-uuid-1",
      "format": "comparison",
      "content": {
        "strategy": "Position as the definitive comparison guide for AI marketing tools",
        "pages": [
          {
            "title": "Best AI Marketing Tools in 2026: Complete Comparison",
            "slug": "best-ai-marketing-tools",
            "target_keywords": ["ai marketing tools", "best ai marketing software"],
            "sections": [
              {
                "heading": "What Makes a Great AI Marketing Tool",
                "guidance": "Define evaluation criteria...",
                "estimated_words": 400
              }
            ]
          }
        ],
        "internal_links": [
          { "anchor": "content automation", "target": "/guides/content-automation" }
        ],
        "key_entities": ["HubSpot", "Jasper", "Semrush"],
        "competitive_angle": "Focus on closed-loop measurement — competitors show dashboards, we show outcomes"
      },
      "created_at": "2026-04-07T10:30:00Z"
    }
  ]
}
```

<Note>
The `content` shape mirrors whatever the current brief generator emits — it is **not a stable API contract**. The example above shows the typical fields (`strategy`, `pages[]`, `internal_links`, `key_entities`, `competitive_angle`) but new keys may appear or be reshaped between deployments. Tolerate unknown keys when consuming briefs.
</Note>

## Example

```bash
curl -H "X-API-Key: $BM_API_KEY" \
  https://api.boringmarketing.com/brands/$BRAND_ID/briefs
```