Submit Documents API

Submit a document or set of documents on behalf of an end user. An end user may be of account type individual or corporate.

POST	https://api.sfox.com/v1/files/verification

---

Overview

This API allows Connect partners to submit one or more documents on behalf of an individual or corporate account.

The following steps provide an overview of how to do so:

1. First, you must obtain a User Auth Token, as that is going to be used during authorization when calling POST /files/verification. You can obtain a User Auth Token using this endpoint.

2. Then, you must obtain the sFOX-provided id that corresponds to the end user for which you are submitting documents. You can obtain the proper id by calling the GET user/{user_id} endpoint.

When uploading documents related to the corporate entity itself - such as a business_formation document, you should use the id of a beneficial owner within the account.

Providing this id will ensure documents flow into the sFOX system properly for our review.

1. You now have the necessary information to call the /files/verification endpoint to submit documents. A few notes:

   1. The request should use form-data encoding.

   2. There are two field names that must exist as part of the request: data and files.

      1. The data field includes the JSON encoded payload as defined below.

      2. The files field is an array of files that are binary encoded.

Regarding document context

A document is of a certain type, such as a passport or ownership_chart. Additionally a document is submitted to sFOX for a purpose; that purpose is to fulfill one or more requirements. This structure allows the sFOX team to obtain contextual information about the documents submitted and review them with that knowledge in-hand.

Request Fields

The data field includes a JSON payload with the below attributes:

Parameter	Type	Description
filename required	string	The name of the file being uploaded, including the extension. This must match the name of the file in the files key. Example: funding-overview.png
document_type required	string	Must be one of the following: passport, drivers_license_front, drivers_license_back, state_provincial_id_front, state_provincial_id_back, national_id_front, national_id_back, military_id, matriculate_id, visa, bank_statement, utility_bill, payslip, business_formation, ownership_chart, ownership_information, flow_of_funds, directors_register, aml_policy, shareholder_register, evidence_of_good_standing, marketing_materials, tax_id, e_signature_agreement, balance_sheet, financials, taxes, other
requirements required	array	Must be one or more of the following, separated by a comma: identity_verification, proof_of_address, proof_of_source_of_funds, proof_of_financial_means, proof_of_tax_id, proof_of_relationship, proof_of_nature_of_business, proof_of_account_purpose, proof_of_authority, proof_of_name_change, business_formation, business_ownership_or_organization_structure, other
related_entity_id required	string	The id corresponding to the individual or beneficial owner (for corporate accounts) for which you are submitting documents.

Example Requests

Data Field JSON

{
    "data": [
        {
            "filename": "funding-overview.png",
            "document_type": "flow_of_funds",
            "requirements": [
                "proof_of_nature_of_business"
            ],
            "related_entity_id": "{ID}"
        },
        {
            "filename": "formation.pdf",
            "document_type": "business_formation",
            "requirements": [
                "proof_of_tax_id", "proof_of_address"
            ],
            "related_entity_id": "{ID}"
        }
    ]
}

Shell

NodeJS

Python

Document Requirements

• The supported MIME types for document submission are image/jpeg, image/png, application/pdf .

• File extension must be one of jpg, jpeg, png, pdf.

• The file names specified for each file in the files array must exactly match the file name included in the data JSON payload.

Response

201 Created

// Request accepted, files uploaded successfully
{
    "data": [
        {
            "filename": "204b9810-d47b-11f0-a8e5-12e9c04dbb1d-flow_of_funds-funding-overview.png",
            "document_type": "flow_of_funds",
            "requirements": [
                "business_formation"
            ],
            "date_added": "2025-12-09T18:22:05.000Z"
        }
    ]
}