Phone Numbers

List the phone numbers attached to your Floo workspace. Numbers can be bought from inside the dashboard at /dashboard/numbers; this API is read-only - provisioning happens through the dashboard UI.

List numbers

{
  "data": [
    {
      "id": "pn_abc123",
      "number": "+15551234567",
      "country": "US",
      "type": "local",
      "agent_id": "agt_xyz789",
      "capabilities": {
        "voice": true,
        "sms": true,
        "mms": false
      },
      "created_at": "2026-05-14T10: 30: 00Z"
    }
  ],
  "meta": {
    "total": 1,
    "limit": 50,
    "offset": 0
  }
}

curl https://flooai.com/api/v1/phone-numbers \
  -H "Authorization: Bearer flk_live_xxxxxxxxxxxxxxxx"

Number capabilities

• voice - number can make / receive voice calls (required for agent assignment)
• sms — carrier reports SMS capability; messaging setup is managed separately from voice agent assignment
• mms — carrier reports MMS capability; media messaging setup is managed separately from voice agent assignment

See Calls for outbound dial that uses one of these numbers as the caller-ID.