WhatsApp API Platform
Chatbots

Get chatbot

GET
/api/v1/chatbots/{id}

Get a single chatbot by ID. The response includes the chatbot's nodes and links arrays (its flow graph) for inspection — flow editing is done from the dashboard builder.

Authorization

ApiKeyAuth
X-API-Key<token>

API key from your dashboard (Settings > API Keys)

In: header

Path Parameters

id*string

Chatbot ID (cuid2)

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://loading/api/v1/chatbots/cbt_abc123"
{
  "success": true,
  "data": {
    "id": "cbt_abc123",
    "user_id": "string",
    "name": "string",
    "description": "string",
    "status": "DRAFT",
    "trigger_type": "MESSAGE_CONTAINS",
    "trigger_config": {},
    "start_node_id": "string",
    "active_version_id": "string",
    "variables": [
      {
        "id": "string",
        "name": "string",
        "type": "string",
        "default_value": null,
        "description": "string",
        "is_required": true
      }
    ],
    "settings": {
      "session_timeout_minutes": 0,
      "fallback_message": "string",
      "max_retries": 0,
      "handoff_enabled": true,
      "handoff_team_id": "string"
    },
    "created_at": "2019-08-24T14:15:22Z",
    "updated_at": "2019-08-24T14:15:22Z",
    "node_count": 0,
    "nodes": [
      {}
    ],
    "links": [
      {}
    ]
  }
}
{
  "success": false,
  "message": "to field is required"
}
{
  "success": false,
  "message": "user not authenticated"
}
{
  "success": false,
  "message": "Chatbot not found"
}
{
  "success": false,
  "message": "internal server error"
}