orvel-dev Verification API
The verification API from orvel-dev — 15 operation(s) for verification.
The verification API from orvel-dev — 15 operation(s) for verification.
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/orvel-dev:orvel-dev-verification-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. 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: Orvel Dev Verification API
version: 0.1.1
contact:
name: EU Verify
url: https://verify.orvel.dev/
description: 'Operations tagged verification across 2 of this provider''s published API definitions: verify-orvel-dev-openapi.json, verify.json. Each path carries the servers of the definition it was published in.'
tags:
- name: Verification
paths:
/v1/vat/{vat}:
get:
tags:
- Verification
summary: Check an EU VAT number against VIES
operationId: vat_v1_vat__vat__get
parameters:
- name: vat
in: path
required: true
schema:
type: string
title: Vat
- name: country_code
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: Only needed when the number has no country prefix
title: Country Code
description: Only needed when the number has no country prefix
- name: requester_vat
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: 'Your own VAT number: switches to the authenticated consultation with a request identifier'
title: Requester Vat
description: 'Your own VAT number: switches to the authenticated consultation with a request identifier'
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'400':
description: Invalid input
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorOut'
'401':
description: Missing or invalid API key
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorOut'
'402':
description: Monthly quota exceeded
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorOut'
'429':
description: Anonymous rate limit reached
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorOut'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v1/siren/{q}:
get:
tags:
- Verification
summary: Look up a French business by SIREN, SIRET or name
operationId: siren_v1_siren__q__get
parameters:
- name: q
in: path
required: true
schema:
type: string
title: Q
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'400':
description: Invalid input
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorOut'
'401':
description: Missing or invalid API key
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorOut'
'402':
description: Monthly quota exceeded
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorOut'
'429':
description: Anonymous rate limit reached
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorOut'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v1/siret/{siret}/normalize:
get:
tags:
- Verification
summary: Validate and split a SIREN or SIRET
operationId: siret_normalize_v1_siret__siret__normalize_get
parameters:
- name: siret
in: path
required: true
schema:
type: string
title: Siret
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'400':
description: Invalid input
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorOut'
'401':
description: Missing or invalid API key
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorOut'
'402':
description: Monthly quota exceeded
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorOut'
'429':
description: Anonymous rate limit reached
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorOut'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v1/iban/{iban}:
get:
tags:
- Verification
summary: Check an IBAN, and the BIC when given
operationId: iban_v1_iban__iban__get
parameters:
- name: iban
in: path
required: true
schema:
type: string
title: Iban
- name: bic
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: Optional BIC to check against the IBAN
title: Bic
description: Optional BIC to check against the IBAN
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'400':
description: Invalid input
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorOut'
'401':
description: Missing or invalid API key
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorOut'
'402':
description: Monthly quota exceeded
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorOut'
'429':
description: Anonymous rate limit reached
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorOut'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v1/address/normalize:
post:
tags:
- Verification
summary: Normalise an EU postal address
operationId: address_v1_address_normalize_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/AddressRequest'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'400':
description: Invalid input
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorOut'
'401':
description: Missing or invalid API key
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorOut'
'402':
description: Monthly quota exceeded
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorOut'
'429':
description: Anonymous rate limit reached
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorOut'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v1/phone/{phone}:
get:
tags:
- Verification
summary: Normalise a phone number to E.164
operationId: phone_v1_phone__phone__get
parameters:
- name: phone
in: path
required: true
schema:
type: string
title: Phone
- name: region
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: ISO country code, for numbers written without a + prefix
title: Region
description: ISO country code, for numbers written without a + prefix
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'400':
description: Invalid input
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorOut'
'401':
description: Missing or invalid API key
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorOut'
'402':
description: Monthly quota exceeded
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorOut'
'429':
description: Anonymous rate limit reached
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorOut'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v1/email/{email}:
get:
tags:
- Verification
summary: 'Check an email address: syntax, MX, disposable'
operationId: email_v1_email__email__get
parameters:
- name: email
in: path
required: true
schema:
type: string
title: Email
- name: mx
in: query
required: false
schema:
type: boolean
description: Also look up the MX records of the domain
default: true
title: Mx
description: Also look up the MX records of the domain
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'400':
description: Invalid input
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorOut'
'401':
description: Missing or invalid API key
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorOut'
'402':
description: Monthly quota exceeded
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorOut'
'429':
description: Anonymous rate limit reached
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorOut'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v1/invoice-party:
post:
tags:
- Verification
summary: Decide whether a party is invoice-ready
operationId: invoice_party_v1_invoice_party_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/InvoicePartyRequest'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'400':
description: Invalid input
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorOut'
'401':
description: Missing or invalid API key
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorOut'
'402':
description: Monthly quota exceeded
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorOut'
'429':
description: Anonymous rate limit reached
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorOut'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v1/eori/{eori}:
get:
tags:
- Verification
summary: Check an EORI number against the EU EOS database
operationId: eori_v1_eori__eori__get
parameters:
- name: eori
in: path
required: true
schema:
type: string
title: Eori
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'400':
description: Invalid input
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorOut'
'401':
description: Missing or invalid API key
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorOut'
'402':
description: Monthly quota exceeded
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorOut'
'429':
description: Anonymous rate limit reached
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorOut'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v1/statuses:
get:
tags:
- Verification
summary: What each result status means
operationId: statuses_v1_statuses_get
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
/v1/plans:
get:
tags:
- Verification
summary: Public plan catalog with self-service checkout links
operationId: plans_v1_plans_get
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
/v1/checkout/{plan}:
get:
tags:
- Verification
summary: Redirect to Stripe Checkout for a plan
operationId: checkout_v1_checkout__plan__get
parameters:
- name: plan
in: path
required: true
schema:
type: string
title: Plan
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v1/billing/session/{session_id}:
get:
tags:
- Verification
summary: Return the API key after a successful Stripe Checkout
operationId: checkout_session_v1_billing_session__session_id__get
parameters:
- name: session_id
in: path
required: true
schema:
type: string
title: Session Id
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v1/billing/portal:
post:
tags:
- Verification
summary: Open the Stripe customer portal for this API key
operationId: billing_portal_v1_billing_portal_post
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
/v1/usage:
get:
tags:
- Verification
summary: Current monthly usage for the API key
operationId: usage_v1_usage_get
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/UsageOut'
components:
schemas:
ErrorOut:
properties:
code:
type: string
title: Code
message:
type: string
title: Message
details:
items:
additionalProperties: true
type: object
type: array
title: Details
type: object
required:
- code
- message
title: ErrorOut
InvoicePartyRequest:
properties:
role:
type: string
enum:
- seller
- buyer
title: Role
default: buyer
siren:
anyOf:
- type: string
- type: 'null'
title: Siren
siret:
anyOf:
- type: string
- type: 'null'
title: Siret
vat:
anyOf:
- type: string
- type: 'null'
title: Vat
iban:
anyOf:
- type: string
- type: 'null'
title: Iban
address:
anyOf:
- type: string
- type: 'null'
title: Address
postal_code:
anyOf:
- type: string
- type: 'null'
title: Postal Code
city:
anyOf:
- type: string
- type: 'null'
title: City
country_code:
anyOf:
- type: string
- type: 'null'
title: Country Code
eori:
anyOf:
- type: string
- type: 'null'
title: Eori
requester_vat:
anyOf:
- type: string
- type: 'null'
title: Requester Vat
description: Your VAT number, for a VIES request_identifier in the evidence pack
additionalProperties: false
type: object
title: InvoicePartyRequest
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
UsageOut:
properties:
plan:
type: string
title: Plan
used:
type: integer
title: Used
quota:
type: integer
title: Quota
remaining:
type: integer
title: Remaining
period:
type: string
title: Period
type: object
required:
- plan
- used
- quota
- remaining
- period
title: UsageOut
AddressRequest:
properties:
address:
type: string
title: Address
description: Street line, or the whole address as one line
default: ''
country_code:
anyOf:
- type: string
- type: 'null'
title: Country Code
description: ISO 3166-1 alpha-2, e.g. FR, DE, NL
postal_code:
anyOf:
- type: string
- type: 'null'
title: Postal Code
city:
anyOf:
- type: string
- type: 'null'
title: City
additionalProperties: false
type: object
title: AddressRequest
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
input:
title: Input
ctx:
type: object
title: Context
type: object
required:
- loc
- msg
- type
title: ValidationError
x-refined-from:
- verify-orvel-dev-openapi.json
- verify.json