---
title: "Retrieve the verification submission"
method: GET
path: "/client/kyb"
tags: ["verification"]
---

# Retrieve the verification submission

`GET /client/kyb`

## Request

- The document declares no server URL.
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/hevn-inc/apis/hevn-api/docs/client/kyb/get.ts> (a function with typed inputs; its response is checked against the schema)

Return the current editable applicant information, related people, filed documents, outstanding requirements and the latest review status. `missing` is authoritative for whether `complete` can succeed. A pending or completed review is read-only as an application snapshot; later draft edits apply to the next submission.

## Headers

- `X-Hevn-Account` string, required: The selected client account, as a `cl_…` id.

## Response `200`

Successful Response

- PlatformKybResponse
  - `ready` boolean, required: Whether all known requirements are satisfied and completion can be attempted.
  - `missing` string[]: Outstanding applicant fields or document slots.
  - `status` 'notStarted' | 'pending' | 'approved' | 'rfi' | 'rejected'
  - `application` PlatformKybApplicationResponse
    - `id` string, required: Immutable verification application identifier.
    - `attemptNo` integer, required: One-based submission attempt number for this account.
    - `status` 'notStarted' | 'pending' | 'approved' | 'rfi' | 'rejected', required
    - `comment` string, nullable: Review comment safe to show to the account holder.
    - `submittedAt` string, date-time, required: UTC timestamp when the immutable submission entered review.
    - `decidedAt` string, date-time, nullable: UTC timestamp of the latest review decision.
  - `document` PlatformKybDocumentBody
    - `company` PlatformKybCompanyView
      - `legalName` string, nullable: Registered legal name of the business applicant.
      - `tradeName` string, nullable: Trading name or DBA, when different from legalName.
      - `country` string, nullable: ISO 3166-1 alpha-2 jurisdiction of incorporation.
      - `registrationNumber` string, nullable: Company registry number exactly as issued.
      - `linkedinUrl` string, nullable: Public LinkedIn company URL.
      - `taxId` string, nullable: Business tax identifier exactly as issued.
      - `phone` string, nullable: Business phone number in E.164 format.
      - `email` string, nullable: Business contact email used for verification correspondence.
      - `address` PlatformKybAddressView
        - `streetAddress` string, nullable: Street name and building number.
        - `addressLine2` string, nullable: Optional apartment, suite or unit.
        - `city` string, nullable: City or locality.
        - `state` string, nullable: State, province or administrative area.
        - `zip` string, nullable: Postal or ZIP code.
        - `country` string, nullable: ISO 3166-1 alpha-2 country code.
      - `entityType` string, nullable: Legal form of the business applicant.
      - `entityTypeDescription` string, nullable: Legal-form detail when entityType is other.
      - `incorporationDate` string, date, nullable: Date the business was legally registered.
      - `industry` string, nullable: Free-text description of the business industry.
      - `websites` string[], nullable: Public business websites, primary site first.
      - `operatingCountries` string[], nullable: ISO country codes where the business operates.
      - `expectedMonthlyVolumeUsd` string, nullable: Expected total monthly transaction volume in USD.
      - `expectedCryptoMonthlyVolumeUsd` string, nullable: Expected monthly digital-asset transaction volume in USD.
      - `expectedMonthlyAchUsd` string, nullable: Expected monthly ACH volume in USD.
      - `expectedMonthlyWireUsd` string, nullable: Expected monthly international-transfer volume in USD.
      - `cryptoIndustrySubtype` string, nullable: Digital-asset business subtype.
      - `hasIntermediateEntityOwnership` boolean, nullable: Whether another legal entity exists between the applicant and an ultimate owner.
      - `primaryTargetMarket` string, nullable: Primary customer segment served by the business.
      - `estimatedAnnualRevenue` string, nullable: Estimated annual revenue in USD.
      - `hasUsBank` boolean, nullable: Whether the business holds a US payment account.
      - `deniedUsBank` boolean, nullable: Whether a US financial institution declined or closed the business account.
      - `hasPep` boolean, nullable: Whether a politically exposed person is connected.
      - `bizAdverse` string[], nullable: Declared adverse information about the business.
      - `ownersAdverse` string[], nullable: Declared adverse information about owners.
      - `publicListed` boolean, nullable: Whether the business is publicly listed.
      - `txPerMonth` string, nullable: Expected number of transactions per month.
      - `usesBlockchain` boolean, nullable: Whether digital assets are used in operations.
      - `revenueCovers` string, nullable: How much of operating expenses current revenue covers.
      - `institutionalInvestors` boolean, nullable: Whether institutional investors fund or own it.
      - `isRegulated` boolean, nullable: Whether the business is regulated or licensed.
      - `regulatorCountry` string, nullable: ISO 3166-1 alpha-2 country of the authority that licenses the business.
      - `regulatoryLicenseType` string, nullable: Type of regulatory license the business holds.
      - `verifiesCustomerIdentity` boolean, nullable: Whether the business verifies the identity of its own customers.
      - `hasTransactionMonitoring` boolean, nullable: Whether the business monitors its customers' transactions.
      - `productsServices` string[], nullable: Products and services offered by the business.
      - `businessDescription` string, nullable: Plain-language description of what the business does.
      - `businessType` string, nullable: High-level business activity category.
      - `businessIndustry` string, nullable: Industry classification used for verification.
      - `verifierRole` string, nullable: Role of the person providing verification information.
      - `sourceOfFunds` string, nullable: Primary economic source of incoming funds.
      - `sourceOfFundsDetails` string, nullable: Additional source-of-funds explanation.
      - `purposeOfFunds` string, nullable: Primary intended use of funds.
      - `purposeOfFundsDetails` string, nullable: Additional purpose-of-funds explanation.
      - `flowOfFunds` string, nullable: Expected origin, movement and destination of funds.
      - `complianceScreening` string, nullable: How customers and transactions are screened.
      - `moneyServicesDescription` string, nullable: Description of money-services activity.
      - `handlesCustomerFunds` boolean, nullable: Whether customer funds are handled.
      - `actingAsIntermediary` boolean, nullable: Whether the business acts as a payment intermediary.
      - `sanctionedCountryOperations` boolean, nullable: Whether the business operates in or serves sanctioned jurisdictions.
      - `highRiskActivities` string[], nullable: Declared higher-risk business activities.
      - `depositMethods` string[], nullable: Expected methods or regions used to fund the account.
      - `contactInfo` string, nullable: Additional business contact or operational information.
      - `identityDocuments` PlatformKybIdentityDocumentView[]: Structured identity-document metadata for the business.
        - `type` 'passport' | 'id_card' | 'drivers_license' | 'driver_license' | 'residence_permit' | 'government_id' | 'state_or_provincial_id' | 'visa': Identity document type.
        - `issuingCountry` string, nullable: ISO country code of the issuing authority.
        - `number` string, nullable: Document number exactly as printed by the issuer.
    - `people` PlatformKybPersonView[]: Related individual applicants.
      - `key` string, nullable: Caller-chosen stable key for this related applicant.
      - `id` string, uuid, required: Entity identifier assigned to the related applicant.
      - `firstName` string, nullable: Applicant's legal given name.
      - `middleName` string, nullable: Applicant's legal middle name, if any.
      - `lastName` string, nullable: Applicant's legal family name.
      - `dateOfBirth` string, date, nullable: Applicant's date of birth.
      - `birthCountry` string, nullable: ISO country code of birth.
      - `nationalities` string[], nullable: Applicant nationalities as ISO country codes.
      - `title` string, nullable: Office held in the business.
      - `country` string, nullable: ISO country code of residence.
      - `linkedinUrl` string, nullable: Public LinkedIn profile URL.
      - `email` string, nullable: Applicant email used for verification correspondence.
      - `phone` string, nullable: Applicant phone number in E.164 format.
      - `address` PlatformKybAddressView
        - `streetAddress` string, nullable: Street name and building number.
        - `addressLine2` string, nullable: Optional apartment, suite or unit.
        - `city` string, nullable: City or locality.
        - `state` string, nullable: State, province or administrative area.
        - `zip` string, nullable: Postal or ZIP code.
        - `country` string, nullable: ISO 3166-1 alpha-2 country code.
      - `taxIdCountry` string, nullable: ISO country code of tax residence.
      - `taxId` string, nullable: Personal tax identifier exactly as issued.
      - `identityDocuments` PlatformKybIdentityDocumentView[]: Identity-document metadata for this applicant.
        - `type` 'passport' | 'id_card' | 'drivers_license' | 'driver_license' | 'residence_permit' | 'government_id' | 'state_or_provincial_id' | 'visa': Identity document type.
        - `issuingCountry` string, nullable: ISO country code of the issuing authority.
        - `number` string, nullable: Document number exactly as printed by the issuer.
      - `ownershipPercentage` string, nullable: Direct ownership percentage.
      - `hasControl` boolean: Whether this applicant exercises control.
      - `isDirector` boolean: Whether this applicant is a director.
      - `isSigner` boolean: Whether this applicant is authorized to sign.
      - `documents` PlatformKybDocumentView[]: Files attached to this related applicant.
        - `slot` 'certificate_of_incorporation' | 'certificate_of_registration' | 'formation_document' | 'articles_of_incorporation' | 'power_of_attorney' | 'corporate_structure' | 'org_structure_chart' | 'company_registry_extract' | 'corporate_registry_extract' | 'shareholder_registry' | 'cap_table' | 'director_structure' | 'proof_of_address' | 'utility_bill' | 'aml_policy' | 'annual_financial_statements' | 'articles_of_association' | 'audit_report' | 'independent_aml_audit_report' | 'identity_verification_attestation' | 'institutional_investor_documentation' | 'audited_financial_statement' | 'bank_reference_letter' | 'bank_verification_letter' | 'bank_statement' | 'banking_details' | 'birth_certificate' | 'business_license' | 'operating_license' | 'business_plan' | 'certificate_of_good_standing' | 'corporate_resolution' | 'proof_of_registered_address' | 'proof_of_operating_address' | 'crypto_statement' | 'credit_report' | 'criminal_record_check' | 'cv_resume' | 'driving_license' | 'education_certificate' | 'financial_projections' | 'investment_statement' | 'insurance_policy' | 'lease_agreement' | 'marriage_certificate' | 'national_id' | 'national_id_front' | 'national_id_back' | 'operating_agreement' | 'partnership_agreement' | 'professional_license' | 'regulatory_license' | 'reference_letter' | 'register_of_members' | 'residence_permit' | 'shareholding_structure' | 'shareholders_agreement' | 'social_security_document' | 'source_of_funds_declaration' | 'tax_identification_document' | 'ein_letter' | 'tax_certificate' | 'tax_compliance_form' | 'tax_returns' | 'payslip' | 'pitch_deck' | 'savings_statement' | 'trade_references' | 'vat_registration' | 'vendor_contracts' | 'visa' | 'wealth_statement' | 'contract' | 'invoice' | 'loan_agreement' | 'subscription_agreement' | 'safe_agreement' | 'convertible_note' | 'promissory_note' | 'marketing_material' | 'employment_contract' | 'authorization_to_act' | 'authority_to_bind' | 'ubo_declaration' | 'income_verification_letter' | 'source_of_funds' | 'flow_of_funds' | 'payroll_register' | 'investment_agreement' | 'source_of_wealth' | 'supporting_document' | 'memorandum' | 'passport_front' | 'passport_back' | 'id_card_front' | 'id_card_back' | 'drivers_license_front' | 'drivers_license_back' | 'residence_permit_front' | 'residence_permit_back' | 'other', required
        - `uploadId` string, required: Document identifier returned by POST /dapi/v1/documents.
    - `documents` PlatformKybDocumentView[]: Business-level documents.
      - `slot` 'certificate_of_incorporation' | 'certificate_of_registration' | 'formation_document' | 'articles_of_incorporation' | 'power_of_attorney' | 'corporate_structure' | 'org_structure_chart' | 'company_registry_extract' | 'corporate_registry_extract' | 'shareholder_registry' | 'cap_table' | 'director_structure' | 'proof_of_address' | 'utility_bill' | 'aml_policy' | 'annual_financial_statements' | 'articles_of_association' | 'audit_report' | 'independent_aml_audit_report' | 'identity_verification_attestation' | 'institutional_investor_documentation' | 'audited_financial_statement' | 'bank_reference_letter' | 'bank_verification_letter' | 'bank_statement' | 'banking_details' | 'birth_certificate' | 'business_license' | 'operating_license' | 'business_plan' | 'certificate_of_good_standing' | 'corporate_resolution' | 'proof_of_registered_address' | 'proof_of_operating_address' | 'crypto_statement' | 'credit_report' | 'criminal_record_check' | 'cv_resume' | 'driving_license' | 'education_certificate' | 'financial_projections' | 'investment_statement' | 'insurance_policy' | 'lease_agreement' | 'marriage_certificate' | 'national_id' | 'national_id_front' | 'national_id_back' | 'operating_agreement' | 'partnership_agreement' | 'professional_license' | 'regulatory_license' | 'reference_letter' | 'register_of_members' | 'residence_permit' | 'shareholding_structure' | 'shareholders_agreement' | 'social_security_document' | 'source_of_funds_declaration' | 'tax_identification_document' | 'ein_letter' | 'tax_certificate' | 'tax_compliance_form' | 'tax_returns' | 'payslip' | 'pitch_deck' | 'savings_statement' | 'trade_references' | 'vat_registration' | 'vendor_contracts' | 'visa' | 'wealth_statement' | 'contract' | 'invoice' | 'loan_agreement' | 'subscription_agreement' | 'safe_agreement' | 'convertible_note' | 'promissory_note' | 'marketing_material' | 'employment_contract' | 'authorization_to_act' | 'authority_to_bind' | 'ubo_declaration' | 'income_verification_letter' | 'source_of_funds' | 'flow_of_funds' | 'payroll_register' | 'investment_agreement' | 'source_of_wealth' | 'supporting_document' | 'memorandum' | 'passport_front' | 'passport_back' | 'id_card_front' | 'id_card_back' | 'drivers_license_front' | 'drivers_license_back' | 'residence_permit_front' | 'residence_permit_back' | 'other', required
      - `uploadId` string, required: Document identifier returned by POST /dapi/v1/documents.

