Skip to main content
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 /v2/verification/chat

​
Request headers

​
Token
string
required
JWT access token obtained from the auth API.

​
Request body

​
message
string
required
The user’s message to the chat system.
​
flow_id
string
required
UUID of the verification flow associated with this chat session.

​
Response

​
message
string
The response generated by the chat system.
​
message_id
string
Unique identifier for the generated message.
​
created_at
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"
  }'

​
Error responses

StatusMeaning
400Missing required parameters (e.g., message)
422Error 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.