---
title: "List previously generated clearance codes"
method: GET
path: "/api/v1/content_id/codes"
tags: ["Content ID"]
---

# List previously generated clearance codes

`GET /api/v1/content_id/codes`

## Query parameters

- `page` integer
- `per_page` integer

## Headers

- `Authorization` string, required

## Response `200`

Clearance codes, newest first

- object
  - `data` ContentIdCode[]
    - `id` string — The clearance code.
    - `type` string
    - `attributes` object
      - `code` string
      - `status` 'active' | 'inactive' | 'expired' | 'quota_reached' — License status. quota_reached means the single-use code has been consumed.
      - `start_date` string, date
      - `expiration_date` string, date — Inclusive: the last day whose uploads are covered.
      - `label` string, nullable — Your note attached at generation time. Local to Melodie.
      - `video_id` string, nullable — The YouTube video Orfium detected using this code (set after the uploaded video is scanned). Read-only.
  - `meta` object
    - `obj_count` integer — Total count of codes
    - `page_count` integer — Total count of pages

## Other responses

- `403` — Missing or invalid API token

---

[API](https://skmtc.net/melod/apis/melodie-api.md) · [All operations](https://skmtc.net/melod/apis/melodie-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/melod/melodie-api/revisions/06cd6e66c531/schema)