Trogis Phone API Documentation

Everything you need to integrate phone number validation and parsing into your applications.

Getting Started

The Trogis Phone API allows you to validate and parse international phone numbers from 240+ countries. Whether you need to extract the country code, validate if a number is reachable, or format it into an international E.164 string, this API has you covered.

Features

Country detection
Country code extraction
National number extraction
International formatting
API key authentication
Lightning fast JSON responses

Base URL

text

https://phone.trogis.com/api

Authentication

All requests to the Trogis Phone API require a valid API key. You must include your API key in the headers of your HTTP request.

Header required:

x-api-key: YOUR_API_KEY

bash

curl -X POST https://phone.trogis.com/api/parse-phone \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Phone Lookup API

POST/api/parse-phone

Validate and parse an international phone number. Pass the phone number as a string in the JSON body. It accepts numbers with or without the '+' prefix, and will automatically clean spaces or dashes.

Request Body

json

{
  "phone": "918076068155"
}

Request Example

bash

curl -X POST https://phone.trogis.com/api/parse-phone \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "918076068155"
  }'

Success Response

json

{
  "success": true,
  "countryCode": "91",
  "country": "IN",
  "nationalNumber": "8076068155",
  "fullNumber": "+918076068155",
  "internationalFormat": "+91 80760 68155"
}

Field Descriptions

Field	Description
success	Boolean indicating request success.
countryCode	Detected country dialing code (e.g. "1" or "91").
country	ISO 3166-1 alpha-2 country code (e.g. "US" or "IN").
nationalNumber	Local phone number without the country code.
fullNumber	Normalized E.164 number format, always starting with +.
internationalFormat	Human-readable international format with proper spacing.

Error Responses

When an error occurs, the API will return a non-200 HTTP status code alongside a standard JSON error object.

Missing API Key

json

{
  "success": false,
  "error": "API key is required"
}

Invalid API Key

json

{
  "success": false,
  "error": "Invalid API key"
}

Invalid Phone Number

json

{
  "success": false,
  "error": "Invalid phone number"
}

Missing Phone Number

json

{
  "success": false,
  "error": "Phone number is required"
}

Rate Limits

Free Plan

100

Requests / Day

Developer Plan

10,000

Requests / Day

Enterprise

Custom

Contact Sales

If the limit is exceeded:

json

{
  "success": false,
  "error": "Rate limit exceeded"
}

Code Examples

Node.js (Fetch API)

javascript

const response = await fetch(
  "https://phone.trogis.com/api/parse-phone",
  {
    method: "POST",
    headers: {
      "x-api-key": "YOUR_API_KEY",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      phone: "918076068155"
    })
  }
);

const data = await response.json();
console.log(data);

Make.com Example

Easily integrate with Make.com workflows using the standard HTTP Module.

Module Type:

HTTP - Make a request

URL:

https://phone.trogis.com/api/parse-phone

Method:

POST

Headers:

x-api-key	YOUR_API_KEY
Content-Type	application/json

Request Body (Raw):

json

{
  "phone": "{{phone_number}}"
}

Expected Parsed Output Variables:

countryCodecountrynationalNumberfullNumber

Postman

You can easily import this raw cURL command directly into Postman (File > Import > Raw text).

bash

curl --location --request POST 'https://phone.trogis.com/api/parse-phone' \
--header 'x-api-key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
    "phone": "918076068155"
}'

API Status

Operational

Uptime: 99.9%

Need More Requests?

Upgrade your API key to a developer or enterprise plan to increase your daily limits and support higher volumes.

Get API Key Contact Sales