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

# Retrieve prompt run

`GET /marketing/aeo/2027-03-beta/prompt-runs/{runUuid}`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/marketing/aeo/2027-03-beta/prompt-runs/{runUuid}`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `marketing.aeo.write`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `marketing.aeo.read`

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.

## Changes

- **2026-10-10** (2027-03-beta) `3e1835f1fe1d`: 2 info
  - the security scope `marketing.aeo.write` was added to the endpoint's security scheme `oauth2`
  - the security scope `marketing.aeo.read` was removed from the endpoint's security scheme `oauth2`
- **2026-10-02** (2027-03-beta) `53bae9def894`: 2 info
  - the security scope `marketing.aeo.write` was added to the endpoint's security scheme `oauth2`
  - the security scope `marketing.aeo.read` was removed from the endpoint's security scheme `oauth2`
- **2026-09-29** (2027-03-beta) `19a567d4b6bd`: 2 info
  - the security scope `marketing.aeo.write` was added to the endpoint's security scheme `oauth2`
  - the security scope `marketing.aeo.read` was removed from the endpoint's security scheme `oauth2`
- **2026-09-18** (2027-03-beta) `619ce091a93a`: 2 info
  - the security scope `marketing.aeo.write` was added to the endpoint's security scheme `oauth2`
  - the security scope `marketing.aeo.read` was removed from the endpoint's security scheme `oauth2`
- **2026-09-16** (2027-03-beta) `265441a89896`: 2 info
  - the security scope `marketing.aeo.write` was added to the endpoint's security scheme `oauth2`
  - the security scope `aeo-standalone-access` was removed from the endpoint's security scheme `oauth2`

[Operation history](https://skmtc.dev/hubspot/apis/marketing-aeo/changes/marketing/aeo/2027-03-beta/prompt-runs/:runUuid/get.md)

---

[API](https://skmtc.dev/hubspot/apis/marketing-aeo.md) - [All operations](https://skmtc.dev/hubspot/apis/marketing-aeo/llms.txt) - [OpenAPI document](https://skmtc.dev/hubspot/apis/marketing-aeo/revisions/3e1835f1fe1d?raw)