Skip to main content
POST
/
v1
/
npn-lookup
Look up NPNs via NIPR
curl --request POST \
  --url https://public.api.live.turrisfi.com/v1/npn-lookup \
  --header 'Content-Type: application/json' \
  --data '
{
  "npns": [
    "1234567",
    "9876543"
  ]
}
'
{
  "data": [
    {
      "npn": "1234567",
      "entityType": "individual",
      "name": "John Doe",
      "residentStates": [
        "CA",
        "TX"
      ],
      "fein": "12-3456789",
      "dateOfBirth": "01/01/1990",
      "error": "<string>"
    }
  ],
  "requestId": "dev-2c5e7cf2-9acf-4c8c-ab2f-b81f39d775a8",
  "timestamp": "2025-11-12T20:49:03.293Z"
}
Accepts an array of 1ā€“20 National Producer Numbers and returns NIPR data for each, indicating whether the NPN belongs to a firm (agency), individual (agent), or is not found. Duplicate NPNs in the request body are deduplicated before lookup. Results are returned for the unique set of NPNs only. Only one request per account can be in progress at a time. If you send a second request while the first is still processing, you will receive a 429 Too Many Requests error.

Body

application/json
ā€‹
npns
string[]
required

Array of National Producer Numbers to look up

Required array length: 1 - 20 elements
Example:
["1234567", "9876543"]

Response

Array of NPN lookup results

ā€‹
data
object[]
required
ā€‹
requestId
string
required

Unique request identifier

Example:

"dev-2c5e7cf2-9acf-4c8c-ab2f-b81f39d775a8"

ā€‹
timestamp
string
required

Response timestamp

Example:

"2025-11-12T20:49:03.293Z"