Get caller ID status

Every business and calling number you can register, where each one stands, and the form a registration needs.

A number with supported: true can be registered for the business in its locations. When it is false, reason says why in words. registrationState is the state of the registration that covers it, or null.

Pass locationId to read one business. fields lists every detail a registration takes, with its allowed values in options, and termsVersion is the value a registration must echo.

When caller ID is switched off for your account, the answer is { "success": true, "enabled": false } and nothing else.

Required API key scope: phone_numbers:read.

GET

api

phone-trust

summary

cURL

curl --request GET \
  --url https://api.teamfollowup.ai/api/phone-trust/summary \
  --header 'Authorization: Bearer YOUR_API_KEY'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.teamfollowup.ai/api/phone-trust/summary', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.teamfollowup.ai/api/phone-trust/summary",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.teamfollowup.ai/api/phone-trust/summary"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.teamfollowup.ai/api/phone-trust/summary")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "enabled": true,
  "available": true,
  "termsVersion": "caller-trust-2026-10-10",
  "fields": [
    {
      "key": "legalName",
      "step": 1,
      "max": 150,
      "label": "Legal business name"
    }
  ],
  "projects": [
    {
      "locationId": "Cc6UY6Z5DiCwMgnwF0av",
      "name": "Forge Personal Training"
    }
  ],
  "numbers": [
    {
      "number": "+16093551813",
      "locations": [
        "Cc6UY6Z5DiCwMgnwF0av"
      ],
      "projectNames": [
        "Forge Personal Training"
      ],
      "inCampaign": true,
      "supported": true,
      "reason": null,
      "registrationId": null,
      "registrationState": null,
      "spam": {
        "status": "unknown",
        "checkedAt": null,
        "labels": []
      }
    }
  ],
  "registrations": [],
  "pollAfterMs": 30000,
  "problem": null
}

Authorizations

Authorization

string

header

required

Send your API key as Authorization: Bearer YOUR_API_KEY.

Query Parameters

locationId

string

Read only this business (sub-account).

Minimum string length: 1

Response

Where every number stands.

success

boolean

required

enabled

boolean

required

available

boolean

termsVersion

string

fields

object[]

Each detail a registration takes: key, label, max, and options where the value is a choice.

Show child attributes

projects

object[]

Show child attributes

numbers

object[]

Show child attributes

registrations

object[]

Show child attributes

pollAfterMs

integer

problem

object | null

Show child attributes

{key}

any

cURL

curl --request GET \
  --url https://api.teamfollowup.ai/api/phone-trust/summary \
  --header 'Authorization: Bearer YOUR_API_KEY'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.teamfollowup.ai/api/phone-trust/summary', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.teamfollowup.ai/api/phone-trust/summary",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.teamfollowup.ai/api/phone-trust/summary"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.teamfollowup.ai/api/phone-trust/summary")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "enabled": true,
  "available": true,
  "termsVersion": "caller-trust-2026-10-10",
  "fields": [
    {
      "key": "legalName",
      "step": 1,
      "max": 150,
      "label": "Legal business name"
    }
  ],
  "projects": [
    {
      "locationId": "Cc6UY6Z5DiCwMgnwF0av",
      "name": "Forge Personal Training"
    }
  ],
  "numbers": [
    {
      "number": "+16093551813",
      "locations": [
        "Cc6UY6Z5DiCwMgnwF0av"
      ],
      "projectNames": [
        "Forge Personal Training"
      ],
      "inCampaign": true,
      "supported": true,
      "reason": null,
      "registrationId": null,
      "registrationState": null,
      "spam": {
        "status": "unknown",
        "checkedAt": null,
        "labels": []
      }
    }
  ],
  "registrations": [],
  "pollAfterMs": 30000,
  "problem": null
}

Developer setup

Agents

TFU Live

In-call Capabilities

Campaigns

Master agent

Phone Numbers

Caller ID

Voices

Projects

Calls

Contacts

Native Contacts

Native Calendar

Analytics

Billing

Get caller ID status

Authorizations

Query Parameters

Response