---
name: orthogonal-ipdata
description: "Call ipdata through Orthogonal's pay-per-use Run API: IP geolocation and threat intelligence: location, ASN, company, mobile carrier, timezone, currency, language and threat flags (Tor, proxy, known attacker/abuser) for any IPv4 or IPv6 address."
---

# ipdata — Orthogonal API

> Pay-per-use API on Orthogonal. Each call is billed to your Orthogonal balance.
> Base API: `https://api.orthogonal.com/v1/run` · [llms.txt](https://www.orthogonal.com/llms.txt) · [browse all APIs](https://www.orthogonal.com/catalog)

IP geolocation and threat intelligence: location, ASN, company, mobile carrier, timezone, currency, language and threat flags (Tor, proxy, known attacker/abuser) for any IPv4 or IPv6 address.

**Verified:** no

## Access

**Run API:** `POST https://api.orthogonal.com/v1/run`
**Auth:** `Authorization: Bearer $ORTHOGONAL_API_KEY`
Get an API key at https://www.orthogonal.com/account/keys

No account or key yet? Set up Orthogonal first with https://www.orthogonal.com/skill.md: it covers the CLI, the MCP server, the TypeScript SDK and sign-up, including an agent sign-up without a password (https://www.orthogonal.com/agent-signup.md).

Every call goes through the unified Run API: send the API `slug`, the endpoint `path`, and the `query`/`body` parameters. The response is `{ "success": true, "priceCents": <US cents>, "requestId": "...", "data": { ... } }`.

Quote first, free: the same request with `"dryRun": true` returns the price without calling the API or charging anything. On a retry after a timeout, send the same `Idempotency-Key` header so the call runs and bills once.

## Endpoints

### IP geolocation lookup

Full lookup of one IPv4 or IPv6 address: location (city, region, country, continent, lat/long, postal), ASN, carrier, languages, currency, timezone and threat flags. Trim with fields.

`GET /{ip}`

**Estimated cost:** $0.000037

**Page:** https://www.orthogonal.com/api/ipdata/841455fe-d4db-437a-b4b6-047bafaf4b96

**Docs:** https://docs.ipdata.co/docs/getting-started

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `ip` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `fields` | string | No | Comma-separated names of the response fields to return, such as ip,city,country_name,carrier. |

```bash
# Replace {ip} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"ipdata","path":"/{ip}","method":"GET","query":{"fields":"<string>"}}'
```

### IP company lookup

Company that owns or uses the network an IP belongs to: name, domain, network and type (~2.7M companies across ~11M subnets). Startup plan and above.

`GET /{ip}/company`

**Estimated cost:** $0.000037

**Page:** https://www.orthogonal.com/api/ipdata/8d544609-f32a-4a0b-9070-ee3c927c6dd4

**Docs:** https://docs.ipdata.co/docs/company

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `ip` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |

```bash
# Replace {ip} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"ipdata","path":"/{ip}/company","method":"GET"}'
```

### IP mobile carrier

Mobile carrier of an IP (name, MCC, MNC) when the address belongs to a mobile network; over 2,500 carriers in 234 countries and territories.

`GET /{ip}/carrier`

**Estimated cost:** $0.000037

**Page:** https://www.orthogonal.com/api/ipdata/70a30bf7-ea93-4570-a1a9-42e873ec48e1

**Docs:** https://docs.ipdata.co/docs/mobile-carrier-detection

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `ip` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |

```bash
# Replace {ip} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"ipdata","path":"/{ip}/carrier","method":"GET"}'
```

### IP threat check

Threat intelligence for an IP: Tor, proxy, anonymous, known attacker, known abuser, bogon and overall threat flags (VPN flags, blocklists and reputation scores depend on the plan).

`GET /{ip}/threat`

**Estimated cost:** $0.000037

**Page:** https://www.orthogonal.com/api/ipdata/38563be3-8e6b-4ead-b71f-62fc97cb0397

**Docs:** https://docs.ipdata.co/docs/proxy-tor-and-threat-detection

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `ip` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |

```bash
# Replace {ip} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"ipdata","path":"/{ip}/threat","method":"GET"}'
```

### IP timezone lookup

Timezone of an IP: name, abbreviation, UTC offset, DST flag and current local time.

`GET /{ip}/time_zone`

**Estimated cost:** $0.000037

**Page:** https://www.orthogonal.com/api/ipdata/92c5249e-2c22-40e0-a21f-e42e0a87c4eb

**Docs:** https://docs.ipdata.co/docs/timezone-detection

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `ip` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |

```bash
# Replace {ip} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"ipdata","path":"/{ip}/time_zone","method":"GET"}'
```

### IP currency lookup

Home currency of an IP's country: name, ISO code, symbol, native symbol and plural.

`GET /{ip}/currency`

**Estimated cost:** $0.000037

**Page:** https://www.orthogonal.com/api/ipdata/65d01820-d60f-4983-9c5b-3b4948f51ea4

**Docs:** https://docs.ipdata.co/docs/currency-detection

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `ip` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |

```bash
# Replace {ip} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"ipdata","path":"/{ip}/currency","method":"GET"}'
```

### IP ASN lookup

Basic ASN data for an IP: AS number, name, domain, route and usage type.

`GET /{ip}/asn`

**Estimated cost:** $0.000037

**Page:** https://www.orthogonal.com/api/ipdata/2186ef3f-0f8a-4dc3-a7a8-cc294cbdb154

**Docs:** https://docs.ipdata.co/docs/asn-data

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `ip` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |

```bash
# Replace {ip} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"ipdata","path":"/{ip}/asn","method":"GET"}'
```

---

Full details and an interactive quickstart: https://www.orthogonal.com/publisher/ipdata
