Create Company

POST

partner

companies

object

string

name

string

address

object

street

string

zip

string

city

string

country

enum<string>

phone

string

vat_number

string

users

array

legal_form

string

legal_representatives

array

tax_deduction_eligibility

enum<string>

notification_channels

array

Authorizations

Authorization

string

headerrequired

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

name

string

required

Name of the company

Minimum length: 1

phone

string

required

Phone number of the company (max 50 characters)

Minimum length: 1

string

Minimum length: 1

address

object

The company's postal address

address.street

string

required

Street and house number

Minimum length: 1

address.zip

string

required

Zip code

Minimum length: 1

address.city

string

required

Full name of the city

Minimum length: 1

address.country

enum<string>

required

The country, formatted as two letter ISO-3166-1 country code.

AF - Afghanistan
EG - Ägypten
AX - Åland-Inseln
AL - Albanien
DZ - Algerien
AS - Amerikanisch-Samoa
VI - Amerikanische Jungferninseln
AD - Andorra
AO - Angola
AI - Anguilla
AQ - Antarktis
AG - Antigua und Barbuda
GQ - Äquatorialguinea
AR - Argentinien
AM - Armenien
AW - Aruba
AZ - Aserbaidschan
ET - Äthiopien
AU - Australien
BS - Bahamas
BH - Bahrain
BD - Bangladesch
BB - Barbados
BE - Belgien
BZ - Belize
BJ - Benin
BM - Bermuda
BT - Bhutan
BO - Bolivien
BQ - Bonaire, Sint Eustatius und Saba
BA - Bosnien und Herzegowina
BW - Botswana
BV - Bouvetinsel
BR - Brasilien
VG - Britische Jungferninseln
IO - Britisches Territorium im Indischen Ozean
BN - Brunei
BG - Bulgarien
BF - Burkina Faso
BI - Burundi
CL - Chile
CN - China
MP - Commonwealth der Nördlichen Marianen
CK - Cookinseln
CR - Costa Rica
CI - Côte d'Ivoire
CW - Curaçao
DK - Dänemark
DE - Deutschland
DM - Dominica
DO - Dominikanische Republik
DJ - Dschibuti
EC - Ecuador
SV - El Salvador
ER - Eritrea
EE - Estland
FK - Falklandinseln (Malwinen)
FO - Faröerinseln
FJ - Fidschi
FI - Finnland
FR - Frankreich
GF - Französisch Guinea
PF - Französisch-Polynesien
TF - Französische Süd- und Antarktisgebiete
GA - Gabun
GM - Gambia
GE - Georgien
GH - Ghana
GI - Gibraltar
GD - Granada
GR - Griechenland
GL - Grönland
GP - Guadeloupe
GU - Guam
GT - Guatemala
GG - Guernsey
GN - Guinea
GW - Guinea-Bissau
GY - Guyana
HT - Haiti
HM - Heard und McDonaldinseln
HN - Honduras
HK - Hong Kong
IN - Indien
ID - Indonesien
IQ - Irak
IR - Iran (Islamische Republik)
IE - Irland
IS - Island
IM - Isle of Man
IL - Israel
IT - Italien
JM - Jamaika
JP - Japan
YE - Jemen
JE - Jersey
JO - Jordanien
KY - Kaimaninseln
KH - Kambodscha
CM - Kamerun
CA - Kanada
CV - Kap Verde
KZ - Kasachstan
QA - Katar
KE - Kenia
KG - Kirgisistan
KI - Kirivati
CC - Kokosinseln (Keelinginseln)
CO - Kolumbien
KM - Komoren
CG - Kongo
CD - Kongo (Demokratische Republik)
HR - Kroatien
CU - Kuba
KW - Kuwait
LA - Laos, Demokratische Volksrepublik
LS - Lesotho
LV - Lettland
LB - Libanon
LR - Liberia
LY - Libyen
LI - Liechtenstein
LT - Litauen
LU - Luxemburg
MO - Macao
MG - Madagaskar
MW - Malawi
MY - Malaysia
MV - Malediven
ML - Mali
MT - Malta
MA - Marokko
MH - Marshallinseln
MQ - Martinique
MR - Mauretanien
MU - Mauritius
YT - Mayotte
MK - Mazedonien
MX - Mexiko
FM - Mikronesien (Föderierte Staaten von)
MD - Moldawien
MC - Monaco
MN - Mongolei
ME - Montenegro
MS - Montserrat
MZ - Mozambique
MM - Myanmar
NA - Namibia
NR - Nauru
NP - Nepal
NC - Neukaledonien
NZ - Neuseeland
NI - Nicaragua
NL - Niederlande
NE - Niger
NG - Nigeria
NU - Niue
KP - Nordkorea
NF - Norfolkinsel
NO - Norwegen
OM - Oman
AT - Österreich
TL - Osttimor
PK - Pakistan
PS - Palästina
PW - Palau
PA - Panama
PG - Papua Neu Guinea
PY - Paraguay
PE - Peru
PH - Philippinen
PN - Pitcairn
PL - Polen
PT - Portugal
PR - Puerto Rico
RE - Réunion
RW - Ruanda
RO - Rumänien
RU - Russland
BL - Saint-Barthélemy
PM - Saint-Pierre und Miquelon
SB - Salomonen
ZM - Sambia
WS - Samoa
SM - San Marino
ST - São Tomé und Príncipe
SA - Saudi Arabien
SE - Schweden
CH - Schweiz
SN - Senegal
RS - Serbien
SC - Seychellen
SL - Sierra Leone
ZW - Simbabwe
SG - Singapur
SX - Sint Maarten (niederländischer Teil)
SK - Slowakei
SI - Slowenien
SO - Somalia
ES - Spanien
SJ - Spitzbergen und Jan Mayen
LK - Sri Lanka
SH - St. Helena, Ascension und Tristan da Cunha
KN - St. Kitts und Nevis
LC - St. Lucia
MF - St. Martin (französischer Teil)
VC - St. Vincent und die Grenadinen
ZA - Südafrika
SD - Sudan
GS - Südgeorgien und die Südlichen Sandwichinseln
KR - Südkorea
SS - Südsudan
SR - Surinam
SZ - Swasiland
SY - Syrien
TJ - Tadschikistan
TW - Taiwan (Provinz Chinas)
TZ - Tansania
TH - Thailand
TG - Togo
TK - Tokelau
TO - Tonga
TT - Trinidad und Tobago
TD - Tschad
CZ - Tschechien
TN - Tunesien
TR - Türkei
TM - Turkmenistan
TC - Turks- und Caicosinseln
TV - Tuvalu
UM - USA - Sonstige Kleine Inseln
UG - Uganda
UA - Ukraine
HU - Ungarn
UY - Uruguay
UZ - Usbekistan
VU - Vanuatu
VA - Vatikanstadt
VE - Venezuela (Bolivarische Republik)
AE - Vereinigte Arabische Emirate
US - Vereinigte Staaten von Amerika
GB - Vereinigtes Königreich
VN - Vietnam
WF - Wallis und Futuna
CX - Weihnachtsinsel
BY - Weißrussland
EH - Westsahara
CF - Zentralafrikanische Republik
CY - Zypern

