Overview

DialRight audits phone numbers before you dial them. Send a number or a list, and every number comes back with a DialRight Score, litigator and Do Not Call flags, reassigned-number status, and line intelligence. Use it to keep TCPA risk, dead numbers, and DNC violations out of a campaign.

Monitoring Platform and Partner Platform live on developers.calleridrep.com.

What a scan returns

Signal	What you get
Confidence	`dialright_score`, 0–100. Higher is more likely live, reachable, and low risk
Litigator risk	`likely_litigator_associated`, `risk_level`, `litigator_name`, `case_reference`, `repeat_filer`, from the TCPA litigator database
Do Not Call	`dnc_fed_number`, `dnc_state_number`, from the federal and state registries
Reassigned or disconnected	`reassigned_numbers_result.contact_disconnected`, from the FCC Reassigned Numbers Database (needs `last_point_contact`)
Line intelligence	`is_valid`, `line_type`, `carrier`, `is_prepaid`, `country_code`, `state`
Business line	`business_associated_number`

Every field is described on the ScanResult schema. The Quickstart has a plain-English table.

How it works

Create an organization API token in the DialRight web app (Authentication).
POST /v1/scan for one number or POST /v1/scan/bulk for up to 1000 numbers per request.
Choose data sources per request, or omit data_sources to run everything.
Read the data array. metadata.cost shows what the scan billed; test_mode: true runs a free dry run with placeholder values.

Billing is per number and per data source, drawn from the organization balance.

Base URL

https://dialright-api.calleridreputation.com
Authorization: Bearer <organization-api-token>

Monitoring Platform API tokens from enterprise.calleridrep.com do not work here.

First request

export DIALRIGHT_TOKEN="YOUR_ORG_API_TOKEN"

curl --request POST \
  --url https://dialright-api.calleridreputation.com/v1/scan/bulk \
  --header "Authorization: Bearer $DIALRIGHT_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "contacts": [
      { "phone_number": "12125550123", "last_point_contact": "2025-06-01" },
      { "phone_number": "13105550199", "last_point_contact": "2025-06-01" }
    ],
    "phone_number_format": "E164",
    "test_mode": true
  }'

Set test_mode to false for real results.

Start here

Path	Use it for
Authentication	Create and rotate organization API tokens
Quickstart	Full request, reading every result field, rate limits
Agents and MCP	Let Claude or Cursor scan lists for you
API reference	Scans, tokens, notification targets, billing, audit logs