---
title: "List messages in a Microsoft Teams chat as the calling member"
method: GET
path: "/v1/capabilities/microsoft-365/teams-chats/{chatId}/messages"
tags: ["Capability Sources"]
---

# List messages in a Microsoft Teams chat as the calling member

`GET /v1/capabilities/microsoft-365/teams-chats/{chatId}/messages`

Reads recent messages from one Teams chat using delegated Chat.Read permission.

## Path parameters

- `chatId` string, required

## Query parameters

- `maxResults` integer

## Response `200`

Teams chat messages returned.

- Microsoft365TeamsMessagesResponse
  - `ok` true, required
  - `messages` Microsoft365TeamsMessage[], required
    - `id` string, required
    - `createdDateTime` string, required
    - `content` string, required
    - `from` Microsoft365EmailAddress, required
      - `name` string, required
      - `address` string, required
    - `webUrl` string, required

## Other responses

- `401` — The caller must be signed in.
- `409` — The calling member has not connected their Microsoft account or is missing permission.
- `502` — Microsoft Graph rejected the request.

---

[API](https://skmtc.net/openworklabs/apis/den-api.md) · [All operations](https://skmtc.net/openworklabs/apis/den-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openworklabs/den-api/versions/55ba7d5c7a7b/schema)