curl --request POST \
  --url https://thirdparty-sandbox.staging.qonto.co/register/registrations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Qonto-Partner-Id: <api-key>' \
  --data '
{
  "legal_flow": "company_creation",
  "locale": "en",
  "partner_redirect_url": "https://example.com/users/123456/dashboard",
  "partner_user": {
    "first_name": "John",
    "last_name": "Doe",
    "email": "example-partner-user@qonto.com"
  },
  "organization": {
    "entity_type": "company",
    "legal_name": "Qonto",
    "legal_form": "SAS",
    "legal_sector": "K.64.11",
    "legal_registration_date": "2019-08-24",
    "legal_vat_number": "123456789",
    "address": {
      "line_1": "Rue La Fayette 20B",
      "line_2": "Room 5",
      "postal_code": "75009",
      "city": "Paris",
      "country": "FR"
    },
    "total_capital_amount": {
      "value": "3641.74",
      "currency": "EUR"
    }
  },
  "stakeholders": [
    {
      "capital_amount": {
        "value": "1023.43",
        "currency": "EUR"
      },
      "is_owner": true,
      "first_name": "Leeroy",
      "last_name": "Jenkins",
      "email": "leeroy.jenkins@qonto.com",
      "gender": "male",
      "phone_number": "0033123456789",
      "nationality": "FR",
      "birth_date": "2021-08-17T12:31:32.689Z",
      "birth_address": {
        "postal_code": "75009",
        "city": "Paris",
        "country": "FR"
      },
      "residence_address": {
        "line_1": "Rue La Fayette 20B",
        "postal_code": "75009",
        "city": "Paris",
        "country": "FR"
      },
      "shareholding_type": "physical",
      "share_capital_origin": [
        "personal_savings",
        "holding_company_contribution",
        "employment_or_business_income"
      ]
    },
    {
      "capital_amount": {
        "value": "0",
        "currency": "EUR"
      },
      "is_owner": false,
      "first_name": "Jane",
      "last_name": "Doe",
      "email": "jane.doe@qonto.com",
      "gender": "female",
      "phone_number": "0033123456780",
      "nationality": "FR",
      "birth_date": "2020-08-17T12:31:32.689Z",
      "birth_address": {
        "postal_code": "75009",
        "city": "Paris",
        "country": "FR"
      },
      "residence_address": {
        "line_1": "Rue La Fayette 17A",
        "postal_code": "75009",
        "city": "Paris",
        "country": "FR"
      },
      "shareholding_type": null,
      "share_capital_origin": [],
      "legal_entities": [
        {
          "legal_name": "Good Company",
          "legal_number": "123456789",
          "legal_country": "FR",
          "capital_amount": {
            "value": "2618.31",
            "currency": "EUR"
          },
          "share_capital_origin": [
            "dividends"
          ]
        }
      ]
    }
  ]
}
'

{
  "registration": {
    "locale": "fr",
    "partner_user": {
      "first_name": "John",
      "last_name": "Doe",
      "email": "example-partner-user@qonto.com"
    },
    "organization": {
      "legal_name": "Qonto",
      "legal_form": "SAS",
      "address": {
        "line_1": "Rue La Fayette 20B",
        "postal_code": "75009",
        "city": "Paris",
        "country": "FR",
        "line_2": "Room 5"
      },
      "total_capital_amount": {
        "value": "1023.43",
        "currency": "EUR"
      },
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "entity_type": "company",
      "legal_number": "<string>",
      "legal_sector": "K.64.11",
      "legal_registration_date": "2023-12-25",
      "legal_vat_number": "<string>"
    },
    "stakeholders": [
      {
        "capital_amount": {
          "value": "1023.43",
          "currency": "EUR"
        },
        "is_owner": true,
        "first_name": "Leeroy",
        "last_name": "Jenkins",
        "email": "leeroy.jenkins@qonto.com",
        "gender": "male",
        "phone_number": "0033123456789",
        "nationality": "FR",
        "birth_date": "2021-08-17T12:31:32.689Z",
        "birth_address": {
          "postal_code": "75009",
          "city": "Paris",
          "country": "FR"
        },
        "residence_address": {
          "line_1": "Rue La Fayette 20B",
          "postal_code": "75009",
          "city": "Paris",
          "country": "FR"
        },
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "shareholding_type": "physical",
        "share_capital_origin": [
          "personal_savings"
        ],
        "legal_entities": [
          {
            "legal_name": "Qonto",
            "legal_number": 123456789,
            "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "legal_country": "FR",
            "capital_amount": "1023.43",
            "share_capital_origin": [
              "personal_savings"
            ]
          }
        ]
      }
    ],
    "id": "a584b060-8c96-488d-8bbb-74f0d3d2803c",
    "legal_flow": "company_creation",
    "flow": {
      "type": "seamless",
      "breakdown": [
        {
          "code": "<string>",
          "detail": "<string>",
          "source": {
            "pointer": "<string>"
          }
        }
      ]
    },
    "status": "pending",
    "redirection_link": "https://xyz.qonto.com/registrations/ID",
    "partner_redirect_url": "https://example.com/users/123456/dashboard",
    "created_at": "2021-08-17T12:31:32.689Z",
    "updated_at": "2021-08-17T14:00:00.689Z"
  }
}

