sent.dm
Sign In

Phone Number Lookup API: Comprehensive Guide

Overview

The Phone Number Lookup API is your go-to solution for obtaining detailed information about phone numbers, including carrier details, portability status, and fraud detection. This API supports phone numbers in the E.164 format, ensuring global compatibility.

Key Features

  • Carrier Information: Identify the service provider and network type.
  • Fraud Detection: Detect potential fraudulent activity linked to the number.
  • Portability Status: Check if a number has been ported to a different carrier.

Rate Limit

  • Multi-region: 15 requests per 60 seconds

API Base URL

https://www.sent.dm/api

API Endpoints

GET /phone-lookup

Summary

This endpoint allows you to perform a lookup for a phone number in E.164 format. It returns comprehensive data including carrier, portability, and fraud status.

Request Parameters

ParameterInRequiredTypeDescription
phonequerytruestringThe phone number in E.164 format (e.g., +12345678900). Must match the pattern: ^\+[1-9]\d{1,14}$

Response

200 OK

A successful response includes detailed phone number information.

{
  "data": {
    "country_code": "US",
    "national_format": "(234) 567-8900",
    "phone_number": "+12345678900",
    "fraud": null,
    "carrier": {
      "mobile_country_code": "221",
      "mobile_network_code": "01",
      "name": "PTK sh.a./Vala",
      "type": "mobile",
      "error_code": null,
      "normalized_carrier": ""
    },
    "caller_name": null,
    "nnid_override": null,
    "portability": {
      "lrn": "234567XXXX",
      "ported_status": "",
      "ported_date": null,
      "ocn": "6959",
      "line_type": "mobile",
      "spid": "",
      "spid_carrier_name": "CELLCO PARTNERSHIP DBA VERIZON",
      "spid_carrier_type": "",
      "altspid": "",
      "altspid_carrier_name": "",
      "altspid_carrier_type": "",
      "city": "MAHOPAC",
      "state": "New York"
    },
    "valid_number": true,
    "record_type": "number_lookup"
  },
  "poweredBy": "Powered by Sent.dm - [Visit Sent.dm](https://www.sent.dm)"
}

Error Responses

400 Bad Request

Occurs when the phone number format is incorrect.

{
  "error": "Invalid phone number format. Must be in E.164 format."
}

429 Too Many Requests

Triggered when the rate limit is exceeded.

{
  "error": "Rate limit exceeded. Please wait and try again."
}

500 Internal Server Error

Returned when there is an internal error processing the request.

{
  "error": "Failed to retrieve phone data."
}

For more information on the E.164 format, visit the official E.164 documentation.