API v1 overview

​

Base URLs

​

Make your first request

1. Create an API key in the Phonely web app.
2. List the organizations the key can reach:
   curl https://api.us.phonely.ai/v1/organizations \
     -H "Authorization: Bearer $PHONELY_API_KEY"
   
3. Check the response. A key belongs to one organization, so the list has one item:
   {
     "data": [
       {
         "object": "organization",
         "id": "ORGANIZATION_ID",
         "name": "Acme Dental"
       }
     ],
     "next_cursor": null
   }
   

​

What you can do

​

Conventions

• Requests and responses are JSON. Field and parameter names are snake_case, such as customer_phone_number.
• Timestamps are UTC, always in the same format: 2026-10-07T09:12:03.000000Z. Time filters take ISO 8601 with a timezone.
• IDs are strings. Every resource has an object field naming its type, such as "object": "call".
• Every documented field is always in the response. A value that’s missing is null.
• Fixed values, such as statuses and reasons, are lowercase snake_case. New values can be added at any time, so handle values you don’t recognize.
• An unknown request field or query parameter is a 400, so a misspelled filter never passes silently.
• A request body can be up to 1 MB. File uploads have their own limit, documented on the upload endpoint.

​

Request IDs