Skip to main content
POST
/
register
/
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": "[email protected]"
  },
  "organization": {
    "entity_type": "company",
    "legal_name": "Olinda",
    "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": "[email protected]",
      "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"
    },
    {
      "capital_amount": {
        "value": "0",
        "currency": "EUR"
      },
      "is_owner": false,
      "first_name": "Jane",
      "last_name": "Doe",
      "email": "[email protected]",
      "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,
      "legal_entities": [
        {
          "legal_name": "Good Company",
          "legal_number": "123456789",
          "legal_country": "FR",
          "capital_amount": {
            "value": "2618.31",
            "currency": "EUR"
          }
        }
      ]
    }
  ]
}
'
{
  "registration": {
    "locale": "fr",
    "partner_user": {
      "first_name": "John",
      "last_name": "Doe",
      "email": "[email protected]"
    },
    "organization": {
      "legal_name": "Olinda",
      "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": "[email protected]",
        "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",
        "legal_entities": [
          {
            "legal_name": "Olinda",
            "legal_number": 123456789,
            "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "legal_country": "FR",
            "capital_amount": "1023.43"
          }
        ]
      }
    ],
    "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"
  }
}

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
​
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.

​
organization
Organization · object
required
​
stakeholders
Stakeholder · object[]
required
​
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

Response

Returns the registration created.

​
registration
Registration · object