Get analytics by lead age

Returns the analytics summary split by how old each lead was when it reached Team Follow Up AI: the gap between the moment the sub-account’s CRM created the lead and the moment it was sent to Team Follow Up AI.

fresh: sent within 5 minutes of being created.
warm: more than 5 minutes, under 3 days.
dbr (database reactivation): 3 days or more, such as a lead from an old list being worked again.
unknown: the stored times cannot place the lead in exactly one of the three. unknownReasons counts why. A lead is never guessed into the nearer segment.

Counted the same way as the analytics summary and over the same filters, so the segments add up to it. The one difference is that a disconnected project’s archived totals are not included, because they carry no lead ages.

Allowed customer roles: agency_admin, project_user.

Required API key scope: dashboard:read.

GET

api

dashboard

analytics

lead-age

cURL

curl --request GET \
  --url https://api.teamfollowup.ai/api/dashboard/analytics/lead-age \
  --header 'Authorization: Bearer YOUR_API_KEY'

import requests

url = "https://api.teamfollowup.ai/api/dashboard/analytics/lead-age"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

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

fetch('https://api.teamfollowup.ai/api/dashboard/analytics/lead-age', 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/dashboard/analytics/lead-age",
  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/dashboard/analytics/lead-age"

	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/dashboard/analytics/lead-age")

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,
  "data": {
    "window": {
      "from": "2026-07-01",
      "to": "2026-07-31"
    },
    "definitions": {
      "freshMaxMinutes": 5,
      "dbrMinDays": 3
    },
    "segments": {
      "fresh": {
        "leads": 180,
        "calls": 240,
        "pickups": 150,
        "conversations": 96,
        "inboundCalls": 12,
        "outboundCalls": 228,
        "appointments": 30,
        "transfers": 14,
        "failedTransfers": 3,
        "attemptedTransfers": 17,
        "pickupRate": 62.5,
        "conversationRate": 40,
        "bookingRate": 16.67,
        "transferRate": 9.44,
        "appointmentConversionRate": 31.25
      },
      "warm": {
        "leads": 110,
        "calls": 170,
        "pickups": 80,
        "conversations": 48,
        "inboundCalls": 6,
        "outboundCalls": 164,
        "appointments": 11,
        "transfers": 5,
        "failedTransfers": 2,
        "attemptedTransfers": 7,
        "pickupRate": 47.06,
        "conversationRate": 28.24,
        "bookingRate": 10,
        "transferRate": 6.36,
        "appointmentConversionRate": 22.92
      },
      "dbr": {
        "leads": 100,
        "calls": 160,
        "pickups": 52,
        "conversations": 28,
        "inboundCalls": 4,
        "outboundCalls": 156,
        "appointments": 5,
        "transfers": 2,
        "failedTransfers": 1,
        "attemptedTransfers": 3,
        "pickupRate": 32.5,
        "conversationRate": 17.5,
        "bookingRate": 5,
        "transferRate": 3,
        "appointmentConversionRate": 17.86
      },
      "unknown": {
        "leads": 30,
        "calls": 42,
        "pickups": 16,
        "conversations": 9,
        "inboundCalls": 2,
        "outboundCalls": 40,
        "appointments": 2,
        "transfers": 1,
        "failedTransfers": 0,
        "attemptedTransfers": 1,
        "pickupRate": 38.1,
        "conversationRate": 21.43,
        "bookingRate": 6.67,
        "transferRate": 3.33,
        "appointmentConversionRate": 22.22
      }
    },
    "unknownReasons": {
      "noLeadRecord": 4,
      "noCreationDate": 11,
      "noReceiptDate": 0,
      "straddlesBoundary": 15,
      "createdAfterReceipt": 0
    },
    "totals": {
      "leads": 420,
      "calls": 612,
      "pickups": 298,
      "conversations": 181,
      "inboundCalls": 24,
      "outboundCalls": 588,
      "appointments": 48,
      "transfers": 22,
      "failedTransfers": 6,
      "attemptedTransfers": 28,
      "pickupRate": 48.69,
      "conversationRate": 29.58,
      "bookingRate": 11.43,
      "transferRate": 6.67,
      "appointmentConversionRate": 26.52
    },
    "cached": false,
    "queryTime": 1840,
    "generatedAt": "2026-07-08T16:00:00.000Z"
  }
}

