API Documentation - NOTALIVEX

Getting Started

The NOTALIVEX API provides programmatic access to OSINT data. All responses are JSON.

Base URL: https://notalivex.org/api

Protocol

HTTPS

All requests must use HTTPS

Format

JSON

All responses are JSON encoded

Method

GET

All search endpoints use GET

Encoding

UTF-8

URL-encode non-ASCII parameters

Quick Start

1. Register at notalivex.org/register.
2. Get your API token from the Dashboard.
3. Include the token in every request header.

curl -H "x-api-token: YOUR_TOKEN" \
  "https://notalivex.org/api/mx/clave_elector/ABCD123456HDFXYZ01"

const response = await fetch(
  "https://notalivex.org/api/mx/clave_elector/ABCD123456HDFXYZ01",
  { headers: { "x-api-token": "YOUR_TOKEN" } }
);
const data = await response.json();
console.log(data);

import requests

headers = {"x-api-token": "YOUR_TOKEN"}
r = requests.get(
    "https://notalivex.org/api/mx/clave_elector/ABCD123456HDFXYZ01",
    headers=headers
)
print(r.json())

require 'net/http'
require 'json'
require 'uri'

uri = URI("https://notalivex.org/api/mx/clave_elector/ABCD123456HDFXYZ01")
req = Net::HTTP::Get.new(uri)
req["x-api-token"] = "YOUR_TOKEN"
res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(req) }
puts JSON.parse(res.body)

$ch = curl_init("https://notalivex.org/api/mx/clave_elector/ABCD123456HDFXYZ01");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-api-token: YOUR_TOKEN"]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
print_r($data);

package main

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

func main() {
    req, _ := http.NewRequest("GET", "https://notalivex.org/api/mx/clave_elector/ABCD123456HDFXYZ01", nil)
    req.Header.Set("x-api-token", "YOUR_TOKEN")
    client := &http.Client{}
    resp, _ := client.Do(req)
    defer resp.Body.Close()
    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

use reqwest;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = reqwest::Client::new();
    let resp = client
        .get("https://notalivex.org/api/mx/clave_elector/ABCD123456HDFXYZ01")
        .header("x-api-token", "YOUR_TOKEN")
        .send()
        .await?
        .text()
        .await?;
    println!("{}", resp);
    Ok(())
}

Authentication

Every API request must include your API token via the x-api-token header.

x-api-token: YOUR_API_TOKEN_HERE

Security: Never expose your token in client-side code or public repos. Use environment variables or a server-side proxy.

Tokens do not expire — regenerate from the dashboard if compromised.
Both web dashboard and API token requests consume credits per successful query.
Two Argentina endpoints (/api/ar/dni, /api/ar/nombre) are free via the web dashboard only.

Response Format

All API endpoints return JSON with a consistent envelope structure.

Success Response

{
  "success": true,
  "data": {
    "key": "value",
    ...
  }
}

Error Response

{
  "success": false,
  "error": "Descriptive error message"
}

The success boolean indicates whether the query completed without errors. When false, an error string describes the issue. Credits are only deducted when success is true.

Rate Limits

Rate limits vary per endpoint to ensure fair usage and protect upstream data sources.

Global IP Limit

60/min

Per IP across all endpoints

AR Nombre Cooldown

4 min

Per user per identical name search

Response Headers

X-Rate*

Limit, Remaining, Reset

On 429

Backoff

Use exponential backoff + retry

Rate limit headers included in every response:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1700000060

Excessive automated requests may result in temporary rate limiting. Contact us if you need higher limits.

Error Codes

Common HTTP status codes returned by the API and their meanings.

Code	Meaning	Cause
200	OK	Query successful, result returned
400	Bad Request	Invalid or missing parameters
401	Unauthorized	Missing or invalid `x-api-token` header
403	Forbidden	Token lacks sufficient credits (→ top up)
404	Not Found	No results found for the given query
429	Too Many Requests	Rate limit exceeded (see Rate Limits)
500	Server Error	Internal error — retry later or contact support

Error Response Format

{
  "success": false,
  "message": "Detailed error description",
  "error_code": "ERROR_CODE"
}

Error Code	Meaning
`INVALID_TOKEN`	API token missing or invalid
`INSUFFICIENT_CREDITS`	Account has 0 credits
`ACCOUNT_DISABLED`	Account suspended
`RATE_LIMIT_EXCEEDED`	Too many requests
`CAPTCHA_REQUIRED`	CAPTCHA verification required (web only)
`CAPTCHA_INVALID`	Invalid or expired CAPTCHA token
`NO_RESULTS`	Search returned no matching records

Only HTTP 200 responses trigger a credit deduction. Errors are free.

Credits & Costs

Credits are deducted only on successful (HTTP 200) responses. Errors, 404s, and rate-limited requests do not deduct credits.

Note: /api/ar/dni and /api/ar/nombre are free via web dashboard (cost 0). Via API token they cost 1 credit. RENAPER endpoints cost 2 credits (web) or 3 credits (API).

