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": "existing_company",
  "locale": "en",
  "partner_redirect_url": "https://example.com/users/123456/dashboard",
  "partner_user": {
    "email": "example-patner-user@qonto.com",
    "first_name": "John",
    "last_name": "Doe"
  },
  "organization": {
    "legal_number": "123232323"
  }
}'
{
  "registration": {
    "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",
    "locale": "fr",
    "partner_user": {
      "first_name": "John",
      "last_name": "Doe",
      "email": "example-partner-user@qonto.com"
    },
    "organization": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "entity_type": "company",
      "legal_name": "Olinda",
      "legal_form": "SAS",
      "legal_number": "<string>",
      "legal_sector": "K.64.11",
      "legal_registration_date": "2023-12-25",
      "legal_vat_number": "<string>",
      "address": {
        "line_1": "Rue La Fayette 20B",
        "line_2": "Room 5",
        "postal_code": "75009",
        "city": "Paris",
        "country": "FR"
      },
      "total_capital_amount": {
        "value": "1023.43",
        "currency": "EUR"
      }
    },
    "stakeholders": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "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",
        "legal_entities": [
          {
            "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "legal_name": "Olinda",
            "legal_number": 123456789,
            "legal_country": "FR",
            "capital_amount": "1023.43"
          }
        ]
      }
    ]
  }
}

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 Existing Company flow
  • Request payload for Company Creation flow
  • Request payload for German Existing Company flow
  • Request payload for German 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.

​
organization
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:
existing_company
​
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
object

Response

Returns the registration created.

​
registration
object
⌘I