---
title: "LRN Lookup (POST)"
method: POST
path: "/api/v1/lrn"
tags: ["LRN"]
---

# LRN Lookup (POST)

`POST /api/v1/lrn`

Retrieve Local Routing Number information for a phone number.

Optional parameters allow including CNAM and Trust data in a single request:
- `include_cnam`: Add caller name lookup
- `include_trust`: Add reputation scoring with trust_level (high/medium/low)
- `lrn_only`: Minimal response with only LRN data (overrides other includes)

Each included lookup is billed separately.

## Request body

- object
  - `phone_number` string, required
  - `lrn_only` boolean — Return only LRN data (overrides all other includes)
  - `include_cnam` boolean — Include CNAM caller name data
  - `include_trust` boolean — Include trust/reputation data with reputation_score (0-100) and trust_level (high/medium/low)
  - `include_enhanced_lrn` boolean — Include enhanced carrier and location data
  - `messaging_lookup` boolean — Include messaging provider information

## Response `200`

Successful LRN lookup

- LRNResponseWithIncludes — LRN response with optional CNAM and Trust data
  - `phone_number` string
  - `lrn` string
  - `lrn_activated_at` string, date-time, nullable
  - `carrier` string
  - `line_type` 'mobile' | 'landline' | 'voip' | 'unknown'
  - `enhanced_lrn` object, nullable
    - `carrier` string
    - `carrier_type` string
    - `city` string
    - `state` string
    - `zip_code` string
    - `timezone` string
  - `messaging` object, nullable
    - `messaging_provider` string
    - `messaging_enabled` boolean
    - `messaging_country` string
  - `cnam` CnamData — Caller name information
    - `caller_name` string — Caller ID name
  - `trust` TrustData — Trust and reputation information
    - `is_spam` boolean
    - `is_robocall` boolean
    - `is_scam` boolean
    - `spam_type` 'NONE' | 'SPAM' | 'ROBOCALL' | 'SCAM'
    - `reputation_score` integer
    - `trust_level` 'high' | 'medium' | 'low'
    - `last_updated` string, date-time

## Other responses

- `402` — Insufficient balance
- `429` — Too Many Requests — rate limit exceeded.

---

[API](https://skmtc.dev/verirouteintel/apis/veriroute-intel-api.md) · [All operations](https://skmtc.dev/verirouteintel/apis/veriroute-intel-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/verirouteintel/veriroute-intel-api/revisions/0bd583e1906e/schema)