List messages

GET/me/messages

Lists messages in the connected person’s own conversations, team chats and patient conversations alike, in a time range, newest first, with a cursor. group_by=message (the default) returns them one by one; group_by=conversation returns every message in the range from one conversation before moving to the next. A conversation’s messages include everyone’s, not only the person’s own.

Credentials: Org admin’s OAuth token only
Scope: messages.read

Query parameters

afterstring

Only messages sent at or after this time. An RFC 3339 timestamp, or a date for midnight in the organization’s time zone.

beforestring

Only messages sent before this time. Same format as after.

group_bymessage, conversation

message (the default) lists messages one by one across conversations. conversation lists every message in the range from one conversation, then the next.

orderdesc, asc

desc for newest first (the default) or asc for oldest first. With group_by=conversation, it orders the conversations by their latest message and the messages within each.

conversation_idUUID

Only messages in this conversation.

patient_idUUID

Only conversations with this patient, on any phone number.

qstring

Words and operators to search for, like refill from:patient is:unread. Supports free text, "exact phrases", from:, patient:, mrn:, phone:, is:unread, is:failed, - to negate, and OR. Use after and before for time ranges. See Search.

page[limit]integer

Number of records to return. Defaults to 50, maximum 100.

page[after]string

Cursor from the previous page’s pagination.next_cursor.

Returns

Returns 200 OK with a data array of Message objects and a pagination object. See pagination.

Errors

Failed requests return application/problem+json problem details. The errors specific to this endpoint:

Status	Code	Meaning
400	`invalid_request`	The request is malformed, such as invalid JSON.
400	`invalid_query`	The `q` query can’t be parsed. See Search.
401	`invalid_token`	The API key or access token is missing, expired, or revoked.
403	`insufficient_scope`	The credential doesn’t have the scope this endpoint needs.
403	`oauth_required`	API keys can’t use this endpoint. It needs an org admin’s OAuth token.
429	`rate_limited`	Too many requests. Retry after `Retry-After` seconds.

cURL

Request


curl "https://api.bloomtext.com/v1/me/messages?after=2026-09-21T00:00:00Z&q=from:patient" \
  -H "Authorization: Bearer $BLOOMTEXT_ACCESS_TOKEN"

JavaScript

Request


const response = await fetch('https://api.bloomtext.com/v1/me/messages?after=2026-09-21T00:00:00Z&q=from:patient', {
  headers: {
    Authorization: `Bearer ${process.env.BLOOMTEXT_ACCESS_TOKEN}`,
  },
})
 
if (!response.ok) throw new Error(`BloomText API error: ${response.status}`)
const data = await response.json()

Python

Request


import os
 
import requests
 
response = requests.get(
    "https://api.bloomtext.com/v1/me/messages?after=2026-09-21T00:00:00Z&q=from:patient",
    headers={
        "Authorization": f"Bearer {os.environ['BLOOMTEXT_ACCESS_TOKEN']}",
    },
)
response.raise_for_status()
data = response.json()

Go

Request


package main
 
import (
	"fmt"
	"io"
	"net/http"
	"os"
)
 
func main() {
	req, err := http.NewRequest("GET", "https://api.bloomtext.com/v1/me/messages?after=2026-09-21T00:00:00Z&q=from:patient", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Authorization", "Bearer "+os.Getenv("BLOOMTEXT_ACCESS_TOKEN"))
 
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
 
	out, _ := io.ReadAll(res.Body)
	fmt.Println(res.Status, string(out))
}

Ruby

Request


require "net/http"
require "json"
 
uri = URI("https://api.bloomtext.com/v1/me/messages?after=2026-09-21T00:00:00Z&q=from:patient")
request = Net::HTTP::Get.new(uri)
request["Authorization"] = "Bearer #{ENV.fetch("BLOOMTEXT_ACCESS_TOKEN")}"
 
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end
data = JSON.parse(response.body)

Response · 200 OK


{
  "data": [
    {
      "id": "4cbfdb50-6b7d-45d4-94b3-05a52ce3f4d1",
      "conversation": {
        "id": "e5c3b7b8-8f08-4d5a-9af1-0d11b0f4b7a0",
        "title": "Jane Doe"
      },
      "sender": {
        "id": "5a1c9e2b-7d44-4f1a-9c3e-2b8d6f0a1e77",
        "name": "Jane Doe",
        "kind": "patient"
      },
      "patient": {
        "id": "5a1c9e2b-7d44-4f1a-9c3e-2b8d6f0a1e77",
        "name": "Jane Doe"
      },
      "channel": "sms",
      "phone_number": {
        "number": "+15125550100",
        "team": "Front desk"
      },
      "delivery": null,
      "campaign_id": null,
      "created_at": "2026-09-21T15:04:05Z",
      "edited_at": null,
      "type": "text",
      "body": "Hi, can I move my Thursday appointment to Friday morning?",
      "file": null,
      "reply_to_message_id": null,
      "unread": true,
      "sent_via": null
    }
  ],
  "pagination": {
    "next_cursor": null,
    "has_more": false
  }
}