---
title: "List Prompt Payloads"
method: GET
path: "/v1/prompts/{id}/payloads"
tags: ["Prompt Payloads"]
---

# List Prompt Payloads

`GET /v1/prompts/{id}/payloads`

Lists all sample payloads associated with the specified prompt.

## Path parameters

- `id` string, uuid, required

## Response `200`

List of prompt payloads

- object
  - `payloads` PromptPayload[], required
    - `id` string, uuid, required — Unique payload identifier.
    - `prompt_id` string, uuid, required — Reference to parent Prompt ID.
    - `name` string, nullable — Optional name for this sample payload.
    - `variables` object, required — Standard JSON object containing variable names and sample values.
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required

## Other responses

- `401` — Unauthorized
- `404` — Prompt not found

---

[API](https://skmtc.net/px0-ai/apis/px0-api.md) · [All operations](https://skmtc.net/px0-ai/apis/px0-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/px0-ai/px0-api/versions/3ed72443989d/schema)