Available options:

AF,

EG,

AX,

AL,

DZ,

AS,

VI,

AD,

AO,

AI,

AQ,

AG,

GQ,

AR,

AM,

AW,

AZ,

ET,

AU,

BS,

BH,

BD,

BB,

BE,

BZ,

BJ,

BM,

BT,

BO,

BQ,

BA,

BW,

BV,

BR,

VG,

IO,

BN,

BG,

BF,

BI,

CL,

CN,

MP,

CK,

CR,

CI,

CW,

DK,

DE,

DM,

DO,

DJ,

EC,

SV,

ER,

EE,

FK,

FO,

FJ,

FI,

FR,

GF,

PF,

TF,

GA,

GM,

GE,

GH,

GI,

GD,

GR,

GL,

GP,

GU,

GT,

GG,

GN,

GW,

GY,

HT,

HM,

HN,

HK,

IN,

ID,

IQ,

IR,

IE,

IS,

IM,

IL,

IT,

JM,

JP,

YE,

JE,

JO,

KY,

KH,

CM,

CA,

CV,

KZ,

QA,

KE,

KG,

KI,

CC,

CO,

KM,

CG,

CD,

HR,

CU,

KW,

LA,

LS,

LV,

LB,

LR,

LY,

LI,

LT,

LU,

