# Twilio Retrieval API

**Canonical:** https://apis.io/apis/twilio/twilio-retrieval-api/  
**Provider:** Twilio — https://apis.io/providers/twilio/  
**Base URL:** https://messaging.twilio.com  
**Documentation:** https://www.twilio.com/docs/iam/api/account

Twilio Retrieval API is one of 153 APIs that [Twilio](https://apis.io/providers/twilio/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification. Tagged areas include Retrieval. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, pricing, and an AsyncAPI specification.

The Retrieval APIs resolve profiles and return relevant memory at the moment an agent needs them. Profile lookup is leveraged by the Conversation Orchestrator. When an inbound message arrives on a configured channel, Twilio resolves the sender's identity and either attaches the conversation to an existing profile or creates a new one if no match is found. The Lookup Profiles endpoint also supports direct lookup by identifier, applying the store's identity resolution rules and normalized values. For memory retrieval, the Recall endpoint uses hybrid semantic and lexical search to return only the most relevant observations and summaries, minimizing token usage by avoiding transmission of the full profile history into the prompt. When a `conversationId` is provided without a query, Twilio derives a query from the conversation context and applies it to search the profile store.

## Operations (2)

| Method | Path | Summary |
|---|---|---|
| POST | `/v1/Stores/{storeId}/Profiles/Lookup` | Lookup Profiles |
| POST | `/v1/Stores/{storeId}/Profiles/{profileId}/Recall` | Retrieve Memories |

## Machine-readable artifacts (36)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/twilio/refs/heads/main/openapi/twilio-retrieval-api-openapi.yml
- **Documentation** — https://www.twilio.com/docs/iam/api/account
- **Documentation** — https://www.twilio.com/en-us/blog/insights/ai/what-is-intelligent-virtual-assistant
- **Documentation** — https://www.twilio.com/docs
- **Documentation** — https://www.twilio.com/docs/conversations
- **Pricing** — https://www.twilio.com/en-us/messaging/pricing/conversations-api
- **AsyncAPI** — https://raw.githubusercontent.com/api-evangelist/twilio/refs/heads/main/asyncapi/twilio-asyncapi.yml
- **Documentation** — https://www.twilio.com/docs/marketplace
- **Documentation** — https://www.twilio.com/en-us/messaging
- **Pricing** — https://www.twilio.com/en-us/sms/pricing/us
- **Documentation** — https://www.twilio.com/en-us/user-authentication-identity/verify
- **Pricing** — https://www.twilio.com/en-us/verify/pricing
- **Documentation** — https://www.twilio.com/docs/video
- **Pricing** — https://www.twilio.com/en-us/video/pricing
- **Documentation** — https://www.twilio.com/en-us/voice
- **Pricing** — https://www.twilio.com/en-us/voice/pricing/us
- **Documentation** — https://www.twilio.com/docs/lookup
- **Pricing** — https://www.twilio.com/en-us/user-authentication-identity/pricing/lookup
- **Documentation** — https://www.twilio.com/docs/flex
- **Pricing** — https://www.twilio.com/en-us/flex/pricing
- **Documentation** — https://www.twilio.com/docs/sendgrid
- **Pricing** — https://www.twilio.com/en-us/products/email-api/pricing
- **Documentation** — https://www.twilio.com/docs/iam/scim/api-reference
- **Documentation** — https://www.twilio.com/docs/iam/oauth-apps/account-oauth-apps
- **Documentation** — https://www.twilio.com/docs/iam/oauth-apps/oauth-access-token
- **Documentation** — https://www.twilio.com/docs/iam/oauth-apps/overview
- **Documentation** — https://www.twilio.com/docs/conversations/memory/api-quickstart
- **Documentation** — https://www.twilio.com/docs/conversations/knowledge
- **Documentation** — https://www.twilio.com/docs/conversational-intelligence
- **Documentation** — https://www.twilio.com/docs/voice
- **Documentation** — https://www.twilio.com/docs/voice/voice-insights
- **Documentation** — https://www.twilio.com/docs/global-infrastructure
- **Documentation** — https://www.twilio.com/docs/messaging
- **Documentation** — https://www.twilio.com/docs/phone-numbers
- **Documentation** — https://www.twilio.com/docs/content
- **Documentation** — https://www.twilio.com/docs/chat

## Other Twilio APIs (12)

- [Twilio A2p API](https://apis.io/apis/twilio/twilio-a2p-api/)
- [Twilio Access Tokens API](https://apis.io/apis/twilio/twilio-access-tokens-api/)
- [Twilio Accounts API](https://apis.io/apis/twilio/twilio-accounts-api/)
- [Twilio Alerts API](https://apis.io/apis/twilio/twilio-alerts-api/)
- [Twilio Alpha Senders API](https://apis.io/apis/twilio/twilio-alpha-senders-api/)
- [Twilio Apps API](https://apis.io/apis/twilio/twilio-apps-api/)
- [Twilio Archives API](https://apis.io/apis/twilio/twilio-archives-api/)
- [Twilio Assistants API](https://apis.io/apis/twilio/twilio-assistants-api/)
- [Twilio Attempts API](https://apis.io/apis/twilio/twilio-attempts-api/)
- [Twilio Auth Tokens API](https://apis.io/apis/twilio/twilio-auth-tokens-api/)
- [Twilio ByocTrunks API](https://apis.io/apis/twilio/twilio-byoctrunks-api/)
- [Twilio Calls API](https://apis.io/apis/twilio/twilio-calls-api/)

## Tags

Retrieval

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/twilio/twilio-retrieval-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/twilio/.