---
title: "How long the brand's ads stay live: the Kaplan-Meier median lifetime of every ad seen launching (stops observed, live ads censored), the share stopped within 7 days and still live at 30, and a log-rank test against its category; with the survival curves of its category, its level-3 type and each format (whole days to 90, with 95% bands). Observed lifetimes, not performance. Rebuilt nightly."
method: GET
path: "/v1/brands/{brandId}/survival"
tags: ["brands"]
---

# How long the brand's ads stay live: the Kaplan-Meier median lifetime of every ad seen launching (stops observed, live ads censored), the share stopped within 7 days and still live at 30, and a log-rank test against its category; with the survival curves of its category, its level-3 type and each format (whole days to 90, with 95% bands). Observed lifetimes, not performance. Rebuilt nightly.

`GET /v1/brands/{brandId}/survival`

## Request

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

How long the brand's ads stay live: the Kaplan-Meier median lifetime of every ad seen launching (stops observed, live ads censored), the share stopped within 7 days and still live at 30, and a log-rank test against its category; with the survival curves of its category, its level-3 type and each format (whole days to 90, with 95% bands). Observed lifetimes, not performance. Rebuilt nightly. Scope `brands:read`; cache `daily`.

## Path parameters

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

## Response `200`

Success.

- object
  - `data` object, required
    - `as_of` string, date, nullable, required
    - `brand` object, nullable, required
      - `median_days` number, nullable, required
      - `median_reached` boolean, required
      - `ads` integer, required
      - `stopped` integer, required
      - `censored` integer, required
      - `kill7` number, nullable, required
      - `s30` number, nullable, required
      - `cohort_ads` integer, required
      - `logrank_vs_category_p` number, nullable, required
    - `benchmarks` object[], required
      - `scope` 'category' | 'subcategory' | 'format' | 'category_format', required
      - `scope_id` string, required
      - `median_days` number, nullable, required
      - `median_reached` boolean, required
      - `ads` integer, required
      - `stopped` integer, required
      - `censored_share` number, required
      - `curve` object[], required
        - `t` number, required
        - `s` number, required
        - `ci_lo` number, required
        - `ci_hi` number, required
        - `n_at_risk` 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/c556e643d689?raw)