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 Messages

GET
https://api.softservv.co/whatsapp-accounts/{number_id}/received-messages/
Fetches received messages 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

Query Params

Responses

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

🟠401Unauthorized
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.softservv.co/whatsapp-accounts//received-messages/?start&limit&order_by&order_direction' \
--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:28
Previous
Get Conversation Messages
Next
Get Received Message
Built with