Country	Endpoint	Type	Credits
🇲🇽 Mexico	`/api/mx/rfc/:rfc`	RFC	1
🇲🇽 Mexico	`/api/mx/curp/:curp`	CURP	1
🇲🇽 Mexico	`/api/mx/nombre/:nombre`	Full Name	1
🇲🇽 Mexico	`/api/mx/telefono/:telefono`	Phone	1
🇲🇽 Mexico	`/api/mx/email/:email`	Email	1
🇲🇽 Mexico	`/api/mx/clave_elector/:clave`	Clave Elector	1
🇲🇽 Mexico	`/api/mx/registro_ine/:registro`	Registro INE	1
🇲🇽 Mexico	`/api/mx/imei/:imei`	IMEI	1
🇲🇽 Mexico	`/api/mx2/curp/:curp`	CURP (mx2)	1
🇲🇽 Mexico	`/api/mx2/telefono/:telefono`	Phone (mx2)	1
🇲🇽 Mexico	`/api/mx2/placa/:placa`	Plate (mx2)	1
🇦🇷 Argentina	`/api/ar/dni/:dni`	DNI	0 web / 1 api
🇦🇷 Argentina	`/api/ar/telefono/:telefono`	Phone	1
🇦🇷 Argentina	`/api/ar/email/:email`	Email	1
🇦🇷 Argentina	`/api/ar/patente/:patente`	License Plate	1
🇦🇷 Argentina	`/api/ar/nombre/:nombre`	Name (Nosis)	0 web / 1 api
🇦🇷 Argentina (RENAPER)	`/api/ar_rena/dni/:dni`	DNI [RENAPER]	2 web / 3 api
🇦🇷 Argentina (RENAPER)	`/api/ar_rena/renaper/:dni/:sexo`	DNI + Sex	2 web / 3 api
🇦🇷 Argentina (SAMARITAN)	`/api/samaritan/argentina/informe?dni=`	Full Report	4
🇦🇷 Argentina (SAMARITAN)	`/api/samaritan/argentina/familiares?dni=`	Relatives	4
🇦🇷 Argentina (SAMARITAN)	`/api/samaritan/argentina/dni-telefono?dni=`	DNI-Phone	4
🇦🇷 Argentina (SAMARITAN)	`/api/samaritan/argentina/telefono?telefono=`	Phone	4
🇦🇷 Argentina (SAMARITAN)	`/api/samaritan/argentina/deudas?dni=`	Debts	4
🇦🇷 Argentina (SAMARITAN)	`/api/samaritan/argentina/vehiculo-patente?patente=`	Vehicle by Plate	4
🇦🇷 Argentina (SAMARITAN)	`/api/samaritan/argentina/busqueda?nombre=&apellido=`	Advanced Search	2 web / 2 api
🇦🇷 Argentina (SAMARITAN)	`/api/samaritan/argentina/direccion?direccion=`	Address	2 web / 2 api
🇦🇷 Argentina (SAMARITAN)	`/api/samaritan/argentina/buscador-domicilios?direccion_domicilio=`	Address Finder	2 web / 2 api
🇦🇷 Argentina (SAMARITAN)	`/api/samaritan/argentina/provincias-municipios?provincia=`	Provinces/Municipalities	2 web / 2 api
🇦🇷 Argentina (SAMARITAN)	`/api/samaritan/argentina/subsidios?dni=`	Subsidies	2 web / 2 api
🇦🇷 Argentina (SAMARITAN)	`/api/samaritan/argentina/familiares-telefono?telefono=`	Relatives by Phone	2 web / 2 api
🇦🇷 Argentina (SAMARITAN)	`/api/samaritan/argentina/vehiculos-dni?dni=`	Vehicles by DNI	2 web / 2 api
🇦🇷 Argentina (SAMARITAN)	`/api/samaritan/argentina/corte-electoral?dni=`	Electoral Court	2 web / 2 api
🇦🇷 Argentina (SAMARITAN)	`/api/samaritan/argentina/fallecidos?dni=`	Deceased	2 web / 2 api
🇦🇷 Argentina (SAMARITAN)	`/api/samaritan/argentina/renaper-id?idpersona=`	Renaper ID	2 web / 2 api
🇨🇱 Chile	`/api/cl/rut/:rut`	RUT	1
🇨🇱 Chile	`/api/cl/nombre/:nombre`	Name	1
🇨🇱 Chile	`/api/cl/telefono/:telefono`	Phone	1
🇨🇱 Chile (SAMARITAN)	`/api/samaritan/chile/busqueda?nombres=&apellidos=`	Name	4
🇨🇱 Chile (SAMARITAN)	`/api/samaritan/chile/busqueda-avanzado?nombre=&apellido=&comuna=`	Advanced Search	2 web / 2 api
🇨🇱 Chile (SAMARITAN)	`/api/samaritan/chile/rut?rut=`	RUT	2 web / 2 api
🇨🇱 Chile (SAMARITAN)	`/api/samaritan/chile/rut-verificador?rut=`	RUT Validator	2 web / 2 api
🇧🇷 Brazil	`/api/br/cpf/:cpf`	CPF	1
🇧🇷 Brazil	`/api/br/nombre/:nombre`	Name	1
🇧🇷 Brazil	`/api/br/fone/:fone`	Phone	1
🇨🇴 Colombia	`/api/co/documento/:documento`	Documento	1
🇨🇴 Colombia	`/api/co/nombre/:nombre`	Name	1
🇨🇴 Colombia	`/api/co/telefono/:telefono`	Phone	1
🇨🇴 Colombia	`/api/co/email/:email`	Email	1
🇨🇴 Colombia (3)	`/api/co3/consulta/:documento`	Document	1
🇨🇴 Colombia (3)	`/api/co3/consulta-placa/:placa`	Plate	1
🇨🇴 Colombia (3)	`/api/co3/secop/:documento`	SECOP Contracts	1
🇨🇴 Colombia (3)	`/api/co3/nequi/:numero`	Nequi Phone	1
🇨🇴 Colombia	`/api/colombia/informe?cedula=`	Report (Cédula)	1
🇨🇴 Colombia (2)	`/api/co2/cedula/:cedula`	Cédula	1
🇨🇴 Colombia (2)	`/api/co2/nombre/:nombre`	Name	1
🇨🇴 Colombia (2)	`/api/co2/telefono/:telefono`	Phone	1
🇨🇴 Colombia (2)	`/api/co2/email/:email`	Email	1
🇵🇪 Peru	`/api/pe/dni/:dni`	DNI	1
🇵🇪 Peru	`/api/pe/nombre/:nombre`	Name	1
🇵🇪 Peru	`/api/pe/nombre2/:nombre`	Name [DB2]	1
🇵🇪 Peru	`/api/pe/telefono/:telefono`	Phone	1
🇵🇪 Peru	`/api/pe/placa/:placa`	License Plate	1
🇵🇪 Peru	`/api/pe/email/:email`	Email	1
🇵🇪 Peru (SAMARITAN)	`/api/samaritan/peru/busqueda?nombres=&apellidos=`	Name	4
🇵🇪 Peru (SAMARITAN)	`/api/samaritan/peru/informe?documento=`	Full Report	4
🇵🇪 Peru (SAMARITAN)	`/api/samaritan/peru/telefono?telefono=`	Phone	4
🇵🇪 Peru (SAMARITAN)	`/api/samaritan/peru/documento?documento=`	Document	2 web / 2 api
🇵🇪 Peru (SAMARITAN)	`/api/samaritan/peru/familiares?documento=`	Relatives	2 web / 2 api
🇵🇪 Peru (SAMARITAN)	`/api/samaritan/peru/telefono-documento?documento=`	Phone by Document	2 web / 2 api
🇵🇪 Peru (SAMARITAN)	`/api/samaritan/peru/vehiculos?placa=`	Vehicles	2 web / 2 api
🇵🇪 Peru (PE2)	`/api/pe2/arbol-txt?dni=`	Family Tree	4
🇵🇪 Peru (PE2)	`/api/pe2/reniec?dni=`	RENIEC	4
🇪🇨 Ecuador	`/api/ec/cedula/:cedula`	Cédula	1
🇪🇨 Ecuador	`/api/ec/nombre/:nombre`	Name	1
🇪🇨 Ecuador (SAMARITAN)	`/api/samaritan/ecuador/cedula?cedula=`	Cédula	2 web / 2 api
🇪🇨 Ecuador (SAMARITAN)	`/api/samaritan/ecuador/busqueda?nombres=`	Search	2 web / 2 api
🇪🇨 Ecuador (SAMARITAN)	`/api/samaritan/ecuador/vehiculos?numero_de_documento=`	Vehicles	2 web / 2 api
🇻🇪 Venezuela	`/api/ve/cedula/:cedula`	Cédula	1
🇻🇪 Venezuela	`/api/ve/nombre/:nombre`	Name	1
🇻🇪 Venezuela (SAMARITAN)	`/api/samaritan/venezuela/documento?cedula=`	Document	2 web / 2 api
🇻🇪 Venezuela (SAMARITAN)	`/api/samaritan/venezuela/busqueda?nombre_completo=&genero=`	Search	2 web / 2 api
🇻🇪 Venezuela (SAMARITAN)	`/api/samaritan/venezuela/busqueda-avanzada?nombre_completo=&genero=`	Advanced Search	2 web / 2 api
🇻🇪 Venezuela (SAMARITAN)	`/api/samaritan/venezuela/informe?cedula=`	Full Report	2 web / 2 api
🇻🇪 Venezuela (SAMARITAN)	`/api/samaritan/venezuela/consulta-policial?cedula=`	Police Query	2 web / 2 api
🇻🇪 Venezuela (SAMARITAN)	`/api/samaritan/venezuela/busqueda-policial?nombres=`	Police Search	2 web / 2 api
🇻🇪 Venezuela (SAMARITAN)	`/api/samaritan/venezuela/movistar?cedula=`	Movistar	2 web / 2 api
🇻🇪 Venezuela (SAMARITAN)	`/api/samaritan/venezuela/carnet-patria?cedula=`	Carnet de la Patria	2 web / 2 api
🇻🇪 Venezuela (SAMARITAN)	`/api/samaritan/venezuela/imagen-policial?cedula=`	Police Image	2 web / 2 api
🇻🇪 Venezuela (SAMARITAN)	`/api/samaritan/venezuela/ipsfa?cedula=`	IPSFA	2 web / 2 api
🇻🇪 Venezuela (SAMARITAN)	`/api/samaritan/venezuela/busqueda-ipsfa?nombre=`	IPSFA Search	2 web / 2 api
🇺🇾 Uruguay	`/api/uy/cedula/:cedula`	Cédula	1
🇺🇾 Uruguay	`/api/uy/nombre/:nombre`	Name	1
🇺🇾 Uruguay	`/api/uy/telefono/:telefono`	Phone	1
🇺🇾 Uruguay	`/api/uy/email/:email`	Email	1
🇺🇾 Uruguay (SAMARITAN)	`/api/samaritan/uruguay/busqueda?nombre_apellido=`	Name	4
🇺🇾 Uruguay (SAMARITAN)	`/api/samaritan/uruguay/cedula?cedula=`	Cédula	4
🇺🇾 Uruguay (SAMARITAN)	`/api/samaritan/uruguay/ceibal?cedula=`	Ceibal	4
🇺🇾 Uruguay (SAMARITAN)	`/api/samaritan/uruguay/contactos?cedula=`	Contacts	4
🇺🇾 Uruguay (SAMARITAN)	`/api/samaritan/uruguay/familiares?cedula=`	Relatives	4
🇺🇾 Uruguay (SAMARITAN)	`/api/samaritan/uruguay/informe?cedula=`	Full Report	4
🇺🇾 Uruguay (SAMARITAN)	`/api/samaritan/uruguay/telefono-cedula?cedula=`	Phone by Cédula	4
🇺🇾 Uruguay (SAMARITAN)	`/api/samaritan/uruguay/multas?matricula=`	Fines	2 web / 2 api
🇺🇾 Uruguay (SAMARITAN)	`/api/samaritan/uruguay/multas-mapa?matricula=`	Fines Map	2 web / 2 api
🇺🇾 Uruguay (SAMARITAN)	`/api/samaritan/uruguay/direcciones?cedula=`	Addresses	2 web / 2 api
🇺🇾 Uruguay (SAMARITAN)	`/api/samaritan/uruguay/propietario-telefono?telefono=`	Owner by Phone	2 web / 2 api
🇺🇾 Uruguay (SAMARITAN)	`/api/samaritan/uruguay/busqueda-ceibal?nombre_apellido=`	Ceibal Search	2 web / 2 api
🇺🇾 Uruguay (SAMARITAN)	`/api/samaritan/uruguay/historial-ceibal?nombre_apellido=`	Ceibal History	2 web / 2 api
🇺🇾 Uruguay (SAMARITAN)	`/api/samaritan/uruguay/escolaridad?cedula=`	Schooling	2 web / 2 api
🇺🇾 Uruguay (SAMARITAN)	`/api/samaritan/uruguay/registro-estudiante?documento=`	Student Registry	2 web / 2 api
🇺🇾 Uruguay (SAMARITAN)	`/api/samaritan/uruguay/historial-educativo?cedula=`	Educational History	2 web / 2 api
🇺🇾 Uruguay (SAMARITAN)	`/api/samaritan/uruguay/cursos-estudiantes?centro=&anio=`	Student Courses	2 web / 2 api
🇺🇾 Uruguay (SAMARITAN)	`/api/samaritan/uruguay/busqueda-estudiantil?nombre=`	Student Search	2 web / 2 api
🇺🇾 Uruguay (SAMARITAN)	`/api/samaritan/uruguay/busqueda-primaria?anio_lectivo=&nivel_clase=&codigo_clase=&numeroescuela=&departamento=`	Primary Search	2 web / 2 api
🇺🇾 Uruguay (SAMARITAN)	`/api/samaritan/uruguay/registro-primaria?cedula=`	Primary Registry	2 web / 2 api
🇺🇾 Uruguay (SAMARITAN)	`/api/samaritan/uruguay/huellas?cedula=`	Fingerprints	2 web / 2 api
🇧🇴 Bolivia	`/api/bo/documento/:documento`	Documento	1
🇧🇴 Bolivia	`/api/bo/nombre/:nombre`	Name	1
🇧🇴 Bolivia	`/api/bo/telefono/:telefono`	Phone	1
🇵🇾 Paraguay	`/api/pa/cedula/:cedula`	Cédula	1
🇵🇾 Paraguay	`/api/pa/nombre/:nombre`	Name	1
🇵🇾 Paraguay	`/api/pa/celular/:celular`	Mobile	1
🇵🇾 Paraguay	`/api/pa/telefono/:telefono`	Phone	1
🇵🇾 Paraguay	`/api/pa/email/:email`	Email	1
🇵🇾 Paraguay (SAMARITAN)	`/api/samaritan/paraguay/documentos?cedula=`	Documents	2 web / 2 api
🇵🇾 Paraguay (SAMARITAN)	`/api/samaritan/paraguay/busqueda?nombres=&apellido=`	Search	2 web / 2 api
🇵🇾 Paraguay (SAMARITAN)	`/api/samaritan/paraguay/huellas?cedula=`	Fingerprints	2 web / 2 api
🇨🇷 Costa Rica	`/api/samaritan/costa-rica/impuestos?documento=`	Taxes	2 web / 2 api
🇨🇷 Costa Rica	`/api/samaritan/costa-rica/domicilio?documento=`	Domicile	2 web / 2 api
🇨🇷 Costa Rica	`/api/samaritan/costa-rica/ciudadano?documento=`	Citizen	2 web / 2 api
🇨🇷 Costa Rica	`/api/samaritan/costa-rica/ciudadano-v2?documento=`	Citizen V2	2 web / 2 api
🇨🇷 Costa Rica	`/api/samaritan/costa-rica/busqueda?nombres=&apellido_paterno=`	Search	2 web / 2 api
🇩🇴 Dominican Rep.	`/api/rd/cedula/:cedula`	Cédula	1
🇩🇴 Dominican Rep.	`/api/rd/nombre/:nombre`	Name	1
🇸🇻 El Salvador	`/api/sv/dui/:dui`	DUI	1
🇸🇻 El Salvador	`/api/sv/nombre/:nombre`	Name	1
🇸🇻 El Salvador	`/api/sv/telefono/:telefono`	Phone	1
🇸🇻 El Salvador	`/api/sv/placa/:placa`	License Plate	1
🇸🇻 El Salvador	`/api/sv/email/:email`	Email	1
🇨🇦 Canada	`/api/ca/email/:email`	Email	1
🇨🇦 Canada	`/api/ca/nombre/:nombre`	Name	1
🇨🇦 Canada	`/api/ca/telefono/:telefono`	Phone	1
🇺🇸 USA	`/api/us/nombre/:nombre`	Name	1
🇺🇸 USA	`/api/us/telefono/:telefono`	Phone	1
🇺🇸 USA	`/api/us/email/:email`	Email	1
🇪🇸 Spain	`/api/es/legal/:legal`	Legal (DNI/NIE/CIF)	1
🇪🇸 Spain	`/api/es/nombre/:nombre`	Name	1
🇪🇸 Spain	`/api/es/email/:email`	Email	1
🇪🇸 Spain	`/api/es/telefono/:telefono`	Phone	1
🇪🇸 Spain DB	`/api/spaindb/search/name/:name`	Name	2
🇪🇸 Spain DB	`/api/spaindb/search/dni/:dni`	DNI	2
🇪🇸 Spain DB	`/api/spaindb/search/phone/:phone`	Phone	2
🇪🇸 Spain DB	`/api/spaindb/search/email/:email`	Email	2
🇷🇺 Russia	`/api/ru/nombre/:nombre`	Name	1
🇷🇺 Russia	`/api/ru/placa/:placa`	License Plate	1
🇷🇺 Russia	`/api/ru/telefono/:telefono`	Phone	1
🇷🇺 Russia	`/api/ru/email/:email`	Email	1
🇵🇭 Philippines	`/api/ph/nombre/:nombre`	Name	1
🇵🇭 Philippines	`/api/ph/telefono/:telefono`	Phone	1
🇵🇭 Philippines	`/api/ph/email/:email`	Email	1
Instagram DB	`/api/instagram/username/:username`	Username	1
Instagram DB	`/api/instagram/email/:email`	Email	1
Instagram DB	`/api/instagram/telefono/:telefono`	Phone	1
Telegram	`/api/tg/telefono/:telefono`	Phone	1
Telegram	`/api/tg/id/:id`	Telegram ID	1
Telegram	`/api/tg/username/:username`	Username	1
Telegram BH	`/api/osint/tg/username/:q`	Username BH	1
Telegram BH	`/api/osint/tg/id/:q`	ID BH	1
Telegram BH	`/api/osint/tg/phone/:q`	Phone BH	1
Instagram BH	`/api/osint/instagram/lookup/:username`	Username	1
Discord	`/api/osint/dc/user/:userid`	User BH	1
Discord	`/api/osint/dc/snowflake/:snowflake`	Snowflake BH	1
Discord	`/api/osint/discord/cordcat/:user`	CordCat	1
Discord	`/api/osint/discord/seeknow/:user`	SeekNow	1
Discord	`/api/osint/discord/eyegod/:user`	EyeGod	1
Discord	`/api/osint/discord/oathnet/:user`	OathNet	1
Discord	`/api/osint/discord/seekria/:user`	Seekria	1
Discord	`/api/osint/cordcat/user/:user`	CordCat direct	1
Discord	`/api/osint/cordcat/invite/:code`	Invite	1
Discord	`/api/osint/seeknow/discord/:user`	SeekNow direct	1
Discord	`/api/osint/seeknow/discord2rb/:user`	Discord2Roblox	1
Discord	`/api/osint/seekria/discord_profile/:user`	Seekria Profile	1
Discord	`/api/osint/seekria/discord_rat/:user`	Seekria RAT	1
Snapchat	`/api/osint/snapchat/lookup/:username`	Username	1
TikTok	`/api/osint/tiktok/recon/:username`	Recon	1
TikTok	`/api/osint/seeknow/tiktok/:username`	SeekNow	1
GitHub	`/api/osint/seeknow/github/:username`	SeekNow	1
Twitter/X	`/api/osint/seeknow/twitter/:username`	SeekNow	1
Reddit	`/api/osint/seeknow/reddit/:username`	SeekNow	1
Social	`/api/osint/seeknow/social/:username`	SeekNow	1
Minecraft	`/api/osint/seekria/minecraft/:username`	Seekria	1
Minecraft	`/api/osint/oathnet/minecraft/:username`	OathNet	1
Minecraft	`/api/osint/seeknow/minecraft/:username`	SeekNow	1
Roblox	`/api/osint/seekria/roblox/:username`	Seekria	1
Roblox	`/api/osint/oathnet/roblox/:username`	OathNet	1
Roblox	`/api/osint/seeknow/roblox/:username`	SeekNow	1
Xbox	`/api/osint/oathnet/xbox/:gamertag`	OathNet	1
Xbox	`/api/osint/seeknow/xbox/:gamertag`	SeekNow	1
Steam	`/api/osint/oathnet/steam/:steamid`	OathNet	1
FiveM	`/api/osint/seekria/fivem/:identifier`	Seekria	1
Medal.tv	`/api/osint/medal/lookup/:username`	Username	1
Room101	`/api/osint/room101/user/:username`	User	1
Room101	`/api/osint/room101/search/:query`	Search	1
EyeGod	`/api/eg/v2/query/:type/:value`	Query	1

