Skip to main content
POST
/
v1
/
chat
/
{chatId}
/
message
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?"}'

{
  "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" } }
      ]
    }
  }
}
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.
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.

​
Path parameters

​
chatId
string
required
The chat session ID.

​
Body

​
message
string
required
Your message, 1–4000 characters.
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?"}'

{
  "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" } }
      ]
    }
  }
}
Both userMessage and aiMessage are stored message records. sender is "user" or "ai". groundingSources is null unless the AI used web search to answer.