Bulk LRN Lookup

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

Features:

• Automatic deduplication (duplicates charged once)
• Two-phase billing (reserve → process → settle)
• Optional CNAM and Trust enrichment per number
• Each included product billed separately

Billing:

• LRN lookup: base price per number
• include_cnam: adds CNAM price per number
• include_trust: adds Spam price per number

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

{
  "job_id": 12345,
  "results": [
    {
      "phone_number": "15555550123",
      "lrn": "15555550123",
      "lrn_activated_at": "2021-09-01T00:00:00+00:00",
      "carrier": "Verizon Wireless",
      "line_type": "mobile",
      "cnam": {
        "caller_name": "ACME CORP"
      },
      "trust": {
        "spam_type": "NONE",
        "reputation_score": 85,
        "trust_level": "high",
        "last_updated": "2026-01-18T12:30:00Z"
      }
    }
  ],
  "summary": {
    "submitted": 10,
    "unique": 8,
    "duplicates_removed": 2,
    "successful": 8
  }
}