OSINT Tools & Breach Databases — all 1 credit each via the unified route /api/osint/:service/:type/:query:

Service	Search Types	Example
IntelVault	email, stealer, breaches	`/api/osint/intelvault/email/:e`
BreachBase	email	`/api/osint/breachbase/email/:e`
BreachDirectory	email	`/api/osint/breachdirectory/email/:e`
OSINTCat	email	`/api/osint/osintcat/email/:e`
HudsonRock	email, domain, domain_overview, username, ip, keyword	`/api/osint/hudsonrock/email/:e`
Seekria	email_osint, email_breach, phone, domain, domain_username, footprint, ip, dns, discord_profile, roblox, minecraft, fivem	`/api/osint/seekria/email_osint/:e`
LeakCheck	email	`/api/osint/leakcheck/email/:e`
Snusbase	domain, combo, hash, ip	`/api/osint/snusbase/domain/:e`
OathNet	holehe, ghunt, breach, stealer, roblox, steam, xbox, minecraft	`/api/osint/oathnet/holehe/:e`
Inf0Sec	search	`/api/osint/inf0sec/search/:q`
Shodan	host, search, dns, honeyscore	`/api/osint/shodan/host/:q`
SeekNow	discord, github, twitter, tiktok, reddit, social, xbox, roblox, minecraft, ip, email, phone, domain	`/api/osint/seeknow/discord/:q`
Room101	user, search	`/api/osint/room101/user/:q`
CordCat	user, invite, ip	`/api/osint/cordcat/user/:q`
SEON	email, phone, ip	`/api/osint/seon/email/:q`
Medal.tv	lookup	`/api/osint/medal/lookup/:q`
PropertyRadar	search	`/api/osint/propertyradar/search/:q`
Cloud	domain, email	`/api/leaks/search/domain/:q`
Instagram BH	lookup	`/api/osint/instagram/lookup/:q`
Snapchat	lookup	`/api/osint/snapchat/lookup/:q`
TikTok	recon	`/api/osint/tiktok/recon/:q`
EyeGod	18 core + 10 v2 + 22 osint/infra + 34 enterprise types	`/api/eg/v2/query/email/:e`

Credits are only deducted on successful (200 OK) responses. Contact us on Discord to purchase credits.

🇲🇽 Mexico

Search Mexican records by RFC, CURP, Clave Elector, Registro INE, name, phone, or email.

GET/api/mx/rfc/:rfc 1 credit

Search by RFC (Registro Federal de Contribuyentes).

GET/api/mx/curp/:curp 1 credit

Search by CURP (Clave Única de Registro de Población).

GET/api/mx/clave_elector/:clave 1 credit

Search by Clave Elector (INE voter ID).

Example Response

{
  "success": true,
  "data": {
    "CLAVE_ELECTOR": "ABCD123456HDFXYZ01",
    "NOM_COMPLETO": "JUAN PEREZ GARCIA",
    "FECHA_NACIMIENTO": "1990-01-15",
    "SEXO": "H",
    "CALLE": "AV REVOLUCION 123",
    "COLONIA": "CENTRO",
    "MUNICIPIO": "GUADALAJARA",
    "ESTADO": "JALISCO",
    "CP": "44100"
  }
}

GET/api/mx/registro_ine/:registro 1 credit

Search by Registro INE.

GET/api/mx/nombre/:nombre 1 credit

Search by full name. Returns multiple matching records.

GET/api/mx/telefono/:telefono 1 credit

Search by phone number.

GET/api/mx/email/:email 1 credit

Search by email address.

GET/api/mx/imei/:imei 1 credit

Search by IMEI (device identifier).

GET/api/mx2/curp/:curp 1 credit

Search by CURP via mx2 (INE).

GET/api/mx2/telefono/:telefono 1 credit

Search by phone number via mx2 (Telcel).

GET/api/mx2/placa/:placa 1 credit

Search by license plate via mx2 (Repuve).

🇦🇷 Argentina

Primary source via Nosis. RENAPER source available for government-grade records with mandatory sex parameter.

GET/api/ar/dni/:dni 0 web / 1 api

Search by DNI (Documento Nacional de Identidad).

Example Response

{
  "success": true,
  "data": {
    "dni": "12345678",
    "nombre": "MARIA GONZALEZ",
    "fecha_nacimiento": "1985-03-20",
    "domicilio": "AV CORRIENTES 1234",
    "provincia": "BUENOS AIRES"
  }
}

GET/api/ar/telefono/:telefono 1 credit

Search by phone number with area code.

GET/api/ar/email/:email 1 credit

Search by email address.

GET/api/ar/patente/:patente 1 credit

Search by license plate (Patente).

GET/api/ar/nombre/:nombre 0 web / 1 api

Search by full name via Nosis. Requires minimum 3 words with 4+ letters each. A 4-minute cooldown applies per user between searches.

GET/api/ar_rena/dni/:dni 2 web / 3 api

Search by DNI via RENAPER (National Registry).

GET/api/ar_rena/renaper/:dni/:sexo 2 web / 3 api

Search by DNI + Sex via RENAPER. Sex must be M or F.

Example

GET /api/ar_rena/renaper/12345678/M

SAMARITAN Argentina (Enhanced)

Enhanced Argentine data via Latam Quality Consulting. Uses query parameters.

These endpoints need more than one parameter. Sending only the name/DNI is not enough — the data source rejects the request with "Debe proporcionar al menos un parámetro de búsqueda".

Complete parameter reference

Endpoint	Required parameters	Optional parameters
argentina/informe	`dni`required	`info_signo`, `limpio`, `extras`, `familiares_extra`, `registro_vehicular_avanzado` — boolean toggles: `activado` / `desactivado`
argentina/familiares	`dni`required	`limpio`, `avanzado` — `activado` / `desactivado`
argentina/dni-telefono	`dni`required	—
argentina/telefono	`telefono`required	—
argentina/deudas	`dni`required	—
argentina/vehiculo-patente	`patente`required	—
argentina/renaper-id	`idpersona`required	—
argentina/corte-electoral	`dni`required	—
argentina/vehiculos-dni	`dni`required	`avanzado` — `activado` / `desactivado`
argentina/familiares-telefono	`telefono`required	`limpio` — `activado` / `desactivado`
argentina/provincias-municipios	`provincia`	—
argentina/busqueda	`nombre` `apellido`required or a date / age filter	`fecha_nacimiento`, `anio`, `mes`, `dia`, `edad`, `edad_desde`, `edad_hasta`, `municipio`, `provincia`, `signo`, `info_signo`, `exactitud` (`exacto`), `limpio`
argentina/subsidios	`dni` `plan`required	—
argentina/direccion	`direccion` `provincia`required	`municipio`, `piso_apartamento`, `limite` (default `100`)
argentina/buscador-domicilios	`numero_de_puerta` `provincia`required	`municipio`, `direccion_domicilio`, `limite` (default `50`)
argentina/fallecidos	`dni` or `cuil`required	—

Gateway limitation: the public gateway currently forwards only one query parameter per endpoint for the following routes, so the extra parameters below are accepted but not yet relayed upstream — argentina/busqueda, argentina/subsidios, argentina/direccion, argentina/buscador-domicilios. Use them as soon as relaying is enabled.

GET/api/samaritan/argentina/informe?dni=12345678 4 credits

Full report by DNI.

Parameters

Parameter	Required	Values	Description
dni	yes	8 digits	Documento Nacional de Identidad
limpio	no	activado / desactivado	Clean output without extra noise
extras	no	activado / desactivado	Include additional record blocks
familiares_extra	no	activado / desactivado	Extended relatives data
registro_vehicular_avanzado	no	activado / desactivado	Advanced vehicle registry
info_signo	no	activado / desactivado	Include zodiac sign information

GET/api/samaritan/argentina/familiares?dni=12345678 4 credits

Relatives lookup by DNI.

GET/api/samaritan/argentina/dni-telefono?dni=12345678 4 credits

Find phone numbers linked to a DNI.

GET/api/samaritan/peru/telefono?telefono=51999123456 4 credits

Lookup owner info by phone number.

GET/api/samaritan/argentina/deudas?dni=12345678 4 credits

Debt/credit history by DNI.

GET/api/samaritan/argentina/vehiculo-patente?patente=AA123BB 4 credits

Vehicle info by license plate (Patente).

GET/api/samaritan/argentina/busqueda?nombre=JUAN&apellido=PEREZ 2 credits

Advanced search by first name and last name. Both nombre and apellido are required.

Parameters

Parameter	Required	Values	Description
nombre	yes	text	First name(s)
apellido	yes	text	Last name(s)
fecha_nacimiento	no	DD/MM/YYYY	Date of birth filter
anio	no	YYYY	Birth year filter
mes	no	1-12	Birth month filter
dia	no	1-31	Birth day filter
edad	no	number	Exact age filter
edad_desde	no	number	Minimum age
edad_hasta	no	number	Maximum age
municipio	no	text	City / municipality filter
provincia	no	text	Province filter
signo	no	text	Zodiac sign filter
exactitud	no	exacto	Match accuracy mode
limpio	no	activado / desactivado	Clean output
info_signo	no	activado / desactivado	Include zodiac sign data

Example

curl -G 'https://notalivex.org/api/samaritan/argentina/busqueda' \
  --data-urlencode 'nombre=JUAN' \
  --data-urlencode 'apellido=PEREZ' \
  -H 'x-api-token: YOUR_API_TOKEN'

GET/api/samaritan/argentina/direccion?direccion=AV+CORRIENTES+1234&provincia=BUENOS+AIRES 2 credits

Address lookup. Both direccion and provincia are required.

Parameters

Parameter	Required	Values	Description
direccion	yes	text	Street name or address
provincia	yes	text	Province name
municipio	no	text	City / municipality
piso_apartamento	no	text	Floor or apartment
limite	no	number	Max results (default `100`)

GET/api/samaritan/argentina/buscador-domicilios?numero_de_puerta=1234&provincia=BUENOS+AIRES 2 credits

Address finder by street number. numero_de_puerta and provincia are both required — direccion_domicilio is only an extra filter.

Parameters

Parameter	Required	Values	Description
numero_de_puerta	yes	number	Street number to look up
provincia	yes	text	Province filter
municipio	no	text	City / municipality filter
direccion_domicilio	no	text	Street text filter
limite	no	number	Max results (default `50`)

GET/api/samaritan/argentina/provincias-municipios?provincia=BUENOS+AIRES 2 credits

Provinces / municipalities by province name.

GET/api/samaritan/argentina/subsidios?dni=12345678&plan=TODOS 2 credits

Government subsidies by DNI. Both dni and plan are required.

Parameters

Parameter	Required	Values	Description
dni	yes	8 digits	Documento Nacional de Identidad
plan	yes	text	Subsidy plan name, e.g. `TODOS`

GET/api/samaritan/argentina/familiares-telefono?telefono=1155551234 2 credits

Relatives of the owner of a phone number.

GET/api/samaritan/argentina/vehiculos-dni?dni=12345678 2 credits

Vehicles registered to a DNI.

GET/api/samaritan/argentina/corte-electoral?dni=12345678 2 credits

Electoral court records by DNI.

GET/api/samaritan/argentina/fallecidos?dni=12345678 2 credits

Deceased individuals by DNI or CUIL. At least one of the two is required.

Parameters

Parameter	Required	Values	Description
dni	one of	8 digits	Documento Nacional de Identidad
cuil	one of	11 digits	Clave Única de Identidad Laboral, e.g. `27-30111222-5`

GET/api/samaritan/argentina/renaper-id?idpersona=12345678 2 credits

Records by Renaper ID (idpersona).

GET/api/samaritan/argentina/telefono?telefono=1122334455 4 credits

Phone lookup by phone number.

Parameters

Parameter	Required	Values	Description
telefono	yes	10-11 digits	Phone number, with or without the `+` prefix

🇨🇱 Chile

Search Chilean records by RUT, name, or phone.

GET/api/cl/rut/:rut 1 credit

Search by RUT (Rol Único Tributario). Format: 12345678-9.

GET/api/cl/nombre/:nombre 1 credit

Search by full name.

GET/api/cl/telefono/:telefono 1 credit

