AthausDocs

Error codes of the app and the MCP servers: what each code means

Every code the app and the MCP servers return, with its meaning. Generated from the registry they are typed against.

Last updated:

Here stand the codes of the app and the MCP servers, not those of /v1. The routes of the app answer plainly with { "error": "rate_limited" }, and the MCP servers put the code in data.error of the JSON-RPC error when they throttle. This is the registry of these codes. The code is an identifier for a branch in your program, not a sentence for a person; there is exactly one per meaning. Branch on the code, never on the HTTP status alone. The REST API at /v1 has its own English codes and its own page: API error codes. Where a code here has a counterpart at /v1, it is named at the end of its row. The error format of /v1 is under Errors.

Sign-in and account

CodeMeaning
account_existsAn account already exists for this address.
no_accountThere is no account for this address.
passwort_anmeldungThis address signs in with a password; no code is sent.
konto_pruefung_fehltThe account check could not be reached.
wegwerf_adresseA disposable address. No reply would reach it.
adresse_unzustellbarThe address's domain accepts no mail: it does not exist, or it has no mail server.
invalid_codeThe code entered is not correct.

Two-factor sign-in

CodeMeaning
zweiter_faktor_code_falschThe two-factor code is wrong: neither the code from the authenticator app nor an unused backup code.
zweiter_faktor_nicht_aktivTwo-factor sign-in is not turned on for this account.
zweiter_faktor_gesperrtToo many wrong two-factor codes in a row; the account accepts no further codes for fifteen minutes.
zweiter_faktor_mailcode_falschThe code sent by email for turning on two-factor sign-in is wrong or has expired.
zweiter_faktor_mailcode_unnoetigThis account has a password and proves itself with it when turning on; an email code is only required without a password.
unauthorizedNo valid session.
forbiddenSigned in, but not allowed.
passwort_nicht_offenNo password is waiting to be set for this account: it was already set, is too old, or the account never needed one.
herkunft_unzulaessigA request with a session cookie comes from a page that does not belong to Athaus.
schluessel_recht_fehltThis API key lacks the right for this route: outside the MCP server only a key with the right freigeben writes, and at /v1 the right per resource decides too. At /v1 it is called insufficient_permissions.
schluessel_nur_v1This API key is narrowed per resource and only works at /v1: the MCP server and the app routes have no such narrowing, and it must not silently drop away there.
verbindung_ungueltigThe consent for a connection has expired, was changed, belongs to no known client, or mixes the rights of both sides.
seite_fehltThis account lacks the product this route or connection requires: search, or the provider side with an active membership in the office.
contact_missingThere is no contact for this session.
confirmation_mismatchThe confirmation does not match what was required.

Approval list (admin panel)

CodeMeaning
freigabe_vorhandenAn approval already exists for this address or domain.
domain_zu_breitA mail provider's domain cannot be approved, only single addresses on it.

Team (admin panel)

CodeMeaning
admin_vorhandenThis address already has this role or is already on the team.
admin_aus_konfigurationThis address is an owner through ADMIN_EMAILS; the admin panel can neither change nor remove it.
letzter_inhaberThis is the last owner; without them nobody could manage the team any more.
eigene_rolleYou cannot raise your own role.

Support view (admin panel and app)

CodeMeaning
uebernahme_grund_fehltThe reason for the support view is missing or shorter than ten characters.
uebernahme_ziel_gesperrtThis person cannot be viewed: an admin, the admin's own address, or an account without a sign-in.
uebernahme_nur_lesenThis route is not allowed in the support view: it is read-only, and anything that writes, sends, pays, deletes or grants access is blocked.
uebernahme_abgelaufenThe support view has expired, ended or been revoked.
uebernahme_ticket_ungueltigThe support view ticket has expired, was already redeemed, or belongs to another panel session.

Shape of the request

