---
title: "Read one owned creative by id."
method: GET
path: "/v1/agent/creatives/{id}"
---

# Read one owned creative by id.

`GET /v1/agent/creatives/{id}`

## Request

- Base URL: `https://api.nowyourlink.com`
- URL: `https://api.nowyourlink.com/v1/agent/creatives/{id}`
- Auth: OAuth 2 (authorization code, authorization URL `https://api.nowyourlink.com/oauth/authorize`, token URL `https://api.nowyourlink.com/oauth/token`, scopes: `creatives:read`)

Read one owned creative by id.

## Path parameters

- `id` string, required

## Response `200`

The creative.

- object
  - `ad` object, required
    - `id` string, required
    - `state` 'draft' | 'pending' | 'approved' | 'rejected' | 'revoked', required
    - `headline` string, nullable, required
    - `body` string, nullable
    - `target_url` string, uri, nullable
    - `display_url` string, nullable
    - `cta_label` string, nullable
    - `asset_id` string, nullable
    - `asset_kind` string, nullable
    - `asset_transcode_state` string, nullable
    - `alt_text` string, nullable
    - `auto_filter_verdict` string, nullable
    - `auto_filter_score` number, nullable
    - `submitted_at` string, date-time, nullable
    - `decided_at` string, date-time, nullable
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `latest_decision` object, nullable
      - `to_state` string, required
      - `reason_code` string, nullable, required
      - `created_at` string, date-time, required

## Other responses

- `401`: The bearer token is missing, expired or invalid. A missing Authorization header returns an empty body.
- `403`: This grant lacks the scope the operation requires.
- `404`: No such creative in your library (ads.not-found).
- `405`: The path exists but does not accept this method (agent.method-not-allowed).
- `429`: This grant's 120-per-minute token bucket is empty. Wait Retry-After seconds before retrying.

---

[API](https://skmtc.dev/nowyourlink/apis/nowyourlink-public-spotlight-api.md) · [All operations](https://skmtc.dev/nowyourlink/apis/nowyourlink-public-spotlight-api/llms.txt) · [OpenAPI document](https://skmtc.dev/nowyourlink/apis/nowyourlink-public-spotlight-api/revisions/cd8408529b48?raw)