Search by phone number.

SAMARITAN Chile (Enhanced)

Enhanced Chilean data via Latam Quality Consulting. Uses query parameters.

Use plural name fields. chile/busqueda needs nombres, apellidos or fecha_nacimiento — the singular nombre and apellido are rejected on their own with "Debes proporcionar al menos nombres, apellidos o fecha_nacimiento". nombre_apellido is accepted as a convenience and is forwarded as nombres, so the web form keeps working. fecha_nacimiento must be DD/MM/YYYY — YYYY-MM-DD is rejected.

Complete parameter reference

Endpoint	Required parameters	Optional parameters
chile/busqueda	`nombres` or `apellidos` or `fecha_nacimiento`at least one `nombre_apellido` also works — sent as `nombres`. Singular `nombre`/`apellido` are accepted as aliases	`limite` (default `20`)
chile/busqueda-avanzado	`nombre_apellido` or `nombre` + `apellido` or `nombres` or `comuna` or `municipio` or `provincia`at least one	`apellidos`, `limite` (default `20`) — a geographic filter works on its own, without a name
chile/rut	`rut`required	`avanzado` — `activado` / `desactivado` (default `activado`)
chile/rut-verificador	`rut`required	—

No gateway limitation. All four Chile endpoints forward their full parameter set.

GET/api/samaritan/chile/busqueda?nombres=JUAN&apellidos=PEREZ 4 credits

Search by first name and last name. Use the plural field names nombres and apellidos; the singular nombre/apellido are accepted only as aliases. nombre_apellido is forwarded as nombres, so the web form works too.

Parameters

Parameter	Required	Values	Description
nombres	one of	text	First name(s)
apellidos	one of	text	Last name(s)
fecha_nacimiento	one of	DD/MM/YYYY	Date of birth. `YYYY-MM-DD` is rejected by the provider
nombre_apellido	no	text	Full name, sent as `nombres`
limite	no	number	Max results (default `20`)

Examples

# the web form
curl -G 'https://notalivex.org/api/samaritan/chile/busqueda' \
  --data-urlencode 'nombre_apellido=JUAN PEREZ' \
  -H 'x-api-token: YOUR_API_TOKEN'

# precise match, capped results
curl -G 'https://notalivex.org/api/samaritan/chile/busqueda' \
  --data-urlencode 'nombres=JUAN' \
  --data-urlencode 'apellidos=PEREZ' \
  --data-urlencode 'limite=5' \
  -H 'x-api-token: YOUR_API_TOKEN'

GET/api/samaritan/chile/busqueda-avanzado?nombre_apellido=JUAN+PEREZ&comuna=SANTIAGO 2 credits

Advanced search by name and/or location. A geographic filter works on its own, without a name.

Parameters

Parameter	Required	Values	Description
nombre_apellido	one of	text	Full name, first and last
nombre	no	text	First name
apellido	no	text	Last name
nombres	no	text	First name(s), plural form
apellidos	no	text	Last name(s), plural form
comuna	no	text	Commune filter, e.g. `SANTIAGO`
municipio	no	text	Municipality filter
provincia	no	text	Province / region filter
limite	no	number	Max results (default `20`)

Example

curl -G 'https://notalivex.org/api/samaritan/chile/busqueda-avanzado' \
  --data-urlencode 'nombres=JUAN' \
  --data-urlencode 'apellidos=PEREZ' \
  --data-urlencode 'comuna=SANTIAGO' \
  --data-urlencode 'limite=5' \
  -H 'x-api-token: YOUR_API_TOKEN'

GET/api/samaritan/chile/rut?rut=12345678-9 2 credits

Lookup by RUT.

Parameters

Parameter	Required	Values	Description
rut	yes	12345678-9	Rol Único Tributario
avanzado	no	activado / desactivado	Extended record detail

GET/api/samaritan/chile/rut-verificador?rut=12345678-9 2 credits

Validate a RUT and return its verification digit.

Parameters

Parameter	Required	Values	Description
rut	yes	123456789	ROL without the verification digit

🇧🇷 Brazil

Search Brazilian records by CPF, name, or phone.

GET/api/br/cpf/:cpf 1 credit

Search by CPF (Cadastro de Pessoas Físicas). Accepted: 123.456.789-00 or 12345678900.

GET/api/br/nombre/:nombre 1 credit

Search by full name.

GET/api/br/fone/:fone 1 credit

Search by phone number (fone).

🇨🇴 Colombia

Three independent sources available: co, co2 and co3 (Colombia 3). Try the others if one returns no results.

GET/api/co/documento/:documento 1 credit

Search by national document (Cédula de Ciudadanía).

GET/api/co/nombre/:nombre 1 credit

Search by full name.

GET/api/co/telefono/:telefono 1 credit

Search by phone number.

GET/api/co/email/:email 1 credit

Search by email address.

Colombia 2 (alternate source)

GET/api/co2/cedula/:cedula 1 credit

Search by Cédula [CO2].

GET/api/co2/nombre/:nombre 1 credit

Search by full name [CO2].

GET/api/co2/telefono/:telefono 1 credit

Search by phone [CO2].

GET/api/co2/email/:email 1 credit

Search by email [CO2].

Colombia 3 (co3)

GET/api/co3/consulta/:documento 1 credit

Search by national document (Cédula).

GET/api/co3/consulta-placa/:placa 1 credit

Search by license plate (Placa).

GET/api/co3/secop/:documento 1 credit

Search SECOP government contracts by document (Cédula/NIT).

GET/api/co3/nequi/:numero 1 credit

Look up Nequi account by phone number.

Report by cédula

GET/api/colombia/informe?cedula=23533467 1 credit

Full report by Cédula (consulta ANI). This query can take up to 3 minutes.

🇵🇪 Peru

Search Peruvian records by DNI, name (two sources), phone, license plate, or email.

GET/api/pe/dni/:dni 1 credit

Search by DNI (8-digit Peruvian national ID).

GET/api/pe/nombre/:nombre 1 credit

Search by full name.

GET/api/pe/nombre2/:nombre 1 credit

Search by full name via alternate database [DB2].

GET/api/pe/telefono/:telefono 1 credit

Search by phone number.

GET/api/pe/placa/:placa 1 credit

Search by license plate (Placa).

GET/api/pe/email/:email 1 credit

Search by email address.

SAMARITAN Peru (Enhanced)

Enhanced Peruvian data via Latam Quality Consulting. Uses query parameters.

peru/busqueda needs two parameters. Sending nombres alone returns "Se requiere nombres y apellidos". Always send nombres and apellidos.

Complete parameter reference

Endpoint	Required parameters	Optional parameters
peru/busqueda	`nombres` `apellidos`required	`info_signo` — `activado` / `desactivado`, `limite` (default `50`)
peru/informe	`documento`required	`avanzado` — `activado` / `desactivado`
peru/documento	`documento`required	—
peru/familiares	`documento`required	`info_signo`, `version_2` — `activado` / `desactivado`, `limite` (default `10`)
peru/telefono	`telefono`required	`reniec` — `activado` / `desactivado`
peru/telefono-documento	`documento`required	`reniec` — `activado` / `desactivado`
peru/vehiculos	`placa` or `tarjeta`required	`vidente`

Gateway limitation: the public gateway currently forwards only one query parameter per endpoint for peru/busqueda, peru/informe, peru/familiares and peru/vehiculos, so the extra parameters below are accepted but not yet relayed upstream. Use them as soon as relaying is enabled.

GET/api/samaritan/peru/busqueda?nombres=JUAN&apellidos=PEREZ 4 credits

Search by first name and last name. Both nombres and apellidos are required.

Parameters

Parameter	Required	Values	Description
nombres	yes	text	First name(s)
apellidos	yes	text	Last name(s)
info_signo	no	activado / desactivado	Include zodiac sign data
limite	no	number	Max results (default `50`)

Example

curl -G 'https://notalivex.org/api/samaritan/peru/busqueda' \
  --data-urlencode 'nombres=JUAN' \
  --data-urlencode 'apellidos=PEREZ' \
  -H 'x-api-token: YOUR_API_TOKEN'

GET/api/samaritan/peru/informe?documento=12345678 4 credits

Full report by document number.

Parameters

Parameter	Required	Values	Description
documento	yes	8 digits	DNI / document number
avanzado	no	activado / desactivado	Extended record detail

GET/api/samaritan/peru/telefono?telefono=51999123456 4 credits

Lookup owner info by phone number.

Parameters

Parameter	Required	Values	Description
telefono	yes	9-11 digits	Phone number with country code
reniec	no	activado / desactivado	Include RENIEC registry data

GET/api/samaritan/peru/documento?documento=12345678 2 credits

Lookup by document number.

Parameters

Parameter	Required	Values	Description
documento	yes	8 digits	DNI / document number

GET/api/samaritan/peru/familiares?documento=12345678 2 credits

Relatives lookup by document number.

Parameters

Parameter	Required	Values	Description
documento	yes	8 digits	DNI / document number
version_2	no	activado / desactivado	Use the v2 relatives dataset
info_signo	no	activado / desactivado	Include zodiac sign data
limite	no	number	Max results (default `10`)

GET/api/samaritan/peru/telefono-documento?documento=12345678 2 credits

Phone by document number.

Parameters

Parameter	Required	Values	Description
documento	yes	8 digits	DNI / document number
reniec	no	activado / desactivado	Include RENIEC registry data

GET/api/samaritan/peru/vehiculos?placa=ABC123 2 credits

Vehicles by license plate or by tarjeta de propiedad.

Parameters

Parameter	Required	Values	Description
placa	one of	ABC123	License plate
tarjeta	one of	text	Número de tarjeta de propiedad
vidente	no	text	Plate-side text for OCR matching

Peru (PE2)

Peruvian genealogy and national registry via PE2. Uses query parameters.

GET/api/pe2/arbol-txt?dni=12345678 4 credits

Family tree by DNI.

GET/api/pe2/reniec?dni=12345678 4 credits

RENIEC records by DNI.

🇪🇨 Ecuador

GET/api/ec/cedula/:cedula 1 credit

Search by Cédula (10-digit Ecuadorian national ID).

GET/api/ec/nombre/:nombre 1 credit

Search by full name.

SAMARITAN Ecuador (Enhanced)

Enhanced Ecuadorian data via Latam Quality Consulting. Uses query parameters.

Correct parameter name. ecuador/busqueda does not accept nombre. Use nombres (or apellidos), otherwise you get "Debe proporcionar al menos uno de los parámetros: 'nombres' o 'apellidos'".

Complete parameter reference

Endpoint	Required parameters	Optional parameters
ecuador/busqueda	`nombres` or `apellidos`required	`edad`, `edad_desde`, `edad_hasta`, `limite` (default `30`)
ecuador/cedula	`cedula`required	—
ecuador/vehiculos	`numero_de_documento` or `numero_de_placa`required	`limite` (default `50`)

Gateway limitation: the public gateway currently forwards only one query parameter per endpoint for ecuador/busqueda and ecuador/vehiculos, so the extra parameters below are accepted but not yet relayed upstream. Use them as soon as relaying is enabled.

GET/api/samaritan/ecuador/cedula?cedula=1234567890 2 credits

Lookup by Cédula (SAMARITAN).

Parameters

Parameter	Required	Values	Description
cedula	yes	10 digits	Cédula de Identidad

GET/api/samaritan/ecuador/busqueda?nombres=JUAN&apellidos=PEREZ 2 credits

Search by first name and last name. The accepted field names are nombres and apellidos.

Parameters

Parameter	Required	Values	Description
nombres	yes	text	First name(s)
apellidos	no	text	Last name(s)
edad	no	number	Exact age filter
edad_desde	no	number	Minimum age
edad_hasta	no	number	Maximum age
limite	no	number	Max results (default `30`)

Example

curl -G 'https://notalivex.org/api/samaritan/ecuador/busqueda' \
  --data-urlencode 'nombres=JUAN' \
  --data-urlencode 'apellidos=PEREZ' \
  -H 'x-api-token: YOUR_API_TOKEN'

GET/api/samaritan/ecuador/vehiculos?numero_de_documento=1234567890 2 credits

Vehicles by document number or plate (SAMARITAN).

Parameters

Parameter	Required	Values	Description
numero_de_documento	one of	10 digits	Cédula of the owner
numero_de_placa	one of	ABC123	License plate
limite	no	number	Max results (default `50`)

🇻🇪 Venezuela

GET/api/ve/cedula/:cedula 1 credit

Search by Cédula de Identidad. Include V- or E- prefix if applicable.

GET/api/ve/nombre/:nombre 1 credit

Search by full name.

SAMARITAN Venezuela (Enhanced)

Enhanced Venezuelan data via Latam Quality Consulting. Uses query parameters.

Search needs genero. nombre_completo on its own returns "Debe proporcionar al menos un parámetro de búsqueda". Always send nombre_completo and genero (Masculino or Femenino).