CodeMeaning
invalid_bodyThe request body does not match the schema.
invalid_fieldOne field of the request body was refused; field names its path in the schema's English names.
invalid_queryThe query parameters do not match the schema.
invalid_idThe ID is not a valid ID.
invalid_inputThe input is not valid.
query_requiredThe search query is missing.
no_fieldsNot a single field was sent.
unknown_keyThe key is unknown.
missing_property_idThe property ID is missing.
payload_too_largeThe request body or file is larger than allowed.
not_foundThere is nothing under this ID.
fassung_unbekanntThe requested version of the public API (header Athaus-Version) does not exist. At /v1 it is called api_version_unsupported.
method_not_allowedThis path of the public API does not accept the method.
referenz_vergebenThis reference number already belongs to another property in this office. At /v1 it is called reference_already_exists.
idempotenz_rumpf_abweichendThis idempotency key was already used with a different request body. At /v1 it is called idempotency_key_reused.
idempotenz_schluessel_fehltThis operation reaches people outside the office and requires the Idempotency-Key header; it is missing. At /v1 it is called idempotency_key_missing.
idempotenz_laeuftThe first request with this idempotency key is still running; once it ends, the same key returns its response. At /v1 it is called idempotency_key_in_use.
idempotenz_ausgang_unklarThe first request with this idempotency key ended without a stored response, so it is unknown whether it wrote. Check the resource, then retry with a new key. At /v1 it is called idempotency_outcome_unknown.
bedingung_nicht_erfuelltThe condition of the request (If-Match or If-None-Match) does not hold for the current state of the resource, and nothing was written. Read the resource again, apply your change to the new state, and retry with the new ETag. At /v1 it is called precondition_failed.
termine_offenThe property still has upcoming appointments, and deleting it would cancel them for the guests. Cancel the appointments first. At /v1 it is called upcoming_viewings_exist.
webhook_limit_erreichtThe office already has as many webhook endpoints as the public API allows. Delete one, then create. At /v1 it is called webhook_endpoint_limit_exceeded.
webhook_url_kein_httpsThe address of the webhook endpoint does not start with https.
webhook_url_anmeldedatenThe address of the webhook endpoint contains a user name or a password.
webhook_url_nicht_oeffentlichThe address of the webhook endpoint points to a host that is not publicly reachable.
webhook_url_unaufloesbarThe host name in the address of the webhook endpoint does not resolve.
webhook_url_ungueltigThe address of the webhook endpoint is not a valid address.
testbuero_vollThe test office is full (properties, contacts or files). Delete some, or reset the test office. At /v1 it is called test_office_full.
test_key_limit_erreichtThe office already has as many valid test keys as allowed (10). Revoke one, then create a new one.
testbuero_beschaeftigtThe test office is being built or reset right now. Try again in a few seconds. At /v1 it is called test_office_busy.

Rate limit

CodeMeaning
rate_limitedToo many requests in too short a time.
tageslimit_erreichtThe chat's daily limit is reached; it holds until the end of the day, waiting a few seconds does not help.
measurement_daily_limitAll manual measurements for today are used; it works again tomorrow.

Files

CodeMeaning
datei_fehltNo file was included.
invalid_attachmentThe attachment is not allowed.
typ_nicht_erlaubtThis file type is not allowed.
typ_stimmt_nichtThe file content does not match its type.
zu_vieleMore files than allowed.
upload_unvollstaendigThe upload in parts is incomplete: parts are missing, or the file is not as large as announced.
zu_gross_gesamtThe files together are larger than allowed.
kein_xmlThe file is not XML.
kein_openimmoThe XML is not OpenImmo.
kaputtThe file could not be read.
leerThe file or upload contains nothing.
unbekanntes_fachThis document folder does not exist.
datei_nicht_abrufbarThe file could not be fetched from the address given.
website_fehltThe profile has no website.
messung_laeuftA visibility measurement is already running for this office.
nicht_messbarThe office has no location, so no visibility questions can be built.
aktion_angenommenThis visibility action already has an open task.
kuerzel_fehltThe office has no handle yet, so there is no public address.
profil_ohne_datenThe office has no properties or listings a profile could be built from.
kein_entwurfThere is no draft for this action yet to approve.
zu_wenig_belegeThe office data does not support an answer to this question.
antwort_unbelegtThe drafted answer does not match the office data.
optimierung_laeuftAn optimization is already running for this property.
objekt_gesperrtThe property cannot be changed right now, for example because its listing is locked.
visibility_credits_leerThe visibility credits are used up; a manual measurement needs one per market.
einrichtung_fehltAI visibility is not set up for this office yet: confirm markets and services first, then measure.
logo_nicht_gefundenThe website names no logo that can be loaded as an image.

