Allo

List conversation notes

Returns the internal team notes on a conversation, paginated.

GET/v2/api/conversations/{contact_number}/notes

Returns the internal team notes on a conversation, paginated. allo_number is required — a conversation is scoped to one of your Allo lines.

Errors

StatusCodeWhen
400MISSING_ALLO_NUMBERThe allo_number parameter is missing
403ALLO_NUMBER_FORBIDDENYou do not have access to this Allo line

Authorization

Authorizationstring · headerrequired

Api-Key ak_live_…

Path parameters

contact_numberstringrequired

The contact's phone number (E.164)

Query parameters

allo_numberstringrequired

The Allo line the conversation belongs to (E.164). List your numbers with GET /v2/api/numbers.

pageinteger

Page number (1-indexed)

sizeinteger

Results per page

Responses

200List of conversation notes
dataobject[]
8 fields
idstring

Note ID (not-*)

contentstring

Note text, with mentions inline as @[Name](usr-...).

contact_numberstring

The contact's phone number (E.164).

allo_numberstring | null

The Allo line the conversation belongs to (E.164).

userobject

Author of a note or comment.

2 fields
idstring
namestring | null
mentionsobject[]
3 fields
user_idstring
namestring | null
deletedboolean

true if the mentioned user has since been removed from the team.

created_atstring<date-time>
updated_atstring<date-time>
paginationobject
5 fields
pageinteger
sizeinteger
total_countinteger
total_pagesinteger
has_moreboolean
400
401
403
429