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

# Available Campaigns

<Columns cols={2}>
  <Column>
    ### Returns a list of campaigns currently available per creator.

    #### Required Scopes: `campaigns:read`

    <ResponseField name="ok" type="boolean">
      true on success
    </ResponseField>

    <ResponseField name="creatorId" type="string (uuid)">
      Echoed back
    </ResponseField>

    <ResponseField name="campaigns" type="string array">
      <Accordion title="child attributes" defaultOpen iconType="regular">
        <ResponseField name="id" type="string (uuid)">
          Use for details / activate / analytics
        </ResponseField>

        <ResponseField name="brand.imageUrl" type="string (url)">
          Brand logo
        </ResponseField>

        <ResponseField name="status" type="string">
          `AVAILABLE`, `ACTIVATED`, or `ENDED` (creator's status for this campaign)
        </ResponseField>

        <ResponseField name="startsAt" type="string (date)">
          `YYYY-MM-DD`
        </ResponseField>

        <ResponseField name="endsAt" type="string (date) | null">
          `null` = open-ended
        </ResponseField>

        <ResponseField name="imageUrl" type="string (url)">
          Campaign hero image
        </ResponseField>

        <ResponseField name="offerCount" type="number">
          Total offers across all offer groups
        </ResponseField>

        <ResponseField name="locationCount" type="number">
          Distinct participating locations
        </ResponseField>
      </Accordion>
    </ResponseField>

    <ResponseField name="total" type="number">
      Count of returned campaigns
    </ResponseField>
  </Column>

  <Column>
    ```shellscript bash wrap theme={null}
    curl -sS https://api.storytime.io/v1/creators/<creatorId>/campaigns \
      -H "Authorization: Bearer pk_live_xxxxxxxxxxxxxxxxxxxxxxxx"
    ```

    ```json 200 theme={null}
    {
      "ok": true,
      "creatorId": "7d4e2a10-0000-4000-8000-000000000101",
      "campaigns": [
        {
          "id": "0b1f3d3e-4c1a-4a5e-9b6a-000000000001",
          "name": "Summer Tasting Menu",
          "brand": {
            "id": "a9c8b7d6-0000-4000-8000-000000000201",
            "name": "Marlow & Vine",
            "imageUrl": "https://cdn.storytime.io/uploads/demo-brand-marlow.jpg"
          },
          "status": "AVAILABLE",
          "startsAt": "2026-07-01",
          "endsAt": "2026-07-31",
          "imageUrl": "https://cdn.storytime.io/uploads/demo-summer-tasting.jpg",
          "offerCount": 1,
          "locationCount": 1
        }
      ],
      "total": 1
    }
    ```
  </Column>
</Columns>