Plan and payment

CodeMeaning
payment_requiredThis cannot continue without payment.
plan_requiredYour plan does not include this.
tarif_zu_kleinYour plan does not include this (provider side). At /v1 it is called plan_required.
profile_unsupportedThere is no country profile for this country.
listing_blockedAthaus has blocked the listing.
listing_closedThe property is sold or let and does not go online again.
listing_incompleteThe listing lacks details needed to publish it.
listing_not_onlineThe listing is not running.
listing_reservedThe property is reserved.
listing_not_unitThe listing is not a unit of a new-build project.
project_not_emptyThe project still has units.
project_unit_limit_exceededThe project already holds as many units as a project can.
unit_already_existsThe project already has a unit with this number.
unit_status_invalidThis status does not fit the distribution type of the project.
quota_exceededThe limit of your plan has been reached (searchers, properties for sale only).
mandate_limitMore search briefs than your plan allows.
nur_kaufAvailable for purchase searches only; for rental searches it exists for no account.
abo_vorhandenA subscription is already running.
zustimmung_fehltA declaration the purchase needs is missing: consent to the terms and the data processing agreement in their current version, or the request for an immediate start.
kein_wechselSwitching to the same plan is not a switch.
no_customerThere is no Stripe customer for this account.
plan_not_configuredNo price is set up for this plan.
billing_not_configuredPayment is not set up.
billing_unavailableThe payment service is not responding.
print_unavailableThe PDF printer is not responding, or too slowly.
verkauf_pausiertSales are paused by operations.
kuendigung_fehlgeschlagenThe cancellation did not go through.
widerruf_fehlgeschlagenThe withdrawal did not go through.
kein_aboNo subscription is running for this account.
nicht_gekuendigtThere is no cancellation that could be withdrawn.
maklervertrag_offenA brokerage contract is still running. At /v1 it is called brokerage_agreement_active.
konto_internThe account is internal and already carries its plan without payment.
angebot_unbekanntThe offer does not exist.
angebot_bezahltThe offer is already paid or the payment is in progress.
konto_vorhandenAn account already exists for this address; an offer for a new customer is only possible without one.
vorkasse_nur_kartePayment at the start is only available with a card link, not with an invoice.
zusatz_nicht_buchbarThis add-on cannot be booked with this plan (Visibility+ is not available with Basic).
zusatz_taktAn add-on only applies with monthly or yearly billing, not with a custom period and not with payment at the start.
kein_empfaengerThe office has no owner with an address, and none was given.
invitation_in_useA subscription, a trial or a paid offer already runs for this provider; the invitation stays.
invitation_expiredThe invitation has expired. The team will gladly send it again, then you can sign in.
invitation_offer_openAn offer for this provider is still open; withdraw the offer first.
invitation_offer_pathThis provider was created through an offer that is not paid yet; resend the offer.
invitation_path_unknownThe history does not fully say how this provider was created; the invitation is not sent again this way.

Search brief

