​
Endpoint

GET https://sms.phones.inc/v1/threads

​
Overview

List your conversation threads — those on your assigned sending numbers — most recently active first.
If your account has no sending number assigned yet, this returns an empty threads array.

​
Response

​
ok
boolean
true on success.
​
threads
Thread[]
Conversation threads, ordered by most recent activity.
curl https://sms.phones.inc/v1/threads \
  -H "API-KEY: sk_your_api_key"

{
  "ok": true,
  "threads": [
    {
      "thread_id": "0b6f5c1e-8f4a-4f4b-9a2d-3a1c2b3d4e5f",
      "number": "+12315551234",
      "address": "+15551234567",
      "display_name": null,
      "last_text": "Sounds good, see you then!",
      "last_unix_ms": 1765432100000,
      "service": "iMessage"
    },
    {
      "thread_id": "1c7d6e2f-9a5b-4c3d-8e7f-2b3c4d5e6f7a",
      "number": "+12315551234",
      "address": "friend@example.com",
      "display_name": "Alex",
      "last_text": "Thanks!",
      "last_unix_ms": 1765345600000,
      "service": "iMessage"
    }
  ]
}