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

# Retrieve prompt

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

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/marketing/aeo/2027-03-beta/prompts/{promptId}`
- 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, including its visibility settings, using the prompt's unique identifier. This endpoint is useful for obtaining insights into a prompt's configuration and its associated data within the specified date range.

## Path parameters

- `promptId` string, required

## Query parameters

- `endDate` string
- `startDate` string

## Response `200`

successful operation

- PublicPromptWithVisibility
  - `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 prompt.
  - `language` string: The language in which the prompt is written.
  - `productIds` string[], required
  - `prompt` string, required: The text of the prompt.
  - `visibility` string: An object representing the visibility settings 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`: 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`: 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 `groupIds` to the response with the `200` status
  - added the required property `icpIds` to the response with the `200` status
  - …1 more
- **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/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)