Bulk LRN lookup: lists of numbers

curl 'https://verirouteintel.com/api/v1/lrn/bulk' \
  -H "Authorization: Bearer $VRI_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"phone_numbers":["13364086644","19494600638"],"include_enhanced":true}'

Bulk LRN Lookup

Process up to 1000 phone numbers in a single request with automatic deduplication and two-phase billing.

Request Body

{
  "phone_numbers": ["13364086644", "19494600638", "13364086644"],
  "include_enhanced": true,
  "include_messaging": false
}

Response

{
  "job_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "results": [
    {
      "phone_number": "13364086644",
      "e164_phone": "+13364086644",
      "lrn": "13364086644",
      "input_indices": [0, 2],
      "status": "success",
      "enhanced_lrn": { ... }
    },
    {
      "phone_number": "19494600638",
      "e164_phone": "+19494600638",
      "lrn": "19494600638",
      "input_indices": [1],
      "status": "success",
      "enhanced_lrn": { ... }
    }
  ],
  "summary": {
    "submitted": 3,
    "unique": 2,
    "duplicates_removed": 1,
    "succeeded": 2,
    "failed": 0,
    "from_cache": 0,
    "invalid_count": 0,
    "breakdown": {
      "success": 2,
      "failed": 0,
      "invalid_format": 0
    }
  },
  "billing": {
    "estimated_cost": 0.001,
    "actual_cost": 0.001,
    "savings_from_deduplication": 0.0005,
    "per_lookup_rate": 0.0005
  },
  "timing": {
    "submitted_at": "2025-12-20T10:30:00Z",
    "started_at": "2025-12-20T10:30:00Z",
    "completed_at": "2025-12-20T10:30:01Z",
    "duration_ms": 1234
  }
}

Billing values above illustrate two unique LRN lookups at $0.0005 each. Selected add-ons and account pricing can change the total; see current published pricing.

Key Features

• Automatic Deduplication: Duplicate phone numbers are detected and only charged once. The input_indices field shows which positions in your input array map to each result.
• Two-Phase Billing: Balance is reserved before processing and settled after completion. Failed lookups are not charged.
• Invalid Number Handling: Rows that fail validation (impossible area code or exchange, wrong length) are returned with status: "invalid" and a specific error reason. Invalid rows are never charged and are counted in summary.invalid_count.
• Full Transparency: Response includes detailed summary, billing breakdown, and timing information.
• Job Tracking: Each bulk request gets a unique job_id for audit and support purposes.
• Larger Lists — Async Jobs API: For lists beyond 1,000 numbers, POST /api/v1/jobs accepts up to 100,000 numbers (JSON array or CSV upload) and processes them in the background. Poll GET /api/v1/jobs/<job_id> for status, download the result CSV from GET /api/v1/jobs/<job_id>/results, or supply a webhook_url (optionally with a webhook_secret for an HMAC-SHA256 X-Webhook-Signature) to be notified on completion. Same per-lookup pricing; balance is reserved at submission and settled on completion.