Onboard businesses

A business must pass WisdomTree’s KYB review before it can trade. The business onboards through the KYB endpoints of its organization. Set provider to wisdomtree in each request. Privy forwards the data to WisdomTree. WisdomTree reviews submissions asynchronously. Privy does not store the KYB data.

Onboarding flow

Your app’s server submits the business data. The request also answers WisdomTree’s agreements.
WisdomTree reviews the submission. The status starts as pending.
WisdomTree may need changes. The status then moves to action_required. Your app answers each correction, and Privy submits the business again.
Once the status is approved, the organization can register wallets and trade.

The review uses these statuses:

Status	Meaning
`not_started`	The organization has not submitted KYB data to WisdomTree.
`pending`	WisdomTree is reviewing the submission.
`action_required`	WisdomTree needs corrections before it continues.
`approved`	The organization can register wallets and trade.
`rejected`	WisdomTree declined the business.
`suspended`	WisdomTree suspended the business.

Submit verification data

To submit an organization’s KYB data, send a POST request to:

https://api.privy.io/v1/organizations/{organization_id}/kyb/submit

Parameters

The body holds the business data and its answers to WisdomTree’s agreements.

'wisdomtree'

required

The fund provider.

'sandbox' | 'production'

The WisdomTree environment of the submission. Defaults to production. Use sandbox to test. See how the sandbox works.

object[]

The WisdomTree agreements the business accepts.

Show child attributes

'provider_terms' | 'stablecoin_customer_terms' | 'other'

required

The kind of terms. Use provider_terms for WisdomTree’s agreements.

string

required

The agreement’s ID.

string

required

The version of WisdomTree’s current agreement set.

string

required

ISO 8601 timestamp of when the business accepted the agreement.

string

The associated person who accepted the agreement for the business.

object[]

The WisdomTree agreements the business does not confirm.

Show child attributes

string

required

The agreement’s ID.

string

required

Why the business does not confirm the agreement.

object

required

The business’s KYB data. See business data fields.

Each agreement of WisdomTree’s current set must be either in agreements or in declined_agreements. If the request does not match the current set, Privy returns a 400 that lists the agreement IDs and the current version. Use that response as the source of truth: the set can change.

Returns

The endpoint returns 202 Accepted with the organization’s KYB status. See the status fields.

If WisdomTree does not answer, Privy returns 502 with the code provider_unavailable. Retry after a few minutes.

Example

This request submits a United States corporation with one owner.

curl -X POST https://api.privy.io/v1/organizations/{organization_id}/kyb/submit \
  -H "privy-app-id: <your-app-id>" \
  -H "Authorization: Basic <credentials>" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "wisdomtree",
    "environment": "sandbox",
    "agreements": [
      {
        "type": "provider_terms",
        "agreement_id": "<agreement-key>",
        "version": "<agreement-set-version>",
        "accepted_at": "2026-11-01T12:00:00.000Z"
      }
    ],
    "data": {
      "business_legal_name": "Acme Corp",
      "registered_address": {
        "street_line_1": "548 Market St",
        "city": "San Francisco",
        "subdivision": "CA",
        "postal_code": "94104",
        "country": "USA"
      },
      "country_of_incorporation": "USA",
      "business_type": "corporation",
      "business_description": "B2B payments platform",
      "email": "[email protected]",
      "identifying_information": [
        {"type": "ein", "issuing_country": "USA", "number": "12-3456789"}
      ],
      "account_purpose": "treasury_management",
      "source_of_funds": "operating_revenue",
      "associated_persons": [
        {
          "first_name": "Jane",
          "last_name": "Doe",
          "email": "[email protected]",
          "date_of_birth": "1985-06-15",
          "residential_address": {
            "street_line_1": "1 Main St",
            "city": "San Francisco",
            "subdivision": "CA",
            "postal_code": "94105",
            "country": "USA"
          },
          "has_ownership": true,
          "has_control": true,
          "is_signer": true,
          "ownership_percentage": 60,
          "is_us_person": true,
          "identifying_information": [
            {"type": "ssn", "issuing_country": "USA", "number": "123-45-6789"}
          ],
          "documents": [
            {"purposes": ["government_id"], "file": "data:application/pdf;base64,<...>"}
          ]
        }
      ],
      "documents": [
        {"purposes": ["w9"], "file": "data:application/pdf;base64,<...>"},
        {"purposes": ["business_formation"], "file": "data:application/pdf;base64,<...>"},
        {"purposes": ["ownership_information"], "file": "data:application/pdf;base64,<...>"}
      ]
    }
  }'

Example response

{
  "provider": "wisdomtree",
  "environment": "sandbox",
  "status": "pending",
  "kyb": {"status": "pending"},
  "requirements_due": [],
  "future_requirements_due": [],
  "resubmission": null
}

Business data fields

data uses the same shape as headless KYB. The same rules apply to its shared fields:

The business details and addresses.
identifying_information and associated_persons.
documents.

Country codes use ISO 3166-1 alpha-3. Unlike headless KYB, data has no investor status. WisdomTree also reads the fields below. The request does not require them. WisdomTree may still ask for them in a correction.

Optional fields WisdomTree reads

