---
title: "Get a Specific Custom List Version"
method: GET
path: "/custom-lists/{customListToken}/versions/{version}"
tags: ["Custom Lists"]
---

# Get a Specific Custom List Version

`GET /custom-lists/{customListToken}/versions/{version}`

Return the data and metadata for a specific version of a custom list

## Response `200`

Custom List Version Data

- object
  - `custom_list_token` string
  - `name` string
  - `description` string
  - `created_at` string, date-time
  - `active_version` string
  - `version` 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
    - `data` object[]

## Other responses

- `400` — Bad request - Invalid Custom List Token or Version
- `403` — Forbidden - Insufficient Permissions
- `404` — Custom List or Version 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)