---
title: "Retrieve prompt run"
method: GET
path: "/marketing/aeo/2026-09-beta/prompt-runs/{runUuid}"
tags: ["Basic"]
---

# Retrieve prompt run

`GET /marketing/aeo/2026-09-beta/prompt-runs/{runUuid}`

Retrieve detailed information about a specific prompt run using its unique identifier. This endpoint provides insights into the run's state, associated AI model, citations, and mentions. It is useful for tracking the progress and results of a prompt run within the Answer Engine Visibility system.

## Path parameters

- `runUuid` string, required

## Response `200`

successful operation

- PublicPromptRunDetail
  - `aiModel` string, required — The AI model used for this prompt run.
  - `citations` PublicCitation[], required — An array of citations that provide references or sources related to the prompt run.
    - `title` string, required — The title of the citation. It is a string that provides a brief description or name of the citation source.
    - `url` string, required — The URL of the citation source. It is a string representing the web address where the citation can be found.
  - `competitorMentions` integer, required — The number of mentions related to competitors in the context of this prompt run.
  - `completedAt` string, date-time — The date and time when the prompt run was completed, in ISO 8601 format.
  - `createdAt` string, date-time, required — The date and time when this prompt run was created, in ISO 8601 format.
  - `id` string, required — The unique identifier for this prompt run.
  - `ownedMentions` integer, required — The number of mentions owned by the entity running the prompt.
  - `promptId` string, required — The unique identifier of the prompt associated with this run.
  - `responseText` string — The text response generated by the prompt run.
  - `searchQueries` string[], required — An array of search queries used during the prompt run.
  - `state` string, required — The current state of the prompt run.
  - `totalCitations` integer, required — The total number of citations associated with this prompt run.
  - `updatedAt` string, date-time, required — The date and time when this prompt run was last updated, in ISO 8601 format.

## Other responses

- `default` — An error occurred.

---

[API](https://skmtc.net/hubspot/apis/marketing-aeo.md) · [All operations](https://skmtc.net/hubspot/apis/marketing-aeo/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hubspot/marketing-aeo/revisions/511ca1e59a4c/schema)