{
  "success": false,
  "error": "BadRequest",
  "message": "Something here doesn't look right. Please check it and try again.",
  "errors": [
    {
      "field": "dateToUTC",
      "code": "FieldInvalid",
      "message": "Please check this and try again."
    }
  ]
}

{
  "success": false,
  "error": "Unauthorized",
  "message": "Please sign in to continue."
}

{
  "success": false,
  "error": "InsufficientScope",
  "message": "This access key does not allow this action. Please ask your account admin to change its permissions.",
  "requiredScope": "dashboard:read"
}

{
  "success": false,
  "error": "TooManyRequests",
  "message": "That's a lot at once. Please wait a moment and try again."
}

{
  "success": false,
  "error": "Internal",
  "message": "Something went wrong on our side. Please try again in a moment.",
  "ref": "3f2b8c1e-7d4a-4f8e-9b6a-2c1d0e5f7a9b"
}

Authorizations

Authorization

string

header

required

Send your API key as Authorization: Bearer YOUR_API_KEY.

Query Parameters

dateFromUTC

string

Start of the reporting window. A UTC ISO 8601 timestamp is canonical; a plain YYYY-MM-DD date is accepted and read as that day at 00:00:00Z. A timestamp must carry Z or an explicit offset, since one without a zone would be read as server-local time and shift the window. An empty string clears the bound. Any other value is refused with 400.

dateToUTC

string

End of the reporting window, inclusive. A UTC ISO 8601 timestamp is canonical; a plain YYYY-MM-DD date is accepted and covers that whole day, through 23:59:59.999Z. A timestamp must carry Z or an explicit offset, since one without a zone would be read as server-local time and shift the window. An empty string clears the bound. Any other value is refused with 400.

projectName

string

Optional display label alongside locationId. It never selects a project. A name sent alone is refused with 400.

Minimum string length: 1

locationId

string

Location ID of the project to read. Required when selecting a project; omit every project selector for an agency-wide read. Project names are labels only and never select a project on their own.

Minimum string length: 1

campaignId

string

Restrict the summary to the leads one campaign dialled. Calls recorded without campaign attribution are not returned by this filter, so an older window can show fewer leads here than an unfiltered read.

Minimum string length: 1

masterCampaignId

string

Restrict the summary to the leads a whole master campaign dialled, across every linked project the user can see. Each linked project runs its own child campaign with its own id, so one campaignId returns only one project's share. Cannot be combined with campaignId. Sending both is a 400.

Minimum string length: 1

agentVariantId

string

Restrict the figures to one Agent Variant inside a split test, so two variants of the same campaign can be compared. Requires campaignId and cannot be combined with masterCampaignId: a variant id only identifies a variant within its own campaign, so an unscoped one has no meaning and is rejected.

Minimum string length: 1

Response

Analytics per lead-age segment.

success

boolean

required

Example:

true

data

object

required

The analytics summary split by lead age.

Show child attributes

cURL

curl --request GET \
  --url https://api.teamfollowup.ai/api/dashboard/analytics/lead-age \
  --header 'Authorization: Bearer YOUR_API_KEY'

import requests

url = "https://api.teamfollowup.ai/api/dashboard/analytics/lead-age"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

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

