Bond KYB API

The KYB API from Bond — 3 operation(s) for kyb.

Operations 4

GET /businesses/{business_id}/verification-kyb Retrieve KYB Status #
POST /businesses/{business_id}/verification-kyb Start KYB (Know-Your-Business) #
POST /kyb Start v2 KYB (Know-Your-Business) #
POST /kyb/{inquiry_id}/resume Resume v2 KYB (Know-Your-Business) #

Specifications

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/bond/refs/heads/main/json-schema/bond-account-docs-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/bond/refs/heads/main/json-schema/bond-statement-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/bond/refs/heads/main/json-schema/bond-account-write-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/bond/refs/heads/main/json-schema/bond-account-patch-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/bond/refs/heads/main/json-schema/bond-businesses-post-serializer-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/bond/refs/heads/main/json-schema/bond-businesses-patch-serializer-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/bond/refs/heads/main/json-schema/bond-address-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/bond/refs/heads/main/json-schema/bond-beneficial-owner-address-patch-serializer-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/bond/refs/heads/main/json-schema/bond-beneficial-owner-post-serializer-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/bond/refs/heads/main/json-schema/bond-kycpost-payload-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/bond/refs/heads/main/json-schema/bond-card-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/bond/refs/heads/main/json-schema/bond-card-restriction-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/bond/refs/heads/main/json-schema/bond-card-write-post-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/bond/refs/heads/main/json-schema/bond-card-restriction-write-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/bond/refs/heads/main/json-schema/bond-card-reissue-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/bond/refs/heads/main/json-schema/bond-card-write-patch-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/bond/refs/heads/main/json-schema/bond-credit-application-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/bond/refs/heads/main/json-schema/bond-credit-application-get-multiple-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/bond/refs/heads/main/json-schema/bond-credit-application-write-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/bond/refs/heads/main/json-schema/bond-adverse-actions-get-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/bond/refs/heads/main/json-schema/bond-credit-application-patch-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/bond/refs/heads/main/json-schema/bond-customer-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/bond/refs/heads/main/json-schema/bond-customer-write-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/bond/refs/heads/main/json-schema/bond-customer-patch-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/bond/refs/heads/main/json-schema/bond-transaction-schema-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/bond/refs/heads/main/json-schema/bond-paginated-transactions-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/bond/refs/heads/main/json-schema/bond-simulate-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/bond/refs/heads/main/json-schema/bond-settle-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/bond/refs/heads/main/json-schema/bond-kyc-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/bond/refs/heads/main/json-schema/bond-transfer-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/bond/refs/heads/main/json-schema/bond-transfer-write-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/bond/refs/heads/main/json-schema/bond-webhook-post-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/bond/refs/heads/main/json-schema/bond-webhook-patch-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/bond/refs/heads/main/json-schema/bond-all-webhooks-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/bond/refs/heads/main/json-schema/bond-webhook-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/bond:bond-kyb-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

bond-kyb-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Business KYB API
  description: Businesses
  version: '0'
servers:
- url: https://sandbox.bond.tech/api/v0
security:
- identity: []
  authorization: []