MO,

MG,

MW,

MY,

MV,

ML,

MT,

MA,

MH,

MQ,

MR,

MU,

YT,

MK,

MX,

FM,

MD,

MC,

MN,

ME,

MS,

MZ,

MM,

NA,

NR,

NP,

NC,

NZ,

NI,

NL,

NE,

NG,

NU,

KP,

NF,

NO,

OM,

AT,

TL,

PK,

PS,

PW,

PA,

PG,

PY,

PE,

PH,

PN,

PL,

PT,

PR,

RE,

RW,

RO,

RU,

BL,

PM,

SB,

ZM,

WS,

SM,

ST,

SA,

SE,

CH,

SN,

RS,

SC,

SL,

ZW,

SG,

SX,

SK,

SI,

SO,

ES,

SJ,

LK,

SH,

KN,

LC,

MF,

VC,

ZA,

SD,

GS,

KR,

SS,

SR,

SZ,

SY,

TJ,

TW,

TZ,

TH,

TG,

TK,

TO,

TT,

TD,

CZ,

TN,

TR,

TM,

TC,

TV,

UM,

UG,

UA,

HU,

UY,

UZ,

VU,

VA,

VE,

AE,

US,

GB,

VN,

WF,

CX,

BY,

EH,

CF,

CY

vat_number

string

VAT ID (Umsatzsteuer-Identifikationsnummer), must adhere to the german schema for VAT IDs

Minimum length: 1

users

object[]

Users registered within this company (read only)

legal_form

string

Legal Form of the company

Minimum length: 1

legal_representatives

object[]

The company's legal representatives (if required)

tax_deduction_eligibility

enum<string>

The company's input tax deduction eligibility (Vorsteuerabzugsberechtigung)

J - Vorsteuerabzugsberechtigt
N - Nicht vorsteuerabzugsberechtigt
K - Reverse-Charge-Verfahren
A - Nicht steuerbare Umsätze - Drittlandunternehmer

Available options:

J,

N,

K,

A

notification_channels

object[]

Notification settings for the company

Response

200 - application/json

href

string

required

name

string

required

Name of the company

phone

string

required

Phone number of the company (max 50 characters)

data_submission_completed

boolean

default: falserequired

Indicates whether the data for the company was completely submitted, either through API or provided by a user. You can only start creating claims once this is completed.

string

address

object

The company's postal address

address.street

string

required

Street and house number

address.zip

string

required

Zip code

address.city

string

required

Full name of the city

address.country

enum<string>

required

The country, formatted as two letter ISO-3166-1 country code.

