---
title: "Get Custom List Versions"
method: GET
path: "/custom-lists/{customListToken}"
tags: ["Custom Lists"]
---

# Get Custom List Versions

`GET /custom-lists/{customListToken}`

Return all versions of the specified custom list

## Response `200`

Custom list versions

- object
  - `custom_list_token` string
  - `name` string
  - `description` string
  - `created_at` string, date-time
  - `active_version` string
  - `last_updated_major_at` string, date-time
  - `last_updated_major_by` string
  - `last_updated_minor_at` string, date-time
  - `last_updated_minor_by` string
  - `versions` object[]
    - `version` string
    - `major_version` integer
    - `minor_version` integer
    - `changelog` string, nullable
    - `created_at` string, date-time
    - `created_by` string
    - `notes` string, nullable
    - `total_entries` integer
    - `columns` object[]
      - `name` string
      - `contains_pii` boolean
      - `sort_order` integer, nullable
  - `workflows` object[]
    - `workflow_name` string
    - `workflow_version` integer
    - `workflow_token` string
    - `list_versions` string[]

## Other responses

- `400` — Bad request - Invalid Custom List Token
- `403` — Forbidden - Insufficient Permissions
- `404` — Custom List Not Found

---

[API](https://skmtc.dev/alloy/apis/alloy-api.md) · [All operations](https://skmtc.dev/alloy/apis/alloy-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/alloy/alloy-api/revisions/405799de4d2a/schema)