---
title: "A brand's creative tests: the ads it launched on the same day (Meta's start date), cohort by cohort, newest first, with how many are still active, stopped or unverified and which ads survived (still active 7 days or more after launch while a sibling stopped). Observed survival, not performance or spend. Answers 409 until the view's first nightly build."
method: GET
path: "/v1/brands/{brandId}/creative-tests"
tags: ["brands"]
---

# A brand's creative tests: the ads it launched on the same day (Meta's start date), cohort by cohort, newest first, with how many are still active, stopped or unverified and which ads survived (still active 7 days or more after launch while a sibling stopped). Observed survival, not performance or spend. Answers 409 until the view's first nightly build.

`GET /v1/brands/{brandId}/creative-tests`

## Request

- Base URL: `https://api.storequant.com`
- URL: `https://api.storequant.com/v1/brands/{brandId}/creative-tests`
- Auth: HTTP bearer

A brand's creative tests: the ads it launched on the same day (Meta's start date), cohort by cohort, newest first, with how many are still active, stopped or unverified and which ads survived (still active 7 days or more after launch while a sibling stopped). Observed survival, not performance or spend. Answers 409 until the view's first nightly build. Scope `brands:read`; cache `daily`.

## Path parameters

- `brandId` union, required
  - string, uuid
  - string

## Query parameters

- `days` integer
- `limit` integer
- `ads_per_cohort` integer

## Response `200`

Success.

- object
  - `data` object, required
    - `as_of` string, date, required
    - `basis` 'observed survival, not performance or spend', required: A note for readers. What each number is (observed, derived or estimate) is in the op's claims: `x-claims` in the OpenAPI document.
    - `days` integer, required
    - `cohorts` object[], required
      - `launch_date` string, date, required
      - `ads_launched` integer, required
      - `active` integer, required
      - `stopped` integer, required
      - `unverified` integer, required
      - `survivors` integer, required
      - `ads` object[], required
        - `id` string, required
        - `url` string, uri, required
        - `page_id` string, required
        - `days_live` integer, required
        - `status` 'active' | 'stopped' | 'unverified', required
        - `status_certainty` 'sighted' | 'meta_stop' | 'walk_stop' | 'unverified', required
        - `stop_date` string, date, nullable, required
        - `first_seen` string, date, required
        - `last_seen` string, date, required
        - `is_survivor` boolean, required
        - `is_last_standing` boolean, required
        - `display_format` string, required
        - `copy_key` string, required
        - `creative_key` string, nullable, required
        - `concept_id` string, nullable, required
      - `ads_omitted` integer, required
  - `meta` object, required
    - `request_id` string, required
    - `as_of` string, date-time, required
    - `lag_hours` number
    - `cursor` string
    - `count` integer

## Other responses

- `4XX`: The one error shape.
- `5XX`: The one error shape.

---

[API](https://skmtc.dev/scrollstash/apis/storequant-api.md) · [All operations](https://skmtc.dev/scrollstash/apis/storequant-api/llms.txt) · [OpenAPI document](https://skmtc.dev/scrollstash/apis/storequant-api/revisions/4d67a114a13c?raw)