Skip to main content
This endpoint returns the most recent chat messages for a given flow. It supports pagination so you can fetch messages incrementally. Use this to:
  • Display chat history in your UI
  • Resume conversations
  • Audit onboarding interactions

​
Endpoint

GET /v2/verification/chat-history

​
Request headers

​
Token
string
required
JWT access token for authentication.

​
Query parameters

​
flow_id
string
required
Unique identifier for the chat flow.
​
page
integer
Page number to retrieve. Default: 1.
​
per_page
integer
Number of messages per page. Default: 10.

​
Response

​
data
array
List of chat messages.
​
page
integer
Current page number.
​
per_page
integer
Number of messages per page.
​
total_pages
integer
Total number of pages available.
​
total_items
integer
Total number of messages.
​
has_next
boolean
Indicates if more pages are available.
​
has_prev
boolean
Indicates if previous pages exist.

​
Example

curl --request GET \
  --url "https://api.helloatlas.in/v2/verification/chat-history?flow_id=3fa85f64-5717-4562-b3fc-2c963f66afa6&page=1&per_page=10" \
  --header "Token: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

​
Error responses

StatusMeaning
400Invalid parameters (e.g., page must be integer)
401Invalid or expired token
Messages include both user and system responses. Use the sender field to differentiate between them when rendering the chat UI.