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
| Code | Meaning |
|---|---|
account_exists | An account already exists for this address. |
no_account | There is no account for this address. |
passwort_anmeldung | This address signs in with a password; no code is sent. |
konto_pruefung_fehlt | The account check could not be reached. |
wegwerf_adresse | A disposable address. No reply would reach it. |
adresse_unzustellbar | The address's domain accepts no mail: it does not exist, or it has no mail server. |
invalid_code | The code entered is not correct. |
Two-factor sign-in
| Code | Meaning |
|---|---|
zweiter_faktor_code_falsch | The two-factor code is wrong: neither the code from the authenticator app nor an unused backup code. |
zweiter_faktor_nicht_aktiv | Two-factor sign-in is not turned on for this account. |
zweiter_faktor_gesperrt | Too many wrong two-factor codes in a row; the account accepts no further codes for fifteen minutes. |
zweiter_faktor_mailcode_falsch | The code sent by email for turning on two-factor sign-in is wrong or has expired. |
zweiter_faktor_mailcode_unnoetig | This account has a password and proves itself with it when turning on; an email code is only required without a password. |
| No valid session. | |
forbidden | Signed in, but not allowed. |
passwort_nicht_offen | No password is waiting to be set for this account: it was already set, is too old, or the account never needed one. |
herkunft_unzulaessig | A request with a session cookie comes from a page that does not belong to Athaus. |
schluessel_recht_fehlt | This 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_v1 | This 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_ungueltig | The consent for a connection has expired, was changed, belongs to no known client, or mixes the rights of both sides. |
seite_fehlt | This account lacks the product this route or connection requires: search, or the provider side with an active membership in the office. |
contact_missing | There is no contact for this session. |
confirmation_mismatch | The confirmation does not match what was required. |
Approval list (admin panel)
| Code | Meaning |
|---|---|
freigabe_vorhanden | An approval already exists for this address or domain. |
domain_zu_breit | A mail provider's domain cannot be approved, only single addresses on it. |
Team (admin panel)
| Code | Meaning |
|---|---|
admin_vorhanden | This address already has this role or is already on the team. |
admin_aus_konfiguration | This address is an owner through ADMIN_EMAILS; the admin panel can neither change nor remove it. |
letzter_inhaber | This is the last owner; without them nobody could manage the team any more. |
eigene_rolle | You cannot raise your own role. |
Support view (admin panel and app)
| Code | Meaning |
|---|---|
uebernahme_grund_fehlt | The reason for the support view is missing or shorter than ten characters. |
uebernahme_ziel_gesperrt | This person cannot be viewed: an admin, the admin's own address, or an account without a sign-in. |
uebernahme_nur_lesen | This 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_abgelaufen | The support view has expired, ended or been revoked. |
uebernahme_ticket_ungueltig | The support view ticket has expired, was already redeemed, or belongs to another panel session. |
Shape of the request
| Code | Meaning |
|---|---|
invalid_body | The request body does not match the schema. |
invalid_field | One field of the request body was refused; field names its path in the schema's English names. |
invalid_query | The query parameters do not match the schema. |
invalid_id | The ID is not a valid ID. |
invalid_input | The input is not valid. |
query_required | The search query is missing. |
no_fields | Not a single field was sent. |
unknown_key | The key is unknown. |
missing_property_id | The property ID is missing. |
payload_too_large | The request body or file is larger than allowed. |
not_found | There is nothing under this ID. |
fassung_unbekannt | The requested version of the public API (header Athaus-Version) does not exist. At /v1 it is called api_version_unsupported. |
method_not_allowed | This path of the public API does not accept the method. |
referenz_vergeben | This reference number already belongs to another property in this office. At /v1 it is called reference_already_exists. |
idempotenz_rumpf_abweichend | This idempotency key was already used with a different request body. At /v1 it is called idempotency_key_reused. |
idempotenz_schluessel_fehlt | This operation reaches people outside the office and requires the Idempotency-Key header; it is missing. At /v1 it is called idempotency_key_missing. |
idempotenz_laeuft | The 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_unklar | The 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_erfuellt | The 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_offen | The 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_erreicht | The 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_https | The address of the webhook endpoint does not start with https. |
webhook_url_anmeldedaten | The address of the webhook endpoint contains a user name or a password. |
webhook_url_nicht_oeffentlich | The address of the webhook endpoint points to a host that is not publicly reachable. |
webhook_url_unaufloesbar | The host name in the address of the webhook endpoint does not resolve. |
webhook_url_ungueltig | The address of the webhook endpoint is not a valid address. |
testbuero_voll | The 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_erreicht | The office already has as many valid test keys as allowed (10). Revoke one, then create a new one. |
testbuero_beschaeftigt | The 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
| Code | Meaning |
|---|---|
rate_limited | Too many requests in too short a time. |
tageslimit_erreicht | The chat's daily limit is reached; it holds until the end of the day, waiting a few seconds does not help. |
measurement_daily_limit | All manual measurements for today are used; it works again tomorrow. |
Files
| Code | Meaning |
|---|---|
datei_fehlt | No file was included. |
invalid_attachment | The attachment is not allowed. |
typ_nicht_erlaubt | This file type is not allowed. |
typ_stimmt_nicht | The file content does not match its type. |
zu_viele | More files than allowed. |
upload_unvollstaendig | The upload in parts is incomplete: parts are missing, or the file is not as large as announced. |
zu_gross_gesamt | The files together are larger than allowed. |
kein_xml | The file is not XML. |
kein_openimmo | The XML is not OpenImmo. |
kaputt | The file could not be read. |
leer | The file or upload contains nothing. |
unbekanntes_fach | This document folder does not exist. |
datei_nicht_abrufbar | The file could not be fetched from the address given. |
website_fehlt | The profile has no website. |
messung_laeuft | A visibility measurement is already running for this office. |
nicht_messbar | The office has no location, so no visibility questions can be built. |
aktion_angenommen | This visibility action already has an open task. |
kuerzel_fehlt | The office has no handle yet, so there is no public address. |
profil_ohne_daten | The office has no properties or listings a profile could be built from. |
kein_entwurf | There is no draft for this action yet to approve. |
zu_wenig_belege | The office data does not support an answer to this question. |
antwort_unbelegt | The drafted answer does not match the office data. |
optimierung_laeuft | An optimization is already running for this property. |
objekt_gesperrt | The property cannot be changed right now, for example because its listing is locked. |
visibility_credits_leer | The visibility credits are used up; a manual measurement needs one per market. |
einrichtung_fehlt | AI visibility is not set up for this office yet: confirm markets and services first, then measure. |
logo_nicht_gefunden | The website names no logo that can be loaded as an image. |
Plan and payment
| Code | Meaning |
|---|---|
payment_required | This cannot continue without payment. |
plan_required | Your plan does not include this. |
tarif_zu_klein | Your plan does not include this (provider side). At /v1 it is called plan_required. |
profile_unsupported | There is no country profile for this country. |
listing_blocked | Athaus has blocked the listing. |
listing_closed | The property is sold or let and does not go online again. |
listing_incomplete | The listing lacks details needed to publish it. |
listing_not_online | The listing is not running. |
listing_reserved | The property is reserved. |
listing_not_unit | The listing is not a unit of a new-build project. |
project_not_empty | The project still has units. |
project_unit_limit_exceeded | The project already holds as many units as a project can. |
unit_already_exists | The project already has a unit with this number. |
unit_status_invalid | This status does not fit the distribution type of the project. |
quota_exceeded | The limit of your plan has been reached (searchers, properties for sale only). |
mandate_limit | More search briefs than your plan allows. |
nur_kauf | Available for purchase searches only; for rental searches it exists for no account. |
abo_vorhanden | A subscription is already running. |
zustimmung_fehlt | A 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_wechsel | Switching to the same plan is not a switch. |
no_customer | There is no Stripe customer for this account. |
plan_not_configured | No price is set up for this plan. |
billing_not_configured | Payment is not set up. |
| The payment service is not responding. | |
| The PDF printer is not responding, or too slowly. | |
verkauf_pausiert | Sales are paused by operations. |
kuendigung_fehlgeschlagen | The cancellation did not go through. |
widerruf_fehlgeschlagen | The withdrawal did not go through. |
kein_abo | No subscription is running for this account. |
nicht_gekuendigt | There is no cancellation that could be withdrawn. |
maklervertrag_offen | A brokerage contract is still running. At /v1 it is called brokerage_agreement_active. |
konto_intern | The account is internal and already carries its plan without payment. |
angebot_unbekannt | The offer does not exist. |
angebot_bezahlt | The offer is already paid or the payment is in progress. |
konto_vorhanden | An account already exists for this address; an offer for a new customer is only possible without one. |
vorkasse_nur_karte | Payment at the start is only available with a card link, not with an invoice. |
zusatz_nicht_buchbar | This add-on cannot be booked with this plan (Visibility+ is not available with Basic). |
zusatz_takt | An add-on only applies with monthly or yearly billing, not with a custom period and not with payment at the start. |
kein_empfaenger | The office has no owner with an address, and none was given. |
invitation_in_use | A subscription, a trial or a paid offer already runs for this provider; the invitation stays. |
invitation_expired | The invitation has expired. The team will gladly send it again, then you can sign in. |
invitation_offer_open | An offer for this provider is still open; withdraw the offer first. |
invitation_offer_path | This provider was created through an offer that is not paid yet; resend the offer. |
invitation_path_unknown | The history does not fully say how this provider was created; the invitation is not sent again this way. |
Search brief
| Code | Meaning |
|---|---|
mandate_conflict | The search brief contradicts an existing one. |
mandate_incomplete | The search brief is missing required details. |
no_active_mandate | There is no active search brief. |
send_failed | The message was not sent. |
claim_not_stored | The claim was not stored. |
schon_angefragt | There is already an enquiry for this property. |
kein_uebergang | The match has changed in the meantime; the decision leads nowhere from its current state. |
schon_geteilt | These details are already shared on this enquiry. |
Listing and property
| Code | Meaning |
|---|---|
unvollstaendig | The listing is missing required details. |
inserat_abgeschlossen | The property has been sold or let. |
inserat_reserviert | The property is reserved. |
inserat_gesperrt | The listing is blocked. |
kuerzel_vergeben | Someone already has this short name. |
interessent_doppelt | This email address already has an enquirer on this property. |
keine_adresse | The address is missing. At /v1 it is called address_missing. |
adresse_vergeben | A property with this address already exists. At /v1 it is called address_already_exists. |
plz_land | The postal code does not match the country of the address. |
einheit_nr_vergeben | The project already has a unit with this number. |
projekt_nicht_leer | The project still has units and cannot be removed. |
status_in_gebrauch | The project status is still in use and cannot be removed. |
seite_unvollstaendig | The project page is missing details and cannot be published until they are added. |
seite_zurueckgezogen | The agent has withdrawn this project page; it stays gone until they publish it again. |
mail_widerspruch | The 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_einwilligung | The contact has not consented to email, so this marketing message cannot go out. At /v1 it is called email_consent_missing. |
eigene_adresse | You cannot invite your own address. |
schon_eingeladen | This person has already been invited. |
inhaber_nicht_entfernbar | The owner cannot be removed from their organisation; without them nobody could invite, pay or cancel. |
inhaber_zuerst_uebergeben | The owner has to hand ownership to another active member before leaving the office. |
eigenes_buero_nicht_leer | The 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_notiert | This sentence is already a note on the same item. |
entwurf_leer | The draft came back empty. |
entwurf_fehlgeschlagen | The draft could not be created. |
versand_fehlgeschlagen | Sending did not go through. |
zu_wenig | Not enough material for this step. |
seller_disabled | The provider side is switched off. |
abruf | Fetching from the external system failed. |
abgeschlossen | The process is finished and can no longer be changed. |
inserat_aktiv | The property is still listed. At /v1 it is called listing_active. |
nicht_online | The listing is not live right now. |
beispielobjekt | The property is a made-up sample; no enquiry goes to it. |
impressum_fehlt | A commercial provider needs a stored legal notice before their properties appear in ChatGPT and Claude. |
Enquiry without an account
| Code | Meaning |
|---|---|
einwilligung_fehlt | Explicit consent to passing the enquiry on to the provider, in its current version, is missing. |
Exposé access
| Code | Meaning |
|---|---|
expose_gesperrt | The exposé is not released: the commission is not permitted as set, or the broker's details are missing. |
expose_widerrufen | The brokerage contract for this exposé has been withdrawn; access has ended. |
expose_unvollstaendig | The exposé cannot be published yet; the response lists what is missing in fehlt. |
expose_tor_pflicht | The gate cannot be switched off: a commission requires the visitor to confirm the texts. |
expose_positionen_ungueltig | The 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_live | The exposé is not published; a link exists only once it is live. |
expose_nur_entwurf | Only a draft, or a withdrawn exposé that no person opened or requested, can be deleted; a published exposé is withdrawn. |
expose_bau_laeuft | The exposé is being built right now; a second build can start when the first one is done. |
expose_ohne_adresse | This link has no email address; the exposé must be requested with a name and an address. |
branding_keine_website | The office profile has no website to read the colour and font from. |
branding_nicht_gelesen | The website could not be reached or has no readable page. |
provision_widerspruch | The buyer commission contradicts itself: the switch, the rate and the clause text do not fit together. |
provision_miete | A tenant owes no commission; for rentals the only option is commission-free. |
CRM
| Code | Meaning |
|---|---|
email_vergeben | This office already has a contact with this email address. At /v1 it is called email_already_exists. |
name_vergeben | A list of this kind or a project status already has this name. |
Connections to external systems
| Code | Meaning |
|---|---|
geheimnis_nicht_eingerichtet | Access credentials cannot be stored securely right now. |
anbindung_nicht_gespeichert | The connection could not be saved. |
Sending to portals
| Code | Meaning |
|---|---|
portal_nicht_verbunden | The portal is not connected for this office. |
portal_unvollstaendig | The property lacks something this portal needs; the response lists the items. |
portal_unterwegs | A job for this property at this portal is already in progress. |
portal_nichts_zu_entfernen | The property is not listed at this portal. |
portal_anmeldung | The portal server did not accept the user name or password. |
portal_adresse | The portal server address is missing or points into a private network. |
portal_sftp | The port belongs to SFTP; Athaus talks to the portals over FTP and FTPS. |
portal_abgewiesen | The portal server refuses the request, for example because the account may not store files. |
schluessel_falsch | The external system rejects the credentials. |
keine_berechtigung | The credentials are valid but may not read properties. |
nicht_erreichbar | The external system could not be reached. |
quelle_drosselt | The external system is not accepting further requests right now. |
quelle_abgewiesen | The external system rejected the request. |
quelle_unlesbar | The external system answered with something that cannot be read. |
zielfeld_unbekannt | This target field does not exist. |
lauf_nicht_zuruecknehmbar | This run cannot be undone. |
lauf_laeuft | A run is already in progress for this connection. |
lauf_beendet | This run has already finished. |
auswahl_zu_gross | The selection is larger than one call processes at once. |
auswahl_geaendert | The contacts have changed since they were shown; nothing was deleted. |
bestaetigung_falsch | The confirmation does not match the contact's name. |
schon_angemeldet | Someone has signed in with this invitation since; it is no longer an open invitation. |
zusammenfuehrung_gleiche_quelle | Both contacts carry a record of the same source; the source keeps them apart, so they stay two. |
dublette_entschieden | This suggestion has already been decided. |
zusammenfuehrung_nicht_trennbar | The merge is already undone, the period has passed, or one of the two contacts has been merged itself since. |
entitaet_nicht_schreibbar | This connection cannot write this area back. |
The agent in the background
| Code | Meaning |
|---|---|
nicht_sammelbar | This suggestion can only be accepted on its own, not in bulk with others. |
vorschlag_entschieden | This suggestion has already been decided: accepted, rejected or expired. At /v1 it is called proposal_already_decided. |
bestaetigung_noetig | Only a person's click carries out this action, in the assistant's card or in the app. |
bestaetigung_abgelaufen | The confirmation has expired; the action has to be prepared again. |
approval_running | The approved change is still running; its result follows. |
stufe_aus | The office has switched this kind of action off in its automation; nothing is prepared. At /v1 it is called automation_disabled. |
wert_geaendert | The value has been changed again since the agent's change; resetting would overwrite that. |
schon_rueckgaengig | This change by the agent has already been undone. |
Viewings
| Code | Meaning |
|---|---|
voll | The viewing is fully booked. |
vorbei | The time is in the past. |
schon_gebucht | This person already has a booking. |
kalender_belegt | The provider already has another appointment at this time. |
kalender_nicht_eingerichtet | This calendar provider is not set up at Athaus. |
Mailbox
| Code | Meaning |
|---|---|
postfach_nicht_eingerichtet | The Gmail mailbox is not set up at Athaus: the Google client is missing. |
postfach_getrennt | The mailbox has expired or is failing and cannot send; connect it again. |
kein_postfach | No 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_anmeldung | The IMAP server rejected the user or password (many providers require an app password). |
postfach_smtp_anmeldung | The SMTP server rejected the user or password. |
postfach_imap_unerreichbar | The IMAP server cannot be reached at that host and port (unknown host, connection refused or timeout). |
postfach_smtp_unerreichbar | The SMTP server cannot be reached at that host and port (unknown host, connection refused or timeout). |
postfach_imap_tls | The encrypted connection to the IMAP server could not be set up (invalid certificate, wrong encryption for the port, no STARTTLS). |
postfach_smtp_tls | The encrypted connection to the SMTP server could not be set up (invalid certificate, wrong encryption for the port, no STARTTLS). |
postfach_imap_fehlgeschlagen | The IMAP server did not accept the login for another reason or answered unexpectedly. |
postfach_smtp_fehlgeschlagen | The SMTP server did not accept the login for another reason or answered unexpectedly. |
postfach_adresse_andere_verbindung | This address is already connected through Gmail or Outlook; disconnect that connection first, then connect via IMAP. |
postfach_host_gesperrt | The host resolves to an address in a private or internal network; Athaus does not connect there. |
keine_eingehende_mail | The thread has no incoming email a reply could go to. |
mail_senden_fehlgeschlagen | Gmail did not accept the email or could not be reached; nothing was sent. |
mail_senden_unklar | The connection dropped after sending: whether the email went out is unknown; check the mailbox before sending it again. |
objekt_fehlt | The enquiry by email has no property yet; choose one. |
textbausteine_voll | This person has as many text snippets as allowed; delete one first. |
mitglied_unbekannt | The person is not part of the office and cannot be assigned a thread. |
keine_abmeldung | The email names no way to unsubscribe (no List-Unsubscribe with mailto or https). |
Series emails and newsletters
| Code | Meaning |
|---|---|
serie_nicht_aenderbar | The series is running or finished and can no longer be changed. |
serie_unvollstaendig | The series is missing a subject, a text, a connected mailbox or the property its text names. |
serie_platzhalter_unbekannt | The text uses a placeholder that does not exist. |
serie_buero_angaben_fehlen | The office is missing its name and address for the footer of every email. |
serie_keine_empfaenger | No contact matches the selection who is allowed to receive the series. |
Google Drive
| Code | Meaning |
|---|---|
drive_nicht_eingerichtet | Google Drive is not set up at Athaus: the Google client or the key for the picker is missing. |
drive_nicht_verbunden | Google Drive is not connected, or access was revoked at Google; connect it again. |
Valuation
| Code | Meaning |
|---|---|
bewertung_fertig | The valuation is final; to change an assumption, create a new valuation. |
unbekannte_annahme | There is no assumption with this key. |
bewertung_nicht_fertig | The valuation is still a draft; the owner report is only available once it is final. |
bewertung_ohne_spanne | The valuation has no range; without a value there is no owner report. |
annahme_von_hand | A person set this assumption; an extracted value does not replace it. |
incomplete | A valuation needs more details. |
ambiguous | The input is ambiguous. |
Webhooks from external systems
| Code | Meaning |
|---|---|
missing_signature | The signature is missing. |
bad_payload | The webhook body does not match. |
bad_signature | The webhook signature is not valid. |
retry_later | Try again later. |
automation_aus | The automation behind this webhook is switched off; the call triggers nothing. |
webhook_not_configured | This delivery channel is not set up; without a secret it accepts nothing. |
Data export
| Code | Meaning |
|---|---|
datenexport_abgelaufen | The link to this data export has expired; you can request a new export in the settings. |
Everything else
| Code | Meaning |
|---|---|
offer_state | The offer is in a state where this is not possible. |
discount_invalid | The discount does not fit the price, the interval or the plan. |
start_invalid | The start date is outside what is possible. |
prepayment_card_only | Paying the first period in advance is possible with a card only. |
prepayment_invalid | The prepayment does not fit the discount or the price. |
payment_method_not_offered | This payment method is not part of this offer. |
legal_changed | The terms changed since they were shown; the page has to be reloaded. |
offer_preview | This is the team's preview; accepting, declining and paying work only with the customer's link. |
prospect_exists | A prospect with this address already exists. |
tool_failed | The agent's tool failed. |
internal_error | An error that has no code of its own. |
Keep reading
API error codes: what each code means
Every code the REST API returns in the member code of a problem, with its HTTP status and meaning. Generated from the contract.
REST API: errors as problem details
Every error from /v1 is an RFC 9457 problem with a real HTTP status, a code to branch on and a request id for support.
Troubleshooting the most common problems
Sign-in, enquiries, replies, listings, MCP and features missing from your plan: the cause and the next step for each problem.