ZEzerohash
Individual Participants

Submit documents

Changed on

Submit a document on behalf of yourself or a customer as a platform on zerohash — for example identity documents, tax forms (such as form_w9), or other supporting files required to complete onboarding and verification. Files are provided as base64-encoded data with the target participant_code and the appropriate document_type.

post/participants/documents

Request

  • Base URL
    https://api.cert.zerohash.com
  • Auth
    API key in header X-SCX-API-KEY and API key in header X-SCX-PASSPHRASE

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
OR
OR

Example request

{
  "document": "aGVsbG8gd29ybGQ=",
  "mime": "pdf",
  "file_name": "supporting_document.pdf",
  "participant_code": "CUST01",
  "document_type": "us_drivers_license",
  "id_front": true
}

Response

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

Example response

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

Changes

  • 47cf70ae701cRevision changes
    • breaking

      removed subschema #1: Document - All accepted fields subschema #2: US - Single sided documents subschema #3: US - Two sided documents (Front + Back) subschema #4: EU - Single sided documents subschema #5: EU - Two sided documents (Front + Back) from the request body oneOf list

    • info

      added subschema #1: Document - All accepted fields subschema #2: US - Single sided documents subschema #3: US - Two sided documents (Front + Back) subschema #4: EU - Single sided documents subschema #5: EU - Two sided documents (Front + Back) to the request body anyOf list