Sign in

v1

latestOpenAPI 3.1.02026-07-241653251.3 MB
Entity Participants

Submit entity documents

Submits a business document on behalf of an entity, or an identity document on behalf of a control person or a beneficial owner of the entity, if you operate a platform on zerohash.

EU NNP onboarding. For an entity onboarded through an EU-region platform, the required document set is lei_certificate, excerpt_of_the_chamber_of_commerce, annual_accounts, and power_of_authorization (a power of attorney or a board resolution authorising the submitter). When the entity was created with is_complex_structure: true, a legal_opinion document is additionally required before the entity can be approved. Any document without a dedicated type can be uploaded as supporting_document with a free-text document_description.

post/participants/entity/documents

Headers

X-SCX-SIGNEDstring required

HMAC-SHA256 signature of the request, base64-encoded. See the Authentication guide for the exact signing formula.

X-SCX-TIMESTAMPstring required
Example:1678901234

Current Unix timestamp in seconds. Must be within 60 seconds of server time or the request is rejected.

Request body

OR
OR

Example request

{
  "document": "aGVsbG8gd29ybGQ=",
  "mime": "pdf",
  "file_name": "supporting_document.pdf",
  "participant_code": "CUST01",
  "user_code": "XYZ789",
  "document_type": "us_passport",
  "id_front": true,
  "document_description": "Legal opinion - complex ownership structure"
}

Response

Successfully created entity document. Returns the created resource with generated IDs and timestamps.

Example response

{
  "message": {
    "state": "Success",
    "file_name": "supporting_document.pdf",
    "created_at": 1572899177383
  }
}