GET
/
partner
/
v1
/
companies
/
{id}
curl --request GET \
  --url https://api.paywise.de/partner/v1/companies/{id}/ \
  --header 'Authorization: Bearer <token>'
{
  "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

​
Authorization
string
header
required

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

Path Parameters

​
id
string
required

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:false
required

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.

​
id
string
​
address
object

The company's postal address

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

​
default_claim_type
enum<string>

The company's default claim type (Vertragsart/Forderungsart)

  • H05 - Dienstleistungsvertrag
  • H43 - Warenlieferung/-en
  • H22 - Mitgliedsbeitrag
  • H21 - Miete
  • H11 - Kaufvertrag
  • H44 - Werkvertrag/Werklieferungsvertrag
  • H08 - Handwerkerleistung
  • H41 - Versicherungsprämie/-beitrag
  • H16 - Lehrgangs-/Unterrichtskosten
  • H10 - Hotelkosten
  • H02 - Ärztliche oder zahnärztliche Leistung
  • H28 - Schadenersatz aus Vertrag
  • H26 - Reparaturleistung
  • H24 - Rechtsanwalts-/Rechtsbeistandshonorar
  • H06 - Frachtkosten
  • H18 - Miete für Kraftfahrzeug
  • H34 - Speditionskosten
  • H19 - Miete für Wohnraum einschl. Nebenkosten
  • H42 - Versorgungsleistung - Strom, Wasser, Gas, Wärme-
  • H17 - Miete für Geschäftsraum einschl. Nebenkosten
  • H45 - Zeitungs-/Zeitschriftenbezug
  • H37 - Ungerechtfertigte Bereicherung
  • H29 - Schadenersatz aus Unfall/Vorfall
  • H01 - Anzeigen in Zeitungen u.a.
  • H78 - Tierärztliche Leistung
  • H14 - Lagerkosten
  • H77 - Krankentransportkosten
  • H40 - Vermittlungs-/Maklerprovision
  • H15 - Leasing/Mietkauf
  • H23 - Pacht
  • H04 - Darlehensrückzahlung
  • H20 - Mietnebenkosten - auch Renovierungskosten-
  • H79 - Verpflegungskosten
  • H75 - Reisevertrag
  • H33 - Schuldanerkenntnis
  • H39 - Vergleich, außergerichtlicher
  • H70 - Kindertagesstättenbeitrag
  • H90 - Wohngeld/Hausgeld für Wohnungseigentümergemeinschaft
  • H09 - Heimunterbringung
  • H03 - Bürgschaft
  • H07 - Geschäftsbesorgung durch Selbständige
  • H12 - Kontokorrentabrechnung
  • H13 - Krankenhauskosten-Pflege/Behandlung
  • H36 - Überziehung des Bankkontos
  • H61 - Wahlleistungen bei stationärer Behandlung
  • H76 - Telekommunikationsleistungen
Available options:
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
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

​
iban
string

The company's payout account to which collected funds will be transferred.

Maximum length: 32