AF - Afghanistan
EG - Ägypten
AX - Åland-Inseln
AL - Albanien
DZ - Algerien
AS - Amerikanisch-Samoa
VI - Amerikanische Jungferninseln
AD - Andorra
AO - Angola
AI - Anguilla
AQ - Antarktis
AG - Antigua und Barbuda
GQ - Äquatorialguinea
AR - Argentinien
AM - Armenien
AW - Aruba
AZ - Aserbaidschan
ET - Äthiopien
AU - Australien
BS - Bahamas
BH - Bahrain
BD - Bangladesch
BB - Barbados
BE - Belgien
BZ - Belize
BJ - Benin
BM - Bermuda
BT - Bhutan
BO - Bolivien
BQ - Bonaire, Sint Eustatius und Saba
BA - Bosnien und Herzegowina
BW - Botswana
BV - Bouvetinsel
BR - Brasilien
VG - Britische Jungferninseln
IO - Britisches Territorium im Indischen Ozean
BN - Brunei
BG - Bulgarien
BF - Burkina Faso
BI - Burundi
CL - Chile
CN - China
MP - Commonwealth der Nördlichen Marianen
CK - Cookinseln
CR - Costa Rica
CI - Côte d'Ivoire
CW - Curaçao
DK - Dänemark
DE - Deutschland
DM - Dominica
DO - Dominikanische Republik
DJ - Dschibuti
EC - Ecuador
SV - El Salvador
ER - Eritrea
EE - Estland
FK - Falklandinseln (Malwinen)
FO - Faröerinseln
FJ - Fidschi
FI - Finnland
FR - Frankreich
GF - Französisch Guinea
PF - Französisch-Polynesien
TF - Französische Süd- und Antarktisgebiete
GA - Gabun
GM - Gambia
GE - Georgien
GH - Ghana
GI - Gibraltar
GD - Granada
GR - Griechenland
GL - Grönland
GP - Guadeloupe
GU - Guam
GT - Guatemala
GG - Guernsey
GN - Guinea
GW - Guinea-Bissau
GY - Guyana
HT - Haiti
HM - Heard und McDonaldinseln
HN - Honduras
HK - Hong Kong
IN - Indien
ID - Indonesien
IQ - Irak
IR - Iran (Islamische Republik)
IE - Irland
IS - Island
IM - Isle of Man
IL - Israel
IT - Italien
JM - Jamaika
JP - Japan
YE - Jemen
JE - Jersey
JO - Jordanien
KY - Kaimaninseln
KH - Kambodscha
CM - Kamerun
CA - Kanada
CV - Kap Verde
KZ - Kasachstan
QA - Katar
KE - Kenia
KG - Kirgisistan
KI - Kirivati
CC - Kokosinseln (Keelinginseln)
CO - Kolumbien
KM - Komoren
CG - Kongo
CD - Kongo (Demokratische Republik)
HR - Kroatien
CU - Kuba
KW - Kuwait
LA - Laos, Demokratische Volksrepublik
LS - Lesotho
LV - Lettland
LB - Libanon
LR - Liberia
LY - Libyen
LI - Liechtenstein
LT - Litauen
LU - Luxemburg
MO - Macao
MG - Madagaskar
MW - Malawi
MY - Malaysia
MV - Malediven
ML - Mali
MT - Malta
MA - Marokko
MH - Marshallinseln
MQ - Martinique
MR - Mauretanien
MU - Mauritius
YT - Mayotte
MK - Mazedonien
MX - Mexiko
FM - Mikronesien (Föderierte Staaten von)
MD - Moldawien
MC - Monaco
MN - Mongolei
ME - Montenegro
MS - Montserrat
MZ - Mozambique
MM - Myanmar
NA - Namibia
NR - Nauru
NP - Nepal
NC - Neukaledonien
NZ - Neuseeland
NI - Nicaragua
NL - Niederlande
NE - Niger
NG - Nigeria
NU - Niue
KP - Nordkorea
NF - Norfolkinsel
NO - Norwegen
OM - Oman
AT - Österreich
TL - Osttimor
PK - Pakistan
PS - Palästina
PW - Palau
PA - Panama
PG - Papua Neu Guinea
PY - Paraguay
PE - Peru
PH - Philippinen
PN - Pitcairn
PL - Polen
PT - Portugal
PR - Puerto Rico
RE - Réunion
RW - Ruanda
RO - Rumänien
RU - Russland
BL - Saint-Barthélemy
PM - Saint-Pierre und Miquelon
SB - Salomonen
ZM - Sambia
WS - Samoa
SM - San Marino
ST - São Tomé und Príncipe
SA - Saudi Arabien
SE - Schweden
CH - Schweiz
SN - Senegal
RS - Serbien
SC - Seychellen
SL - Sierra Leone
ZW - Simbabwe
SG - Singapur
SX - Sint Maarten (niederländischer Teil)
SK - Slowakei
SI - Slowenien
SO - Somalia
ES - Spanien
SJ - Spitzbergen und Jan Mayen
LK - Sri Lanka
SH - St. Helena, Ascension und Tristan da Cunha
KN - St. Kitts und Nevis
LC - St. Lucia
MF - St. Martin (französischer Teil)
VC - St. Vincent und die Grenadinen
ZA - Südafrika
SD - Sudan
GS - Südgeorgien und die Südlichen Sandwichinseln
KR - Südkorea
SS - Südsudan
SR - Surinam
SZ - Swasiland
SY - Syrien
TJ - Tadschikistan
TW - Taiwan (Provinz Chinas)
TZ - Tansania
TH - Thailand
TG - Togo
TK - Tokelau
TO - Tonga
TT - Trinidad und Tobago
TD - Tschad
CZ - Tschechien
TN - Tunesien
TR - Türkei
TM - Turkmenistan
TC - Turks- und Caicosinseln
TV - Tuvalu
UM - USA - Sonstige Kleine Inseln
UG - Uganda
UA - Ukraine
HU - Ungarn
UY - Uruguay
UZ - Usbekistan
VU - Vanuatu
VA - Vatikanstadt
VE - Venezuela (Bolivarische Republik)
AE - Vereinigte Arabische Emirate
US - Vereinigte Staaten von Amerika
GB - Vereinigtes Königreich
VN - Vietnam
WF - Wallis und Futuna
CX - Weihnachtsinsel
BY - Weißrussland
EH - Westsahara
CF - Zentralafrikanische Republik
CY - Zypern

