POST /chat — Send Message - Atlas API Documentation

This endpoint allows you to send a user message to the Atlas chat service and receive a conversational response. It is typically used to drive document collection and onboarding flows interactively.

Endpoint

POST /verification/chat

Request headers

string

required

JWT access token obtained from the auth API.

Request body

string

required

The user’s message to the chat system.

string

required

UUID of the verification flow associated with this chat session.

Response

string

The response generated by the chat system.

string

Unique identifier for the generated message.

string

Timestamp when the response was created (ISO format).

Example

curl --request POST \
  --url https://api.helloatlas.in/v2/verification/chat \
  --header "Token: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." \
  --header "Content-Type: application/json" \
  --data '{
    "message": "Hi, I want to apply for a loan",
    "flow_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  }'

{
  "message": "I'm doing well, thank you for asking! How can I help you today?",
  "message_id": "45ba2f40-02ff-43d3-b3fc-de2300f25756",
  "created_at": "2025-10-11T06:01:03"
}

Error responses

Status	Meaning
`400`	Missing required parameters (e.g., `message`)
`401`	Invaid or expired token
`422`	Error while processing message from LLM service

Each message is processed in the context of the provided flow_id, allowing Atlas to guide users through document collection and onboarding dynamically.

Authentication

IDP Extraction

Document Verification

Chat Based Onboarding

Bulk Service

Address Match

POST /chat — Send Message

Endpoint

Request headers

Request body

Response

Example

Error responses

​Endpoint

​Request headers

​Request body

​Response

​Example

​Error responses

Endpoint

Request headers

Request body

Response

Example

Error responses