> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getmalakai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Phone Numbers

> Retrieve a list of all phone numbers (callers) associated with your account.

### Headers

<ParamField header="Authorization" type="string" required>
  Your API key for authentication. Prefix with `Bearer `.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'callers' \
    --header 'Authorization: Bearer YOUR_API_KEY'
  ```
</RequestExample>

### Response

The response contains a list of all phone number objects.

<ResponseField name="responseCode" type="number">
  A code indicating the status of the request. `2000` signifies success.
</ResponseField>

<ResponseField name="message" type="string">
  A human-readable message about the request's outcome.
</ResponseField>

<ResponseField name="data" type="object[]">
  An array of phone number objects.
</ResponseField>

<ResponseField name="data[].id" type="string">
  The unique internal identifier for the phone number record.
</ResponseField>

<ResponseField name="data[].user_id" type="string">
  The ID of the user associated with this phone number.
</ResponseField>

<ResponseField name="data[].phone_number" type="string">
  The phone number in E.164 format.
</ResponseField>

<ResponseField name="data[].phone_number_details" type="object">
  A detailed object from the provider (e.g., Twilio) containing comprehensive information about the number.
</ResponseField>

<ResponseField name="data[].phone_number_details.sid" type="string">
  The unique SID from the provider for the phone number resource.
</ResponseField>

<ResponseField name="data[].phone_number_details.friendlyName" type="string">
  The phone number formatted for display (e.g., `(825) 254-9760`).
</ResponseField>

<ResponseField name="data[].phone_number_details.status" type="string">
  The current status of the phone number (e.g., `in-use`).
</ResponseField>

<ResponseField name="data[].phone_number_details.capabilities" type="object">
  An object indicating the capabilities of the number (voice, sms, mms, fax).
</ResponseField>

<ResponseField name="data[].created_at" type="string (ISO 8601)">
  The timestamp when the phone number record was created in your system.
</ResponseField>

<ResponseExample>
  ```json Response theme={null}
  {
      "responseCode": 2000,
      "message": "Phone numbers fetched successfully",
      "data": [
          {
              "id": "***",
              "user_id": "***",
              "phone_number": "+18252549760",
              "phone_number_details": {
                  "sid": "***",
                  "uri": "***",
                  "beta": false,
                  "origin": "twilio",
                  "smsUrl": "",
                  "status": "in-use",
                  "trunkSid": null,
                  "voiceUrl": null,
                  "bundleSid": null,
                  "smsMethod": "POST",
                  "accountSid": "***",
                  "addressSid": null,
                  "apiVersion": "2010-04-01",
                  "dateCreated": "2024-11-11T14:01:05.000Z",
                  "dateUpdated": "2024-11-11T14:01:05.000Z",
                  "identitySid": null,
                  "phoneNumber": "+18252549760",
                  "voiceMethod": "POST",
                  "capabilities": {
                      "fax": false,
                      "mms": true,
                      "sms": true,
                      "voice": true
                  },
                  "friendlyName": "(825) 254-9760",
                  "smsFallbackUrl": "",
                  "statusCallback": "",
                  "emergencyStatus": "Active",
                  "voiceFallbackUrl": null,
                  "smsApplicationSid": "",
                  "smsFallbackMethod": "POST",
                  "addressRequirements": "none",
                  "emergencyAddressSid": null,
                  "voiceApplicationSid": null,
                  "voiceCallerIdLookup": false,
                  "voiceFallbackMethod": "POST",
                  "statusCallbackMethod": "POST",
                  "emergencyAddressStatus": "unregistered"
              },
              "created_at": "2024-11-11T14:01:08.087Z",
              "updated_at": "2024-11-11T14:01:08.087Z"
          }
      ]
  }
  ```
</ResponseExample>