curl -g --request GET \
--url 'https://demo.texterchat.com/server/api/v2/chats/67a87067aeed4dee1271cb4d/chat-notes?limit=20' \
--header 'Authorization: Bearer <token>'{
"notes": [
{
"_id": "6731f0c2a1b2c3d4e5f60718",
"chatId": "67a87067aeed4dee1271cb4d",
"text": "Customer asked for a refund on order 1234",
"messageId": "6731efa0a1b2c3d4e5f60701",
"author": {
"actor": {
"type": "jwt",
"issuer": "https://texterchat.com/demo",
"kid": "a1b2c3"
},
"customName": "Refunds system"
},
"createdAt": 1762851000000,
"updatedAt": 1762851000000
}
],
"total": 1
}List Chat Notes
Retrieve a page of the internal notes of a chat, newest first, with optional filters on the original author.
curl -g --request GET \
--url 'https://demo.texterchat.com/server/api/v2/chats/67a87067aeed4dee1271cb4d/chat-notes?limit=20' \
--header 'Authorization: Bearer <token>'{
"notes": [
{
"_id": "6731f0c2a1b2c3d4e5f60718",
"chatId": "67a87067aeed4dee1271cb4d",
"text": "Customer asked for a refund on order 1234",
"messageId": "6731efa0a1b2c3d4e5f60701",
"author": {
"actor": {
"type": "jwt",
"issuer": "https://texterchat.com/demo",
"kid": "a1b2c3"
},
"customName": "Refunds system"
},
"createdAt": 1762851000000,
"updatedAt": 1762851000000
}
],
"total": 1
}View notes of all chats
Filters match the note’s original author, not its last editor. When you set several filters, a note must match all of them.
Array parameters use brackets: send authorSources[]=bot&authorSources[]=api. A plain authorSources=bot is rejected with 400.
total counts every note that matches the filters, not only the notes on this page. More pages exist while skip + the number of returned notes is less than total.Authorizations
API token generated in Texter: gear icon → Developers → API Tokens. When creating a token, assign it the scopes required by the endpoints you plan to call - each endpoint lists its required scopes.
Path Parameters
The unique identifier of the chat. You can obtain this value by using the Search Chats endpoint with the contact's phone number
Query Parameters
How many notes to skip. Defaults to 0
^\d+$Maximum notes to return (1-1000). Defaults to 100
^\d+$Return notes whose original author comes from any of these sources: user (an agent in the inbox), bot, scenario, api (any API token), unknown. Repeat the parameter for several sources. Duplicate values return 400
1user, bot, scenario, api, unknown Return notes written by the agent with this user ID (the author.actor.uid of that agent's notes)
1Return notes whose author customName is exactly this value
1