Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API 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. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: Orisift Lookup API
version: '2026-09-28'
description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-09-28: 1 operation(s) read from 3 public documentation page(s) (each operation names its page in x-source). This is not the provider''s published contract; Orisift has published no machine-readable contract that the pipeline could find. Engine: local.'
x-evidence-tiers:
code-example: 0
documentation: 1
pages-with-code: 1
pages-read: 3
x-generated-from: documentation
x-provenance: generated
x-authored-by: API Evangelist
x-generated: '2026-09-28'
x-generator: generate-contract-from-docs.py
x-engine: local
x-sources:
- https://orisift.com/phone-number-validation-api
- https://orisift.com/docs
- https://orisift.com/for-agencies
security:
- bearer: []
tags:
- name: Lookup
paths:
/v1/lookup:
post:
operationId: post_v1_lookup
tags:
- Lookup
summary: Phone number validation with the evidence attached
x-source: https://orisift.com/phone-number-validation-api
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/PostV1LookupRequest'
responses:
'201':
description: Success (status as documented)
content:
application/json:
schema:
$ref: '#/components/schemas/PostV1LookupResponse'
x-evidence:
kind: documentation
components:
schemas:
PostV1LookupRequest:
type: object
properties:
phone_number:
type: string
description: The phone number to validate, e.g. +12125550142
required:
- phone_number
PostV1LookupResponse:
type: object
properties:
verdict:
type: string
description: Decision about the number, e.g. rejected
risk_score:
type: integer
description: Risk score associated with the number
evidence_coverage:
type: integer
description: Percentage of evidence coverage
credits:
type: integer
description: Credits consumed for the lookup
recommendation:
type: string
description: Suggested action for the caller
capability:
type: string
description: Capability state, e.g. VERIFIED
state:
type: string
description: State of the validation, e.g. Format VERIFIED
format:
type: string
description: Result of format parsing
plan_validity:
type: string
description: Validity of the numbering plan
carrier:
type: string
description: Carrier information (if available)
reachability:
type: string
description: Reachability status (if available)
source:
type: string
description: Source of the evidence, e.g. National regulator allocations
line_type:
type: string
description: Type of line (fixed line or mobile) derived from the numbering plan
securitySchemes:
bearer:
type: http
scheme: bearer