curl --request POST \
--url https://api.fintoc.com/v2/entities/{entity_id}/onboardings \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"type": "account_holder",
"data": {
"company_information": {
"incorporation_date": "2020-01-15",
"business_activity": "Servicios financieros",
"sector": "ecommerce",
"fiscal_address": "Av. Reforma 123, CDMX",
"business_address": "Av. Insurgentes 456, CDMX",
"settlement_account": "646180357600000013",
"phone": "+521111111111"
},
"legal_representatives": [
{
"first_name": "Test Customer 1",
"last_name": "Customer",
"email": "rep@example.com",
"nationality": "mx",
"identification_number": "AAAA010101HDFAAA01",
"position": "Director General"
}
],
"transactional_profile": {
"resource_origins": [
"trusts",
"investments"
],
"monthly_amount_range": "1_2000000",
"monthly_operations_range": "1_15000",
"account_purpose": "own_sales_collection"
},
"shareholders": [
{
"type": "natural_person",
"name": "Test Customer 2",
"last_name": "Customer",
"nationality": "mx",
"percentage": 60,
"holder_id": "AAAA010101AAA"
},
{
"type": "legal_entity",
"name": "Acme SA",
"nationality": "mx",
"percentage": 40,
"holder_id": "AAA010101AAA",
"children": [
{
"type": "natural_person",
"name": "Test Customer 3",
"last_name": "Customer",
"nationality": "mx",
"percentage": 80,
"holder_id": "AAAA010101AAA"
}
]
}
]
}
}
'{
"id": "onbprc_0ujsswThIGTUYm2K8FjOOfXtY1K",
"object": "onboarding",
"entity_id": "ent_8anBwgZktbZH6ydyHa6Tm0eM",
"type": "account_holder",
"status": "in_progress",
"source": "api",
"submitted_at": null,
"reviewed_at": null,
"submittable": false,
"data": {
"company_information": {
"incorporation_date": "2020-01-15T00:00:00.000Z",
"business_activity": "Servicios financieros",
"sector": "ecommerce",
"fiscal_address": "Av. Reforma 123, CDMX",
"business_address": "Av. Insurgentes 456, CDMX",
"settlement_account": "000000000000000000",
"phone": "+521111111111"
},
"transactional_profile": {
"resource_origins": [
"trusts",
"investments"
],
"monthly_amount_range": "1_2000000",
"monthly_operations_range": "1_15000",
"account_purpose": "own_sales_collection",
"declaration_accepted": true
}
},
"legal_representatives": [
{
"id": "onblr_0ujsswThIGTUYm2K8FjOOfXtY1K",
"object": "onboarding_legal_representative",
"first_name": "Test Customer 1",
"last_name": "Customer",
"email": "rep@example.com",
"nationality": "mx",
"identification_number": "AAAA010101HDFAAA01",
"position": "Director General",
"documents": [
{
"slot_key": "identification",
"status": "missing"
},
{
"slot_key": "power_of_attorney",
"status": "missing"
}
]
}
],
"shareholders": [
{
"id": "onbsh_0ujsswThIGTUYm2K8FjOOfXtY1K",
"object": "onboarding_shareholder",
"type": "natural_person",
"name": "Test Customer 2",
"last_name": "Customer",
"percentage": 60,
"holder_id": "AAAA010101AAA",
"parent_id": null,
"document": {
"slot_key": "identification",
"status": "missing"
}
},
{
"id": "onbsh_8anBwgZktbZH6ydyHa6Tm0eM",
"object": "onboarding_shareholder",
"type": "legal_entity",
"name": "Acme SA",
"percentage": 40,
"holder_id": "AAA010101AAA",
"parent_id": null,
"document": {
"slot_key": "articles_of_incorporation",
"status": "missing"
}
},
{
"id": "onbsh_9bnCxhAlucAI7zezIb7Un1fN",
"object": "onboarding_shareholder",
"type": "natural_person",
"name": "Test Customer 3",
"last_name": "Customer",
"percentage": 80,
"holder_id": "AAAA010101AAA",
"parent_id": "onbsh_8anBwgZktbZH6ydyHa6Tm0eM",
"document": {
"slot_key": "identification",
"status": "missing"
}
}
],
"documents": [
{
"slot_key": "tax_registration_certificate",
"status": "missing"
},
{
"slot_key": "settlement_bank_statement",
"status": "missing"
},
{
"slot_key": "proof_of_address",
"status": "missing"
},
{
"slot_key": "shareholder_structure",
"status": "missing"
},
{
"slot_key": "articles_of_incorporation",
"status": "missing"
}
]
}Create an onboarding
Creates an onboarding from the data required for the entity’s country. Provide all company answers when creating the onboarding, then upload documents and submit it for review.
curl --request POST \
--url https://api.fintoc.com/v2/entities/{entity_id}/onboardings \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"type": "account_holder",
"data": {
"company_information": {
"incorporation_date": "2020-01-15",
"business_activity": "Servicios financieros",
"sector": "ecommerce",
"fiscal_address": "Av. Reforma 123, CDMX",
"business_address": "Av. Insurgentes 456, CDMX",
"settlement_account": "646180357600000013",
"phone": "+521111111111"
},
"legal_representatives": [
{
"first_name": "Test Customer 1",
"last_name": "Customer",
"email": "rep@example.com",
"nationality": "mx",
"identification_number": "AAAA010101HDFAAA01",
"position": "Director General"
}
],
"transactional_profile": {
"resource_origins": [
"trusts",
"investments"
],
"monthly_amount_range": "1_2000000",
"monthly_operations_range": "1_15000",
"account_purpose": "own_sales_collection"
},
"shareholders": [
{
"type": "natural_person",
"name": "Test Customer 2",
"last_name": "Customer",
"nationality": "mx",
"percentage": 60,
"holder_id": "AAAA010101AAA"
},
{
"type": "legal_entity",
"name": "Acme SA",
"nationality": "mx",
"percentage": 40,
"holder_id": "AAA010101AAA",
"children": [
{
"type": "natural_person",
"name": "Test Customer 3",
"last_name": "Customer",
"nationality": "mx",
"percentage": 80,
"holder_id": "AAAA010101AAA"
}
]
}
]
}
}
'{
"id": "onbprc_0ujsswThIGTUYm2K8FjOOfXtY1K",
"object": "onboarding",
"entity_id": "ent_8anBwgZktbZH6ydyHa6Tm0eM",
"type": "account_holder",
"status": "in_progress",
"source": "api",
"submitted_at": null,
"reviewed_at": null,
"submittable": false,
"data": {
"company_information": {
"incorporation_date": "2020-01-15T00:00:00.000Z",
"business_activity": "Servicios financieros",
"sector": "ecommerce",
"fiscal_address": "Av. Reforma 123, CDMX",
"business_address": "Av. Insurgentes 456, CDMX",
"settlement_account": "000000000000000000",
"phone": "+521111111111"
},
"transactional_profile": {
"resource_origins": [
"trusts",
"investments"
],
"monthly_amount_range": "1_2000000",
"monthly_operations_range": "1_15000",
"account_purpose": "own_sales_collection",
"declaration_accepted": true
}
},
"legal_representatives": [
{
"id": "onblr_0ujsswThIGTUYm2K8FjOOfXtY1K",
"object": "onboarding_legal_representative",
"first_name": "Test Customer 1",
"last_name": "Customer",
"email": "rep@example.com",
"nationality": "mx",
"identification_number": "AAAA010101HDFAAA01",
"position": "Director General",
"documents": [
{
"slot_key": "identification",
"status": "missing"
},
{
"slot_key": "power_of_attorney",
"status": "missing"
}
]
}
],
"shareholders": [
{
"id": "onbsh_0ujsswThIGTUYm2K8FjOOfXtY1K",
"object": "onboarding_shareholder",
"type": "natural_person",
"name": "Test Customer 2",
"last_name": "Customer",
"percentage": 60,
"holder_id": "AAAA010101AAA",
"parent_id": null,
"document": {
"slot_key": "identification",
"status": "missing"
}
},
{
"id": "onbsh_8anBwgZktbZH6ydyHa6Tm0eM",
"object": "onboarding_shareholder",
"type": "legal_entity",
"name": "Acme SA",
"percentage": 40,
"holder_id": "AAA010101AAA",
"parent_id": null,
"document": {
"slot_key": "articles_of_incorporation",
"status": "missing"
}
},
{
"id": "onbsh_9bnCxhAlucAI7zezIb7Un1fN",
"object": "onboarding_shareholder",
"type": "natural_person",
"name": "Test Customer 3",
"last_name": "Customer",
"percentage": 80,
"holder_id": "AAAA010101AAA",
"parent_id": "onbsh_8anBwgZktbZH6ydyHa6Tm0eM",
"document": {
"slot_key": "identification",
"status": "missing"
}
}
],
"documents": [
{
"slot_key": "tax_registration_certificate",
"status": "missing"
},
{
"slot_key": "settlement_bank_statement",
"status": "missing"
},
{
"slot_key": "proof_of_address",
"status": "missing"
},
{
"slot_key": "shareholder_structure",
"status": "missing"
},
{
"slot_key": "articles_of_incorporation",
"status": "missing"
}
]
}Authorizations
Path Parameters
Unique identifier for the entity, such as ent_8anBwgZktbZH6ydyHa6Tm0eM.
Body
Type of onboarding to create: account_holder or settlement_recipient.
account_holder, settlement_recipient Onboarding answers, grouped by step. Mexican account holders provide company_information, legal_representatives, transactional_profile, and shareholders. Chilean account holders provide company_basics, company_information, senior_management, legal_representatives, shareholders, transactional_profile, and plaft. position is optional for Chilean representatives. Each Chilean shareholder also includes address, fiscal_address, and effective_controller. company_basics.incorporation_type (one_day_company or traditional) determines the company document slots, and plaft.uaf_obligated decides whether you must upload uaf_registration_certificate and plaft_manual_and_policies. Chilean companies onboarding as settlement recipients must also send company_information.activities_start_date, the date the company started activities before the Chilean tax authority, as an ISO 8601 date such as 2018-05-02. For Mexican account_holder onboardings, transactional_profile.account_purpose is required. Allowed values: own_sales_collection, collection_and_dispersion, marketplace, psp_aggregator, third_party_dispersion, betting_gaming, other. transactional_profile.account_purpose_details is required when account_purpose is other; provide a description of the intended account use.
- Option 1
- Option 2
Show child attributes
Show child attributes
Response
The API starts the onboarding process from the provided data and returns the created onboarding.
Unique identifier of the onboarding.
"onbprc_0ujsswThIGTUYm2K8FjOOfXtY1K"
Type of the object. Always onboarding.
Reviewed answers, grouped by step. The fields depend on the onboarding type and the entity's country. Chilean account holders include company_basics, company_information, senior_management, transactional_profile, and plaft. Mexican account holders include company_information and transactional_profile, with declaration_accepted set to true and incorporation_date returned as an ISO 8601 datetime in UTC.
{
"company_information": {
"incorporation_date": "2020-01-15T00:00:00.000Z",
"business_activity": "Servicios financieros",
"sector": "ecommerce",
"fiscal_address": "Av. Reforma 123, CDMX",
"business_address": "Av. Insurgentes 456, CDMX",
"settlement_account": "000000000000000000",
"phone": "+521111111111"
},
"transactional_profile": {
"resource_origins": ["trusts", "investments"],
"monthly_amount_range": "1_2000000",
"monthly_operations_range": "1_15000",
"account_purpose": "own_sales_collection",
"declaration_accepted": true
}
}
Document slots for the onboarding, with their upload status. A slot that accepts more than one file appears once per uploaded file, repeating its slot_key. A slot with no files appears once, with status set to missing. Chilean account holders always list uaf_registration_certificate and plaft_manual_and_policies, but you upload them only if plaft.uaf_obligated is true.
Show child attributes
Show child attributes
Identifier of the entity this onboarding belongs to. null if not associated with an entity.
"ent_8anBwgZktbZH6ydyHa6Tm0eM"
Legal representatives declared for the entity.
Show child attributes
Show child attributes
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.
Show child attributes
Show child attributes
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"
Type of the onboarding: account_holder or settlement_recipient.
account_holder, settlement_recipient "account_holder"
Was this page helpful?