Complete parameter reference

Endpoint	Required parameters	Optional parameters
venezuela/busqueda	`nombre_completo` `genero`required	`estado_civil`, `limite` (default `30`)
venezuela/busqueda-avanzada	`nombre_completo` `genero`required	`estado_civil`, `dia`, `mes`, `anio`, `edad`, `edad_desde`, `edad_hasta`, `anio_desde`, `anio_hasta`, `signo`, `info_signo`, `limite` (default `30`)
venezuela/documento	`cedula`required	—
venezuela/informe	`cedula` or `telefono`	—
venezuela/consulta-policial	`cedula`required	—
venezuela/busqueda-policial	`nombres` `apellidos`required	`limite` (default `30`)
venezuela/movistar	`cedula` `numero_de_telefono`required	—
venezuela/carnet-patria	`cedula`required	—
venezuela/imagen-policial	`cedula`required	`tipo_imagen` — `Funcionario`, `Civil` or both (comma separated). Defaults to both.
venezuela/ipsfa	`cedula`required	—
venezuela/busqueda-ipsfa	`nombre`required	`apellido`, `grado_militar`, `limite` (default `30`)

Gateway limitation: the public gateway currently forwards only one query parameter per endpoint for venezuela/busqueda, venezuela/busqueda-avanzada, venezuela/informe, venezuela/movistar and venezuela/imagen-policial, so the extra parameters below are accepted but not yet relayed upstream. Use them as soon as relaying is enabled.

GET/api/samaritan/venezuela/busqueda?nombre_completo=JUAN+PEREZ&genero=Masculino 2 credits

Search by full name and gender. Both nombre_completo and genero are required.

Parameters

Parameter	Required	Values	Description
nombre_completo	yes	text	Full name
genero	yes	Masculino / Femenino	Gender
estado_civil	no	text	Marital status filter
limite	no	number	Max results (default `30`)

Example

curl -G 'https://notalivex.org/api/samaritan/venezuela/busqueda' \
  --data-urlencode 'nombre_completo=JUAN PEREZ' \
  --data-urlencode 'genero=Masculino' \
  -H 'x-api-token: YOUR_API_TOKEN'

GET/api/samaritan/venezuela/busqueda-avanzada?nombre_completo=JUAN+PEREZ&genero=Masculino 2 credits

Advanced search by full name and gender, with optional date, age and sign filters.

Parameters

Parameter	Required	Values	Description
nombre_completo	yes	text	Full name
genero	yes	Masculino / Femenino	Gender
dia	no	1-31	Birth day filter
mes	no	1-12	Birth month filter
anio	no	YYYY	Birth year filter
edad	no	number	Exact age filter
edad_desde	no	number	Minimum age
edad_hasta	no	number	Maximum age
anio_desde	no	YYYY	Minimum year
anio_hasta	no	YYYY	Maximum year
signo	no	text	Zodiac sign filter
estado_civil	no	text	Marital status filter
info_signo	no	activado / desactivado	Include zodiac sign data
limite	no	number	Max results (default `30`)

GET/api/samaritan/venezuela/documento?cedula=V-12345678 2 credits

Lookup by Cédula (SAMARITAN).

Parameters

Parameter	Required	Values	Description
cedula	yes	V-12345678 / E-12345678	Cédula de Identidad

GET/api/samaritan/venezuela/informe?cedula=V-12345678 2 credits

Full report by Cédula (SAMARITAN).

Parameters

Parameter	Required	Values	Description
cedula	one of	V-12345678	Cédula de Identidad
telefono	one of	0412-1234567	Phone number

GET/api/samaritan/venezuela/consulta-policial?cedula=V-12345678 2 credits

Police query by Cédula (SAMARITAN).

Parameters

Parameter	Required	Values	Description
cedula	yes	V-12345678	Cédula de Identidad

GET/api/samaritan/venezuela/busqueda-policial?nombres=JUAN&apellidos=PEREZ 2 credits

Police search by first name and last name.

Parameters

Parameter	Required	Values	Description
nombres	yes	text	First name(s)
apellidos	yes	text	Last name(s)
limite	no	number	Max results (default `30`)

GET/api/samaritan/venezuela/movistar?cedula=V-12345678&numero_de_telefono=04121234567 2 credits

Movistar records by Cédula and phone number.

Parameters

Parameter	Required	Values	Description
cedula	yes	V-12345678	Cédula de Identidad
numero_de_telefono	yes	04121234567	Movistar line number

GET/api/samaritan/venezuela/carnet-patria?cedula=V-12345678 2 credits

Carnet de la Patria by Cédula (SAMARITAN).

Parameters

Parameter	Required	Values	Description
cedula	yes	V-12345678	Cédula de Identidad

GET/api/samaritan/venezuela/imagen-policial?cedula=V-12345678 2 credits

Police image by Cédula (SAMARITAN). Returns both Funcionario and Civil photos in base64 by default.

Parameters

Parameter	Required	Values	Description
cedula	yes	V-12345678	Cédula de Identidad
tipo_imagen	no	Funcionario / Civil / Funcionario,Civil	Which photo(s) to return. Defaults to both.

GET/api/samaritan/venezuela/ipsfa?cedula=V-12345678 2 credits

IPSFA records by Cédula (SAMARITAN).

Parameters

Parameter	Required	Values	Description
cedula	yes	V-12345678	Cédula de Identidad

GET/api/samaritan/venezuela/busqueda-ipsfa?nombre=JUAN&apellido=PEREZ 2 credits

IPSFA search by name (SAMARITAN).

Parameters

Parameter	Required	Values	Description
nombre	yes	text	First name(s)
apellido	no	text	Last name(s)
grado_militar	no	text	Military rank filter
limite	no	number	Max results (default `30`)

🇺🇾 Uruguay

GET/api/uy/cedula/:cedula 1 credit

Search by Cédula de Identidad.

GET/api/uy/nombre/:nombre 1 credit

Search by full name.

GET/api/uy/telefono/:telefono 1 credit

Search by phone number.

GET/api/uy/email/:email 1 credit

Search by email address.

SAMARITAN Uruguay (Enhanced)

Enhanced Uruguayan data via Latam Quality Consulting. Uses query parameters.

Uruguay has the strictest parameter rules in the API. uruguay/busqueda needs at least one real search term — nombre, apellidos, departamento or fechanacimiento. The remaining parameters are filters and are ignored on their own, so sending only edad, signo or genero returns "Debe proporcionar al menos un parámetro de búsqueda". cursos-estudiantes needs centro and anio, and busqueda-primaria needs five parameters.

Complete parameter reference

Endpoint	Required parameters	Optional parameters
uruguay/busqueda	`nombre` or `apellidos` or `departamento` or `fechanacimiento`at least one `nombre_apellido` also works — it is normalised to `nombre`	filters (need a search term): `departamento`, `fechanacimiento` (`DD/MM/YYYY` or `YYYY-MM-DD`), `dia`, `mes`, `anio`, `edad`, `edad_desde`, `edad_hasta`, `anio_desde`, `anio_hasta`, `signo`, `genero`, `numero_liceo`, `nombre_utu`, `numero_escuela`, `nombre_censurado` options: `modo_busqueda` (`exacta` / `libre`, default `libre`), `info_signo`, `historial_instituciones_educativas`, `fue_a_primaria`, `fue_a_liceo`, `fue_a_utu`, `fue_a_udelar` — toggles: `activado` / `desactivado`
uruguay/cedula	`cedula`required	`verificador`, `censurada` — `activado` / `desactivado`
uruguay/ceibal	`cedula`required	`historial_de_dispositivos`, `foto_de_perfil` — `activado` / `desactivado`
uruguay/contactos	`cedula`required	`avanzado` — `activado` / `desactivado`
uruguay/familiares	`cedula`required	`avanzado` — `activado` / `desactivado`
uruguay/informe	`cedula`required	`nivel_del_informe` (default `ultra`)
uruguay/telefono-cedula	`cedula`required	—
uruguay/direcciones	`cedula`required	`ultima_actualizaciones` — `activado` / `desactivado`
uruguay/propietario-telefono	`telefono`required	`persona_relacionada` — `activado` / `desactivado`
uruguay/multas	`matricula`required	`intervenido`, `solo_informacion`
uruguay/multas-mapa	`matricula`required	`intervenido`
uruguay/cursos-estudiantes	`centro` `anio`required	`grupo`, `curso`, `limit` (default `20`)
uruguay/busqueda-primaria	`anio_lectivo` `nivel_clase` `codigo_clase` `numeroescuela` `departamento`all 5	`limit` (default `30`)
uruguay/busqueda-estudiantil	`nombre` `apellidos` or a school / date filter	`numero_liceo`, `nombre_utu`, `numero_escuela`, `departamento`, `fechanacimiento`, `dia`, `mes`, `anio`, `edad`, `edad_desde`, `edad_hasta`, `anio_desde`, `anio_hasta`, `signo`, `tipo_de_curso`, `fue_a_primaria`, `fue_a_liceo`, `fue_a_utu`, `info_signo`, `historial_instituciones_educativas`, `registros_avanzados`, `registros_primaria`, `limit` (default `20`)
uruguay/busqueda-ceibal	`nombre_apellido` or an institution filter	`nombre_institucion_educativa`, `tipo_de_usuario`, `cursos`, `direccion_institucion`, `grupos`, `nombre_logros`, `descripcion_logros`, `subnota`, `crea_info`, `limite` (default `20`)
uruguay/historial-ceibal	`nombre_apellido` or a device filter	`nombre`, `apellido`, `numero_serie_dispositivo`, `fecha_asignacion_desde`, `fecha_asignacion_hasta`, `limite` (default `20`)
uruguay/escolaridad	`cedula`required	`ids`
uruguay/registro-estudiante	`documento`required	`ocultar_reuniones`, `ocultar_inasistencias`, `avanzado` — `activado` / `desactivado`
uruguay/historial-educativo	`cedula`required	`registros_avanzados` (default `activado`), `registros_primaria` (default `desactivado`)
uruguay/registro-primaria	`cedula`required	—
uruguay/huellas	`cedula` or `correo_electronico` or `numero_de_telefono`	—

Gateway limitation: the public gateway currently forwards only one query parameter per endpoint for uruguay/cursos-estudiantes, uruguay/busqueda-primaria, uruguay/busqueda-estudiantil, uruguay/busqueda-ceibal, uruguay/historial-ceibal, uruguay/escolaridad, uruguay/huellas, uruguay/multas and uruguay/multas-mapa, so the extra parameters below are accepted but not yet relayed upstream. Use them as soon as relaying is enabled. uruguay/busqueda is not affected — it forwards its full parameter set.

GET/api/samaritan/uruguay/busqueda?nombre_apellido=JUAN+PEREZ 4 credits

Advanced Uruguayan people search. Send at least one search term (nombre, apellidos, departamento or fechanacimiento); every other parameter is a filter and is ignored on its own. nombre_apellido is accepted and normalised to nombre, so the web form and the API behave the same.

Search terms — at least one required

Parameter	Type	Description
nombre	string	First name, e.g. `Carlos`
apellidos	string	Last name, e.g. `Fernandez`
nombre_apellido	string	Full name, e.g. `Maria Gonzalez` — normalised to `nombre`
departamento	enum	Artigas, Canelones, Cerro Largo, Colonia, Durazno, Flores, Florida, Lavalleja, Montevideo, Paysandú, Rivera, Rocha, Salto, San José, Soriano, Tacuarembó, Treinta y Tres
fechanacimiento	string	Date of birth, `DD/MM/YYYY` or `YYYY-MM-DD`

Filters — optional, ignored without a search term

Parameter	Required	Values	Description
departamento	no	enum	Department to filter
dia	no	DD	Birth day
mes	no	MM	Birth month
anio	no	YYYY	Birth year
edad	no	integer	Exact age, e.g. `32`
edad_desde	no	integer	Minimum age, e.g. `25`
edad_hasta	no	integer	Maximum age, e.g. `40`
anio_desde	no	integer	Birth year from
anio_hasta	no	integer	Birth year to
signo	no	enum	Zodiac sign: Aries, Tauro, Geminis, Cancer, Leo, Virgo, Libra, Escorpio, Sagitario, Capricornio, Acuario, Piscis
genero	no	Masculino / Femenino	Gender filter
numero_liceo	no	integer	Liceo number attended, e.g. `12`
nombre_utu	no	string	Partial UTU name, e.g. `ELECTRONICA`
numero_escuela	no	integer	Primary school number, e.g. `47`
nombre_censurado	no	string	Censored name with asterisks, e.g. `Ro**** Sil*`

Options

Parameter	Required	Values	Description
modo_busqueda	no	exacta / libre	`exacta` matches whole words, `libre` contains the text (default `libre`)
info_signo	no	activado / desactivado	Show zodiac sign in results (default `desactivado`)
historial_instituciones_educativas	no	activado / desactivado	Include educational institution history (default `desactivado`)
fue_a_primaria	no	activado / desactivado	Only people who attended primary school
fue_a_liceo	no	activado / desactivado	Only people who attended liceo
fue_a_utu	no	activado / desactivado	Only people who attended UTU
fue_a_udelar	no	activado / desactivado	Only people who attended Universidad de la República

