---
title: "List Observations"
method: GET
path: "/v1/Stores/{storeId}/Profiles/{profileId}/Observations"
tags: ["Observations"]
---

# List Observations

`GET /v1/Stores/{storeId}/Profiles/{profileId}/Observations`

## Request

- Base URL: `https://memory.twilio.com`
- URL: `https://memory.twilio.com/v1/Stores/{storeId}/Profiles/{profileId}/Observations`
- Auth: HTTP basic

Retrieve a paginated list of transient observations for a specific profile. Observations are sorted by creation time in descending order by default. Results can be filtered by source parameter. Supports response compression for large datasets.

## Query parameters

- `pageSize` integer
- `pageToken` string
- `orderBy` 'ASC' | 'DESC'
- `source` string
- `createdAfter` string, date-time
- `createdBefore` string, date-time
- `conversationId` string: A unique identifier for the conversation using Twilio Type ID (TTID) format.

## Headers

- `Accept-Encoding` string

## Response `200`

A list of observations for the profile.

- object
  - `observations` ObservationInfo[]
    - `content` string: The main content of the observation.
    - `occurredAt` string, date-time: The timestamp when the observation originally occurred.
    - `source` string: The source system that generated this observation. Allows letters, numbers, spaces, periods, underscores, hyphens, and forward slashes.
    - `conversationIds` ConversationID[]: Array of conversation IDs associated with this observation.
    - `id` string, required: A unique identifier for the observation using Twilio Type ID (TTID) format.
    - `createdAt` string, date-time, required: The timestamp when the observation was created.
    - `updatedAt` string, date-time, required: The timestamp when the observation was last updated.
  - `meta` ObservationsMeta
    - `key` string: The key of the list property contains the actual data items. This enables programmatic iteration over paginated results.
    - `pageSize` integer
    - `nextToken` string
    - `previousToken` string

## Other responses

- `301`: This resource has moved.
- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `429`: This error indicates that you have sent too many requests to the API. You should retry according to the `Retry-After` response header.
- `500`: Internal Server Error
- `503`: Service Unavailable

## Changes

> 12 revisions in range; 1 not diffed.

- **2026-10-06** (v1) `8f92a002d9f1`: 1 warning, 1 info
  - changed the pattern of the `query` request parameter `source` from `^[a-zA-Z0-9 _.-]+$` to `^[a-zA-Z0-9 _./-]+$`
  - the `observations/items/source` response's property pattern was changed from `^[a-zA-Z0-9 _.-]+$` to `^[a-zA-Z0-9 _./-]+$` for the status `200`
- **2026-08-11** (v1) `b0ed05460bbf`: 10 breaking, 2 info
  - the response property `observations/items/content` became optional for the status `200`
  - the response property `observations/items/occurredAt` became optional for the status `200`
  - the response property `observations/items/source` became optional for the status `200`
  - the `code` response property's max was increased from `99999.00` to `999999.00` for the response status `400`
  - …8 more

[Operation history](https://skmtc.dev/twilio/apis/memory-v1/changes/v1/Stores/:storeId/Profiles/:profileId/Observations/get.md)

---

[API](https://skmtc.dev/twilio/apis/memory-v1.md) - [All operations](https://skmtc.dev/twilio/apis/memory-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/twilio/apis/memory-v1/revisions/1c9618b83dfd?raw)