CodeMeaning
mandate_conflictThe search brief contradicts an existing one.
mandate_incompleteThe search brief is missing required details.
no_active_mandateThere is no active search brief.
send_failedThe message was not sent.
claim_not_storedThe claim was not stored.
schon_angefragtThere is already an enquiry for this property.
kein_uebergangThe match has changed in the meantime; the decision leads nowhere from its current state.
schon_geteiltThese details are already shared on this enquiry.

Listing and property

CodeMeaning
unvollstaendigThe listing is missing required details.
inserat_abgeschlossenThe property has been sold or let.
inserat_reserviertThe property is reserved.
inserat_gesperrtThe listing is blocked.
kuerzel_vergebenSomeone already has this short name.
interessent_doppeltThis email address already has an enquirer on this property.
keine_adresseThe address is missing. At /v1 it is called address_missing.
adresse_vergebenA property with this address already exists. At /v1 it is called address_already_exists.
plz_landThe postal code does not match the country of the address.
einheit_nr_vergebenThe project already has a unit with this number.
projekt_nicht_leerThe project still has units and cannot be removed.
status_in_gebrauchThe project status is still in use and cannot be removed.
seite_unvollstaendigThe project page is missing details and cannot be published until they are added.
seite_zurueckgezogenThe agent has withdrawn this project page; it stays gone until they publish it again.
mail_widerspruchThe contact has objected to email or withdrawn consent; only a reply to their own message may go out. At /v1 it is called email_opted_out.
mail_ohne_einwilligungThe contact has not consented to email, so this marketing message cannot go out. At /v1 it is called email_consent_missing.
eigene_adresseYou cannot invite your own address.
schon_eingeladenThis person has already been invited.
inhaber_nicht_entfernbarThe owner cannot be removed from their organisation; without them nobody could invite, pay or cancel.
inhaber_zuerst_uebergebenThe owner has to hand ownership to another active member before leaving the office.
eigenes_buero_nicht_leerThe person's own office still holds data, members or a running subscription and cannot be given up silently for the invitation; the response says what it still holds.
schon_notiertThis sentence is already a note on the same item.
entwurf_leerThe draft came back empty.
entwurf_fehlgeschlagenThe draft could not be created.
versand_fehlgeschlagenSending did not go through.
zu_wenigNot enough material for this step.
seller_disabledThe provider side is switched off.
abrufFetching from the external system failed.
abgeschlossenThe process is finished and can no longer be changed.
inserat_aktivThe property is still listed. At /v1 it is called listing_active.
nicht_onlineThe listing is not live right now.
beispielobjektThe property is a made-up sample; no enquiry goes to it.
impressum_fehltA commercial provider needs a stored legal notice before their properties appear in ChatGPT and Claude.

Enquiry without an account

CodeMeaning
einwilligung_fehltExplicit consent to passing the enquiry on to the provider, in its current version, is missing.

Exposé access

CodeMeaning
expose_gesperrtThe exposé is not released: the commission is not permitted as set, or the broker's details are missing.
expose_widerrufenThe brokerage contract for this exposé has been withdrawn; access has ended.
expose_unvollstaendigThe exposé cannot be published yet; the response lists what is missing in fehlt.
expose_tor_pflichtThe gate cannot be switched off: a commission requires the visitor to confirm the texts.
expose_positionen_ungueltigThe slots do not fit: an image or file does not belong to the property, does not suit the slot, or a slot is filled too often.
expose_nicht_liveThe exposé is not published; a link exists only once it is live.
expose_nur_entwurfOnly a draft, or a withdrawn exposé that no person opened or requested, can be deleted; a published exposé is withdrawn.
expose_bau_laeuftThe exposé is being built right now; a second build can start when the first one is done.
expose_ohne_adresseThis link has no email address; the exposé must be requested with a name and an address.
branding_keine_websiteThe office profile has no website to read the colour and font from.
branding_nicht_gelesenThe website could not be reached or has no readable page.
provision_widerspruchThe buyer commission contradicts itself: the switch, the rate and the clause text do not fit together.
provision_mieteA tenant owes no commission; for rentals the only option is commission-free.

