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

# POST /chat — Send Message

> Send a message to the Atlas chat-based onboarding service and receive a response.

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

```text theme={null}
POST /verification/chat
```

## Request headers

<ParamField header="Token" type="string" required>
  JWT access token obtained from the auth API.
</ParamField>

## Request body

<ParamField body="message" type="string" required>
  The user's message to the chat system.
</ParamField>

<ParamField body="flow_id" type="string" required>
  UUID of the verification flow associated with this chat session.
</ParamField>

## Response

<ResponseField name="message" type="string">
  The response generated by the chat system.
</ResponseField>

<ResponseField name="message_id" type="string">
  Unique identifier for the generated message.
</ResponseField>

<ResponseField name="created_at" type="string">
  Timestamp when the response was created (ISO format).
</ResponseField>

## Example

<CodeGroup>
  ```bash cURL theme={null}
  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"
    }'
  ```

  ```json 200 OK theme={null}
  {
    "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"
  }
  ```
</CodeGroup>

## Error responses

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

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