Create new business

The endpoint allows to create a new business in Bitpanda system. Each business will be associated with one Bitpanda user.

SecuritybearerAuth
Request
Request Body schema: application/json

Request details

external_id
string

External ID

full_legal_name
required
string
business_name
string
email
string
website
string
required
object
legal_type
required
string
registration_number
required
string
lei_number
string
service
string
industry
required
string
tax_number
string
vat_number
string
nace_code
string
account_purpose
string
ext_risk_level
string
ext_pep_status
string
last_kyc_update
string
next_kyc_update
string
us_tax_residency
boolean
acting_on_own_behalf
required
boolean
terms
Array of integers

The IDs of the accepted terms and conditions and privacy policy

Array of objects
Array of objects

Appropriateness test answers shall be provided latest before the first trade with stocks or ETFs

Array of objects
Responses
201

New business and user has been created

401

Unauthorized

403

Forbidden

422

Error

500

Internal Error

503

Maintenance or Service unavailable

post/v1/businesses
Request samples
application/json
{
  • "external_id": "Ext-Id-1",
  • "full_legal_name": "Acme Inc",
  • "business_name": "Acme",
  • "email": "username@acme.com",
  • "website": "http://acme.com",
  • "address": {
    },
  • "legal_type": "GmbH",
  • "registration_number": "AB123CD",
  • "lei_number": "549300E00W82GZ93PU70",
  • "service": "Digital Services",
  • "industry": "IT Services",
  • "tax_number": "123-45-6789",
  • "vat_number": "FR987654321",
  • "nace_code": "62.010 - Computer programming activities",
  • "account_purpose": "Research and Development",
  • "ext_risk_level": "Moderate Risk",
  • "ext_pep_status": "PEP: Family Member",
  • "last_kyc_update": "2022-07-20T08:14:20+00:00",
  • "next_kyc_update": "2023-07-20T08:14:20+00:00",
  • "us_tax_residency": false,
  • "acting_on_own_behalf": true,
  • "terms": [
    ],
  • "aml": [
    ],
  • "appropriateness": [
    ],
  • "risk": [
    ]
}
Response samples
application/json
{
  • "data": {
    }
}