{
  "errors": [
    {
      "code": "<string>",
      "detail": "<string>",
      "source": {
        "pointer": "<string>"
      }
    }
  ]
}

{
  "errors": [
    {
      "code": "unauthorized",
      "detail": "You must authenticate to perform API requests"
    }
  ]
}

{
  "errors": [
    {
      "code": "conflict",
      "detail": "Type do not match server's endpoint",
      "source": {
        "pointer": "/data/type"
      }
    },
    {
      "code": "conflict",
      "detail": "ID do not match server's endpoint",
      "source": {
        "pointer": "/data/id"
      }
    }
  ]
}

{
  "errors": [
    {
      "code": "<string>",
      "detail": "<string>",
      "source": {
        "pointer": "<string>"
      }
    }
  ]
}

{
  "errors": [
    {
      "code": "<error-code>",
      "detail": "<relevant-detail>",
      "source": {
        "pointer": "<ie /data/attributes/attr_name>"
      }
    }
  ]
}

Registrations

Create a registration

Creates a single registration for the authenticated partner i.e. triggers a workflow to guide the user through the necessary steps to register its organization with Qonto. The response provides a registration ID for tracking the registration progress.

This endpoint supports existing company registration, new company creation, and Qonto Invoicing onboarding, determined by the legal_flow attribute.

For German companies and freelancers, specific schemas are used with adapted requirements.

POST

registrations

curl --request POST \
  --url https://thirdparty-sandbox.staging.qonto.co/register/registrations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Qonto-Partner-Id: <api-key>' \
  --data '
{
  "legal_flow": "company_creation",
  "locale": "en",
  "partner_redirect_url": "https://example.com/users/123456/dashboard",
  "partner_user": {
    "first_name": "John",
    "last_name": "Doe",
    "email": "example-partner-user@qonto.com"
  },
  "organization": {
    "entity_type": "company",
    "legal_name": "Qonto",
    "legal_form": "SAS",
    "legal_sector": "K.64.11",
    "legal_registration_date": "2019-08-24",
    "legal_vat_number": "123456789",
    "address": {
      "line_1": "Rue La Fayette 20B",
      "line_2": "Room 5",
      "postal_code": "75009",
      "city": "Paris",
      "country": "FR"
    },
    "total_capital_amount": {
      "value": "3641.74",
      "currency": "EUR"
    }
  },
  "stakeholders": [
    {
      "capital_amount": {
        "value": "1023.43",
        "currency": "EUR"
      },
      "is_owner": true,
      "first_name": "Leeroy",
      "last_name": "Jenkins",
      "email": "leeroy.jenkins@qonto.com",
      "gender": "male",
      "phone_number": "0033123456789",
      "nationality": "FR",
      "birth_date": "2021-08-17T12:31:32.689Z",
      "birth_address": {
        "postal_code": "75009",
        "city": "Paris",
        "country": "FR"
      },
      "residence_address": {
        "line_1": "Rue La Fayette 20B",
        "postal_code": "75009",
        "city": "Paris",
        "country": "FR"
      },
      "shareholding_type": "physical",
      "share_capital_origin": [
        "personal_savings",
        "holding_company_contribution",
        "employment_or_business_income"
      ]
    },
    {
      "capital_amount": {
        "value": "0",
        "currency": "EUR"
      },
      "is_owner": false,
      "first_name": "Jane",
      "last_name": "Doe",
      "email": "jane.doe@qonto.com",
      "gender": "female",
      "phone_number": "0033123456780",
      "nationality": "FR",
      "birth_date": "2020-08-17T12:31:32.689Z",
      "birth_address": {
        "postal_code": "75009",
        "city": "Paris",
        "country": "FR"
      },
      "residence_address": {
        "line_1": "Rue La Fayette 17A",
        "postal_code": "75009",
        "city": "Paris",
        "country": "FR"
      },
      "shareholding_type": null,
      "share_capital_origin": [],
      "legal_entities": [
        {
          "legal_name": "Good Company",
          "legal_number": "123456789",
          "legal_country": "FR",
          "capital_amount": {
            "value": "2618.31",
            "currency": "EUR"
          },
          "share_capital_origin": [
            "dividends"
          ]
        }
      ]
    }
  ]
}
'

