ChartVoyant error codes

ChartVoyant does not use numbered codes like E1234. The stable name is the word in the error — conflict, unauthorized, and so on. Banners often show Failed (409): using the HTTP status and a short sentence.

When escalating, copy the correlation id from the error if you see one. Support uses it to find the exact request in the logs without anyone sending patient details.

Find a code

API error codes

Most failures in the EMR are one of these.

Code	HTTP	What it means	What to do
`bad_request`	400	The request was malformed: a missing field, a bad date or id, or a step that isn’t allowed yet.	Read the message. Fix the input (dates as YYYY-MM-DD, required fields, valid ids) and retry. If a workflow step was skipped — a claim not assembled, a note not signed — finish that step first.
`validation_failed`	400	The form failed a rule: incomplete answers, missing ICD/CPT attestation, a declined card, a bad NPI, and similar.	Correct the highlighted field. Finish required questions or signatures. For billing, attest the required codes. For payments, check the card and amount.
`unauthorized`	401	No valid sign-in: wrong password or two-factor code, an expired invite/reset/QR, a revoked session, or an inactive account.	Sign in again. For two-factor, use a fresh authenticator code. Expired links need a new one from the front desk or an admin. If the account is inactive, ask an admin to re-enable it.
`forbidden`	403	You are signed in, but this action isn’t allowed — wrong role, the practice is suspended, or a second factor is required for controlled substances.	Use an account with the right role (Admin → Roles & permissions). If the practice is suspended, call ChartVoyant support. For e-prescribing controls, complete the extra authenticator step.
`ai_addon_disabled`	403	The AI assistant add-on is not enabled for this office.	Ask a practice administrator or ChartVoyant to enable the AI add-on.
`module_disabled`	403	This module is not installed for this office.	An administrator can install it from Admin → Modules.
`not_found`	404	That record isn’t here — already finished or removed, the link is wrong, or you are in a different office.	Reload the screen. Confirm you are in the right office and patient. If a draft was signed elsewhere, open the signed note instead.
`method_not_allowed`	405	The address exists, but not for this kind of request.	Refresh the page and try again. Usually a stale tab or an out-of-date app. If it keeps happening, call support.
`conflict`	409	This change collides with what’s already saved: a duplicate name, a concurrent edit, a payment already voided, or a job already running.	Reload and retry with the latest data. Pick a different unique value if one was taken. Don’t retry a payment or a migration commit blindly — check the current status first.
`rate_limited`	429	Too many requests in a short time (sign-in, two-factor, uploads, kiosk, or the app as a whole).	Wait about a minute and try once. Close extra tabs that may be refreshing. Don’t keep retrying immediately.
`internal`	500	An unexpected server problem. The message is generic on purpose so patient information is never leaked.	Copy the correlation id if you see one and send it to support. Retry once; if it persists, call (855) 686-9268.
`service_unavailable`	503	A service ChartVoyant depends on — often AI — is not available right now, usually because of configuration.	Read the full message; it usually names what to fix. If you can’t, call support and quote that sentence.

No codes match that search.

Fax failure codes

When an outbound or inbound fax fails, the queue may show one of these next to the vendor’s own words.

Code	What it means	What to do
`not_configured`	No fax vendor is set up for this office.	Call ChartVoyant support — this is a platform setting, not something the front desk can toggle.
`invalid_number`	The destination is not a dialable fax number.	Check the number and send again.
`no_document`	A send was attempted with nothing attached.	Attach a document, then send.
`too_large`	The document is over the size limit.	Reduce page count or resolution, or split the document.
`network`	A transient network or vendor failure.	Retry shortly. If it keeps failing, call support.
`empty`	The vendor returned empty pages.	Re-request the fax. If it persists, call support.
`unknown`	An unclassified fax failure.	Call support with the time and destination (no patient details).

No codes match that search.

Still stuck? Open a ticket or call (855) 686-9268. Please don’t include patient information.