Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Cadana KYB API

APIs for business verification

Cadana KYB API is one of 30 APIs that Cadana publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include KYB. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 4 operations across 2 paths, and defines 14 schemas. It is described by OpenAPI 3.0.0, at version 1.0.0.

Requests are made against 2 base URLs: https://api.cadanapay.com, https://dev-api.cadanapay.com.

4 operations 2 paths 14 schemas 1 GET1 PATCH2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
1.0.0
Base URL
https://api.cadanapay.com
Authentication
HTTP Bearer
License
Terms of Service
Resource Areas
1

Authentication & Security 1

Cadana KYB API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (API_SECRET_KEY) (Authorization). By default, every request must be authenticated.

Paths & Operations 4

Across 2 paths, the API surfaces 4 operations — 1 GET, 1 PATCH, 2 POST. Each is listed below with its method, path, parameters, and response codes.

KYB 4

APIs for business verification

POST
/v1/businesses/{businessId}/kyb
Submit KYB
submitKYB 2 params body → 2044004045XX
GET
/v1/businesses/{businessId}/kyb
Get KYB
getKyb 2 params → 2004004045XX
PATCH
/v1/businesses/{businessId}/kyb
Update KYB
updateKyb 2 params body → 2044004045XX
POST
/v1/businesses/{businessId}/kyb-link
Generate KYB Link
getKybLink 2 params body → 2004004045XX

Schemas 14

The contract defines 14 schemas that model the data the API accepts and returns. The most detailed are GetKYB (19 properties), KYBRequest (17 properties), KYBPrincipal (12 properties), PrincipalRequest (12 properties). Each schema is shown below with its type and property counts.

PrincipalRequest
object
A principal is either an individual or a business entity. For individuals, provide the personal fields (firstName, lastName, dateOfBirth, identifier, etc.). Fo…
12 properties
GenerateKybLinkRequest
phoneNumber
object
Person's phone number
2 properties
GetKYB
object
19 properties
uuid
string
KYBPrincipal
object
A principal on the KYB record — either an individual or, when isEntity is true, a business entity with its own owners nested under entity.individuals.
12 properties
InternalError
Internal server error
NotFoundError
Not Found
KYBRequest
object
17 properties
BadRequestError
Bad input provided by client
EntityIndividual
object
An owner or controlling person of an entity principal. Same shape as a top-level principal — when the owner is itself a company, set isEntity to true and provi…
12 properties
HostedLinkRequest
object
Common request body for endpoints that generate hosted (link-out) URLs.
2 properties
address
object
Address
6 properties 1 required
Error
object
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

cadana-kyb-api-openapi.yml Raw ↑

Other APIs Cadana publishes across the network.

Cadana Balances API
Cadana Beneficiaries API
Cadana Businesses API
Cadana Contracts API
Cadana Custom Auth API
Cadana Entities API
Cadana Events API
Cadana Files API
Cadana Filings API
Cadana FX API
Cadana Instant Pay API
Cadana Invoices API