ParseAPI Carrier API
Who serves a number: carrier, line type, and burner.
Who serves a number: carrier, line type, and burner.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/parseapi-com:parseapi-com-carrier-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Parse Carrier API
version: 1.0.0
summary: Fast APIs for developers, locate, validate, decode.
description: 'One base URL, one key, minimal JSON. Response schemas describe API 2.3.0. Paid plans include their profile detail automatically at its natural resource homes; Free returns the complete ordinary answer. There is no deep response object. When neither version header is sent, requests use the saved team default, or 1.0.0 for keyless self-lookups. Read https://parseapi.com/docs/versioning for other supported contracts. Responses that reach the organization rate check carry X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset. Optional X-RateLimit-Burst indicates continuous refill. Rate-limit 429 responses add Retry-After (seconds). See https://parseapi.com/agents and https://parseapi.com/llms.txt for agent-oriented guidance. Field-level docs: https://parseapi.com/docs Free-plan users must include a link to ParseAPI on their website, app, or project documentation. A footer, about page, credits page, or another reasonable location is fine. Paid plans do not require ParseAPI attribution. Example HTML: Data provided by ParseAPI. Details: https://parseapi.com/legal/attribution#crediting-parseapi.'
termsOfService: https://parseapi.com/legal/terms
contact:
name: ParseAPI
email: hello@parseapi.com
url: https://parseapi.com
servers:
- url: https://api.parseapi.com
description: Production
tags:
- name: Carrier
description: 'Who serves a number: carrier, line type, and burner.'
externalDocs:
description: Carrier Lookup API docs
url: https://parseapi.com/docs/carrier
paths:
/carrier/{number}:
get:
operationId: carrier
tags:
- Carrier
summary: Carrier and line type for a phone number
description: 'Who serves a number: carrier, line type, and burner. Full field reference: https://parseapi.com/docs/carrier'
security:
- ApiKeyAuth: []
- BearerAuth: []
parameters:
- $ref: '#/components/parameters/ParseVersion'
- name: number
in: path
required: true
description: Supplied check value. Invalid values return HTTP 200 with valid false.
schema:
type: string
example: '+12127365000'
maxLength: 4096
- name: country
in: query
required: false
description: Default region for national formats without a leading +
schema:
type: string
example: US
responses:
'200':
description: Success, minimal JSON object (shape varies by endpoint)
headers:
X-RateLimit-Limit:
description: Sustained requests per minute for your team
schema:
type: integer
X-RateLimit-Remaining:
description: Estimated requests available in the current window or token bucket
schema:
type: integer
X-RateLimit-Reset:
description: Seconds until the window resets, or until full bucket recovery with no more calls when X-RateLimit-Burst is present. On a 429 use Retry-After for the next attempt.
schema:
type: integer
X-RateLimit-Burst:
description: Optional token bucket capacity. When present, capacity replenishes continuously at X-RateLimit-Limit requests per minute.
schema:
type: integer
X-API-Version:
description: The exact response contract selected for this request.
schema:
type: string
enum:
- 1.0.0
- 2.0.0
- 2.1.0
- 2.2.0
- 2.3.0
content:
application/json:
schema:
type: object
properties:
phone:
type:
- string
- 'null'
valid:
type: boolean
country:
type:
- string
- 'null'
type:
anyOf:
- const: mobile
type: string
- const: landline
type: string
- const: voip
type: string
- const: toll_free
type: string
- const: unknown
type: string
- type: 'null'
carrier:
type:
- string
- 'null'
burner:
type:
- boolean
- 'null'
city:
type:
- string
- 'null'
state:
type:
- string
- 'null'
state_name:
type:
- string
- 'null'
required:
- phone
- valid
- country
- type
- carrier
- burner
- city
- state
- state_name
additionalProperties: true
'400':
description: invalid_request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: invalid_api_key
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: permission_denied or plan_required
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: not_found
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'410':
description: api_version_retired
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'429':
description: rate_limited or quota_exceeded
headers:
X-RateLimit-Limit:
description: Sustained requests per minute for your team
schema:
type: integer
X-RateLimit-Remaining:
description: Estimated requests available in the current window or token bucket
schema:
type: integer
X-RateLimit-Reset:
description: Seconds until the window resets, or until full bucket recovery with no more calls when X-RateLimit-Burst is present. On a 429 use Retry-After for the next attempt.
schema:
type: integer
X-RateLimit-Burst:
description: Optional token bucket capacity. When present, capacity replenishes continuously at X-RateLimit-Limit requests per minute.
schema:
type: integer
Retry-After:
description: Seconds to wait before retrying
schema:
type: integer
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'500':
description: server_error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'503':
description: service_unavailable
headers:
Retry-After:
description: Seconds to wait before retrying
schema:
type: integer
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
components:
parameters:
ParseVersion:
name: X-API-Version
in: header
required: false
description: Exact response contract for this lookup. Overrides the saved team default for this request only. Legacy Parse-Version is also accepted; both headers must match if sent together. With neither header, keyed requests use that default and keyless self-lookups use 1.0.0. Invalid or unsupported values return invalid_request (400). Retired selections return api_version_retired (410). Reference/help URLs keep their documented version and do not use this selector.
schema:
type: string
enum:
- 1.0.0
- 2.0.0
- 2.1.0
- 2.2.0
- 2.3.0
example: 2.3.0
schemas:
Error:
type: object
required:
- code
- message
- docs
- request_id
properties:
code:
type: string
description: Machine-readable error code
enum:
- invalid_request
- ambiguous_time
- nonexistent_time
- invalid_api_key
- permission_denied
- plan_required
- not_found
- api_version_retired
- rate_limited
- quota_exceeded
- server_error
- service_unavailable
- dns_resolution_failed
- task_invalid
- task_not_found
- task_request_conflict
- task_budget_exceeded
- task_limit_exceeded
- task_terms_changed
- task_expired
- task_cancelled
- task_in_progress
- task_outcome_unknown
- task_unavailable
message:
type: string
docs:
type: string
format: uri
description: Link to the docs section for this error
request_id:
type: string
description: Send this if you contact support
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: X-API-Key
description: API key from the ParseAPI dashboard
BearerAuth:
type: http
scheme: bearer
description: 'Same key as X-API-Key, via Authorization: Bearer'