Examples

# the web form
curl -G 'https://notalivex.org/api/samaritan/uruguay/busqueda' \
  --data-urlencode 'nombre_apellido=JUAN PEREZ' \
  -H 'x-api-token: YOUR_API_TOKEN'

# separate name fields + exact match + location filter
curl -G 'https://notalivex.org/api/samaritan/uruguay/busqueda' \
  --data-urlencode 'nombre=JUAN' \
  --data-urlencode 'apellidos=PEREZ' \
  --data-urlencode 'modo_busqueda=exacta' \
  --data-urlencode 'departamento=Montevideo' \
  -H 'x-api-token: YOUR_API_TOKEN'

GET/api/samaritan/uruguay/cedula?cedula=12345678 4 credits

Lookup by Cédula de Identidad.

Parameters

Parameter	Required	Values	Description
cedula	yes	7-8 digits	Cédula de Identidad
verificador	no	activado / desactivado	Include verification data
censurada	no	activado / desactivado	Return censored record

GET/api/samaritan/uruguay/ceibal?cedula=12345678 4 credits

Ceibal platform lookup by Cédula.

Parameters

Parameter	Required	Values	Description
cedula	yes	7-8 digits	Cédula de Identidad
foto_de_perfil	no	activado / desactivado	Include profile photo
historial_de_dispositivos	no	activado / desactivado	Include device history

GET/api/samaritan/uruguay/contactos?cedula=12345678 4 credits

Contact list by Cédula.

Parameters

Parameter	Required	Values	Description
cedula	yes	7-8 digits	Cédula de Identidad
avanzado	no	activado / desactivado	Extended contact detail

GET/api/samaritan/uruguay/familiares?cedula=12345678 4 credits

Relatives lookup by Cédula.

Parameters

Parameter	Required	Values	Description
cedula	yes	7-8 digits	Cédula de Identidad
avanzado	no	activado / desactivado	Extended relatives detail

GET/api/samaritan/uruguay/informe?cedula=12345678 4 credits

Full report by Cédula.

Parameters

Parameter	Required	Values	Description
cedula	yes	7-8 digits	Cédula de Identidad
nivel_del_informe	no	ultra	Report depth

GET/api/samaritan/uruguay/telefono-cedula?cedula=12345678 4 credits

Find phone numbers by Cédula.

Parameters

Parameter	Required	Values	Description
cedula	yes	7-8 digits	Cédula de Identidad

GET/api/samaritan/uruguay/multas?matricula=ABC1234 2 credits

Traffic fines by license plate.

Parameters

Parameter	Required	Values	Description
matricula	yes	ABC1234	Vehicle plate
intervenido	no	text	Filter by driver name on the fine
solo_informacion	no	activado / desactivado	Return summary only

GET/api/samaritan/uruguay/multas-mapa?matricula=ABC1234 2 credits

Traffic fines map by license plate. Returns a map URL.

Parameters

Parameter	Required	Values	Description
matricula	yes	ABC1234	Vehicle plate
intervenido	no	text	Filter by driver name on the fine

GET/api/samaritan/uruguay/direcciones?cedula=12345678 2 credits

Addresses linked to a Cédula.

Parameters

Parameter	Required	Values	Description
cedula	yes	7-8 digits	Cédula de Identidad
ultima_actualizaciones	no	activado / desactivado	Return only the latest addresses

GET/api/samaritan/uruguay/propietario-telefono?telefono=099123456 2 credits

Owner lookup by phone number.

Parameters

Parameter	Required	Values	Description
telefono	yes	09XXXXXXXX	Uruguayan mobile number
persona_relacionada	no	activado / desactivado	Include related persons

GET/api/samaritan/uruguay/busqueda-ceibal?nombre_apellido=JUAN+PEREZ 2 credits

Ceibal search by full name or by educational institution.

Parameters

Parameter	Required	Values	Description
nombre_apellido	one of	text	Full name
nombre_institucion_educativa	no	text	Institution name filter
tipo_de_usuario	no	text	User type filter
cursos	no	text	Course filter
direccion_institucion	no	text	Institution address filter
grupos	no	text	Group filter
nombre_logros	no	text	Achievement name filter
descripcion_logros	no	text	Achievement description filter
subnota	no	number	Sub-grade filter
crea_info	no	activado / desactivado	Include CREA information
limite	no	number	Max results (default `20`)

GET/api/samaritan/uruguay/historial-ceibal?nombre_apellido=JUAN+PEREZ 2 credits

Ceibal device history by full name or by device serial.

Parameters

Parameter	Required	Values	Description
nombre_apellido	one of	text	Full name
nombre	no	text	First name
apellido	no	text	Last name
numero_serie_dispositivo	no	text	Device serial number
fecha_asignacion_desde	no	DD/MM/YYYY	Assignment date from
fecha_asignacion_hasta	no	DD/MM/YYYY	Assignment date to
limite	no	number	Max results (default `20`)

GET/api/samaritan/uruguay/escolaridad?cedula=12345678 2 credits

Schooling records by Cédula.

Parameters

Parameter	Required	Values	Description
cedula	yes	7-8 digits	Cédula de Identidad
ids	no	text	Restrict to specific record IDs

GET/api/samaritan/uruguay/registro-estudiante?documento=12345678 2 credits

Student registry by document number.

Parameters

Parameter	Required	Values	Description
documento	yes	7-8 digits	Document / cédula number
avanzado	no	activado / desactivado	Extended record detail
ocultar_reuniones	no	activado / desactivado	Hide meetings
ocultar_inasistencias	no	activado / desactivado	Hide absences

GET/api/samaritan/uruguay/historial-educativo?cedula=12345678 2 credits

Educational history by Cédula.

Parameters

Parameter	Required	Values	Description
cedula	yes	7-8 digits	Cédula de Identidad
registros_avanzados	no	activado / desactivado	Include advanced records (default `activado`)
registros_primaria	no	activado / desactivado	Include primary school records (default `desactivado`)

GET/api/samaritan/uruguay/cursos-estudiantes?centro=12345&anio=2024 2 credits

Student courses by centre and year. Both centro and anio are required — sending only anio returns "Se requiere centro y anio".

Parameters

Parameter	Required	Values	Description
centro	yes	text	Educational centre code
anio	yes	YYYY	School year
grupo	no	text	Group filter
curso	no	text	Course filter
limit	no	number	Max results (default `20`)

Example

curl -G 'https://notalivex.org/api/samaritan/uruguay/cursos-estudiantes' \
  --data-urlencode 'centro=12345' \
  --data-urlencode 'anio=2024' \
  -H 'x-api-token: YOUR_API_TOKEN'

GET/api/samaritan/uruguay/busqueda-estudiantil?nombre=JUAN&apellidos=PEREZ 2 credits

Student search by name, or by school, department, date or age filters.

Parameters

Parameter	Required	Values	Description
nombre	yes	text	First name(s)
apellidos	no	text	Last name(s)
numero_liceo	no	text	Liceo number
nombre_utu	no	text	UTU name
numero_escuela	no	text	School number
departamento	no	text	Department
fechanacimiento	no	DD/MM/YYYY	Date of birth
dia	no	1-31	Birth day
mes	no	1-12	Birth month
anio	no	YYYY	Birth year
edad	no	number	Exact age
edad_desde	no	number	Minimum age
edad_hasta	no	number	Maximum age
anio_desde	no	YYYY	Minimum year
anio_hasta	no	YYYY	Maximum year
signo	no	text	Zodiac sign
tipo_de_curso	no	text	Course type
fue_a_primaria	no	activado / desactivado	Primary school filter (default `activado`)
fue_a_liceo	no	activado / desactivado	Liceo filter (default `activado`)
fue_a_utu	no	activado / desactivado	UTU filter (default `activado`)
historial_instituciones_educativas	no	activado / desactivado	Include institution history (default `activado`)
info_signo	no	activado / desactivado	Include zodiac sign data
registros_avanzados	no	activado / desactivado	Include advanced records
registros_primaria	no	activado / desactivado	Include primary records
limit	no	number	Max results (default `20`)

GET

/api/samaritan/uruguay/busqueda-primaria?anio_lectivo=2024&nivel_clase=1&codigo_clase=A&numeroescuela=12345&departamento=MONTEVIDEO

2 credits

Primary school search. All five parameters are required — sending only anio_lectivo returns "Se requiere anio_lectivo, nivel_clase, codigo_clase, numeroescuela y departamento".

Parameters

Parameter	Required	Values	Description
anio_lectivo	yes	YYYY	School year
nivel_clase	yes	number	Grade level
codigo_clase	yes	text	Class code
numeroescuela	yes	number	School number
departamento	yes	text	Department
limit	no	number	Max results (default `30`)

Example

curl -G 'https://notalivex.org/api/samaritan/uruguay/busqueda-primaria' \
  --data-urlencode 'anio_lectivo=2024' \
  --data-urlencode 'nivel_clase=1' \
  --data-urlencode 'codigo_clase=A' \
  --data-urlencode 'numeroescuela=12345' \
  --data-urlencode 'departamento=MONTEVIDEO' \
  -H 'x-api-token: YOUR_API_TOKEN'

GET/api/samaritan/uruguay/registro-primaria?cedula=12345678 2 credits

Primary registry by Cédula.

Parameters

Parameter	Required	Values	Description
cedula	yes	7-8 digits	Cédula de Identidad

GET/api/samaritan/uruguay/huellas?cedula=12345678 2 credits

Fingerprint records by Cédula, email or phone number.

Parameters

Parameter	Required	Values	Description
cedula	one of	7-8 digits	Cédula de Identidad
correo_electronico	one of	email	Email address
numero_de_telefono	one of	09XXXXXXXX	Phone number

🇧🇴 Bolivia

GET/api/bo/documento/:documento 1 credit

Search by national document number.

GET/api/bo/nombre/:nombre 1 credit

Search by full name.

GET/api/bo/telefono/:telefono 1 credit

Search by phone number.

🇵🇾 Paraguay

GET/api/pa/cedula/:cedula 1 credit

Search by Cédula (Paraguayan national ID).

GET/api/pa/nombre/:nombre 1 credit

Search by full name.

GET/api/pa/celular/:celular 1 credit

Search by mobile phone number.

GET/api/pa/telefono/:telefono 1 credit

Search by phone number.

GET/api/pa/email/:email 1 credit

Search by email address.

SAMARITAN Paraguay

Paraguayan records via Latam Quality Consulting. Uses query parameters.

Complete parameter reference

Endpoint	Required parameters	Optional parameters
paraguay/documentos	`cedula`required	—
paraguay/busqueda	`nombres` or another filter	`apellido`, `sexo`, `nacionalidad`, `fecha_de_nacimiento`, `edad_actual`
paraguay/huellas	`cedula` or `numero_de_telefono`	—

Gateway limitation: the public gateway currently forwards only one query parameter for paraguay/busqueda and paraguay/huellas, so the extra parameters below are accepted but not yet relayed upstream. Use them as soon as relaying is enabled.

GET/api/samaritan/paraguay/documentos?cedula=1234567 2 credits

Documents by Cédula.

Parameters

Parameter	Required	Values	Description
cedula	yes	6-8 digits	Cédula de Identidad

GET/api/samaritan/paraguay/busqueda?nombres=JUAN&apellido=PEREZ 2 credits

Search by name. The most precise results come from sending nombres together with apellido.

Parameters

Parameter	Required	Values	Description
nombres	yes	text	First name(s)
apellido	no	text	Last name(s)
sexo	no	text	Sex
nacionalidad	no	text	Nationality
fecha_de_nacimiento	no	DD/MM/YYYY	Date of birth
edad_actual	no	number	Current age

Example

curl -G 'https://notalivex.org/api/samaritan/paraguay/busqueda' \
  --data-urlencode 'nombres=JUAN' \
  --data-urlencode 'apellido=PEREZ' \
  -H 'x-api-token: YOUR_API_TOKEN'

GET/api/samaritan/paraguay/huellas?cedula=1234567 2 credits

Fingerprint records by Cédula or phone number.

Parameters

Parameter	Required	Values	Description
cedula	one of	6-8 digits	Cédula de Identidad
numero_de_telefono	one of	09XXXXXXXX	Phone number

🇨🇷 Costa Rica

Costa Rican records via Latam Quality Consulting. Uses query parameters.

SAMARITAN Costa Rica

Complete parameter reference

Endpoint	Required parameters	Optional parameters
costa-rica/impuestos	`documento`required	—
costa-rica/domicilio	`documento`required	—
costa-rica/ciudadano	`documento`required	—
costa-rica/ciudadano-v2	`documento`required	—
costa-rica/busqueda	`nombres` or another filter	`apellido_paterno`, `apellido_materno`, `provincia`, `region`, `distrito`

