---
title: "List prompt runs"
method: GET
path: "/marketing/aeo/2027-03-beta/prompts/{promptId}/runs"
tags: ["Basic"]
---

# List prompt runs

`GET /marketing/aeo/2027-03-beta/prompts/{promptId}/runs`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/marketing/aeo/2027-03-beta/prompts/{promptId}/runs`
- 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 a list of runs for a specific prompt in the Answer Engine Visibility API. This endpoint allows you to filter runs based on creation dates and paginate through results. Useful for tracking the execution history of a specific prompt.

## Path parameters

- `promptId` string, required

## Query parameters

- `after` string
- `createdAfter` string
- `createdAt` string
- `createdBefore` string
- `limit` integer

## Response `200`

successful operation

- CollectionResponsePublicPromptRunForwardPaging
  - `paging` ForwardPaging: Paging information for forward-only pagination. Contains the next page reference when more results are available; omitted or empty on the last page.
    - `next` NextPage: Specifies the paging information needed to retrieve the next set of results in a paginated API response
      - `after` string, required: A string token used as a cursor to retrieve the next set of results in a paginated response.
      - `link` string: A URL string pointing to the next page of results in the paginated response.
  - `results` PublicPromptRun[], required: An array of public prompt run objects. Each object contains details about a specific prompt run.
    - `aiModel` string, required: The AI model used for this prompt run.
    - `competitorMentions` integer, required: The number of mentions related to competitors during this prompt run.
    - `completedAt` string, date-time: The date and time when this 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 user during this prompt run.
    - `promptId` string, required: The unique identifier of the prompt associated with this run.
    - `state` string, required: The current state of the prompt run.
    - `totalCitations` integer, required: The total number of citations generated during 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/prompts/:promptId/runs/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)