## Other responses

- `422`: Request validation failed

## Changes

- **2026-11-12** `299a3aa6f521`: 1 warning, 10 info
  - added the new `verification_not_applicable` enum value to the `error/code` response property for the response status `422`
  - added the optional property `document/company/anyOf[subschema #1: PlatformKybCompanyView]/hasTransactionMonitoring` to the response with the `200` status
  - added the optional property `document/company/anyOf[subschema #1: PlatformKybCompanyView]/regulatorCountry` to the response with the `200` status
  - added the optional property `document/company/anyOf[subschema #1: PlatformKybCompanyView]/regulatoryLicenseType` to the response with the `200` status
  - …7 more
- **2026-10-23** `a02795de2d2b`: 49 warning, 5 info
  - deleted the `header` request parameter `x-api-key`
  - added the new `audited_financial_statement` enum value to the `document/documents/items/slot` response property for the response status `200`
  - added the new `audited_financial_statement` enum value to the `document/people/items/documents/items/slot` response property for the response status `200`
  - added the new `bank_verification_letter` enum value to the `document/documents/items/slot` response property for the response status `200`
  - …50 more
- **2026-10-20** `19eb00e9f258`: 1 info
  - removed the `phone_in_use` enum value from the `error/code` response property for the response status `422`
- …earlier changes not shown

[Operation history](https://skmtc.dev/hevn-inc/apis/hevn-api/changes/client/kyb/get.md)

---

[API](https://skmtc.dev/hevn-inc/apis/hevn-api.md) - [All operations](https://skmtc.dev/hevn-inc/apis/hevn-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hevn-inc/apis/hevn-api/revisions/299a3aa6f521?raw)