Active Documentation for /v1

idtbeyond · Company

Company No Auth Free & Open telecom

Our active docs provide the ability to test out your account and to see the responses to your queries. The services are RESTful, and are accessed using standard HTTP methods over a secure HTTPS channel. Requests and responses are currently sent in JSON format, and have a base URL of /v1.

Authentication

No authentication requiredFree to use with no key needed.

Sample Requests

GET Mobile number validation

Checks to verify if the phone number is valid for the country supplied.

https://api.apis.guru/v2/specs/idtbeyond.com/1.1.7/iatu/number-validator?country_code=BR&mobile_number=5521983115555

Hover any highlighted part to learn what it does

Headers — extra info sent with the request

x-idt-beyond-app-id	APP_ID
x-idt-beyond-app-key	APP_KEY

curl -X GET "https://api.apis.guru/v2/specs/idtbeyond.com/1.1.7/iatu/number-validator?country_code=BR&mobile_number=5521983115555" \
  -H "x-idt-beyond-app-id: APP_ID" \
  -H "x-idt-beyond-app-key: APP_KEY"

import requests
params = {
    "country_code": "BR",
    "mobile_number": "5521983115555"
}
headers = {
    "x-idt-beyond-app-id": "APP_ID",
    "x-idt-beyond-app-key": "APP_KEY"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/idtbeyond.com/1.1.7/iatu/number-validator",
    params=params,
    headers=headers,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/idtbeyond.com/1.1.7/iatu/number-validator');
url.searchParams.set('country_code', 'BR');
url.searchParams.set('mobile_number', '5521983115555');

const response = await fetch(url, {
  headers: {
    'x-idt-beyond-app-id': 'APP_ID',
    'x-idt-beyond-app-key': 'APP_KEY'
  },
}); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/idtbeyond.com/1.1.7/iatu/number-validator")
	q := baseURL.Query()
	q.Set("country_code", "BR")
	q.Set("mobile_number", "5521983115555")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)
	req.Header.Set("x-idt-beyond-app-id", "APP_ID")
	req.Header.Set("x-idt-beyond-app-key", "APP_KEY")

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/idtbeyond.com/1.1.7/iatu/number-validator")
uri.query = URI.encode_www_form({
  "country_code" => "BR",
  "mobile_number" => "5521983115555"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)
req["x-idt-beyond-app-id"] = "APP_ID"
req["x-idt-beyond-app-key"] = "APP_KEY"

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/idtbeyond.com/1.1.7/iatu/number-validator?" . http_build_query([
    "country_code" => "BR",
    "mobile_number" => "5521983115555"
]);
$opts = ["http" => [
    "method" => "GET",
    "header" => implode("\r\n", [
        "x-idt-beyond-app-id: APP_ID",
        "x-idt-beyond-app-key: APP_KEY"
    ]),
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

GET Status check

Returns a JSON of the API status.

https://api.apis.guru/v2/specs/idtbeyond.com/1.1.7/status

Hover any highlighted part to learn what it does

Headers — extra info sent with the request

x-idt-beyond-app-id	APP_ID
x-idt-beyond-app-key	APP_KEY

curl -X GET "https://api.apis.guru/v2/specs/idtbeyond.com/1.1.7/status" \
  -H "x-idt-beyond-app-id: APP_ID" \
  -H "x-idt-beyond-app-key: APP_KEY"

import requests
headers = {
    "x-idt-beyond-app-id": "APP_ID",
    "x-idt-beyond-app-key": "APP_KEY"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/idtbeyond.com/1.1.7/status",
    headers=headers,
)
print(response.json())

const url = 'https://api.apis.guru/v2/specs/idtbeyond.com/1.1.7/status';

const response = await fetch(url, {
  headers: {
    'x-idt-beyond-app-id': 'APP_ID',
    'x-idt-beyond-app-key': 'APP_KEY'
  },
}); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	targetURL := "https://api.apis.guru/v2/specs/idtbeyond.com/1.1.7/status"
	req, _ := http.NewRequest("GET", targetURL, nil)
	req.Header.Set("x-idt-beyond-app-id", "APP_ID")
	req.Header.Set("x-idt-beyond-app-key", "APP_KEY")

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/idtbeyond.com/1.1.7/status")

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)
req["x-idt-beyond-app-id"] = "APP_ID"
req["x-idt-beyond-app-key"] = "APP_KEY"

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/idtbeyond.com/1.1.7/status";
$opts = ["http" => [
    "method" => "GET",
    "header" => implode("\r\n", [
        "x-idt-beyond-app-id: APP_ID",
        "x-idt-beyond-app-key: APP_KEY"
    ]),
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

GET Account balance

Returns a JSON of the account balance.

https://api.apis.guru/v2/specs/idtbeyond.com/1.1.7/iatu/balance

Hover any highlighted part to learn what it does

Headers — extra info sent with the request

x-idt-beyond-app-id	APP_ID
x-idt-beyond-app-key	APP_KEY

curl -X GET "https://api.apis.guru/v2/specs/idtbeyond.com/1.1.7/iatu/balance" \
  -H "x-idt-beyond-app-id: APP_ID" \
  -H "x-idt-beyond-app-key: APP_KEY"

import requests
headers = {
    "x-idt-beyond-app-id": "APP_ID",
    "x-idt-beyond-app-key": "APP_KEY"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/idtbeyond.com/1.1.7/iatu/balance",
    headers=headers,
)
print(response.json())

const url = 'https://api.apis.guru/v2/specs/idtbeyond.com/1.1.7/iatu/balance';

const response = await fetch(url, {
  headers: {
    'x-idt-beyond-app-id': 'APP_ID',
    'x-idt-beyond-app-key': 'APP_KEY'
  },
}); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	targetURL := "https://api.apis.guru/v2/specs/idtbeyond.com/1.1.7/iatu/balance"
	req, _ := http.NewRequest("GET", targetURL, nil)
	req.Header.Set("x-idt-beyond-app-id", "APP_ID")
	req.Header.Set("x-idt-beyond-app-key", "APP_KEY")

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/idtbeyond.com/1.1.7/iatu/balance")

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)
req["x-idt-beyond-app-id"] = "APP_ID"
req["x-idt-beyond-app-key"] = "APP_KEY"

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/idtbeyond.com/1.1.7/iatu/balance";
$opts = ["http" => [
    "method" => "GET",
    "header" => implode("\r\n", [
        "x-idt-beyond-app-id: APP_ID",
        "x-idt-beyond-app-key: APP_KEY"
    ]),
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

Postman Setup Guide

Get Postman ↗

See official documentation for authentication and setup.

What can you build with Active Documentation for /v1?

Active Documentation for /v1 is a Company API. Developers commonly use company APIs for:

enriching CRM records with company firmographics
building lead-generation and prospecting tools
verifying business identity and registration details
monitoring competitors and market intelligence
powering B2B data enrichment pipelines

No authentication required. This API is open — no signup or key needed. Ideal for quick prototypes and public-facing features. Active Documentation for /v1 is free to use, making it a low-risk choice to experiment with.

New to APIs? Read our beginner's guide · Learn about API keys · What is REST?

Open documentation ↗