Submit an onboarding

curl --request POST \
  --url https://api.fintoc.com/v2/entities/{entity_id}/onboardings/{id}/submit \
  --header 'Authorization: <api-key>'

import requests

url = "https://api.fintoc.com/v2/entities/{entity_id}/onboardings/{id}/submit"

headers = {"Authorization": "<api-key>"}

response = requests.post(url, headers=headers)

print(response.text)

const options = {method: 'POST', headers: {Authorization: '<api-key>'}};

fetch('https://api.fintoc.com/v2/entities/{entity_id}/onboardings/{id}/submit', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fintoc.com/v2/entities/{entity_id}/onboardings/{id}/submit",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.fintoc.com/v2/entities/{entity_id}/onboardings/{id}/submit"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.fintoc.com/v2/entities/{entity_id}/onboardings/{id}/submit")
  .header("Authorization", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.fintoc.com/v2/entities/{entity_id}/onboardings/{id}/submit")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "id": "onbprc_0ujsswThIGTUYm2K8FjOOfXtY1K",
  "object": "onboarding",
  "entity_id": "ent_8anBwgZktbZH6ydyHa6Tm0eM",
  "status": "submitted",
  "source": "api",
  "submitted_at": "2024-01-01T00:00:00Z",
  "reviewed_at": null,
  "submittable": false,
  "data": {
    "company_information": {
      "incorporation_date": "2020-01-15T00:00:00.000Z",
      "business_activity": "Servicios financieros",
      "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_500000",
      "monthly_operations_range": "1_15000",
      "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": "uploaded",
          "filename": "id.pdf",
          "uploaded_at": "2024-01-01T00:00:00Z"
        },
        {
          "slot_key": "power_of_attorney",
          "status": "uploaded",
          "filename": "poa.pdf",
          "uploaded_at": "2024-01-01T00:00:00Z"
        }
      ]
    }
  ],
  "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": "uploaded",
        "filename": "id.pdf",
        "uploaded_at": "2024-01-01T00:00:00Z"
      }
    },
    {
      "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": "uploaded",
        "filename": "articles_of_incorporation.pdf",
        "uploaded_at": "2024-01-01T00:00:00Z"
      }
    },
    {
      "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": "uploaded",
        "filename": "id.pdf",
        "uploaded_at": "2024-01-01T00:00:00Z"
      }
    }
  ],
  "documents": [
    {
      "slot_key": "tax_registration_certificate",
      "status": "uploaded",
      "filename": "csf.pdf",
      "uploaded_at": "2024-01-01T00:00:00Z"
    },
    {
      "slot_key": "settlement_bank_statement",
      "status": "uploaded",
      "filename": "bank_statement.pdf",
      "uploaded_at": "2024-01-01T00:00:00Z"
    },
    {
      "slot_key": "proof_of_address",
      "status": "uploaded",
      "filename": "proof_of_address.pdf",
      "uploaded_at": "2024-01-01T00:00:00Z"
    },
    {
      "slot_key": "shareholder_structure",
      "status": "uploaded",
      "filename": "shareholder_structure.pdf",
      "uploaded_at": "2024-01-01T00:00:00Z"
    },
    {
      "slot_key": "articles_of_incorporation",
      "status": "uploaded",
      "filename": "articles_of_incorporation.pdf",
      "uploaded_at": "2024-01-01T00:00:00Z"
    }
  ]
}

POST

entities

{entity_id}

onboardings

{id}

submit

Submit an onboarding

curl --request POST \
  --url https://api.fintoc.com/v2/entities/{entity_id}/onboardings/{id}/submit \
  --header 'Authorization: <api-key>'

import requests

url = "https://api.fintoc.com/v2/entities/{entity_id}/onboardings/{id}/submit"

headers = {"Authorization": "<api-key>"}

response = requests.post(url, headers=headers)

print(response.text)

const options = {method: 'POST', headers: {Authorization: '<api-key>'}};

