---
title: "Gets stored completion messages by the given stored completion id."
method: GET
path: "/chat/completions/{stored-completion-id}/messages"
tags: ["StoredCompletion:"]
---

# Gets stored completion messages by the given stored completion id.

`GET /chat/completions/{stored-completion-id}/messages`

## Path parameters

- `stored-completion-id` string, required

## Query parameters

- `after` string
- `limit` integer
- `order` string
- `api-version` string, required

## Response `200`

Success

- StoredCompletionMessages
  - `object` string — The object type, which is always `list`
  - `data` InputMessage[] — The list of retrieved objects.
    - `id` string — The identity of message.
    - `role` string — The role of the entity that is creating the message.
    - `content` string — The contents of the message.
    - `name` string — An optional name for the participant. Provides the model information to differentiate between participants of the same role.
  - `total` integer — Total number of items.
  - `first_id` string — The first id in the retrieved `list`
  - `last_id` string — The last id in the retrieved `list`
  - `has_more` boolean — The `has_more` property is used for pagination to indicate there are additional results.

## Other responses

- `default` — An error occurred.

---

[API](https://skmtc.net/azure/apis/cognitiveservices-azureopenai-authoring.md) · [All operations](https://skmtc.net/azure/apis/cognitiveservices-azureopenai-authoring/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/cognitiveservices-azureopenai-authoring/revisions/b177dc430e39/schema)