Start new chat

curl -X POST https://api.vouchmark.com/v1/chat/new \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"companyId": "cmp_aBcD..."}'

{
  "message": "Chat created successfully",
  "chat": {
    "id": "chat_aBcD...",
    "title": "TEKCIFY TECHNOLOGIES LTD - 6/27/2026",
    "companyId": "cmp_aBcD...",
    "messages": []
  }
}

POST

chat

new

curl -X POST https://api.vouchmark.com/v1/chat/new \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"companyId": "cmp_aBcD..."}'

{
  "message": "Chat created successfully",
  "chat": {
    "id": "chat_aBcD...",
    "title": "TEKCIFY TECHNOLOGIES LTD - 6/27/2026",
    "companyId": "cmp_aBcD...",
    "messages": []
  }
}

Returns the Vouch AI chat for a company, creating it if one does not yet exist. Each user has a single persistent chat per company. No first message is sent here — use Send message to talk to the AI.

Vouch AI requires a positive wallet balance and is metered per AI request. Conversation turns are billed at ₦100 per 1,000 tokens. Requests are rejected if the wallet balance is not positive, and rate limited to 10 AI requests per minute.

Body

string

required

The company the chat is scoped to.

curl -X POST https://api.vouchmark.com/v1/chat/new \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"companyId": "cmp_aBcD..."}'

{
  "message": "Chat created successfully",
  "chat": {
    "id": "chat_aBcD...",
    "title": "TEKCIFY TECHNOLOGIES LTD - 6/27/2026",
    "companyId": "cmp_aBcD...",
    "messages": []
  }
}

A brand-new chat returns 201 Created with an empty messages array. If a chat already exists for the company, the response is 200 OK and includes the existing messages plus a top-level chatId:

{
  "success": true,
  "message": "A chat already exists for this company",
  "chat": {
    "id": "chat_aBcD...",
    "title": "TEKCIFY TECHNOLOGIES LTD - 6/27/2026",
    "companyId": "cmp_aBcD...",
    "messages": [
      {
        "id": "msg_aBcD...",
        "chatId": "chat_aBcD...",
        "sender": "user",
        "content": "What are my compliance risks?",
        "timestampAt": "2026-06-27T10:00:00Z",
        "groundingSources": null
      }
    ]
  },
  "chatId": "chat_aBcD..."
}

Overview

Auth

Companies

Verifications

Onboarding (KYB)

Widget Embed (Runtime)

Trust Badge

Monitoring

Investigations

Disputes

Vouch AI

Compliance

Wallet & Billing

Developers

Body

​Body

Body