Phone Number Lookup API

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

Parameter	In	Required	Type	Description
`phone`	query	true	string	The 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.