Gateway limitation: the public gateway currently forwards only nombres for costa-rica/busqueda, so the surname and location filters below are accepted but not yet relayed upstream. Use them as soon as relaying is enabled. The four documento endpoints are fully supported.

GET/api/samaritan/costa-rica/impuestos?documento=123456789 2 credits

Tax records by document number.

Parameters

Parameter	Required	Values	Description
documento	yes	9 digits	Cédula de identidad

GET/api/samaritan/costa-rica/domicilio?documento=123456789 2 credits

Domicile records by document number.

Parameters

Parameter	Required	Values	Description
documento	yes	9 digits	Cédula de identidad

GET/api/samaritan/costa-rica/ciudadano?documento=123456789 2 credits

Citizen lookup by document number.

Parameters

Parameter	Required	Values	Description
documento	yes	9 digits	Cédula de identidad

GET/api/samaritan/costa-rica/ciudadano-v2?documento=123456789 2 credits

Citizen lookup (v2) by document number.

Parameters

Parameter	Required	Values	Description
documento	yes	9 digits	Cédula de identidad

GET/api/samaritan/costa-rica/busqueda?nombres=JUAN&apellido_paterno=PEREZ&provincia=SAN+JOSE 2 credits

Search by name and optional location.

Parameters

Parameter	Required	Values	Description
nombres	yes	text	First name(s)
apellido_paterno	no	text	Paternal surname
apellido_materno	no	text	Maternal surname
provincia	no	text	Province
region	no	text	Region
distrito	no	text	District

Example

curl -G 'https://notalivex.org/api/samaritan/costa-rica/busqueda' \
  --data-urlencode 'nombres=JUAN' \
  --data-urlencode 'apellido_paterno=PEREZ' \
  --data-urlencode 'provincia=SAN JOSE' \
  -H 'x-api-token: YOUR_API_TOKEN'

🇩🇴 Dominican Republic

GET/api/rd/cedula/:cedula 1 credit

Search by Cédula.

GET/api/rd/nombre/:nombre 1 credit

Search by full name.

🇸🇻 El Salvador

GET/api/sv/dui/:dui 1 credit

Search by DUI (Documento Único de Identidad).

GET/api/sv/nombre/:nombre 1 credit

Search by full name.

GET/api/sv/telefono/:telefono 1 credit

Search by phone number.

GET/api/sv/placa/:placa 1 credit

Search by license plate (Placa).

GET/api/sv/email/:email 1 credit

Search by email address.

🇨🇦 Canada

GET/api/ca/email/:email 1 credit

Search by email address.

GET/api/ca/nombre/:nombre 1 credit

Search by full name.

GET/api/ca/telefono/:telefono 1 credit

Search by phone number.

🇺🇸 USA

GET/api/us/nombre/:nombre 1 credit

Search by full name.

GET/api/us/telefono/:telefono 1 credit

Search by phone number.

GET/api/us/email/:email 1 credit

Search by email address.

🇪🇸 Spain

GET/api/es/legal/:legal 1 credit

Search by legal ID — accepts DNI, NIE, or CIF.

GET/api/es/nombre/:nombre 1 credit

Search by full name.

GET/api/es/email/:email 1 credit

Search by email address.

GET/api/es/telefono/:telefono 1 credit

Search by phone number.

Spanish Database (Spain DB)

Extended Spanish public records via the Spain DB dataset. Uses 2 credits per request.

GET/api/spaindb/search/name/:name 2 credits

Search Spain DB by full name.

GET/api/spaindb/search/dni/:dni 2 credits

Search Spain DB by DNI / NIE.

GET/api/spaindb/search/phone/:phone 2 credits

Search Spain DB by phone number.

GET/api/spaindb/search/email/:email 2 credits

Search Spain DB by email address.

🇷🇺 Russia

GET/api/ru/nombre/:nombre 1 credit

Search by full name.

GET/api/ru/placa/:placa 1 credit

Search by license plate.

GET/api/ru/telefono/:telefono 1 credit

Search by phone number.

GET/api/ru/email/:email 1 credit

Search by email address.

🇵🇭 Philippines

GET/api/ph/nombre/:nombre 1 credit

Search by full name.

GET/api/ph/telefono/:telefono 1 credit

Search by phone number.

GET/api/ph/email/:email 1 credit

Search by email address.

Instagram DB

Search Instagram account data by username, email, or phone number.

GET/api/instagram/username/:username 1 credit

Search by Instagram username (without @).

GET/api/instagram/email/:email 1 credit

Search by email address linked to an Instagram account.

GET/api/instagram/telefono/:telefono 1 credit

Search by phone number linked to an Instagram account.

Telegram

Search Telegram accounts by phone number, user ID, or username.

GET/api/tg/telefono/:telefono 1 credit

Search by phone number.

GET/api/tg/id/:id 1 credit

Search by Telegram user ID.

GET/api/tg/username/:username 1 credit

Search by Telegram username (without @).

Additional Telegram routes via unified OSINT:

Route	Description
`/api/osint/tg/username/:q`	Telegram username lookup (BreachHub)
`/api/osint/tg/id/:q`	Telegram user ID lookup (BreachHub)
`/api/osint/tg/phone/:q`	Telegram phone lookup (BreachHub)

Discord OSINT

Discord intelligence from multiple sources. Use /api/osint/discord/:service/:query or individual endpoints below.

GET/api/osint/discord/cordcat/:user 1 credit

Lookup Discord user via CordCat (user ID or snowflake).

GET/api/osint/discord/seeknow/:user 1 credit

Lookup Discord user via SeekNow.

GET/api/osint/discord/eyegod/:user 1 credit

Lookup Discord user via EyeGod.

GET/api/osint/discord/oathnet/:user 1 credit

Lookup Discord user via OathNet.

GET/api/osint/discord/seekria/:user 1 credit

Lookup Discord user via Seekria.

Additional Discord endpoints via the unified OSINT route:

Route	Description
`/api/osint/dc/user/:userid`	Discord user lookup (BreachHub)
`/api/osint/dc/snowflake/:snowflake`	Decode Discord snowflake to timestamp
`/api/osint/seekria/discord_profile/:user`	Discord profile via Seekria
`/api/osint/seekria/discord_rat/:user`	Discord RAT lookup via Seekria
`/api/osint/cordcat/user/:user`	Discord user via CordCat
`/api/osint/cordcat/invite/:code`	Discord invite via CordCat
`/api/osint/seeknow/discord/:user`	Discord user via SeekNow
`/api/osint/seeknow/discord2rb/:user`	Discord to Roblox via SeekNow

Instagram BH

Instagram lookup via BreachHub integration.

GET/api/osint/instagram/lookup/:username 1 credit

Lookup Instagram profile data by username.

TikTok OSINT

GET/api/osint/tiktok/recon/:username 1 credit

TikTok profile recon via BreachHub.

GET/api/osint/seeknow/tiktok/:username 1 credit

TikTok lookup via SeekNow.

Snapchat OSINT

GET/api/osint/snapchat/lookup/:username 1 credit

Lookup Snapchat profile data by username.

Twitter / X OSINT

GET/api/osint/seeknow/twitter/:username 1 credit

Twitter/X lookup via SeekNow.

Reddit OSINT

GET/api/osint/seeknow/reddit/:username 1 credit

Reddit lookup via SeekNow.

GET/api/osint/room101/user/:username 1 credit

Reddit user lookup via Room101.

GET/api/osint/room101/search/:query 1 credit

Reddit content search via Room101.

OSINT Tools Overview

All OSINT tools and breach databases share a unified route pattern:

Pattern: GET /api/osint/:service/:type/:query

Where :service is the service name, :type is the search type, and :query is the search term (URL-encoded). All endpoints cost 1 credit per successful request.

Example

curl -H "x-api-token: YOUR_TOKEN" \
  "https://notalivex.org/api/osint/intelvault/email/[email protected]"

Below are all available OSINT tools organized alphabetically. Each shows the :service/:type values to use.

IntelVault

Email breach intelligence and stealer log data.

GET/api/osint/intelvault/email/:email 1 credit

Search breached accounts by email.

GET/api/osint/intelvault/stealer/:email 1 credit

Search stealer logs by email.

GET/api/osint/intelvault/breaches/:email 1 credit

Multi-source breach lookup by email.

BreachBase

GET/api/osint/breachbase/email/:email 1 credit

Search breached credentials by email.

BreachDirectory

GET/api/osint/breachdirectory/email/:email 1 credit

Search breached credentials by email.

OSINTCat

GET/api/osint/osintcat/email/:email 1 credit

Email breach lookup.

HudsonRock

Comprehensive threat intelligence platform with multiple search types.

GET/api/osint/hudsonrock/email/:email 1 credit

Search by email.

GET/api/osint/hudsonrock/domain/:domain 1 credit

Search by domain.

GET/api/osint/hudsonrock/domain_overview/:domain 1 credit

Get domain overview.

GET/api/osint/hudsonrock/username/:username 1 credit

Search by username.

GET/api/osint/hudsonrock/ip/:ip 1 credit

Search by IP address.

GET/api/osint/hudsonrock/keyword/:keyword 1 credit

Search by keyword.

Seekria

Multi-purpose OSINT tool with email, phone, domain, IP, Discord, and gaming lookups.

GET/api/osint/seekria/email_osint/:email 1 credit

Email OSINT investigation.

GET/api/osint/seekria/email_breach/:email 1 credit

Email breach search.

GET/api/osint/seekria/phone/:phone 1 credit

Phone number lookup.

GET/api/osint/seekria/domain/:domain 1 credit

Domain intelligence.

GET/api/osint/seekria/domain_username/:domain 1 credit

Find usernames associated with a domain.

GET/api/osint/seekria/footprint/:email 1 credit

Digital footprint analysis by email.

GET/api/osint/seekria/ip/:ip 1 credit

IP address lookup.

GET/api/osint/seekria/dns/:domain 1 credit

DNS record lookup for domain.

GET/api/osint/seekria/discord_profile/:user 1 credit

Discord profile lookup.

LeakCheck

GET/api/osint/leakcheck/email/:email 1 credit

Email breach check.

Snusbase

GET/api/osint/snusbase/domain/:domain 1 credit

Domain breach search.

GET/api/osint/snusbase/combo/:query 1 credit

Combo list search (email:password).

GET/api/osint/snusbase/hash/:hash 1 credit

Hash lookup.

GET/api/osint/snusbase/ip/:ip 1 credit

IP breach search.

OathNet

Multi-tool OSINT platform with email, gaming, and infrastructure lookups.

GET/api/osint/oathnet/holehe/:email 1 credit

Check if email is registered on various services (Holehe).

GET/api/osint/oathnet/ghunt/:email 1 credit

Google account lookup (GHunt).

GET/api/osint/oathnet/breach/:email 1 credit

Email breach search.

GET/api/osint/oathnet/stealer/:email 1 credit

Stealer log search.

Inf0Sec

GET/api/osint/inf0sec/search/:query 1 credit

Security/breach data search.

Shodan

Internet-connected device search engine.

GET/api/osint/shodan/host/:ip 1 credit

Lookup host details by IP.

GET/api/osint/shodan/search/:query 1 credit

Search Shodan by query.

GET/api/osint/shodan/dns/:domain 1 credit

DNS resolution for domain.

GET/api/osint/shodan/honeyscore/:ip 1 credit

Check if IP is a honeypot.

SeekNow

Multi-purpose OSINT platform supporting social, gaming, and contact lookups.

GET/api/osint/seeknow/discord/:user 1 credit

Discord user lookup.

GET/api/osint/seeknow/discord2rb/:user 1 credit

Discord to Roblox lookup.

GET/api/osint/seeknow/github/:username 1 credit

GitHub profile lookup.

GET/api/osint/seeknow/twitter/:username 1 credit

Twitter/X profile lookup.

GET/api/osint/seeknow/tiktok/:username 1 credit

TikTok profile lookup.

GET/api/osint/seeknow/reddit/:username 1 credit

Reddit profile lookup.

GET/api/osint/seeknow/social/:username 1 credit

Multi-platform social lookup.

GET/api/osint/seeknow/ip/:ip 1 credit

IP address lookup.

GET/api/osint/seeknow/email/:email 1 credit

Email lookup.

GET/api/osint/seeknow/phone/:phone 1 credit

Phone number lookup.

GET/api/osint/seeknow/domain/:domain 1 credit

Domain intelligence lookup.

GET/api/osint/seeknow/xbox/:gamertag 1 credit

Xbox gamertag lookup.

GET/api/osint/seeknow/roblox/:username 1 credit

Roblox profile lookup.

GET/api/osint/seeknow/minecraft/:username 1 credit

Minecraft profile lookup.

CordCat

GET/api/osint/cordcat/user/:user 1 credit

Discord user lookup by ID.

GET/api/osint/cordcat/invite/:code 1 credit

