> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vouchmark.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Send message

> Send a message in a Vouch AI conversation and get the AI reply.

Sends a message in an existing chat and returns both the persisted user message and the AI reply. Vouch AI has context about the chat's company, its verification data, and monitoring events.

<Note>
  Requires a positive wallet balance. Billed at ₦100 per 1,000 tokens consumed by the request, and rate limited to 10 AI requests per minute.
</Note>

## Path parameters

<ParamField path="chatId" type="string" required>
  The chat session ID.
</ParamField>

## Body

<ParamField body="message" type="string" required>
  Your message, 1–4000 characters.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST https://api.vouchmark.com/v1/chat/chat_aBcD.../message \
    -H "Authorization: Bearer $TOKEN" \
    -H "Content-Type: application/json" \
    -d '{"message": "Can you suggest steps to resolve the TIN issue?"}'
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "message": "Message sent successfully",
    "userMessage": {
      "id": "msg_aBcD...",
      "chatId": "chat_aBcD...",
      "sender": "user",
      "content": "Can you suggest steps to resolve the TIN issue?",
      "timestampAt": "2026-06-27T10:05:00Z",
      "groundingSources": null
    },
    "aiMessage": {
      "id": "msg_eFgH...",
      "chatId": "chat_aBcD...",
      "sender": "ai",
      "content": "Here are the recommended steps to resolve the TIN deactivation:\n\n1. Contact FIRS directly...",
      "timestampAt": "2026-06-27T10:05:02Z",
      "groundingSources": {
        "groundingChunks": [
          { "web": { "uri": "https://firs.gov.ng/...", "title": "FIRS" } }
        ]
      }
    }
  }
  ```
</ResponseExample>

Both `userMessage` and `aiMessage` are stored message records. `sender` is `"user"` or `"ai"`. `groundingSources` is `null` unless the AI used web search to answer.