Sign in

v1

latestOpenAPI 3.0.3Proprietary2026-07-13261150.7 KB
CNAM

Bulk CNAM Lookup

Process up to 1,000 CNAM lookups in a single request.

Features:

  • Automatic deduplication (duplicates charged once)
  • Two-phase billing (reserve → process → settle)
  • Job tracking with unique ID
  • Full transparency in response
post/api/v1/cnam/bulk

Request body

phone_numbersstring[] required
include_spamboolean

Include spam detection for each number

Example request

{
  "phone_numbers": [
    "15555550123",
    "15555550124"
  ]
}

Response

Successful bulk CNAM lookup

job_idinteger

Example response

{
  "job_id": 12345,
  "results": [
    {
      "phone_number": "15555550123",
      "cnam": "JOHN DOE",
      "input_indices": [
        0,
        2
      ],
      "status": "success"
    }
  ],
  "summary": {
    "submitted": 10,
    "unique": 8,
    "duplicates_removed": 2,
    "successful": 8
  }
}