Discord invite info lookup.

GET/api/osint/cordcat/ip/:ip 1 credit

IP address lookup via CordCat.

DataVoid

Universal OSINT search. The response is a Server-Sent Events stream, so results arrive live while the scan is running.

Pattern: GET /api/osint/datavoid/stream/:query?chip=<chip>

Query parameters

Param	Type	Required	Description
`chip`	string	No	Search type chip: `Email`, `Phone`, `Username`, `Domain`, `IP`. If omitted it is auto-detected from the query.

Event types

Event	Payload
`meta`	Scan metadata: `query`, `chip`, `totalTasks`, `timestamp`.
`progress`	Progress tick: `completed` / `total`.
`result`	One found service (sent once per hit).
`done`	Scan finished.
`billing`	Credits consumed: `credits_used`, `remaining_credits`.

Example

curl -N -H "x-api-token: YOUR_TOKEN" \
  "https://notalivex.org/api/osint/datavoid/stream/[email protected]?chip=Email"

Sub-categories

Sub-category	`chip`	Example query
Email	`Email`	`/api/osint/datavoid/stream/[email protected]?chip=Email`
Phone	`Phone`	`/api/osint/datavoid/stream/+14155552671?chip=Phone`
Username	`Username`	`/api/osint/datavoid/stream/jhon?chip=Username`
Domain	`Domain`	`/api/osint/datavoid/stream/example.com?chip=Domain`
IP	`IP`	`/api/osint/datavoid/stream/8.8.8.8?chip=IP`

StealerLogs

Stealer machine logs indexed by credential, host or URL.

Sub-categories

Sub-category	Endpoint	Description
Email	`/api/osint/stealerlogs/email/:query`	Logs containing the email.
Username	`/api/osint/stealerlogs/username/:query`	Logs containing the username.
Password	`/api/osint/stealerlogs/password/:query`	Logs containing the password.
IP	`/api/osint/stealerlogs/ip/:query`	Logs from the IP address.
URL	`/api/osint/stealerlogs/url/:query`	Logs referencing the URL.

Example

curl -H "x-api-token: YOUR_TOKEN" \
  "https://notalivex.org/api/osint/stealerlogs/email/[email protected]"

DataHound

OSINT suite: username/email/phone footprinting, IP intelligence, breach lookups, stealer search and gaming profiles.

Sub-categories

Sub-category	Endpoint	Description
Username	`/api/osint/datahound/username/:query`	Username footprinting across 200+ social platforms.
Email	`/api/osint/datahound/email/:query`	Email footprinting across social platforms and breach sources.
Phone	`/api/osint/datahound/phone/:query`	Phone footprinting (E.164 or national digits).
IP	`/api/osint/datahound/ip/:query`	IP intelligence: geolocation, ISP, leaks, stealer machines.
Breach	`/api/osint/datahound/breach/:query`	Breach lookup (Snusbase, LeakCheck, HackCheck, LeakSight, UPL, IntelVault).
Full Breach	`/api/osint/datahound/breach_full/:query`	Full breach lookup across every source (deeper, slower).
Stealer Logs	`/api/osint/datahound/stealer/:query`	Stealer-log search with combinable filters.
Steam	`/api/osint/datahound/steam/:query`	Steam profile: URL, SteamID64, hex ID or vanity.
Minecraft	`/api/osint/datahound/minecraft/:query`	Minecraft lookup by username.
Discord	`/api/osint/datahound/discord/:id`	Discord profile by snowflake ID (17–20 digits).
Discord History	`/api/osint/datahound/discord_history/:id`	Discord username history by snowflake ID.
Roblox	`/api/osint/datahound/roblox/:query`	Roblox lookup by username.
FiveM	`/api/osint/datahound/fivem/:query`	FiveM lookup with `license:`, `discord:`, `steam:` or `username:` prefixes.

Example

curl -H "x-api-token: YOUR_TOKEN" \
  "https://notalivex.org/api/osint/datahound/username/jhon"

SEON

GET/api/osint/seon/email/:email 1 credit

Email fraud risk assessment.

GET/api/osint/seon/phone/:phone 1 credit

Phone number fraud assessment.

GET/api/osint/seon/ip/:ip 1 credit

IP fraud risk assessment.

EyeGod

Advanced OSINT query engine via EyeGod v2. All queries use a single unified endpoint and consume exactly 1 credit. Enterprise modules require an Enterprise plan — other plans receive an HTTP 403 with {"required":"enterprise"}.

GET/api/eg/v2/query/:type/:value 1 credit

Query EyeGod by type and value. URL-encode special characters in :value (spaces → %20, emails keep @ as-is).

Example Request

curl -H "x-api-token: YOUR_TOKEN_HERE" \
  https://notalivex.org/api/eg/v2/query/email/[email protected]

curl -H "x-api-token: YOUR_TOKEN_HERE" \
  https://notalivex.org/api/eg/v2/query/reconly_leakcheck/john.doe%40gmail.com

Core Types

Type	Description	Input
`username`	Social media username search (500+ sites)	Username
`email`	Email breach & account lookup	Email
`phone`	Phone number lookup	Phone number
`password`	Password breach lookup	Password
`ip`	IP address intelligence	IPv4/IPv6
`proxy`	Proxy / VPN detection	IP address
`url`	URL intelligence	URL
`domain`	Breaches by domain	Domain
`domain_mapper`	Domain mapping / infrastructure discovery	Domain
`subdomain_list`	List subdomains of a domain	Domain
`name_br`	Name lookup (Brazilian databases)	Full name
`fullnamebreach`	Search breaches by full name	Full name
`passport`	Passport number lookup	Passport #
`facebookid`	Facebook profile ID lookup	Numeric ID
`plate`	License plate lookup (BR)	Plate
`ssn`	Social Security Number lookup	SSN
`hwid`	Hardware ID lookup	HWID string
`ip_geo`	IP geolocation	IPv4

V2 Types

Type	Description	Input
`username2`	Username search, second engine	Username
`url2`	Domain intelligence, second engine	Domain or URL
`tiktok_resolver`	TikTok user resolver	Username
`tiktok_comments`	TikTok comment history	User ID
`telegram_channel`	Telegram channel info & members	Channel URL / @handle
`discord_channel`	Discord channel/guild info	Channel URL or invite link
`snapchat_profile`	Snapchat profile lookup	Username
`reddit_scraper`	Reddit user data scraper	Username
`kwai_profile`	Kwai profile lookup	Username
`linkedin_comments`	LinkedIn comments by author	Username

OSINT & Infrastructure Types

Live infrastructure and threat-intel modules served directly by EyeGod (unlimited, no third-party quota).

Type	Description	Input
`subdomain_search`	Search known subdomains with records	Domain
`portscan`	Open port scan on a host	Host or IP
`threat_actor`	Threat actor intelligence	Actor name or alias
`csintduck_ip_info`	CsintDuck IP information	IP address
`csintduck_github`	CsintDuck GitHub lookup	GitHub username
`csintduck_shodan_host`	CsintDuck Shodan host lookup	IP address
`csintduck_shodan_dns`	CsintDuck Shodan DNS records	Domain
`csintduck_shodan_resolve`	CsintDuck Shodan hostname resolve	Hostname or domain
`csintduck_shodan_reverse`	CsintDuck Shodan reverse IP	IP address
`csintduck_shodan_honeyscore`	CsintDuck Shodan honeypot score	IP address
`csintduck_xbox`	CsintDuck Xbox profile	Gamertag
`csintduck_steam`	CsintDuck Steam profile	Steam ID or vanity URL
`csintduck_telegram_username`	CsintDuck Telegram by username	@username
`csintduck_telegram_id`	CsintDuck Telegram by ID	Telegram user ID
`csintduck_snapchat`	CsintDuck Snapchat profile	Username
`csintduck_instagram`	CsintDuck Instagram profile	Username
`wolfeye_ip`	WolfEye IP intelligence	IP address
`wolfeye_domain`	WolfEye domain intelligence	Domain
`wolfeye_url`	WolfEye URL intelligence	URL
`wolfeye_email`	WolfEye email intelligence	Email
`wolfeye_username`	WolfEye username intelligence	Username

Enterprise Modules

Premium third-party integrations available exclusively on the Enterprise plan. Third-party modules (Reconly, Hudson Rock, Snusbase, Inf0sec, OsintCat) are limited to 100 requests/day per module.

Type	Description	Input
`hudsonrock`	Hudson Rock infostealer intelligence	Email, username, domain
`snusbase`	Snusbase database search	Email, username, domain
`antipublic`	AntiPublic combo list check	Email or username
`intelvault`	IntelVault breach index	Email, username, domain
`seon`	Seon fraud scoring	Email, phone, IP
`reconly_auto`	Reconly auto-detected query	Email, username, domain, IP
`reconly_discord`	Reconly Discord leaks	Discord ID or username
`reconly_discord_leak`	Reconly Discord Leak database	Discord ID or username
`reconly_discord_lookup`	Reconly Discord ID lookup	Discord ID
`reconly_discord_search`	Reconly Discord full-text search	Search term
`reconly_dcturkiye`	Reconly DC Turkiye leaks	Discord ID or username
`reconly_fivem`	Reconly FiveM player leaks	FiveM identifier (license/steam/discord)
`reconly_github`	Reconly GitHub commits & secrets	GitHub username
`reconly_leakcheck`	Reconly LeakCheck breach search	Email, username, domain, or phone
`reconly_owobot`	Reconly OwOBot Discord leaks	Discord ID or username
`reconly_pinterest`	Reconly Pinterest leaks	Email or username
`inf0sec_leaks`	Inf0sec combined leaks	Email, username, domain
`discord_lookup`	Discord user lookup	Discord ID
`inf0sec_username`	Inf0sec username search	Username
`inf0sec_hlr`	Inf0sec HLR phone lookup	Phone number
`inf0sec_cfx`	Inf0sec CFX/FiveM lookup	CFX identifier
`osintcat_breach`	OsintCat breach search	Email, username, domain
`osintcat_db_search`	OsintCat database search	Search term
`breachdirectory_email`	BreachDirectory email search	Email
`breachdirectory_username`	BreachDirectory username search	Username
`breachdirectory_ip`	BreachDirectory IP search	IP address
`nosint_email`	NoSINT email intelligence	Email
`nosint_username`	NoSINT username intelligence	Username
`nosint_phone`	NoSINT phone intelligence	Phone number
`nosint_ip`	NoSINT IP intelligence	IP address

PropertyRadar

GET/api/osint/propertyradar/search/:query 1 credit

US property records search.

Clouds

Search leaked credentials by domain or email.

GET/api/leaks/search/domain/:query 1 credit

Find leaks associated with a domain.

GET/api/leaks/search/email/:query 1 credit

Find leaks associated with an email address.

Minecraft OSINT

Search Minecraft player profiles and account data.

GET/api/osint/seekria/minecraft/:username 1 credit

Minecraft profile via Seekria.

GET/api/osint/oathnet/minecraft/:username 1 credit

Minecraft profile via OathNet.

GET/api/osint/seeknow/minecraft/:username 1 credit

Minecraft profile via SeekNow.

Roblox OSINT

Search Roblox player profiles and linked accounts.

GET/api/osint/seekria/roblox/:username 1 credit

Roblox profile via Seekria.

GET/api/osint/oathnet/roblox/:username 1 credit

Roblox profile via OathNet.

GET/api/osint/seeknow/roblox/:username 1 credit

Roblox profile via SeekNow.

Xbox OSINT

GET/api/osint/oathnet/xbox/:gamertag 1 credit

Xbox gamertag via OathNet.

GET/api/osint/seeknow/xbox/:gamertag 1 credit

Xbox gamertag via SeekNow.

Steam OSINT

GET/api/osint/oathnet/steam/:steamid 1 credit

Steam profile via OathNet (Steam ID or custom URL).

FiveM OSINT

GET/api/osint/seekria/fivem/:identifier 1 credit

FiveM player lookup via Seekria.

Medal.tv

GET/api/osint/medal/lookup/:username 1 credit

Medal.tv clip/profile lookup by username.

Best Practices

Secure Your Token: Use environment variables. Never commit it to source control.
URL-encode Parameters: Always encode names and non-ASCII characters (spaces → %20).
Handle All Status Codes: Always check data.success before using results.
Cache Results: Cache successful responses to avoid redundant credit consumption.
Implement Backoff: On 429, use exponential backoff — don't hammer the API.
Free AR Endpoints: /api/ar/dni and /api/ar/nombre cost 0 credits via the web dashboard.
Try Alternate Sources: For Colombia, use both co and co2 if one returns nothing. For Peru names, try nombre and nombre2.
Argentina Nombre: Must be at least 3 words with 4+ letters each. Respect the 4-minute cooldown.

Need Help?

Join our Discord or Telegram for real-time support and to purchase credits
Check your balance and token in the Dashboard
Review our Terms of Service and Privacy Policy