---
title: "List prompts"
method: GET
path: "/marketing/aeo/2027-03-beta/prompts"
tags: ["Basic"]
---

# List prompts

`GET /marketing/aeo/2027-03-beta/prompts`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/marketing/aeo/2027-03-beta/prompts`
- 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 prompts from the AnswerEngineVisibilityPublicApi. This endpoint allows you to filter and sort prompts based on various criteria, such as creation date and business unit. Use this endpoint to manage and view prompts efficiently.

## Query parameters

- `after` string
- `businessUnitId` string
- `createdAfter` string
- `createdAt` string
- `createdBefore` string
- `groupFilterMode` string
- `groupId` string[]
- `language` string[]
- `limit` integer
- `productId` string[]
- `sort` string

## Response `200`

successful operation

- CollectionResponsePublicPromptForwardPaging
  - `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` PublicPrompt[], required: An array of PublicPrompt objects, representing the individual prompts in the collection.
    - `aiAssistants` string[], required: An array of AI assistants associated with the prompt.
    - `businessUnitId` string, required: The identifier for the business unit associated with the prompt.
    - `buyingJourneyPhase` string: The phase of the buying journey that the prompt is associated with.
    - `createdAt` string, date-time, required: The date and time when the prompt was created, in ISO 8601 format.
    - `groupIds` string[], required
    - `icpIds` string[], required
    - `id` string, required: The unique identifier for the public prompt.
    - `language` string: The language in which the prompt is written.
    - `productIds` string[], required
    - `prompt` string, required: The text content of the prompt.

## 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`: 3 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`
  - added the new optional `query` request parameter `language`
- **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`: 5 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`
  - added the required property `results/items/groupIds` to the response with the `200` status
  - added the required property `results/items/icpIds` to the response with the `200` status
  - …1 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/hubspot/apis/marketing-aeo/changes/marketing/aeo/2027-03-beta/prompts/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)