fetch('https://api.teamfollowup.ai/api/dashboard/analytics/lead-age', 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/dashboard/analytics/lead-age",
  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/dashboard/analytics/lead-age"

	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/dashboard/analytics/lead-age")

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,
  "data": {
    "window": {
      "from": "2026-07-01",
      "to": "2026-07-31"
    },
    "definitions": {
      "freshMaxMinutes": 5,
      "dbrMinDays": 3
    },
    "segments": {
      "fresh": {
        "leads": 180,
        "calls": 240,
        "pickups": 150,
        "conversations": 96,
        "inboundCalls": 12,
        "outboundCalls": 228,
        "appointments": 30,
        "transfers": 14,
        "failedTransfers": 3,
        "attemptedTransfers": 17,
        "pickupRate": 62.5,
        "conversationRate": 40,
        "bookingRate": 16.67,
        "transferRate": 9.44,
        "appointmentConversionRate": 31.25
      },
      "warm": {
        "leads": 110,
        "calls": 170,
        "pickups": 80,
        "conversations": 48,
        "inboundCalls": 6,
        "outboundCalls": 164,
        "appointments": 11,
        "transfers": 5,
        "failedTransfers": 2,
        "attemptedTransfers": 7,
        "pickupRate": 47.06,
        "conversationRate": 28.24,
        "bookingRate": 10,
        "transferRate": 6.36,
        "appointmentConversionRate": 22.92
      },
      "dbr": {
        "leads": 100,
        "calls": 160,
        "pickups": 52,
        "conversations": 28,
        "inboundCalls": 4,
        "outboundCalls": 156,
        "appointments": 5,
        "transfers": 2,
        "failedTransfers": 1,
        "attemptedTransfers": 3,
        "pickupRate": 32.5,
        "conversationRate": 17.5,
        "bookingRate": 5,
        "transferRate": 3,
        "appointmentConversionRate": 17.86
      },
      "unknown": {
        "leads": 30,
        "calls": 42,
        "pickups": 16,
        "conversations": 9,
        "inboundCalls": 2,
        "outboundCalls": 40,
        "appointments": 2,
        "transfers": 1,
        "failedTransfers": 0,
        "attemptedTransfers": 1,
        "pickupRate": 38.1,
        "conversationRate": 21.43,
        "bookingRate": 6.67,
        "transferRate": 3.33,
        "appointmentConversionRate": 22.22
      }
    },
    "unknownReasons": {
      "noLeadRecord": 4,
      "noCreationDate": 11,
      "noReceiptDate": 0,
      "straddlesBoundary": 15,
      "createdAfterReceipt": 0
    },
    "totals": {
      "leads": 420,
      "calls": 612,
      "pickups": 298,
      "conversations": 181,
      "inboundCalls": 24,
      "outboundCalls": 588,
      "appointments": 48,
      "transfers": 22,
      "failedTransfers": 6,
      "attemptedTransfers": 28,
      "pickupRate": 48.69,
      "conversationRate": 29.58,
      "bookingRate": 11.43,
      "transferRate": 6.67,
      "appointmentConversionRate": 26.52
    },
    "cached": false,
    "queryTime": 1840,
    "generatedAt": "2026-07-08T16:00:00.000Z"
  }
}

{
  "success": false,
  "error": "BadRequest",
  "message": "Something here doesn't look right. Please check it and try again.",
  "errors": [
    {
      "field": "dateToUTC",
      "code": "FieldInvalid",
      "message": "Please check this and try again."
    }
  ]
}

{
  "success": false,
  "error": "Unauthorized",
  "message": "Please sign in to continue."
}

{
  "success": false,
  "error": "InsufficientScope",
  "message": "This access key does not allow this action. Please ask your account admin to change its permissions.",
  "requiredScope": "dashboard:read"
}

{
  "success": false,
  "error": "TooManyRequests",
  "message": "That's a lot at once. Please wait a moment and try again."
}

{
  "success": false,
  "error": "Internal",
  "message": "Something went wrong on our side. Please try again in a moment.",
  "ref": "3f2b8c1e-7d4a-4f8e-9b6a-2c1d0e5f7a9b"
}

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 analytics by lead age

Authorizations

Query Parameters

Response