---
title: "API reference"
url: "https://lookvalid.com/docs/api.md"
canonical_url: "https://lookvalid.com/docs/api"
last_updated: "2026-10-22"
type: "index"
summary: "One reference page per LookValid endpoint, generated from the OpenAPI document, with credits and examples."
---

# API reference

One reference page per LookValid endpoint, generated from the OpenAPI document, with credits and examples.

One reference page per endpoint, generated from the API's own OpenAPI description. Each page lists the request fields, the response fields, the credits the endpoint costs, and copy-paste examples.

All endpoints live under `https://YOUR_API_HOST` and need an API key in the `Authorization` header. See [authentication](https://lookvalid.com/docs/authentication.md).

## Lookups

Lookups are `POST` requests with a JSON body.

| Endpoint | Product | Credits | Charged |
| --- | --- | --- | --- |
| [`POST /v1/phone`](https://lookvalid.com/docs/api/phone.md) | Phone Numbering-Plan Validation | 1 | Success only |
| [`POST /v1/country-code`](https://lookvalid.com/docs/api/country-code.md) | Country Calling Codes | 1 | Success only |
| [`POST /v1/email-domain-check`](https://lookvalid.com/docs/api/email-domain-check.md) | Email Domain Check | 1 | Success only |
| [`POST /v1/ip`](https://lookvalid.com/docs/api/ip.md) | IP Intelligence | 1 | Success only |
| [`POST /v1/phone-spam`](https://lookvalid.com/docs/api/phone-spam.md) | Phone Spam Check | 1 | Success only |
| [`POST /v1/link-safety`](https://lookvalid.com/docs/api/link-safety.md) | Link Safety Check | 1 | Every call |
| [`POST /v1/carrier-lookup`](https://lookvalid.com/docs/api/carrier-lookup.md) | Carrier Lookup (original carrier) | 1 | Success only |
| [`POST /v1/vin-decoder`](https://lookvalid.com/docs/api/vin-decoder.md) | VIN Decoder | 1 | Success only |
| [`POST /v1/link-in-bio-lookup`](https://lookvalid.com/docs/api/link-in-bio-lookup.md) | Link-in-Bio Lookup | 3 | Success only |
| [`POST /v1/domain-authority`](https://lookvalid.com/docs/api/domain-authority.md) | Domain Authority | 10 | Success only |
| [`POST /v1/domain-age`](https://lookvalid.com/docs/api/domain-age.md) | Domain Age | 2 | Success only |
| [`POST /v1/website-scraper`](https://lookvalid.com/docs/api/website-scraper.md) | Website Scraper | 10 | Success only |
| [`POST /v1/website-contacts-scraper`](https://lookvalid.com/docs/api/website-contacts-scraper.md) | Website Contacts Scraper | 10 | Success only |
| [`POST /v1/site-files`](https://lookvalid.com/docs/api/site-files.md) | Site Files Checker | 2 | Success only |

## Account

Account endpoints are free and never spend credits.

| Endpoint | What it returns |
| --- | --- |
| [`GET /v1/account`](https://lookvalid.com/docs/api/account.md) | Balance and API keys. |
| [`GET /v1/usage`](https://lookvalid.com/docs/api/usage.md) | Usage per product for a date range. |

## MCP

`POST /v1/mcp` is the [MCP server](https://lookvalid.com/docs/mcp.md). It offers every lookup above as a tool with an API key, and only the [free tools](https://lookvalid.com/tools.md) without one.

## Conventions

- Requests and responses are JSON. Request bodies are limited to 64 KB.
- A lookup that ran returns HTTP 200 with `found` true or false. Errors use the [error envelope](https://lookvalid.com/docs/errors.md).
- Every response has an `X-Request-Id` header. Quote it when you contact support.