List Companies
List Companies managed by your account. Provide appropriate filters to limit the search.
curl --request GET \
--url https://api.paywise.de/partner/v1/companies/ \
--header 'Authorization: Bearer <token>'
{
"count": 123,
"next": "http://api.example.org/accounts/?offset=400&limit=100",
"previous": "http://api.example.org/accounts/?offset=200&limit=100",
"results": [
{
"href": "https://api.paywise.de/partner/v1/companies/e2f8f69c-d5ef-4821-b334-d3b5769f9a70/",
"id": "6196ba03-83f2-46ea-83e1-a087bd0c5acc",
"name": "Mustermann GmbH & Co. KG",
"address": {
"street": "Musterstr. 1",
"zip": "44651",
"city": "Musterhausen",
"country": "DE"
},
"phone": "+49 89 123456",
"vat_number": "DE123456789",
"users": [
{
"href": "https://api.paywise.de/partner/v1/users/ab5fc850-7bb3-4c33-9741-d1305dfa41d9/",
"id": "ab5fc850-7bb3-4c33-9741-d1305dfa41d9",
"email": "[email protected]",
"first_name": "Max",
"last_name": "Mustermann",
"company": "6196ba03-83f2-46ea-83e1-a087bd0c5acc",
"email_verified": true,
"notification_channels": [
{
"channel_type": "EMAIL",
"value": "[email protected]",
"notification_types": [
"REQUESTS_TO_CLIENT",
"STATUS_UPDATE",
"STATEMENTS"
]
}
]
}
],
"data_submission_completed": true,
"legal_form": "GmbH & Co. KG",
"legal_representatives": [
{
"type": "komplementaer",
"name": "Mustermann Holding GbnH"
},
{
"type": "geschaeftsführer",
"name": "Max Mustermann"
}
],
"tax_deduction_eligibility": "J",
"notification_channels": [
{
"channel_type": "EMAIL",
"value": "[email protected]",
"notification_types": [
"REQUESTS_TO_CLIENT",
"STATUS_UPDATE",
"STATEMENTS"
]
}
]
}
]
}
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Query Parameters
Number of results to return per page.
The initial index from which to return the results.
Response
123
"http://api.example.org/accounts/?offset=400&limit=100"
"http://api.example.org/accounts/?offset=200&limit=100"
Name of the company
Phone number of the company (max 50 characters)
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.
The company's postal address
Street and house number
Zip code
Full name of the city
The country, formatted as two letter ISO-3166-1 country code.
AF
- AfghanistanEG
- ÄgyptenAX
- Åland-InselnAL
- AlbanienDZ
- AlgerienAS
- Amerikanisch-SamoaVI
- Amerikanische JungferninselnAD
- AndorraAO
- AngolaAI
- AnguillaAQ
- AntarktisAG
- Antigua und BarbudaGQ
- ÄquatorialguineaAR
- ArgentinienAM
- ArmenienAW
- ArubaAZ
- AserbaidschanET
- ÄthiopienAU
- AustralienBS
- BahamasBH
- BahrainBD
- BangladeschBB
- BarbadosBE
- BelgienBZ
- BelizeBJ
- BeninBM
- BermudaBT
- BhutanBO
- BolivienBQ
- Bonaire, Sint Eustatius und SabaBA
- Bosnien und HerzegowinaBW
- BotswanaBV
- BouvetinselBR
- BrasilienVG
- Britische JungferninselnIO
- Britisches Territorium im Indischen OzeanBN
- BruneiBG
- BulgarienBF
- Burkina FasoBI
- BurundiCL
- ChileCN
- ChinaMP
- Commonwealth der Nördlichen MarianenCK
- CookinselnCR
- Costa RicaCI
- Côte d'IvoireCW
- CuraçaoDK
- DänemarkDE
- DeutschlandDM
- DominicaDO
- Dominikanische RepublikDJ
- DschibutiEC
- EcuadorSV
- El SalvadorER
- EritreaEE
- EstlandFK
- Falklandinseln (Malwinen)FO
- FaröerinselnFJ
- FidschiFI
- FinnlandFR
- FrankreichGF
- Französisch GuineaPF
- Französisch-PolynesienTF
- Französische Süd- und AntarktisgebieteGA
- GabunGM
- GambiaGE
- GeorgienGH
- GhanaGI
- GibraltarGD
- GranadaGR
- GriechenlandGL
- GrönlandGP
- GuadeloupeGU
- GuamGT
- GuatemalaGG
- GuernseyGN
- GuineaGW
- Guinea-BissauGY
- GuyanaHT
- HaitiHM
- Heard und McDonaldinselnHN
- HondurasHK
- Hong KongIN
- IndienID
- IndonesienIQ
- IrakIR
- Iran (Islamische Republik)IE
- IrlandIS
- IslandIM
- Isle of ManIL
- IsraelIT
- ItalienJM
- JamaikaJP
- JapanYE
- JemenJE
- JerseyJO
- JordanienKY
- KaimaninselnKH
- KambodschaCM
- KamerunCA
- KanadaCV
- Kap VerdeKZ
- KasachstanQA
- KatarKE
- KeniaKG
- KirgisistanKI
- KirivatiCC
- Kokosinseln (Keelinginseln)CO
- KolumbienKM
- KomorenCG
- KongoCD
- Kongo (Demokratische Republik)HR
- KroatienCU
- KubaKW
- KuwaitLA
- Laos, Demokratische VolksrepublikLS
- LesothoLV
- LettlandLB
- LibanonLR
- LiberiaLY
- LibyenLI
- LiechtensteinLT
- LitauenLU
- LuxemburgMO
- MacaoMG
- MadagaskarMW
- MalawiMY
- MalaysiaMV
- MaledivenML
- MaliMT
- MaltaMA
- MarokkoMH
- MarshallinselnMQ
- MartiniqueMR
- MauretanienMU
- MauritiusYT
- MayotteMK
- MazedonienMX
- MexikoFM
- Mikronesien (Föderierte Staaten von)MD
- MoldawienMC
- MonacoMN
- MongoleiME
- MontenegroMS
- MontserratMZ
- MozambiqueMM
- MyanmarNA
- NamibiaNR
- NauruNP
- NepalNC
- NeukaledonienNZ
- NeuseelandNI
- NicaraguaNL
- NiederlandeNE
- NigerNG
- NigeriaNU
- NiueKP
- NordkoreaNF
- NorfolkinselNO
- NorwegenOM
- OmanAT
- ÖsterreichTL
- OsttimorPK
- PakistanPS
- PalästinaPW
- PalauPA
- PanamaPG
- Papua Neu GuineaPY
- ParaguayPE
- PeruPH
- PhilippinenPN
- PitcairnPL
- PolenPT
- PortugalPR
- Puerto RicoRE
- RéunionRW
- RuandaRO
- RumänienRU
- RusslandBL
- Saint-BarthélemyPM
- Saint-Pierre und MiquelonSB
- SalomonenZM
- SambiaWS
- SamoaSM
- San MarinoST
- São Tomé und PríncipeSA
- Saudi ArabienSE
- SchwedenCH
- SchweizSN
- SenegalRS
- SerbienSC
- SeychellenSL
- Sierra LeoneZW
- SimbabweSG
- SingapurSX
- Sint Maarten (niederländischer Teil)SK
- SlowakeiSI
- SlowenienSO
- SomaliaES
- SpanienSJ
- Spitzbergen und Jan MayenLK
- Sri LankaSH
- St. Helena, Ascension und Tristan da CunhaKN
- St. Kitts und NevisLC
- St. LuciaMF
- St. Martin (französischer Teil)VC
- St. Vincent und die GrenadinenZA
- SüdafrikaSD
- SudanGS
- Südgeorgien und die Südlichen SandwichinselnKR
- SüdkoreaSS
- SüdsudanSR
- SurinamSZ
- SwasilandSY
- SyrienTJ
- TadschikistanTW
- Taiwan (Provinz Chinas)TZ
- TansaniaTH
- ThailandTG
- TogoTK
- TokelauTO
- TongaTT
- Trinidad und TobagoTD
- TschadCZ
- TschechienTN
- TunesienTR
- TürkeiTM
- TurkmenistanTC
- Turks- und CaicosinselnTV
- TuvaluUM
- USA - Sonstige Kleine InselnUG
- UgandaUA
- UkraineHU
- UngarnUY
- UruguayUZ
- UsbekistanVU
- VanuatuVA
- VatikanstadtVE
- Venezuela (Bolivarische Republik)AE
- Vereinigte Arabische EmirateUS
- Vereinigte Staaten von AmerikaGB
- Vereinigtes KönigreichVN
- VietnamWF
- Wallis und FutunaCX
- WeihnachtsinselBY
- WeißrusslandEH
- WestsaharaCF
- Zentralafrikanische RepublikCY
- Zypern
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 ID (Umsatzsteuer-Identifikationsnummer), must adhere to the german schema for VAT IDs
Users registered within this company (read only)
E-Mail des Benutzers
Vorname des Benutzers
Nachname des Benutzers
UUID of the company that the user is going to be part of
Notification settings for the user
Type of the communication channel to be used. Currently only supports email
EMAIL
- E-Mail
EMAIL
Value of the communication channel (e.g. the email Address)
STATUS_UPDATE
- Status UpdatesREQUESTS_TO_CLIENT
- RückfragenSTATEMENTS
- Abrechnungen
STATUS_UPDATE
, REQUESTS_TO_CLIENT
, STATEMENTS
The company's default claim type (Vertragsart/Forderungsart)
H05
- DienstleistungsvertragH43
- Warenlieferung/-enH22
- MitgliedsbeitragH21
- MieteH11
- KaufvertragH44
- Werkvertrag/WerklieferungsvertragH08
- HandwerkerleistungH41
- Versicherungsprämie/-beitragH16
- Lehrgangs-/UnterrichtskostenH10
- HotelkostenH02
- Ärztliche oder zahnärztliche LeistungH28
- Schadenersatz aus VertragH26
- ReparaturleistungH24
- Rechtsanwalts-/RechtsbeistandshonorarH06
- FrachtkostenH18
- Miete für KraftfahrzeugH34
- SpeditionskostenH19
- Miete für Wohnraum einschl. NebenkostenH42
- Versorgungsleistung - Strom, Wasser, Gas, Wärme-H17
- Miete für Geschäftsraum einschl. NebenkostenH45
- Zeitungs-/ZeitschriftenbezugH37
- Ungerechtfertigte BereicherungH29
- Schadenersatz aus Unfall/VorfallH01
- Anzeigen in Zeitungen u.a.H78
- Tierärztliche LeistungH14
- LagerkostenH77
- KrankentransportkostenH40
- Vermittlungs-/MaklerprovisionH15
- Leasing/MietkaufH23
- PachtH04
- DarlehensrückzahlungH20
- Mietnebenkosten - auch Renovierungskosten-H79
- VerpflegungskostenH75
- ReisevertragH33
- SchuldanerkenntnisH39
- Vergleich, außergerichtlicherH70
- KindertagesstättenbeitragH90
- Wohngeld/Hausgeld für WohnungseigentümergemeinschaftH09
- HeimunterbringungH03
- BürgschaftH07
- Geschäftsbesorgung durch SelbständigeH12
- KontokorrentabrechnungH13
- Krankenhauskosten-Pflege/BehandlungH36
- Überziehung des BankkontosH61
- Wahlleistungen bei stationärer BehandlungH76
- Telekommunikationsleistungen
H05
, H43
, H22
, H21
, H11
, H44
, H08
, H41
, H16
, H10
, H02
, H28
, H26
, H24
, H06
, H18
, H34
, H19
, H42
, H17
, H45
, H37
, H29
, H01
, H78
, H14
, H77
, H40
, H15
, H23
, H04
, H20
, H79
, H75
, H33
, H39
, H70
, H90
, H09
, H03
, H07
, H12
, H13
, H36
, H61
, H76
Legal Form of the company
The company's legal representatives (if required)
Type / function of the legal representative. This must be compatible with the selected legal form
gesellschafter
- Gesellschafterdirektor
- Direktordirector
- Directorvorstand
- Vorstandinhaber
- Inhabergeschaeftsführer
- Geschäftsführerkomplementaer
- Komplementärpartner
- Partnervorsitzender
- Vorsitzendersonstiges
- Sonstiges
gesellschafter
, direktor
, director
, vorstand
, inhaber
, geschaeftsführer
, komplementaer
, partner
, vorsitzender
, sonstiges
Full name of the legal representative (e.g. Hans Meiser or Meiser Holding GmbH)
The company's input tax deduction eligibility (Vorsteuerabzugsberechtigung)
J
- VorsteuerabzugsberechtigtN
- Nicht vorsteuerabzugsberechtigtK
- Reverse-Charge-VerfahrenA
- Nicht steuerbare Umsätze - Drittlandunternehmer
J
, N
, K
, A
Notification settings for the company
Type of the communication channel to be used. Currently only supports email
EMAIL
- E-Mail
EMAIL
Value of the communication channel (e.g. the email Address)
STATUS_UPDATE
- Status UpdatesREQUESTS_TO_CLIENT
- RückfragenSTATEMENTS
- Abrechnungen
STATUS_UPDATE
, REQUESTS_TO_CLIENT
, STATEMENTS
The company's payout account to which collected funds will be transferred.
32
curl --request GET \
--url https://api.paywise.de/partner/v1/companies/ \
--header 'Authorization: Bearer <token>'
{
"count": 123,
"next": "http://api.example.org/accounts/?offset=400&limit=100",
"previous": "http://api.example.org/accounts/?offset=200&limit=100",
"results": [
{
"href": "https://api.paywise.de/partner/v1/companies/e2f8f69c-d5ef-4821-b334-d3b5769f9a70/",
"id": "6196ba03-83f2-46ea-83e1-a087bd0c5acc",
"name": "Mustermann GmbH & Co. KG",
"address": {
"street": "Musterstr. 1",
"zip": "44651",
"city": "Musterhausen",
"country": "DE"
},
"phone": "+49 89 123456",
"vat_number": "DE123456789",
"users": [
{
"href": "https://api.paywise.de/partner/v1/users/ab5fc850-7bb3-4c33-9741-d1305dfa41d9/",
"id": "ab5fc850-7bb3-4c33-9741-d1305dfa41d9",
"email": "[email protected]",
"first_name": "Max",
"last_name": "Mustermann",
"company": "6196ba03-83f2-46ea-83e1-a087bd0c5acc",
"email_verified": true,
"notification_channels": [
{
"channel_type": "EMAIL",
"value": "[email protected]",
"notification_types": [
"REQUESTS_TO_CLIENT",
"STATUS_UPDATE",
"STATEMENTS"
]
}
]
}
],
"data_submission_completed": true,
"legal_form": "GmbH & Co. KG",
"legal_representatives": [
{
"type": "komplementaer",
"name": "Mustermann Holding GbnH"
},
{
"type": "geschaeftsführer",
"name": "Max Mustermann"
}
],
"tax_deduction_eligibility": "J",
"notification_channels": [
{
"channel_type": "EMAIL",
"value": "[email protected]",
"notification_types": [
"REQUESTS_TO_CLIENT",
"STATUS_UPDATE",
"STATEMENTS"
]
}
]
}
]
}