{
  "registration": {
    "locale": "fr",
    "partner_user": {
      "first_name": "John",
      "last_name": "Doe",
      "email": "example-partner-user@qonto.com"
    },
    "organization": {
      "legal_name": "Qonto",
      "legal_form": "SAS",
      "address": {
        "line_1": "Rue La Fayette 20B",
        "postal_code": "75009",
        "city": "Paris",
        "country": "FR",
        "line_2": "Room 5"
      },
      "total_capital_amount": {
        "value": "1023.43",
        "currency": "EUR"
      },
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "entity_type": "company",
      "legal_number": "<string>",
      "legal_sector": "K.64.11",
      "legal_registration_date": "2023-12-25",
      "legal_vat_number": "<string>"
    },
    "stakeholders": [
      {
        "capital_amount": {
          "value": "1023.43",
          "currency": "EUR"
        },
        "is_owner": true,
        "first_name": "Leeroy",
        "last_name": "Jenkins",
        "email": "leeroy.jenkins@qonto.com",
        "gender": "male",
        "phone_number": "0033123456789",
        "nationality": "FR",
        "birth_date": "2021-08-17T12:31:32.689Z",
        "birth_address": {
          "postal_code": "75009",
          "city": "Paris",
          "country": "FR"
        },
        "residence_address": {
          "line_1": "Rue La Fayette 20B",
          "postal_code": "75009",
          "city": "Paris",
          "country": "FR"
        },
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "shareholding_type": "physical",
        "share_capital_origin": [
          "personal_savings"
        ],
        "legal_entities": [
          {
            "legal_name": "Qonto",
            "legal_number": 123456789,
            "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "legal_country": "FR",
            "capital_amount": "1023.43",
            "share_capital_origin": [
              "personal_savings"
            ]
          }
        ]
      }
    ],
    "id": "a584b060-8c96-488d-8bbb-74f0d3d2803c",
    "legal_flow": "company_creation",
    "flow": {
      "type": "seamless",
      "breakdown": [
        {
          "code": "<string>",
          "detail": "<string>",
          "source": {
            "pointer": "<string>"
          }
        }
      ]
    },
    "status": "pending",
    "redirection_link": "https://xyz.qonto.com/registrations/ID",
    "partner_redirect_url": "https://example.com/users/123456/dashboard",
    "created_at": "2021-08-17T12:31:32.689Z",
    "updated_at": "2021-08-17T14:00:00.689Z"
  }
}

{
  "errors": [
    {
      "code": "<string>",
      "detail": "<string>",
      "source": {
        "pointer": "<string>"
      }
    }
  ]
}

{
  "errors": [
    {
      "code": "unauthorized",
      "detail": "You must authenticate to perform API requests"
    }
  ]
}

{
  "errors": [
    {
      "code": "conflict",
      "detail": "Type do not match server's endpoint",
      "source": {
        "pointer": "/data/type"
      }
    },
    {
      "code": "conflict",
      "detail": "ID do not match server's endpoint",
      "source": {
        "pointer": "/data/id"
      }
    }
  ]
}

{
  "errors": [
    {
      "code": "<string>",
      "detail": "<string>",
      "source": {
        "pointer": "<string>"
      }
    }
  ]
}

{
  "errors": [
    {
      "code": "<error-code>",
      "detail": "<relevant-detail>",
      "source": {
        "pointer": "<ie /data/attributes/attr_name>"
      }
    }
  ]
}

Authorizations

Authorization

string

header

required

Bearer authorization header: Bearer <token>. To get your <token>, please sign up to the Developer Portal.

Qonto-Partner-Id

string

header

required

API Key authorization header: Qonto-Partner-Id: <partner_id>. To get your <partner_id> please, sign up to the Developer Portal.

Headers

X-Qonto-Staging-Token

string

Required only for Sandbox API requests; to get one, please sign up to the Developer Portal.

Body

application/json

Request payload for Company Creation flow
Request payload for Existing Company flow
Request payload for German Company Creation flow
Request payload for German Existing Company flow
Request payload for Qonto Invoicing flow
Request payload for Italian Company Creation flow

locale

enum<string>

required

Only a subset is supported from IETF Language Tags

Available options:

en,

fr,

it,

de,

es,

pt

Example:

"fr"

partner_user

object

required

Describes the user that owns the flow on the partner side.

Show child attributes

organization

Organization · object

required

Show child attributes

stakeholders

Stakeholder · object[]

required

Show child attributes

legal_flow

enum<string>

Identifies the type of registration process:

company_creation: Initiates a new company registration.
existing_company: Registers an existing company.

Available options:

company_creation

partner_redirect_url

string | null

The URL where the user will be redirected after the registration process is completed. If not provided, then the user will be redirected to Qonto's application.

Note: this parameter is allowed only for embed applications.

Example:

"https://example.com/users/123456/dashboard"

oauth

OAuth Parameters · object

Show child attributes

Response

Returns the registration created.

registration

Registration · object

Show child attributes

⌘I

Business API

Onboarding API

Create a registration

Authorizations

Headers

Body

Response