tags:
- name: KYB
paths:
  /businesses/{business_id}/verification-kyb:
    get:
      tags:
      - KYB
      summary: Retrieve KYB Status
      description: Retrieve the KYB status of a `Business`
      operationId: get_kyb
      parameters:
      - name: business_id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              examples:
                example:
                  value:
                    business_id: 12348579-5d05-4e3e-a5e3-e61e3a5b1234
                    kyb_status: warning
                    details:
                    - code: rejected_address
                      reason: address verification failed
                    - code: rejected_tin
                      reason: TIN verification failed
                    - code: rejected_name
                      reason: name verification failed
                    - code: rejected_watchlist
                      reason: watchlist verification failed.
    post:
      tags:
      - KYB
      summary: Start KYB (Know-Your-Business)
      description: Start a KYB verification for a `Business`
      operationId: post_kyb
      parameters:
      - name: business_id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              examples:
                example:
                  value:
                    business_id: 12348579-5d05-4e3e-a5e3-e61e3a5b1234
                    kyb_status: initiated
  /kyb:
    post:
      tags:
      - KYB
      summary: Start v2 KYB (Know-Your-Business)
      description: Start a KYB verification for a `Business` on given program
      operationId: post_kyb_2
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/KYBPostSerializer'
        required: true
      responses:
        '200':
          description: ''
          content:
            application/json:
              examples:
                example:
                  value:
                    inquiry_id: inq_ZgXs71DijBhW1k7uoBvQrCK2
                    url: https://withpersona.com/verify?inquiry-id=inq_ZgXs71DijBhW1k7uoBvQrCK2
  /kyb/{inquiry_id}/resume:
    post:
      tags:
      - KYB
      summary: Resume v2 KYB (Know-Your-Business)
      description: Resume a KYB verification for a given inquiry
      operationId: post_kyb_resume
      parameters:
      - name: inquiry_id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              examples:
                example:
                  value:
                    session_token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJpcXNlX1VBTWZFRjJaUnpMOUJIVmdLQXN4S295RCIsImF1ZCI6InBlcnNvbmEtdmVyaWZ5IiwiaXNzIjoid2l0aHBlcnNvbmEuY29tIiwiaWF0IjoxNjg1NDc2MTUyLCJuYmYiOjE2ODU0NzYxNTIsImV4cCI6MTY4NjY4NTczNSwianRpIjoiZGZkYjRjNmEtOWNmNS00MjliLTlmNGMtM2Q5YmVhNjRkYTY3IiwiaW5xdWlyeV9pZCI6ImlucV9aZ1hzNzFEaWpCaFcxazd1b0J2UXJDSzIiLCJlbnZpcm9ubWVudF9pZCI6ImVudl9ldXN4N1hKM2M1VVFyTlVSNTFkRUhlaGMifQ.y7U3HkHR9WRpQRbhkQEoz50sAlz5MozAXcXR7Ip_5XA
                    url: https://withpersona.com/verify?inquiry-id=inq_ZgXs71DijBhW1k7uoBvQrCK2&session-token=eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJpcXNlX1VBTWZFRjJaUnpMOUJIVmdLQXN4S295RCIsImF1ZCI6InBlcnNvbmEtdmVyaWZ5IiwiaXNzIjoid2l0aHBlcnNvbmEuY29tIiwiaWF0IjoxNjg1NDc2MTUyLCJuYmYiOjE2ODU0NzYxNTIsImV4cCI6MTY4NjY4NTczNSwianRpIjoiZGZkYjRjNmEtOWNmNS00MjliLTlmNGMtM2Q5YmVhNjRkYTY3IiwiaW5xdWlyeV9pZCI6ImlucV9aZ1hzNzFEaWpCaFcxazd1b0J2UXJDSzIiLCJlbnZpcm9ubWVudF9pZCI6ImVudl9ldXN4N1hKM2M1VVFyTlVSNTFkRUhlaGMifQ.y7U3HkHR9WRpQRbhkQEoz50sAlz5MozAXcXR7Ip_5XA
components:
  schemas:
    KYBPostSerializer:
      required:
      - business_id
      - program_id
      type: object
      properties:
        business_id:
          type: string
          description: UUID of the business to be reviewed for KYB
          example: a1163ef7-f477-4c79-86cc-ba5e85ec3acb
        program_id:
          type: string
          description: UUID of the program to be setup (sponsor bank on this program determines KYB type)
          example: da7f5c2a-6fa0-4033-be12-e29a793eaaaa
  securitySchemes:
    identity:
      type: apiKey
      name: Identity
      in: header
    authorization:
      type: apiKey
      name: Authorization
      in: header
x-samples-languages:
- curl
- node
- ruby
- javascript
- python
- csharp
- java
x-provenance:
  method: searched
  source: https://docs.bond.tech/reference
  harvested: '2026-10-14'
  tool: harvest-readme-openapi.py
  note: Assembled verbatim from the OpenAPI definition ReadMe embeds in each operation page of the provider's developer portal; paths and components merged by API title, nothing authored.
  assembled_from:
  - https://docs.bond.tech/reference/delete_beneficial_owner.md
  - https://docs.bond.tech/reference/delete_beneficial_owner_address.md
  - https://docs.bond.tech/reference/delete_business.md
  - https://docs.bond.tech/reference/delete_business_address.md
  - https://docs.bond.tech/reference/get_beneficial_owner.md
  - https://docs.bond.tech/reference/get_beneficial_owner_address.md
  - https://docs.bond.tech/reference/get_beneficial_owner_addresses.md
  - https://docs.bond.tech/reference/get_beneficial_owner_kyc.md
  - https://docs.bond.tech/reference/get_beneficial_owners.md
  - https://docs.bond.tech/reference/get_business.md
  - https://docs.bond.tech/reference/get_business_address.md
  - https://docs.bond.tech/reference/get_business_addresses.md
  - https://docs.bond.tech/reference/get_businesses.md
  - https://docs.bond.tech/reference/get_kyb.md
  - https://docs.bond.tech/reference/patch_beneficial_owner.md
  - https://docs.bond.tech/reference/patch_beneficial_owner_address.md
  - https://docs.bond.tech/reference/patch_business.md
  - https://docs.bond.tech/reference/patch_business_address.md
  - https://docs.bond.tech/reference/post_beneficial_owner_addresses.md
  - https://docs.bond.tech/reference/post_beneficial_owner_kyc.md
  - https://docs.bond.tech/reference/post_beneficial_owners.md
  - https://docs.bond.tech/reference/post_business_addresses.md
  - https://docs.bond.tech/reference/post_businesses.md
  - https://docs.bond.tech/reference/post_kyb.md
  - https://docs.bond.tech/reference/post_kyb_2.md
  - https://docs.bond.tech/reference/post_kyb_resume.md
  merge:
    pages: 26
    deduped: 64
    conflicts_kept_first: 0