fetch('https://api.fintoc.com/v2/entities/{entity_id}/onboardings/{id}/submit', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fintoc.com/v2/entities/{entity_id}/onboardings/{id}/submit",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.fintoc.com/v2/entities/{entity_id}/onboardings/{id}/submit"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.fintoc.com/v2/entities/{entity_id}/onboardings/{id}/submit")
  .header("Authorization", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.fintoc.com/v2/entities/{entity_id}/onboardings/{id}/submit")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "id": "onbprc_0ujsswThIGTUYm2K8FjOOfXtY1K",
  "object": "onboarding",
  "entity_id": "ent_8anBwgZktbZH6ydyHa6Tm0eM",
  "status": "submitted",
  "source": "api",
  "submitted_at": "2024-01-01T00:00:00Z",
  "reviewed_at": null,
  "submittable": false,
  "data": {
    "company_information": {
      "incorporation_date": "2020-01-15T00:00:00.000Z",
      "business_activity": "Servicios financieros",
      "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_500000",
      "monthly_operations_range": "1_15000",
      "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": "uploaded",
          "filename": "id.pdf",
          "uploaded_at": "2024-01-01T00:00:00Z"
        },
        {
          "slot_key": "power_of_attorney",
          "status": "uploaded",
          "filename": "poa.pdf",
          "uploaded_at": "2024-01-01T00:00:00Z"
        }
      ]
    }
  ],
  "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": "uploaded",
        "filename": "id.pdf",
        "uploaded_at": "2024-01-01T00:00:00Z"
      }
    },
    {
      "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": "uploaded",
        "filename": "articles_of_incorporation.pdf",
        "uploaded_at": "2024-01-01T00:00:00Z"
      }
    },
    {
      "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": "uploaded",
        "filename": "id.pdf",
        "uploaded_at": "2024-01-01T00:00:00Z"
      }
    }
  ],
  "documents": [
    {
      "slot_key": "tax_registration_certificate",
      "status": "uploaded",
      "filename": "csf.pdf",
      "uploaded_at": "2024-01-01T00:00:00Z"
    },
    {
      "slot_key": "settlement_bank_statement",
      "status": "uploaded",
      "filename": "bank_statement.pdf",
      "uploaded_at": "2024-01-01T00:00:00Z"
    },
    {
      "slot_key": "proof_of_address",
      "status": "uploaded",
      "filename": "proof_of_address.pdf",
      "uploaded_at": "2024-01-01T00:00:00Z"
    },
    {
      "slot_key": "shareholder_structure",
      "status": "uploaded",
      "filename": "shareholder_structure.pdf",
      "uploaded_at": "2024-01-01T00:00:00Z"
    },
    {
      "slot_key": "articles_of_incorporation",
      "status": "uploaded",
      "filename": "articles_of_incorporation.pdf",
      "uploaded_at": "2024-01-01T00:00:00Z"
    }
  ]
}

v2 · Base URL https://api.fintoc.com/v2

Autorizaciones

Authorization

string

header

requerido

Parámetros de ruta

entity_id

string

requerido

The unique identifier of the entity (for example ent_8anBwgZktbZH6ydyHa6Tm0eM).

string

requerido

The unique identifier of the onboarding (for example onbprc_0ujsswThIGTUYm2K8FjOOfXtY1K).

Respuesta

Returns the onboarding after Fintoc submits it. The status is submitted.

string

requerido

Unique identifier of the onboarding.

Ejemplo:

"onbprc_0ujsswThIGTUYm2K8FjOOfXtY1K"

object

any

requerido

Type of the object. Always onboarding.

data

object

requerido

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.

Ejemplo:

{
  "company_information": {
    "incorporation_date": "2020-01-15T00:00:00.000Z",
    "business_activity": "Servicios financieros",
    "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_500000",
    "monthly_operations_range": "1_15000",
    "declaration_accepted": true
  }
}

documents

object[]

requerido

Document slots for the onboarding, with their upload status.

Show child attributes

entity_id

string | null

requerido

Identifier of the entity this onboarding belongs to. null if not associated with an entity.

Ejemplo:

"ent_8anBwgZktbZH6ydyHa6Tm0eM"

legal_representatives

object[]

requerido

Legal representatives declared for the entity.

Show child attributes

reviewed_at

string<date-time> | null

requerido

ISO 8601 datetime, in UTC, of when the onboarding was reviewed. null until it is reviewed.

Ejemplo:

"2026-01-16T09:00:00Z"

shareholders

object[]

requerido

Shareholders declared for the entity.

Show child attributes

source

enum<string>

requerido

Channel the onboarding is being completed through. One of api or dashboard.

Opciones disponibles:

api,

dashboard

Ejemplo:

"api"

status

enum<string>

requerido

Current status of the onboarding. One of pending, in_progress, submitted, approved, rejected or cancelled.

Opciones disponibles:

pending,

in_progress,

submitted,

approved,

rejected,

cancelled

Ejemplo:

"pending"

submittable

boolean

requerido

Whether the onboarding has every required field and document completed and can be submitted for review.

Ejemplo:

false

submitted_at

string<date-time> | null

requerido

ISO 8601 datetime, in UTC, of when the onboarding was submitted for review. null until it is submitted.

Ejemplo:

"2026-01-15T14:30:00Z"

Get an onboarding Upload an onboarding document

API de Fintoc

Recursos principales

API de Pagos

API de Transferencias

API de Movimientos

Direct Debit (Legacy)

API Fiscal

Submit an onboarding

Autorizaciones

Parámetros de ruta

Respuesta