Available options:

AF,

EG,

AX,

AL,

DZ,

AS,

VI,

AD,

AO,

AI,

AQ,

AG,

GQ,

AR,

AM,

AW,

AZ,

ET,

AU,

BS,

BH,

BD,

BB,

BE,

BZ,

BJ,

BM,

BT,

BO,

BQ,

BA,

BW,

BV,

BR,

VG,

IO,

BN,

BG,

BF,

BI,

CL,

CN,

MP,

CK,

CR,

CI,

CW,

DK,

DE,

DM,

DO,

DJ,

EC,

SV,

ER,

EE,

FK,

FO,

FJ,

FI,

FR,

GF,

PF,

TF,

GA,

GM,

GE,

GH,

GI,

GD,

GR,

GL,

GP,

GU,

GT,

GG,

GN,

GW,

GY,

HT,

HM,

HN,

HK,

IN,

ID,

IQ,

IR,

IE,

IS,

IM,

IL,

IT,

JM,

JP,

YE,

JE,

JO,

KY,

KH,

CM,

CA,

CV,

KZ,

QA,

KE,

KG,

KI,

CC,

CO,

KM,

CG,

CD,

HR,

CU,

KW,

LA,

LS,

LV,

LB,

LR,

LY,

LI,

LT,

LU,

MO,

MG,

MW,

MY,

MV,

ML,

MT,

MA,

MH,

MQ,

MR,

MU,

YT,

MK,

MX,

FM,

MD,

MC,

MN,

ME,

MS,

MZ,

MM,

NA,

NR,

NP,

NC,

NZ,

NI,

NL,

NE,

NG,

NU,

KP,

NF,

NO,

OM,

AT,

TL,

PK,

PS,

PW,

PA,

PG,

PY,

PE,

PH,

PN,

PL,

PT,

PR,

RE,

RW,

RO,

RU,

BL,

PM,

SB,

ZM,

WS,

SM,

ST,

SA,

SE,

CH,

SN,

RS,

SC,

SL,

ZW,

SG,

SX,

SK,

SI,

SO,

ES,

SJ,

LK,

SH,

KN,

LC,

MF,

VC,

ZA,

SD,

GS,

KR,

SS,

SR,

SZ,

SY,

TJ,

TW,

TZ,

TH,

TG,

TK,

TO,

TT,

TD,

CZ,

TN,

TR,

TM,

TC,

TV,

UM,

UG,

UA,

HU,

UY,

UZ,

VU,

VA,

VE,

AE,

US,

GB,

VN,

WF,

CX,

BY,

EH,

CF,

CY

vat_number

string

VAT ID (Umsatzsteuer-Identifikationsnummer), must adhere to the german schema for VAT IDs

users

object[]

Users registered within this company (read only)

legal_form

string

Legal Form of the company

legal_representatives

object[]

The company's legal representatives (if required)

tax_deduction_eligibility

enum<string>

The company's input tax deduction eligibility (Vorsteuerabzugsberechtigung)

J - Vorsteuerabzugsberechtigt
N - Nicht vorsteuerabzugsberechtigt
K - Reverse-Charge-Verfahren
A - Nicht steuerbare Umsätze - Drittlandunternehmer

Available options:

J,

N,

K,

A

notification_channels

object[]

Notification settings for the company

List Companies Get Company

Partner API

Companies

Users

User Invites

Token Info

Authorizations

Body

Response