Create entity evidence

POST/entities/{entity_id}/evidence

Add evidence to an entity. Supports file, signature, and third-party JSON evidence — if your KYC provider sends you a JSON blob, pass it directly in data with third_party_json as the evidence_type. A single submission can cover several purposes at once: Column creates one evidence record per entry in purposes, all referencing the same underlying document or data.

Path Parameters

entity_id

stringRequired

Unique identifier for the entity.

Body Parameters

data

objectOptional

Structured data associated with the evidence, as a JSON object. The shape of this object depends on the evidence type.

description

stringOptional

A description of the evidence. Maximum 255 characters.

evidence_type

stringRequired

The type of evidence to submit.

omit_data_in_response

booleanOptional

When true, the data field of each evidence object in the response is returned as an empty object. The submitted data is still stored in full. Use this to keep responses small when submitting large payloads for multiple purposes, since each created evidence object otherwise echoes the full data.

purposes

array of enumsRequired

The purposes of the evidence submission. Column creates one evidence record per purpose, all referencing the same document/data. Use cardholder_agreement for cardholder agreements collected for card programs. Possible values: proof_of_address, business_formation, identity_verification, tax_id_confirmation, active_status_certificate, signed_account_agreement, cardholder_agreement, attestation_control_person, attestation_beneficial_ownership, attestation_account_info_truth, attestation_terms_of_service, ofac_screening, adverse_media_screening, pep_screening, complete_customer_file, irs_form_ss4, irs_form_990, nonprofit_other_evidence, edd, attestation_privacy_policy