Endpoint

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

Overview

Get the account behind the calling API key: name, credit balance, and the sending numbers assigned to you.

Response

ok
boolean
true on success.
user_id
string
Your account ID.
name
string | null
Your account name.
credits
number
Current credit balance, used for message sending and number rental. Reply charges can take the balance negative; sending is blocked until it is topped up.
numbers
string[]
Sending numbers assigned to your account — valid values for the from field on POST /v1/messages. Your threads live on these numbers. An empty array means you cannot send iMessages yet — contact the Phones Inc team to get a number assigned.
curl https://sms.phones.inc/v1/me \
  -H "API-KEY: sk_your_api_key"
{
  "ok": true,
  "user_id": "2a1b3c4d-5e6f-7890-abcd-ef0123456789",
  "name": "Acme Corp",
  "credits": 12.5,
  "numbers": ["+15550001111"]
}