Softservv API
  1. Messages
Softservv API
  • Authentication
    • Login
      POST
  • Accounts
    • Get Account
      GET
  • Whatsapp Accounts
    • Get Whatsapp Accounts
      GET
    • Get Whatsapp Account
      GET
    • Update Whatsapp Account Webhook
      POST
    • Upgrade Whatsapp Account Plan
      POST
    • Suspend Whatsapp Account (Resellers Only)
      POST
    • Unsuspend Whatsapp Account (Resellers Only)
      POST
  • Messages
    • JSON Examples for Sending Messages
    • Get Conversations List
      GET
    • Get Conversation Messages
      GET
    • Get Received Messages
      GET
    • Get Received Message
      GET
    • Get Sent Messages
      GET
    • Get Sent Message
      GET
    • Send Message
      POST
    • Mark Message As Read
      POST
  • Media
    • Get Media
      GET
    • Upload Media
      POST
    • Delete Media
      DELETE
  • Templates
    • JSON Examples for Creating Templates
    • Get Templates
      GET
    • Get Template
      GET
    • Create New Template
      POST
    • Update Template
      POST
    • Delete Template
      DELETE
  • Billing
    • Get Pricing Plans
  • Embedded Inbox
    • Embedded Inbox - How To
    • Generate Embed Code
    • Generate Embed Token
  • Onboarding
    • Create Onboarding Invite
  • Schemas
    • Schemas
  1. Messages

Get Received Message

GET
https://api.softservv.co/whatsapp-accounts/{number_id}/received-messages/{message_id}/
Fetches a single received message for the specified Whatsapp account. Requires a Bearer token in the Authorization header.

Request

Authorization
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
Path Params

Responses

🟢200OK
application/json
Successful retrieval of received message
Body

🟠401Unauthorized
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.softservv.co/whatsapp-accounts//received-messages//' \
--header 'Authorization: Bearer <token>'
Response Response Example
200 - Example 1
{
    "status": "Success",
    "data": {
        "audio": {
            "id": "audio_12345"
        },
        "button": {
            "type": "reply"
        },
        "context": {
            "message_id": "message_12345"
        },
        "document": {
            "id": "doc_12345",
            "caption": "Caption"
        },
        "errors": [
            {
                "code": "1001",
                "message": "Invalid message format"
            }
        ],
        "from": "0987654321",
        "message_id": "wamid.1234567890",
        "identity": {
            "acknowledged": "true",
            "created_timestamp": "2025-05-15T09:59:00Z",
            "hash": "hash_12345"
        },
        "image": {
            "id": "image_12345",
            "caption": "Caption"
        },
        "interactive": {
            "action": {
                "button": "Click Me",
                "sections": [
                    {
                        "title": "Section 1",
                        "rows": [
                            {
                                "id": "row_1",
                                "title": "Option 1",
                                "description": "Description 1"
                            }
                        ]
                    }
                ]
            },
            "header": {
                "type": "text",
                "text": "Header Text"
            },
            "body": {
                "text": "Body Text"
            },
            "footer": {
                "text": "Footer Text"
            },
            "type": "list"
        },
        "order": {
            "catalog_id": "catalog_12345",
            "product_items": [
                {
                    "product_retailer_id": "item_123",
                    "quantity": 2
                }
            ],
            "text": "Order confirmation"
        },
        "referral": {
            "headline": "Check this out!",
            "body": "Amazing product you should try.",
            "source_type": "ad",
            "source_id": "ad_12345",
            "source_url": "https://example.com/ad/12345",
            "image": {
                "id": "image_12345",
                "caption": "Caption"
            },
            "video": {
                "id": "video_12345",
                "caption": "Caption"
            }
        },
        "sticker": {
            "id": "sticker_12345"
        },
        "system": {
            "body": "Text"
        },
        "text": {
            "body": "Hello, how are you?"
        },
        "timestamp": "2025-05-15T09:59:00Z",
        "type": "text",
        "video": {
            "id": "video_12345",
            "caption": "Caption"
        },
        "status": "delivered",
        "date_created": "2025-05-15T09:59:00Z"
    }
}
Modified at 2025-09-08 13:56:44
Previous
Get Received Messages
Next
Get Sent Messages
Built with