Softservv API
  1. Whatsapp Accounts
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. Whatsapp Accounts

Get Whatsapp Accounts

GET
https://api.softservv.co/whatsapp-accounts/
Fetches a list of the authenticated user's Whatsapp accounts. 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
Query Params

Responses

🟢200OK
application/json
Successful retrieval of Whatsapp accounts
Body

🟠401Unauthorized
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.softservv.co/whatsapp-accounts/?start&limit&order_by&order_direction' \
--header 'Authorization: Bearer <token>'
Response Response Example
200 - Example 1
{
    "status": "Success",
    "data": [
        {
            "whatsapp_business_account_id": "123456789012345",
            "name": "My Business",
            "message_template_namespace": "com.example.templates",
            "currency": "USD",
            "country": "ZA",
            "business_verification_status": "VERIFIED",
            "business_info": {},
            "ownership_type": "SELF",
            "message_templates": [
                {
                    "name": "string",
                    "parameter_format": "string",
                    "components": [
                        {
                            "type": "string",
                            "text": "string",
                            "example": {
                                "param_name": "string",
                                "example": "string"
                            }
                        }
                    ],
                    "language": "string",
                    "status": "string",
                    "category": "string",
                    "sub_category": "string",
                    "id": "string"
                }
            ],
            "whatsapp_number_id": 123456789012345,
            "whatsapp_number": "+271234567",
            "whatsapp_number_display_phone_number": "+27 123 4567",
            "whatsapp_number_verified_name": "My Business",
            "whatsapp_number_official_business": "My Business",
            "whatsapp_number_quality_rating": "GREEN",
            "whatsapp_number_platform_type": "CLOUD",
            "whatsapp_number_messaging_limit": "TIER_1K",
            "whatsapp_number_health_status": {},
            "whatsapp_profile_about": "We provide the best service in town",
            "whatsapp_profile_address": "123 Main St, Cape Town, ZA",
            "whatsapp_profile_description": "We are a leading provider of XYZ services",
            "whatsapp_profile_email": "test@example.com",
            "whatsapp_profile_profile_picture": "https://example.com/profile.jpg",
            "whatsapp_profile_websites": [
                "https://example.com"
            ],
            "whatsapp_profile_vertical": "RETAIL",
            "external_webhook": "https://example.com/webhook",
            "status": "ACTIVE",
            "billing_status": "Active",
            "last_payment_date": "2025-05-15 09:59:00",
            "date_created": "2025-05-15 09:59:00"
        }
    ]
}
Modified at 2025-09-08 13:52:56
Previous
Get Account
Next
Get Whatsapp Account
Built with