# Sent as ?limit=50&created_after=2026-11-10T09%3A30%3A00Z
curl -G https://api.ibubbl.com/v1/messages \
  -H "Authorization: Bearer $IBUBBL_API_KEY" \
  --data-urlencode "limit=50" \
  --data-urlencode "created_after=2026-11-10T09:30:00Z"

# Next page: add the id of the last message you received.
#   --data-urlencode "starting_after=8b3a4e72-1c2d-4e5f-9a0b-2c3d4e5f6a7b"

const params = new URLSearchParams({
  limit: "50",
  created_after: "2026-11-10T09:30:00Z",
});

const res = await fetch(`https://api.ibubbl.com/v1/messages?${params}`, {
  headers: { Authorization: `Bearer ${process.env.IBUBBL_API_KEY}` },
  signal: AbortSignal.timeout(10_000),
});

const data = await res.json();
if (!res.ok) throw new Error(`${res.status} ${data.detail?.error}`);
for (const message of data.data) {
  console.log(message.created_at, message.direction, message.status, message.body);
}
// More? Repeat with starting_after = data.data[data.data.length - 1].id
console.log("has_more:", data.has_more);

import os

import requests

API_KEY = os.environ["IBUBBL_API_KEY"]

res = requests.get(
    "https://api.ibubbl.com/v1/messages",
    headers={"Authorization": f"Bearer {API_KEY}"},
    params={"limit": 50, "created_after": "2026-11-10T09:30:00Z"},
    timeout=10,
)
data = res.json()
if not res.ok:
    raise RuntimeError(f"{res.status_code} {data['detail']['error']}")
for message in data["data"]:
    print(message["created_at"], message["direction"], message["status"], message["body"])
# More? Repeat with starting_after = data["data"][-1]["id"]
print("has_more:", data["has_more"])

{
  "data": [
    {
      "id": "5f6a7b8c-9d0e-4f1a-8b2c-3d4e5f6a7b8c",
      "direction": "inbound",
      "created_at": "2026-11-10T15:06:41.518204Z",
      "status": "delivered",
      "to": "+14155551234",
      "body": "Thanks! Can we talk tomorrow?",
      "contact_id": "c8a1f4e2-3b9d-4f7c-a8e5-1d2c3b4a5e6f",
      "conversation_id": "3a4b5c6d-7e8f-9a0b-1c2d-3e4f5a6b7c8d",
      "conversation_kind": "one_to_one",
      "chat_guid": null,
      "channel": "imessage",
      "sent_at": "2026-11-10T15:06:40.902Z",
      "held_until": null,
      "held_reason": null,
      "effect": null,
      "reply_to_message_id": null,
      "attachments": []
    },
    {
      "id": "8b3a4e72-1c2d-4e5f-9a0b-2c3d4e5f6a7b",
      "direction": "outbound",
      "created_at": "2026-11-10T15:04:10.112730Z",
      "status": "read",
      "to": "+14155551234",
      "body": "Hey Sam — quick check-in about your order.",
      "contact_id": "c8a1f4e2-3b9d-4f7c-a8e5-1d2c3b4a5e6f",
      "conversation_id": "3a4b5c6d-7e8f-9a0b-1c2d-3e4f5a6b7c8d",
      "conversation_kind": "one_to_one",
      "chat_guid": null,
      "channel": "imessage",
      "sent_at": "2026-11-10T15:04:12.381Z",
      "held_until": null,
      "held_reason": null,
      "effect": null,
      "reply_to_message_id": null,
      "attachments": []
    }
  ],
  "has_more": true
}

{
  "detail": {
    "error": "invalid_cursor",
    "message": "starting_after is not the id of one of your items"
  }
}

{
  "detail": {
    "error": "rate_limited",
    "message": "Too many list requests; wait 18s (limit 120 a minute per account)."
  }
}