> ## Documentation Index > Fetch the complete documentation index at: https://help.withallo.com/llms.txt > Use this file to discover all available pages before exploring further. # Obtenir un élément de conversation > Returns a single call or SMS message by its ID. **Scope requis :** `CONVERSATIONS_READ` ## Format des ID d'éléments * Les ID d'appels commencent par `cll-` (ex. `cll-abc123`) * Les ID de messages commencent par `msg-` (ex. `msg-def456`) Passer un ID avec un préfixe non reconnu renvoie une erreur `400` avec le code `INVALID_ITEM_ID`. ## Notes sur les champs | Champ | Null quand | | --------------- | --------------------------------------------------------------------- | | `summary` | Éléments SMS, ou appels dont le résumé IA n'est pas encore disponible | | `duration` | Éléments SMS (s'applique uniquement aux appels) | | `result` | Éléments SMS (s'applique uniquement aux appels) | | `recording_url` | Enregistrement désactivé, appel sans réponse, ou éléments SMS | | `transcript` | Non demandé via `extend=transcript`, ou éléments SMS | | `content` | Éléments d'appel (s'applique uniquement aux SMS) | | `status` | Éléments d'appel (s'applique uniquement aux SMS) | ### Paramètre extend | Valeur | Effet | | ------------ | ----------------------------------------------- | | `transcript` | Inclure les transcriptions complètes des appels | Passer une valeur non prise en charge renvoie une erreur `400` avec le code `UNSUPPORTED_EXTEND_VALUE`. ## OpenAPI ````yaml GET /v2/api/conversations/items/{id} openapi: 3.0.3 info: title: Allo API description: >- Allo API provides programmatic access to your Allo account, allowing you to manage webhooks, retrieve calls and contacts, and send SMS messages. All requests to `/v1/api/**` endpoints automatically go through quota checking and scope validation. version: 1.0.0 contact: name: Allo Support servers: - url: https://api.withallo.com description: Production server security: [] tags: - name: Summary Templates description: >- Manage call summary templates that control how AI-generated call summaries are structured for your team. - name: Webhooks description: >- Manage webhook endpoints to receive real-time notifications about events in your Allo account. Each endpoint subscribes to one or more event topics and is verified with a signing secret. - name: Calls description: >- Retrieve and search call records with filtering and pagination. Filter calls by your Allo phone number. - name: Contacts description: >- Search and retrieve contact information with sorting and pagination. Includes engagement level tracking. - name: SMS description: Send SMS messages to phone numbers using your Allo numbers. - name: Phone Numbers description: Retrieve information about your Allo phone numbers. - name: Analytics description: Pre-computed call metrics, team performance, and outbound dial funnel - name: CRM description: Manage people, companies, and deals in your CRM. - name: Notes description: >- Internal team notes on conversations and CRM people, with @mention support. Notes are never visible to the contact. - name: Threads description: >- Team discussion threads attached to a conversation item (call, SMS, or conversation note). One thread per item. paths: /v2/api/conversations/items/{id}: get: tags: - Conversations summary: Get conversation item description: Returns a single call or SMS message by its ID. operationId: getConversationItem parameters: - name: id in: path required: true description: Item ID (`cll-*` for calls, `msg-*` for messages) schema: type: string example: cll-abc123 - $ref: '#/components/parameters/Extend' responses: '200': description: Conversation item content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/ConversationItem' '401': $ref: '#/components/responses/ApiUnauthorized' '404': $ref: '#/components/responses/ApiNotFound' '429': $ref: '#/components/responses/ApiRateLimited' security: - ApiKeyAuth: [] components: parameters: Extend: name: extend in: query description: 'Comma-separated optional fields. Supported: `transcript`' schema: type: string example: transcript schemas: ConversationItem: type: object properties: id: type: string example: cll-abc123 type: type: string enum: - CALL - SMS direction: type: string enum: - INBOUND - OUTBOUND allo_number: type: string example: '+14155550100' contact_number: type: string example: '+14155551234' contacts: type: array items: $ref: '#/components/schemas/Contact' user: $ref: '#/components/schemas/UserRef' date: type: string format: date-time duration: type: integer nullable: true result: type: string nullable: true enum: - ANSWERED - VOICEMAIL - TRANSFERRED recording_url: type: string nullable: true summary: type: string nullable: true tags: type: array items: type: string nullable: true transcript: type: array nullable: true items: $ref: '#/components/schemas/TranscriptEntry' content: type: string nullable: true status: type: string nullable: true enum: - PENDING - SENT - DELIVERED - FAILED message_type: type: string nullable: true enum: - SMS - MMS - WHATSAPP Contact: type: object properties: id: type: string example: cnt-abc123 name: type: string example: Sarah Johnson company: type: object nullable: true properties: id: type: string example: com-xyz789 name: type: string example: Acme Corp deals: type: array items: type: object properties: id: type: string example: dea-def456 name: type: string example: Enterprise Plan status: type: string enum: - OPEN - WON - LOST UserRef: type: object properties: id: type: string example: usr-abc123 name: type: string example: John email: type: string example: john@acme.com TranscriptEntry: type: object properties: source: type: string enum: - USER - EXTERNAL time: type: string format: date-time text: type: string ApiError: type: object properties: error: type: object properties: type: type: string code: type: string message: type: string retryable: type: boolean request_id: type: string retry_after_seconds: type: integer nullable: true responses: ApiUnauthorized: description: Invalid or missing API key content: application/json: schema: $ref: '#/components/schemas/ApiError' ApiNotFound: description: Resource not found content: application/json: schema: $ref: '#/components/schemas/ApiError' ApiRateLimited: description: Rate limit exceeded content: application/json: schema: $ref: '#/components/schemas/ApiError' securitySchemes: ApiKeyAuth: type: apiKey in: header name: Authorization ````