Hosted SIM API

Accounts

Your account. It's read-only here, because accounts are made in the console.

GET /Accounts/{AccountSid}.json

Read your account.

Read-only in v1, and status is always active through the API.

Returns the account. It's read-only, because accounts are made in the console. status is always active here: a suspended account's credentials get 401 with code 20005 first.

Responses

StatusMeaning
200

The account.

401

Authentication failed (20003), or the account isn't active (20005). This comes before any lookup.

429

Over a rate (20429, with Retry-After in seconds): per account, GET 10/s (burst 30), list pages with PageSize over 50 at 2/s, POST/DELETE 5/s (burst 10); per source IP before auth, 20/s; a gateway-wide ceiling with a fair share per account. Failed auth from one source IP (10/min) also answers 429 with code 20429, for 15 min.

500

An internal error (799999).

Response fields

FieldTypeAlways thereDescription
sid string

AC + 32 hex.

friendly_name string
status string: active

Always active through the API. A suspended account gets 401 / 20005 first.

date_created string

RFC 2822.

date_updated string

RFC 2822.

uri string

Example request

curl -X GET "https://api.dongleswithwings.com/2010-04-01/Accounts/{AccountSid}.json" \
  -u "$ACCOUNT_SID:$AUTH_TOKEN"

Example response

{
  "sid": "ACa61cd972830fc5bc41386edc0a9f8463",
  "friendly_name": "Example Clinic Pty Ltd",
  "status": "active",
  "date_created": "Thu, 15 Oct 2026 01:00:00 +0000",
  "date_updated": "Fri, 16 Oct 2026 02:15:00 +0000",
  "uri": "/2010-04-01/Accounts/ACa61cd972830fc5bc41386edc0a9f8463.json"
}