Upload a shareholder document
Use this endpoint to upload the identity document for one onboarding shareholder. Send the file as multipart/form-data. The file must be a PDF, JPEG, or PNG and cannot exceed 20 MB. The expected document type depends on the shareholder type: an identification for a natural person, or the articles of incorporation for a legal entity. You can upload documents only while the onboarding is in progress.
v2 · Base URL https://api.fintoc.com/v2Authorizations
Path Parameters
The unique identifier of the entity (for example ent_8anBwgZktbZH6ydyHa6Tm0eM).
The unique identifier of the onboarding (for example onbprc_0ujsswThIGTUYm2K8FjOOfXtY1K).
The unique identifier of the shareholder (for example onbsh_0ujsswThIGTUYm2K8FjOOfXtY1K).
Body
The document to upload. Must be a PDF, JPEG, or PNG and cannot exceed 20 MB.
Response
Returns the onboarding after Fintoc uploads the document. The shareholder document status is uploaded.
Unique identifier of the onboarding.
"onbprc_0ujsswThIGTUYm2K8FjOOfXtY1K"
Type of the object. Always onboarding.
Reviewed data for the onboarding, grouped by type. Onboardings created through the API include company_information and transactional_profile. Fintoc sets declaration_accepted to true on creation and returns incorporation_date as an ISO 8601 datetime in UTC.
Document slots for the onboarding, with their upload status.
Identifier of the entity this onboarding belongs to. null if not associated with an entity.
"ent_8anBwgZktbZH6ydyHa6Tm0eM"
Legal representatives declared for the entity.
ISO 8601 datetime, in UTC, of when the onboarding was reviewed. null until it is reviewed.
"2026-01-16T09:00:00Z"
Shareholders declared for the entity.
Channel the onboarding is being completed through. One of api or dashboard.
api, dashboard "api"
Current status of the onboarding. One of pending, in_progress, submitted, approved, rejected or cancelled.
pending, in_progress, submitted, approved, rejected, cancelled "pending"
Whether the onboarding has every required field and document completed and can be submitted for review.
false
ISO 8601 datetime, in UTC, of when the onboarding was submitted for review. null until it is submitted.
"2026-01-15T14:30:00Z"