API reference

Conversations

A conversation is a thread of messages with one recipient (or group). We auto-create conversations on first send/receive and keep them sticky to a single line — so the same thread always continues from the same number.

List conversations

GET/v1/conversations

Most recent first.

Query

Field	Type	Description
`limit`	integer	Max 100. Default 50.
`cursor`	string	Pagination cursor from a previous response.

curl 'https://api.bluereplies.com/v1/conversations?limit=25' \
  -H "x-api-key: $BLUEREPLIES_KEY"

Get a conversation

GET/v1/conversations/:participant

Conversations are keyed by participant phone number (E.164). Returns paginated messages from that thread.

curl 'https://api.bluereplies.com/v1/conversations/%2B15551234567' \
  -H "x-api-key: $BLUEREPLIES_KEY"

URL-encode the leading + as %2B when calling from curl.

Line stickiness

Once a conversation is created, every outbound message in that thread goes through the same line. This is critical: shuffling lines mid-thread looks like spoofing to Apple and gets your line flagged.

If you need to send from a specific line to a NEW recipient, pass from(a line ID or phone number) on the first send. Subsequent sends to that recipient will continue on the same line whether or not you pass from.