Developer reference

API problem types

When a Corplyst API request fails, the response body follows RFC 9457 (formerly RFC 7807) problem details. Its type field is a link to one of the pages below, which explains what went wrong and how to fix it. Match on type in your code, not on title or detail.

Sign-in and access

• 401Unauthorizedunauthorized
• 401Authentication Failedauthentication-failed
• 401Invalid Tokeninvalid-token
• 429Account Temporarily Lockedaccount-locked
• 429Too Many Requestsrate-limit-exceeded
• 403Forbiddenforbidden
• 403No Active Companyno-active-company
• 403Company Suspendedtenant-suspended
• 403Account Suspendedgroup-suspended
• 403Role Grant Not Allowedrole-grant-not-allowed
• 400Weak Passwordweak-password

Requests

• 400Validation Failedvalidation-failed
• 400Malformed Requestmalformed-request
• 400Invalid Requestinvalid-request
• 400Invalid Upload Object Keyinvalid-upload-object-key

Accounting

• 404Journal Entry Not Foundjournal-entry-not-found
• 409Journal Entry Already Reversedjournal-entry-already-reversed
• 400Unknown Account Codeunknown-account-code
• 409Concurrent Posting Conflictconcurrent-posting-conflict

Invoices, quotes and payments

• 404Invoice Not Foundinvoice-not-found
• 409Invoice Not Editableinvoice-not-editable
• 403Invoice Edit Not Authorizedinvoice-edit-not-authorized
• 409Invoice Not Issuedinvoice-not-issued
• 404Recurring Invoice Schedule Not Foundrecurring-invoice-schedule-not-found
• 409Recurring Invoice Schedule Invalid Transitionrecurring-invoice-schedule-invalid-transition
• 404Quote Not Foundquote-not-found
• 409Quote Not Editablequote-not-editable
• 409Quote Not Acceptedquote-not-accepted
• 409Quote Already Convertedquote-already-converted
• 404Payment Not Foundpayment-not-found
• 400Payment Exceeds Balancepayment-exceeds-balance
• 409Payment Already Reversedpayment-already-reversed
• 422Exchange Rate Unavailableexchange-rate-unavailable

Expenses and documents

• 404Expense Not Foundexpense-not-found
• 409Expense Not Editableexpense-not-editable
• 400Unsupported Receiptunsupported-receipt
• 404Receipt Not Foundreceipt-not-found
• 404Company Document Not Foundcompany-document-not-found

Clients, suppliers and products

• 404Client Not Foundclient-not-found
• 404Supplier Not Foundsupplier-not-found
• 404Product Not Foundproduct-not-found

Employees and payroll

• 404Employee Not Foundemployee-not-found
• 409Employee Invalid Transitionemployee-invalid-transition
• 404Employment Contract Not Foundemployment-contract-not-found
• 409Employment Contract Invalid Transitionemployment-contract-invalid-transition
• 404Contract Clause Template Not Foundcontract-clause-template-not-found
• 409System Default Clause Templatesystem-default-clause-template
• 404Payroll Run Not Foundpayroll-run-not-found
• 409Payroll Run Invalid Transitionpayroll-run-invalid-transition
• 404Payslip Not Foundpayslip-not-found
• 409Payslip Invalid Transitionpayslip-invalid-transition

Tax Center

• 409Tax Form Not Ready For Filingtax-form-not-ready-for-filing
• 404Company Profile Not Foundcompany-profile-not-found
• 404Bank Account Not Foundbank-account-not-found

Account and company administration

• 409Email Already In Useemail-already-in-use
• 409Already A Memberalready-member-of-company
• 409Company Limit Reachedgroup-tenant-limit-exceeded
• 409User Limit Reachedgroup-user-limit-exceeded
• 400Limit Below Current Usagegroup-limit-below-current-usage
• 404Group Not Foundgroup-not-found
• 409Invalid Group Status Transitioninvalid-group-status-transition

Public tools

• 404Link not validtax-check-link-invalid

Server

• 429/503AI Assistance Unavailableai-assist-unavailable
• 500Internal Server Errorinternal-error