CRM

CodeMeaning
email_vergebenThis office already has a contact with this email address. At /v1 it is called email_already_exists.
name_vergebenA list of this kind or a project status already has this name.

Connections to external systems

CodeMeaning
geheimnis_nicht_eingerichtetAccess credentials cannot be stored securely right now.
anbindung_nicht_gespeichertThe connection could not be saved.

Sending to portals

CodeMeaning
portal_nicht_verbundenThe portal is not connected for this office.
portal_unvollstaendigThe property lacks something this portal needs; the response lists the items.
portal_unterwegsA job for this property at this portal is already in progress.
portal_nichts_zu_entfernenThe property is not listed at this portal.
portal_anmeldungThe portal server did not accept the user name or password.
portal_adresseThe portal server address is missing or points into a private network.
portal_sftpThe port belongs to SFTP; Athaus talks to the portals over FTP and FTPS.
portal_abgewiesenThe portal server refuses the request, for example because the account may not store files.
schluessel_falschThe external system rejects the credentials.
keine_berechtigungThe credentials are valid but may not read properties.
nicht_erreichbarThe external system could not be reached.
quelle_drosseltThe external system is not accepting further requests right now.
quelle_abgewiesenThe external system rejected the request.
quelle_unlesbarThe external system answered with something that cannot be read.
zielfeld_unbekanntThis target field does not exist.
lauf_nicht_zuruecknehmbarThis run cannot be undone.
lauf_laeuftA run is already in progress for this connection.
lauf_beendetThis run has already finished.
auswahl_zu_grossThe selection is larger than one call processes at once.
auswahl_geaendertThe contacts have changed since they were shown; nothing was deleted.
bestaetigung_falschThe confirmation does not match the contact's name.
schon_angemeldetSomeone has signed in with this invitation since; it is no longer an open invitation.
zusammenfuehrung_gleiche_quelleBoth contacts carry a record of the same source; the source keeps them apart, so they stay two.
dublette_entschiedenThis suggestion has already been decided.
zusammenfuehrung_nicht_trennbarThe merge is already undone, the period has passed, or one of the two contacts has been merged itself since.
entitaet_nicht_schreibbarThis connection cannot write this area back.

The agent in the background

CodeMeaning
nicht_sammelbarThis suggestion can only be accepted on its own, not in bulk with others.
vorschlag_entschiedenThis suggestion has already been decided: accepted, rejected or expired. At /v1 it is called proposal_already_decided.
bestaetigung_noetigOnly a person's click carries out this action, in the assistant's card or in the app.
bestaetigung_abgelaufenThe confirmation has expired; the action has to be prepared again.
approval_runningThe approved change is still running; its result follows.
stufe_ausThe office has switched this kind of action off in its automation; nothing is prepared. At /v1 it is called automation_disabled.
wert_geaendertThe value has been changed again since the agent's change; resetting would overwrite that.
schon_rueckgaengigThis change by the agent has already been undone.

Viewings

CodeMeaning
vollThe viewing is fully booked.
vorbeiThe time is in the past.
schon_gebuchtThis person already has a booking.
kalender_belegtThe provider already has another appointment at this time.
kalender_nicht_eingerichtetThis calendar provider is not set up at Athaus.

Mailbox