Field	Type	Description
`funds_ownership`	`string`	Who owns the funds the business invests: `business`, `customers`, `outside_investors`, `mixed`, or `other`.
`material_investors`	`object[]`	Investors with material ownership, each with `name`, `investor_type`, `country`, `ownership_percentage`, and `relationship_description`.
`ownership_threshold`	`number`	The ownership percentage, from 5 to 25, above which the business lists beneficial owners.
`has_material_intermediary_ownership`	`boolean`	Whether an intermediary entity holds material ownership.
`has_25_percent_beneficial_owner`	`boolean`	Whether a person owns 25% or more of the business.
`due_diligence_exemption_classifications`	`string[]`	The due diligence exemptions the business claims.
`fatf_high_risk_country_exposure`	`object`	Exposure to FATF high-risk countries, with `has_exposure`, `countries`, and `explanation`.
`complies_with_us_sanctions`	`boolean`	Whether the business complies with United States sanctions.
`aml_program`	`object`	The anti-money-laundering program, with `status` and `explanation`.
`sanctions_screening_lists`	`string[]`	The sanctions lists the business screens against: `ofac`, `un`, `eu`, `hmt_ofsi`, `dfat`, or `other`.
`compliance_screening_explanation`	`string`	How the business screens customers.
`blockchain_monitoring`	`object`	How the business monitors blockchain activity, with `status`, `provider`, and `explanation`.
`independent_compliance_testing`	`object`	Independent testing of the compliance program, with `status`, `tested_by`, `tested_at`, and `explanation`.
`compliance_officer`	`object`	The compliance officer, with `name`, `email`, and `phone`.
`operates_in_digital_assets`	`boolean`	Whether the business operates in digital assets.
`exercises_discretion_over_stablecoin_reserves`	`boolean`	Whether the business manages stablecoin reserves at its discretion.

The status of aml_program and blockchain_monitoring is implemented, in_progress, not_implemented, or not_applicable. The status of independent_compliance_testing is completed, scheduled, not_completed, or not_applicable. Each associated person can also include is_director, is_regulatory_notices_recipient, is_us_person, politically_exposed_person (is_pep and details), delegation (is_delegated), and relationship_established_at.

Check the review status

To check the status, send a GET request to:

https://api.privy.io/v1/organizations/{organization_id}/kyb?provider=wisdomtree

Add environment=sandbox to the query to read the sandbox status. The response lists one status for WisdomTree, in that environment:

Example response

{
  "kyb_statuses": [
    {
      "provider": "wisdomtree",
      "environment": "sandbox",
      "status": "action_required",
      "kyb": {"status": "action_required"},
      "requirements_due": ["org_details.tax_id"],
      "future_requirements_due": [],
      "resubmission": {
        "message": "Please correct the highlighted fields.",
        "due_at": "2026-11-15T00:00:00Z",
        "reasons": [
          {
            "id": 5,
            "field": "org_details.tax_id",
            "field_label": "Tax ID",
            "message": "The EIN does not match the IRS record",
            "required_action": "resubmit_corrected",
            "answered": false
          }
        ]
      }
    }
  ],
  "next_cursor": null
}

Status fields

The submit, status, and corrections endpoints all return these fields.

'wisdomtree'

The fund provider.

'sandbox' | 'production'

The WisdomTree environment of the status.

string

The organization’s KYB status. See the onboarding flow.

object

The KYB review.

Show child attributes

string

The KYB status.

string[] | undefined

WisdomTree’s reasons, while the status is rejected.

string[]

The fields WisdomTree needs corrected, by the provider’s field paths.

string[]

Fields WisdomTree may ask for later.

object | null

What WisdomTree needs corrected, while the status is action_required. null otherwise.

Show child attributes

string | null

A short summary to show the business.

string | null

The deadline to answer every reason.

object[]

The corrections to answer. Each has id, field, field_label, message, required_action, and answered.

Answer corrections

While the status is action_required, resubmission.reasons lists what WisdomTree needs. Answer each reason by its id. Send a POST request to:

https://api.privy.io/v1/organizations/{organization_id}/kyb/corrections/{reason_id}

Once your app answers every reason, Privy submits the business to WisdomTree again. The status then moves back to pending.

Parameters

Each reason has a required_action. It tells your app which field to send.

'wisdomtree'

required

The fund provider.

'sandbox' | 'production'

The WisdomTree environment of the submission to correct. Defaults to production. Use sandbox to test. See how the sandbox works.

boolean

required

Whether the business attests that the answer is accurate. false withdraws an earlier answer.

object

Corrected values by the provider’s field path, e.g. {"org_details.tax_id": "98-7654321"}. For reasons with required_action set to resubmit_corrected.

string

A base64 data URI of a PDF, JPEG, or PNG file. For reasons with required_action set to upload_replacement_document or upload_additional_document.

string

A written answer. For reasons with required_action set to provide_explanation.

Returns

The endpoint returns the organization’s KYB status. See the status fields.

Example

This request answers reason 5 with a new tax ID.

curl -X POST https://api.privy.io/v1/organizations/{organization_id}/kyb/corrections/5 \
  -H "privy-app-id: <your-app-id>" \
  -H "Authorization: Basic <credentials>" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "wisdomtree",
    "environment": "sandbox",
    "values": {"org_details.tax_id": "98-7654321"},
    "attested": true
  }'

If WisdomTree rejects an answer, for example a document that does not match what the reason asks for, Privy returns 400 with WisdomTree’s message. The reason stays unanswered.

Next steps

Once WisdomTree approves the business, register its wallets.

Register wallets

Webhooks

Receive tmmf.kyb.updated when WisdomTree takes a submission.

Earn

Tokenized money market funds

DeFi vaults

Onboarding flow

Submit verification data

Parameters

Returns

Example

Business data fields

Check the review status

Status fields

Answer corrections

Parameters

Returns

Example

Next steps

Register wallets

Webhooks

​Onboarding flow

​Submit verification data

​Parameters

​Returns

​Example

​Business data fields

​Check the review status

​Status fields

​Answer corrections

​Parameters

​Returns

​Example

​Next steps

Register wallets

Webhooks

Onboarding flow

Submit verification data

Parameters

Returns

Example

Business data fields

Check the review status

Status fields

Answer corrections

Parameters

Returns

Example

Next steps