# numlookupapi

> numlookupapi validates phone numbers and returns their formatting, country, location, carrier and line type over a simple JSON REST API.

Authenticate every request with your API key via the `apikey` query parameter or request header. Base URL: https://api.numlookupapi.com

## Documentation
- [Introduction](https://numlookupapi.com/docs): Learn everything there is to know about the numlookupapi.com API and integrate numlookupapi into your product.
- [Authentication](https://numlookupapi.com/docs/authentication): In this guide, we’ll look at how authentication works. numlookupapi offers two ways to authenticate your API requests: via GET parameter or alternatively via a HTTP header.
- [MCP Server](https://numlookupapi.com/docs/mcp): Connect AI agents to the numlookupapi API through our hosted MCP (Model Context Protocol) server.
- [Quickstart](https://numlookupapi.com/docs/quickstart): This guide will get you all set up and ready to use the numlookupapi.com API. We’ll cover how to get started an API client and how to make your first API request.
- [Rate Limit & Quotas](https://numlookupapi.com/docs/rate-limit): In this guide, we will look at how many open connections you can have with the numlookupapi.com API.
- [SDKs](https://numlookupapi.com/docs/sdks): numlookupapi offers fine-tuned JavaScript, Ruby, PHP, Python, and Go libraries to make your life easier and give you the best experience when consuming the API.
- [Status Endpoint](https://numlookupapi.com/docs/status): On this page, we’ll dive into the API status endpoint you can use to retrieve information about your request quota programmatically.
- [Request Status Codes](https://numlookupapi.com/docs/status-codes): In this guide, we will talk about what happens when something goes wrong while you work with the API.
- [Testing](https://numlookupapi.com/docs/testing): On this page, we’ll dive into testing the different API responses.
- [Phone Number Validation Endpoint](https://numlookupapi.com/docs/validate): On this page, we’ll dive into the phone number validation endpoint you can use to validate any given phone number and retrieve its carrier and location information.

## API Reference
- [OpenAPI 3.1 specification](https://numlookupapi.com/docs/openapi.yaml): Machine-readable spec for every API endpoint, parameters and responses.
- [Full documentation as markdown](https://numlookupapi.com/docs/llms-full.txt): All documentation pages concatenated as plain markdown.

## Optional
- [Pricing & plans](https://numlookupapi.com/#pricing)