import requests
url = "https://api.paywise.de/partner/v2/companies/{id}/"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.paywise.de/partner/v2/companies/{id}/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.get("https://api.paywise.de/partner/v2/companies/{id}/")
.header("Authorization", "Bearer <token>")
.asString();using RestSharp;
var options = new RestClientOptions("https://api.paywise.de/partner/v2/companies/{id}/");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "Bearer <token>");
var response = await client.GetAsync(request);
Console.WriteLine("{0}", response.Content);
curl --request GET \
--url https://api.paywise.de/partner/v2/companies/{id}/ \
--header 'Authorization: Bearer <token>'{
"address": {
"city": "Berlin",
"country": "DE",
"postal_code": "10115",
"street": "Example Avenue 5"
},
"case_access": "available",
"case_submission_readiness": {
"issues": [],
"ready": true
},
"created_at": "2026-07-18T10:00:00Z",
"customer_number": "5G0123",
"default_claim_type": "H11",
"external_reference": "crm-4711",
"id": "12000000-0000-4000-8000-000000000001",
"legal_form": "gmbh",
"legal_representatives": [
{
"name": "Taylor Example",
"type": "managing_director"
}
],
"name": "Example Manufacturing GmbH",
"notification_channels": [
{
"notifications": [
"requests_to_client",
"status_updates",
"statements"
],
"type": "email",
"value": "[email protected]"
}
],
"onboarding_mode": "api_only",
"onboarding_status": "confirmation_not_required",
"payout_bank_account": {
"account_holder": "Example Manufacturing GmbH",
"iban": "DE89370400440532013000"
},
"phone": "+49301234567",
"sandbox_origin": "unclassified",
"tax_treatment": "input_tax_deductible",
"updated_at": "2026-07-18T10:00:00Z",
"users": [
{
"created_at": "2026-07-18T10:00:00Z",
"email": "[email protected]",
"first_name": "Taylor",
"id": "13000000-0000-4000-8000-000000000001",
"invite_expires_at": "2026-07-28T10:00:00Z",
"last_name": "Example",
"revocation_reason": "",
"revoked_at": null,
"revoked_by_token_id": null,
"role": "admin",
"sandbox_origin": "unclassified",
"status": "pending_setup",
"updated_at": "2026-07-18T10:00:00Z"
}
],
"vat_number": "DE129273398"
}{
"code": "not_authenticated",
"detail": "Authentication credentials were not provided."
}{
"code": "<string>",
"detail": "<string>",
"errors": [
{
"code": "<string>",
"field": "<string>",
"message": "<string>"
}
]
}{
"code": "not_found",
"detail": "The requested resource was not found."
}{
"code": "<string>",
"detail": "<string>",
"errors": [
{
"code": "<string>",
"field": "<string>",
"message": "<string>"
}
]
}{
"code": "<string>",
"detail": "<string>",
"errors": [
{
"code": "<string>",
"field": "<string>",
"message": "<string>"
}
]
}Get a managed company
Retrieve a single managed company by its uuid.
import requests
url = "https://api.paywise.de/partner/v2/companies/{id}/"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.paywise.de/partner/v2/companies/{id}/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.get("https://api.paywise.de/partner/v2/companies/{id}/")
.header("Authorization", "Bearer <token>")
.asString();using RestSharp;
var options = new RestClientOptions("https://api.paywise.de/partner/v2/companies/{id}/");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "Bearer <token>");
var response = await client.GetAsync(request);
Console.WriteLine("{0}", response.Content);
curl --request GET \
--url https://api.paywise.de/partner/v2/companies/{id}/ \
--header 'Authorization: Bearer <token>'{
"address": {
"city": "Berlin",
"country": "DE",
"postal_code": "10115",
"street": "Example Avenue 5"
},
"case_access": "available",
"case_submission_readiness": {
"issues": [],
"ready": true
},
"created_at": "2026-07-18T10:00:00Z",
"customer_number": "5G0123",
"default_claim_type": "H11",
"external_reference": "crm-4711",
"id": "12000000-0000-4000-8000-000000000001",
"legal_form": "gmbh",
"legal_representatives": [
{
"name": "Taylor Example",
"type": "managing_director"
}
],
"name": "Example Manufacturing GmbH",
"notification_channels": [
{
"notifications": [
"requests_to_client",
"status_updates",
"statements"
],
"type": "email",
"value": "[email protected]"
}
],
"onboarding_mode": "api_only",
"onboarding_status": "confirmation_not_required",
"payout_bank_account": {
"account_holder": "Example Manufacturing GmbH",
"iban": "DE89370400440532013000"
},
"phone": "+49301234567",
"sandbox_origin": "unclassified",
"tax_treatment": "input_tax_deductible",
"updated_at": "2026-07-18T10:00:00Z",
"users": [
{
"created_at": "2026-07-18T10:00:00Z",
"email": "[email protected]",
"first_name": "Taylor",
"id": "13000000-0000-4000-8000-000000000001",
"invite_expires_at": "2026-07-28T10:00:00Z",
"last_name": "Example",
"revocation_reason": "",
"revoked_at": null,
"revoked_by_token_id": null,
"role": "admin",
"sandbox_origin": "unclassified",
"status": "pending_setup",
"updated_at": "2026-07-18T10:00:00Z"
}
],
"vat_number": "DE129273398"
}{
"code": "not_authenticated",
"detail": "Authentication credentials were not provided."
}{
"code": "<string>",
"detail": "<string>",
"errors": [
{
"code": "<string>",
"field": "<string>",
"message": "<string>"
}
]
}{
"code": "not_found",
"detail": "The requested resource was not found."
}{
"code": "<string>",
"detail": "<string>",
"errors": [
{
"code": "<string>",
"field": "<string>",
"message": "<string>"
}
]
}{
"code": "<string>",
"detail": "<string>",
"errors": [
{
"code": "<string>",
"field": "<string>",
"message": "<string>"
}
]
}Authorizations
Headers
Response
Detail and mutation representation of a Partner-managed company.
Administrator confirmation status: confirmation_not_required for api_only; confirmation_pending for provisional web_flow; confirmed for confirmed web_flow. Poll this field independently of membership setup or email delivery.
confirmation_not_required, confirmation_pending, confirmed Provenance of this record. sandbox_native — created inside the sandbox and therefore a test resource you fully own. production_mirror — a read-only copy of a production record. unclassified — everything else, including every record in production. Determines what may be changed in the sandbox, so it is published rather than left to guesswork.
production_mirror- Production mirrorsandbox_native- Sandbox nativeunclassified- Unclassified
production_mirror, sandbox_native, unclassified Default contract or transaction type for new principal claims.
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 Your own identifier for this company (for example a CRM id). Unique per partner, compared byte-exact after trimming surrounding whitespace (case-sensitive): creating a second company with the same value returns 409 company_exists with the existing company_id. Filter with ?external_reference= on the list endpoint.
120Company's input-VAT or reverse-charge treatment.
input_tax_deductible- input_tax_deductiblenot_input_tax_deductible- not_input_tax_deductiblereverse_charge- reverse_chargethird_country_non_taxable- third_country_non_taxable
input_tax_deductible, not_input_tax_deductible, reverse_charge, third_country_non_taxable 