> ## Documentation Index > Fetch the complete documentation index at: https://docs.wavix.com/llms.txt > Use this file to discover all available pages before exploring further. # Retrieve a WhatsApp message > Returns the WhatsApp message identified by `uuid`, including its delivery status. ## OpenAPI ````yaml https://wavix.github.io/wavix-openapi/wavix-api.yaml get /v1/whatsapp/messages/{uuid} openapi: 3.1.0 info: title: Wavix APIs description: >- Wavix provides robust APIs that let you integrate voice and text messaging features directly into your app. Send text, place calls, and access detailed reports programmatically. termsOfService: https://wavix.com/terms-and-conditions license: name: MIT identifier: MIT contact: name: Wavix url: https://wavix.com email: support@wavix.com version: '1.0' servers: - url: https://api.wavix.com description: https://api.wavix.com variables: {} security: - bearerAuth: [] tags: - name: SIP trunks description: SIP trunks - name: Buy description: Numbers - name: Cart description: Numbers - name: My numbers description: Numbers - name: Billing description: Billing, transactions, and invoices - name: Profile description: Account profile and customer information - name: CDRs description: Call detail records and call history - name: Speech Analytics description: Call transcription and speech analytics - name: SMS and MMS description: Messaging - name: Number Validator description: Phone number validation - name: Link shortener description: Short link and click metrics - name: 2FA description: Two-factor authentication - name: 10DLC description: 10DLC Campaigns and Brands - name: API Keys description: API key management - name: Call webhooks description: Webhook configuration for call events - name: Call control description: Programmable Voice - name: Call streaming description: Real-time call audio streaming over WebSocket - name: Call recording description: Call recording - name: Sub-accounts description: Sub-account management - name: Voice campaigns description: Outbound voice campaigns - name: Wavix Embeddable description: WebRTC embeddable widget - name: WhatsApp description: WhatsApp senders, templates, and messages paths: /v1/whatsapp/messages/{uuid}: get: tags: - WhatsApp summary: Retrieve a WhatsApp message description: >- Returns the WhatsApp message identified by `uuid`, including its delivery status. operationId: whatsapp_messages_get parameters: - name: uuid in: path required: true description: The unique ID of the message. schema: type: string format: uuid example: 3a525ca2-6909-4c72-9399-905adf7f3a74 responses: '200': description: The requested WhatsApp message. content: application/json: schema: $ref: '#/components/schemas/WhatsAppMessageGetResponse' '400': $ref: '#/components/responses/WhatsAppBadRequestResponse' '401': $ref: '#/components/responses/WhatsAppUnauthorizedResponse' '402': $ref: '#/components/responses/WhatsAppPaymentRequiredResponse' '403': $ref: '#/components/responses/WhatsAppForbiddenResponse' '404': description: >- Returns when WhatsApp is not available or not enabled for the account, or no message matches `uuid`. content: application/problem+json: schema: $ref: '#/components/schemas/WhatsAppProblem' examples: whatsapp-not-available: summary: WhatsApp is not available for this account value: type: https://wavix.com/problems/whatsapp-not-available title: WhatsApp Not Available status: 404 detail: WhatsApp is not available for this account. instance: 3a525ca2-6909-4c72-9399-905adf7f3a74 error_class: permanent error_code: WAVIX_WHATSAPP_NOT_AVAILABLE channel-not-enabled: summary: WhatsApp is not enabled yet for this account value: type: https://wavix.com/problems/channel-not-enabled title: Channel Not Enabled status: 404 detail: The WhatsApp channel is not enabled for this account yet. instance: 3a525ca2-6909-4c72-9399-905adf7f3a74 error_class: permanent error_code: WAVIX_CHANNEL_NOT_ENABLED resource-not-found: summary: No message matches the given uuid value: type: https://wavix.com/problems/resource-not-found title: Resource Not Found status: 404 detail: No message was found. instance: 3a525ca2-6909-4c72-9399-905adf7f3a74 error_class: permanent error_code: WAVIX_RESOURCE_NOT_FOUND '429': $ref: '#/components/responses/WhatsAppTooManyRequestsResponse' deprecated: false security: - bearerAuth: - whatsapp:read components: schemas: WhatsAppMessageGetResponse: title: WhatsAppMessageGetResponse required: - message type: object additionalProperties: false properties: message: $ref: '#/components/schemas/WhatsAppMessageListItem' WhatsAppProblem: title: WhatsAppProblem description: >- RFC 9457 problem document returned by WhatsApp endpoints as `application/problem+json`. required: - type - title - status - detail - instance type: object additionalProperties: false properties: type: type: string description: URI identifying the problem type. example: https://wavix.com/problems/whatsapp-not-available title: type: string description: Short, human-readable summary of the problem type. example: WhatsApp Not Available status: type: integer format: int32 description: HTTP status code. example: 404 detail: type: string description: >- Human-readable explanation specific to this occurrence of the problem. example: WhatsApp is not available for this account. instance: type: string description: >- URI identifying this specific occurrence of the problem, such as the request ID. example: 3a525ca2-6909-4c72-9399-905adf7f3a74 error_class: type: string description: Machine-readable classification of the error. enum: - permanent - retriable - rate_limited - invalid_template example: permanent error_code: type: string description: Stable machine-readable error code, derived from the problem slug. example: WAVIX_WHATSAPP_NOT_AVAILABLE WhatsAppMessageListItem: title: WhatsAppMessageListItem required: - uuid - direction - status - created_at - from - to type: object additionalProperties: false properties: uuid: type: string format: uuid description: Message ID. example: 3a525ca2-6909-4c72-9399-905adf7f3a74 direction: type: string description: Message direction. enum: - outbound - inbound example: outbound status: type: string description: Message delivery status. enum: - failed - sent - delivered - undelivered - expired - rejected - unknown example: delivered from: type: string description: >- For `outbound` messages, the sender's phone number. For `inbound`, the originating phone number. example: '14155550100' to: type: string description: >- For `outbound` messages, the recipient's phone number. For `inbound`, the sender's phone number. example: '447537151866' country: type: - string - 'null' description: Recipient's country, derived from the phone number. example: GB created_at: type: string description: Date and time the message was created, in ISO 8601 format. example: '2026-01-15T10:30:00Z' responses: WhatsAppBadRequestResponse: description: Returns when the request body or parameters are invalid. headers: {} content: application/problem+json: schema: $ref: '#/components/schemas/WhatsAppProblem' examples: invalid-request: value: type: https://wavix.com/problems/invalid-request title: Invalid Request status: 400 detail: The request body is invalid. instance: 3a525ca2-6909-4c72-9399-905adf7f3a74 error_class: permanent error_code: WAVIX_INVALID_REQUEST WhatsAppUnauthorizedResponse: description: Returns when the request is not authenticated. headers: {} content: application/problem+json: schema: $ref: '#/components/schemas/WhatsAppProblem' examples: authentication-required: value: type: https://wavix.com/problems/authentication-required title: Authentication Required status: 401 detail: Authentication is required to access this resource. instance: 3a525ca2-6909-4c72-9399-905adf7f3a74 error_class: permanent error_code: WAVIX_AUTHENTICATION_REQUIRED WhatsAppPaymentRequiredResponse: description: Returns when the account balance is insufficient. headers: {} content: application/problem+json: schema: $ref: '#/components/schemas/WhatsAppProblem' examples: payment-required: value: type: https://wavix.com/problems/payment-required title: Payment Required status: 402 detail: Please top up your balance. instance: 3a525ca2-6909-4c72-9399-905adf7f3a74 error_class: permanent error_code: WAVIX_PAYMENT_REQUIRED WhatsAppForbiddenResponse: description: Returns when the account is suspended. headers: {} content: application/problem+json: schema: $ref: '#/components/schemas/WhatsAppProblem' examples: account-suspended: value: type: https://wavix.com/problems/account-suspended title: Account Suspended status: 403 detail: Please top up your balance. instance: 3a525ca2-6909-4c72-9399-905adf7f3a74 error_class: permanent error_code: WAVIX_ACCOUNT_SUSPENDED WhatsAppTooManyRequestsResponse: description: Returns when the account has exceeded its request rate limit. headers: Retry-After: description: Number of seconds to wait before retrying the request. schema: type: integer example: 30 content: application/problem+json: schema: $ref: '#/components/schemas/WhatsAppProblem' examples: rate-limited: value: type: https://wavix.com/problems/rate-limited title: Rate Limited status: 429 detail: Too many requests. Try again later. instance: 3a525ca2-6909-4c72-9399-905adf7f3a74 error_class: rate_limited error_code: WAVIX_RATE_LIMITED securitySchemes: bearerAuth: type: http scheme: bearer description: > Wavix API key. Pass as `Authorization: Bearer `. Keys support per-resource scopes (none / read / write). See [Restricted keys and scopes](https://docs.wavix.com/api-reference/authentication#restricted-keys-and-scopes). ````