CodeMeaning
postfach_nicht_eingerichtetThe Gmail mailbox is not set up at Athaus: the Google client is missing.
postfach_getrenntThe mailbox has expired or is failing and cannot send; connect it again.
kein_postfachNo mailbox is connected; a reply to this enquiry is only sent from your own mailbox. At /v1 it is called mailbox_not_connected.
postfach_imap_anmeldungThe IMAP server rejected the user or password (many providers require an app password).
postfach_smtp_anmeldungThe SMTP server rejected the user or password.
postfach_imap_unerreichbarThe IMAP server cannot be reached at that host and port (unknown host, connection refused or timeout).
postfach_smtp_unerreichbarThe SMTP server cannot be reached at that host and port (unknown host, connection refused or timeout).
postfach_imap_tlsThe encrypted connection to the IMAP server could not be set up (invalid certificate, wrong encryption for the port, no STARTTLS).
postfach_smtp_tlsThe encrypted connection to the SMTP server could not be set up (invalid certificate, wrong encryption for the port, no STARTTLS).
postfach_imap_fehlgeschlagenThe IMAP server did not accept the login for another reason or answered unexpectedly.
postfach_smtp_fehlgeschlagenThe SMTP server did not accept the login for another reason or answered unexpectedly.
postfach_adresse_andere_verbindungThis address is already connected through Gmail or Outlook; disconnect that connection first, then connect via IMAP.
postfach_host_gesperrtThe host resolves to an address in a private or internal network; Athaus does not connect there.
keine_eingehende_mailThe thread has no incoming email a reply could go to.
mail_senden_fehlgeschlagenGmail did not accept the email or could not be reached; nothing was sent.
mail_senden_unklarThe connection dropped after sending: whether the email went out is unknown; check the mailbox before sending it again.
objekt_fehltThe enquiry by email has no property yet; choose one.
textbausteine_vollThis person has as many text snippets as allowed; delete one first.
mitglied_unbekanntThe person is not part of the office and cannot be assigned a thread.
keine_abmeldungThe email names no way to unsubscribe (no List-Unsubscribe with mailto or https).

Series emails and newsletters

CodeMeaning
serie_nicht_aenderbarThe series is running or finished and can no longer be changed.
serie_unvollstaendigThe series is missing a subject, a text, a connected mailbox or the property its text names.
serie_platzhalter_unbekanntThe text uses a placeholder that does not exist.
serie_buero_angaben_fehlenThe office is missing its name and address for the footer of every email.
serie_keine_empfaengerNo contact matches the selection who is allowed to receive the series.

Google Drive

CodeMeaning
drive_nicht_eingerichtetGoogle Drive is not set up at Athaus: the Google client or the key for the picker is missing.
drive_nicht_verbundenGoogle Drive is not connected, or access was revoked at Google; connect it again.

Valuation

CodeMeaning
bewertung_fertigThe valuation is final; to change an assumption, create a new valuation.
unbekannte_annahmeThere is no assumption with this key.
bewertung_nicht_fertigThe valuation is still a draft; the owner report is only available once it is final.
bewertung_ohne_spanneThe valuation has no range; without a value there is no owner report.
annahme_von_handA person set this assumption; an extracted value does not replace it.
incompleteA valuation needs more details.
ambiguousThe input is ambiguous.

Webhooks from external systems

CodeMeaning
missing_signatureThe signature is missing.
bad_payloadThe webhook body does not match.
bad_signatureThe webhook signature is not valid.
retry_laterTry again later.
automation_ausThe automation behind this webhook is switched off; the call triggers nothing.
webhook_not_configuredThis delivery channel is not set up; without a secret it accepts nothing.

Data export

CodeMeaning
datenexport_abgelaufenThe link to this data export has expired; you can request a new export in the settings.

Everything else

CodeMeaning
offer_stateThe offer is in a state where this is not possible.
discount_invalidThe discount does not fit the price, the interval or the plan.
start_invalidThe start date is outside what is possible.
prepayment_card_onlyPaying the first period in advance is possible with a card only.
prepayment_invalidThe prepayment does not fit the discount or the price.
payment_method_not_offeredThis payment method is not part of this offer.
legal_changedThe terms changed since they were shown; the page has to be reloaded.
offer_previewThis is the team's preview; accepting, declining and paying work only with the customer's link.
prospect_existsA prospect with this address already exists.
tool_failedThe agent's tool failed.
internal_errorAn error that has no code of its own.

Keep reading

On this page