Error Code Reference
Error codes returned by the CoverFi API. Each problem response carries a code and an instance reference — quote both when you contact support.
ERR_REQ_001 — Request could not be processed
- HTTP status: 400
- Severity: warning · Display: toast
- User sees: We couldn't process that request. *Try again. If it keeps happening, contact support and mention the code shown below.*
ERR_REQ_002 — Not found
- HTTP status: 404
- Severity: info · Display: toast
- User sees: We couldn't find that page or it may have been removed. *Check the link, or head back to your dashboard.*
ERR_REQ_003 — Conflict
- HTTP status: 409
- Severity: info · Display: toast
- User sees: That change conflicts with the current state of your data. *Refresh to see the latest version, then try again.*
ERR_REQ_004 — Too many requests
- HTTP status: 429
- Severity: warning · Display: toast
- User sees: You're doing that a little too fast, so we've paused things briefly. *Wait a moment, then try again.*
ERR_REQ_005 — Payload too large
- HTTP status: 413
- Severity: info · Display: toast
- User sees: That file or request is too large for us to accept. *Try something smaller, or compress the file first.*
ERR_VAL_001 — Validation failed
- HTTP status: 422
- Severity: info · Display: field
- User sees: Some of the information looks incomplete or incorrect. *Check the highlighted fields and try again.*
ERR_VAL_002 — Email already registered
- HTTP status: 409
- Severity: info · Display: field
- User sees: An account with this email already exists. *Try signing in instead, or use 'Forgot password' if you don't remember it.*
ERR_VAL_003 — Password too weak
- HTTP status: 400
- Severity: info · Display: field
- User sees: That password is too easy to guess. *Use at least 8 characters with a mix of letters and numbers, avoiding common passwords.*
ERR_VAL_004 — Passwords do not match
- HTTP status: 400
- Severity: info · Display: field
- User sees: The two passwords you entered don't match. *Re-type both passwords so they match exactly.*
ERR_VAL_005 — Terms not accepted
- HTTP status: 400
- Severity: info · Display: field
- User sees: You'll need to accept the Terms of Service and Privacy Policy to create an account. *Tick the agreement checkbox, then try again.*
ERR_VAL_006 — Edit conflict
- HTTP status: 409
- Severity: info · Display: toast
- User sees: Someone else changed this just now, so we didn't save your edits to avoid overwriting theirs. *Refresh to see the latest version, then re-apply your changes.*
ERR_VAL_007 — Business email required
- HTTP status: 400
- Severity: info · Display: field
- User sees: Please use your work email to sign up. Free email providers like Gmail or Yahoo aren't accepted. *Enter your company or organization email address.*
ERR_VAL_008 — Permitted use attestation required
- HTTP status: 400
- Severity: info · Display: field
- User sees: You must certify that you won't use this data for FCRA-covered eligibility decisions. *Read and accept the permitted-use attestation, then try again.*
ERR_VAL_009 — Name not allowed
- HTTP status: 422
- Severity: info · Display: toast
- User sees: Names can't include links, web addresses, or HTML. *Remove the link or web address and try again.*
ERR_AUTH_001 — Invalid credentials
- HTTP status: 401
- Severity: info · Display: field
- User sees: That email and password combination didn't match our records. *Double-check both fields and try again, or use 'Forgot password' to reset it.*
ERR_AUTH_002 — Session expired
- HTTP status: 401
- Severity: info · Display: page
- User sees: Your session has ended, so we signed you out to keep your account safe. *Sign in again to pick up where you left off.*
ERR_AUTH_003 — Could not verify sign-in
- HTTP status: 401
- Severity: warning · Display: toast
- User sees: We couldn't verify your sign-in. *Refresh the page. If you're still stuck, sign out and back in.*
ERR_AUTH_004 — Link invalid or expired
- HTTP status: 400
- Severity: info · Display: page
- User sees: This link is no longer valid — it may have expired or already been used. *Request a fresh link and use it soon after it arrives.*
ERR_AUTH_005 — Access token expired
- HTTP status: 401
- Severity: info · Display: toast
- User sees: Your sign-in needed a quick refresh. *Retry the request — the app refreshes your session automatically.*
ERR_AUTH_006 — Verify your email to continue
- HTTP status: 403
- Severity: info · Display: page
- User sees: Verify your email address to start using CoverFi. *Open the verification link we emailed you, or request a new one from this page.*
ERR_PERM_001 — Permission denied
- HTTP status: 403
- Severity: info · Display: toast
- User sees: You don't have permission to do that in this organization. *Ask an organization admin to upgrade your role, or switch to an organization where you have access.*
ERR_PERM_002 — Not found
- HTTP status: 404
- Severity: warning · Display: toast
- User sees: We couldn't find that page or it may have been removed. *Check the link, or head back to your dashboard.*
ERR_PERM_003 — Invitation invalid
- HTTP status: 404
- Severity: info · Display: page
- User sees: This invitation is no longer valid. *Ask the person who invited you to send a new invitation.*
ERR_PERM_004 — Administrator access required
- HTTP status: 403
- Severity: warning · Display: page
- User sees: This area is for platform administrators. *Head back to your dashboard. If you believe you should have access, contact an existing administrator.*
ERR_ORG_001 — Last owner
- HTTP status: 409
- Severity: info · Display: toast
- User sees: An organization needs at least one owner, and this is the only one. *Make someone else an owner first, then try again.*
ERR_ORG_002 — Already a member
- HTTP status: 409
- Severity: info · Display: toast
- User sees: That person is already a member of this organization. *Nothing to do — they already have access. Check the Members page.*
ERR_ORG_003 — Member not found
- HTTP status: 404
- Severity: info · Display: toast
- User sees: We couldn't find that member in this organization. *Refresh the Members page — they may have already been removed.*
ERR_ORG_004 — Organization suspended
- HTTP status: 403
- Severity: warning · Display: page
- User sees: This organization has been suspended. *Contact support to resolve the suspension.*
ERR_ORG_005 — Domain not claimable
- HTTP status: 400
- Severity: info · Display: toast
- User sees: That domain can't be claimed for this organization. *Use your company's own domain — it must match your email address, and shared providers like gmail.com aren't allowed.*
ERR_ORG_006 — Domain already claimed
- HTTP status: 409
- Severity: info · Display: toast
- User sees: Another organization has already claimed that domain. *If this is your company's domain, contact support to resolve the conflict.*
ERR_ORG_007 — Company workspace already exists
- HTTP status: 409
- Severity: info · Display: field
- User sees: Your company already has a workspace on CoverFi. *Verify your email to join automatically, or ask your company's workspace owner for an invitation.*
ERR_ORG_008 — Verify your email to claim a domain
- HTTP status: 403
- Severity: info · Display: toast
- User sees: Verify your email address before claiming a company domain. *Open the verification link we emailed you, then try again.*
ERR_ORG_009 — Workspace limit reached
- HTTP status: 403
- Severity: info · Display: toast
- User sees: You already own the maximum number of workspaces. *Delete a workspace you no longer use, or ask a teammate to create the new one.*
ERR_CRD_001 — Not enough credits
- HTTP status: 409
- Severity: info · Display: toast
- User sees: Your organization doesn't have enough credits for this. *Buy a credit pack, then try again.*
ERR_CRD_002 — Action already settled
- HTTP status: 409
- Severity: info · Display: toast
- User sees: That action was already completed or cancelled. *Refresh to see the current state — no credits were double-charged.*
ERR_CRD_003 — Reservation not found
- HTTP status: 404
- Severity: info · Display: toast
- User sees: We couldn't find that pending action. *Refresh and try again from the start.*
ERR_CRD_004 — Unknown action
- HTTP status: 409
- Severity: warning · Display: toast
- User sees: That action isn't available. *Refresh the page — you may be on an older version of the app.*
ERR_CRD_005 — Unknown credit pack
- HTTP status: 409
- Severity: warning · Display: toast
- User sees: That credit pack isn't available. *Refresh the page and pick one of the listed packs.*
ERR_CRD_006 — Member credit limit reached
- HTTP status: 409
- Severity: info · Display: toast
- User sees: You've reached your monthly credit limit for this organization. *Ask an organization admin to raise your limit, or try again next month.*
ERR_CRD_007 — Not an organization member
- HTTP status: 404
- Severity: info · Display: toast
- User sees: That person isn't a member of this organization. *Check the member list and try again.*
ERR_GEN_001 — Generation not found
- HTTP status: 404
- Severity: info · Display: toast
- User sees: We couldn't find that generation. *Head back to your generations list — it may have been removed.*
ERR_GEN_002 — Generation not available
- HTTP status: 409
- Severity: warning · Display: toast
- User sees: Content generation isn't set up on this server yet. *Try again later, or contact support if this keeps happening.*
ERR_GEN_003 — Generation failed
- HTTP status: 409
- Severity: error · Display: toast
- User sees: We couldn't finish generating that, and your credits for it have been returned. *Try again. If it keeps failing, tweak your input or contact support with the code below.*
ERR_GEN_004 — Still generating
- HTTP status: 409
- Severity: info · Display: toast
- User sees: This is still being generated. *Give it a few seconds — the result will appear when it's ready.*
ERR_GEN_005 — Can't cancel this
- HTTP status: 409
- Severity: info · Display: toast
- User sees: This can only be canceled while it's still generating. *It already finished — refresh to see the result.*
ERR_GEN_006 — Can't delete this yet
- HTTP status: 409
- Severity: info · Display: toast
- User sees: Wait until this finishes before deleting it. *Cancel it first, then delete it.*
ERR_REC_001 — Record not found
- HTTP status: 404
- Severity: info · Display: toast
- User sees: We couldn't find that record. *Head back to the browse list — this record may no longer be available.*
ERR_REC_002 — Insufficient search criteria
- HTTP status: 400
- Severity: info · Display: toast
- User sees: Please narrow your search — we need a bit more to go on. *Add a name plus state, ZIP, or date of birth; an email address; or a phone number.*
ERR_REC_003 — Insufficient address criteria
- HTTP status: 400
- Severity: info · Display: toast
- User sees: Please enter a full street address to look up who has lived there. *Provide a house number and street name, plus either a ZIP or city and state.*
ERR_REC_004 — Insufficient identity criteria
- HTTP status: 400
- Severity: info · Display: toast
- User sees: We need a bit more to run an identity check. *Provide a full name, date of birth, and an email or phone number.*
ERR_REC_005 — Free search needs a name and state
- HTTP status: 400
- Severity: info · Display: toast
- User sees: Free preview searches need a person's name and state. *Add both a name and a two-letter state, or purchase credits to search by any combination of criteria.*
ERR_REC_006 — Records search is busy
- HTTP status: 503
- Severity: warning · Display: toast · Auto-retry: 2× after 3000ms
- User sees: Our records search is handling a burst of requests right now. *Wait a few seconds and try again — no credits were used.*
ERR_REC_007 — Invalid date of birth filter
- HTTP status: 400
- Severity: info · Display: toast
- User sees: That date of birth doesn't look right. *Use YYYY-MM-DD for a full date or YYYY-MM for year and month — e.g. 1985-01-15.*
ERR_REC_008 — Invalid phone filter
- HTTP status: 400
- Severity: info · Display: toast
- User sees: That phone number doesn't look right. *Enter a 10-digit US phone number, e.g. (555) 123-4567.*
ERR_ABU_001 — Records temporarily limited
- HTTP status: 403
- Severity: warning · Display: banner
- User sees: Records access is temporarily limited due to unusual activity. *Wait and try again later, or contact support if you believe this is a mistake.*
ERR_ABU_002 — Records access locked
- HTTP status: 403
- Severity: warning · Display: page
- User sees: Records access for this organization is locked pending review. *Contact support — a human review is required before access can be reinstated.*
ERR_ABU_003 — Abuse alert not found
- HTTP status: 404
- Severity: info · Display: toast
- User sees: We couldn't find that abuse alert. *Refresh the Abuse queue — it may already have been resolved.*
ERR_ABU_004 — Sign-up could not be completed
- HTTP status: 400
- Severity: warning · Display: toast
- User sees: We couldn't create your account right now. *Refresh the page and try again. If it keeps happening, contact support.*
ERR_ABU_005 — Sign-ups temporarily paused
- HTTP status: 429
- Severity: warning · Display: toast
- User sees: New sign-ups are paused for a short while. *Please try again in a little while.*
ERR_FDBK_001 — Feedback not found
- HTTP status: 404
- Severity: info · Display: toast
- User sees: We couldn't find that feedback item. *Refresh the Feedback queue — it may already have been closed or redacted.*
ERR_FDBK_002 — Screenshot too large
- HTTP status: 400
- Severity: warning · Display: field
- User sees: That screenshot is too large to attach. *Send the feedback without the screenshot — your message still reaches us.*
ERR_PRIV_001 — Privacy request not found
- HTTP status: 404
- Severity: info · Display: toast
- User sees: We couldn't find that privacy request. *Refresh the queue — it may have been closed or the link is stale.*
ERR_PRIV_002 — Privacy request cannot be updated
- HTTP status: 409
- Severity: info · Display: toast
- User sees: That privacy request is not in a state that allows this action. *Check the current status, then use the next allowed step (verify → fulfill/forward → close).*
ERR_PRIV_003 — Privacy request incomplete
- HTTP status: 400
- Severity: info · Display: field
- User sees: We need a bit more information to process this privacy request. *Provide a contact email plus an email, phone, or consumer key for the subject.*
ERR_LLM_001 — AI text provider not configured
- HTTP status: 409
- Severity: warning · Display: toast
- User sees: This AI text provider isn't set up on this server yet. *Try again later, or contact support if this keeps happening.*
ERR_LLM_002 — Text generation failed
- HTTP status: 409
- Severity: error · Display: toast
- User sees: The AI provider couldn't complete this request, and your credit for it has been returned. *Try again. If it keeps failing, switch providers or contact support with the code below.*
ERR_LLM_003 — Text completion not found
- HTTP status: 404
- Severity: info · Display: toast
- User sees: We couldn't find that text completion. *Head back to your completions list — it may have been removed.*
ERR_BILL_001 — Billing not configured
- HTTP status: 409
- Severity: warning · Display: toast
- User sees: Payments aren't set up on this server yet. *Try again later, or contact support if this keeps happening.*
ERR_BILL_002 — Payment provider unreachable
- HTTP status: 502
- Severity: critical · Display: toast · Auto-retry: 2× after 2000ms
- User sees: We couldn't reach our payment provider just now. You have not been charged. *Wait a moment and try again. Your credits and data are unaffected.*
ERR_BILL_003 — Plan not purchasable
- HTTP status: 409
- Severity: info · Display: toast
- User sees: That plan can't be purchased directly. *Buy a credit pack on the Billing page instead.*
ERR_BILL_004 — No billing account
- HTTP status: 409
- Severity: warning · Display: toast
- User sees: This organization doesn't have a billing account yet. *Buy a credit pack first — that sets up billing automatically.*
ERR_BILL_005 — Billing update processing
- HTTP status: 409
- Severity: warning · Display: toast
- User sees: Your billing update is still processing. *Give it a minute, then refresh. If nothing changes after a few minutes, contact support with the code below.*
ERR_BILL_006 — Credit pack not purchasable
- HTTP status: 409
- Severity: warning · Display: toast
- User sees: That credit pack can't be purchased right now. *Pick another pack, or contact your administrator if none work.*
ERR_SRV_001 — Internal server error
- HTTP status: 500
- Severity: critical · Display: toast
- User sees: Something went wrong on our end. Your data is safe, and we've been notified. *Try again in a few moments. If it keeps happening, contact support and mention the code shown below.*
ERR_SRV_002 — Request timed out
- HTTP status: 504
- Severity: error · Display: toast · Auto-retry: 2× after 2000ms
- User sees: This is taking longer than expected. *Wait a moment and try again — your previous attempt may still finish on its own.*
ERR_SRV_003 — Maintenance in progress
- HTTP status: 503
- Severity: warning · Display: page
- User sees: We're doing some quick maintenance and will be right back. *Nothing to fix on your end — this page will refresh itself when we're done.*
ERR_SRV_004 — Duplicate request in progress
- HTTP status: 409
- Severity: info · Display: toast
- User sees: We're still working on your previous attempt at this. *Give it a few seconds — the first attempt should finish on its own.*
ERR_KEY_001 — API key not found
- HTTP status: 404
- Severity: info · Display: toast
- User sees: We couldn't find that API key. *Head back to the API Keys page — it may have been revoked.*
ERR_PROP_001 — Property not found
- HTTP status: 404
- Severity: info · Display: toast
- User sees: No property records found for this person. *Try searching by address instead, or check if the county is in our coverage area.*
ERR_PROP_002 — County not covered
- HTTP status: 404
- Severity: info · Display: toast
- User sees: We don't have property data for this county yet. *Property data covers selected counties only; try an address in another county.*
ERR_PROP_003 — Could not parse address
- HTTP status: 400
- Severity: warning · Display: toast
- User sees: We couldn't understand that address. Please check the format and try again. *Make sure you've entered at least a street name and either a state or zip code.*
ERR_PROP_004 — Property not found
- HTTP status: 404
- Severity: info · Display: toast
- User sees: We couldn't find that property. *Search by address again — the parcel may not be in the latest county data.*
ERR_BIZ_001 — Business not found
- HTTP status: 404
- Severity: info · Display: toast
- User sees: We couldn't find that business. *Search by name again — this business may no longer be listed.*
ERR_BIZ_002 — Search needs more detail
- HTTP status: 400
- Severity: warning · Display: toast
- User sees: That search is too short to run. *Enter at least 2 letters of the business name, or a person's last name.*
ERR_NBHD_001 — Neighborhood data unavailable
- HTTP status: 503
- Severity: warning · Display: field · Auto-retry: 2× after 3000ms
- User sees: Neighborhood data is temporarily unavailable. *Try again in a minute — the rest of the record is unaffected.*
ERR_NBHD_002 — No neighborhood match
- HTTP status: 404
- Severity: info · Display: field
- User sees: No neighborhood match for this address. *Neighborhood data needs a valid ZIP or county on the record's primary address.*
ERR_NBHD_003 — Segmentation file invalid
- HTTP status: 400
- Severity: warning · Display: field
- User sees: Segmentation file invalid. *Upload a CSV with a zip column and at most 5,000 rows (2 MB), then try again — no credits were used.*
ERR_NBHD_004 — View the record first
- HTTP status: 403
- Severity: info · Display: field
- User sees: Open the record first to see its neighborhood. *View the record*
ERR_NBHD_005 — Neighborhood explorer not available
- HTTP status: 403
- Severity: info · Display: field
- User sees: Neighborhood exploration isn't available on your account yet. *Contact support if you need access.*
ERR_ADDR_001 — View the record first
- HTTP status: 403
- Severity: info · Display: field
- User sees: Open this record first to see its address check. *View the record*
ERR_ADDR_002 — Record not found
- HTTP status: 404
- Severity: info · Display: field
- User sees: We couldn't find that record. *Go back to search and open the record again.*
ERR_ADDR_003 — Address check data unavailable
- HTTP status: 503
- Severity: warning · Display: field · Auto-retry: 2× after 3000ms
- User sees: The address check is temporarily unavailable. *Try again in a minute — the rest of the record is unaffected.*
ERR_LACT_001 — Contractor not found
- HTTP status: 404
- Severity: info · Display: toast
- User sees: We couldn't find that contractor. *Search again — the license may not appear in the latest permit data.*
ERR_LACT_002 — Local activity data unavailable
- HTTP status: 503
- Severity: warning · Display: banner · Auto-retry: 2× after 3000ms
- User sees: Permit and local activity data is temporarily unavailable. *Try again in a minute.*
ERR_LACT_003 — Local activity not available
- HTTP status: 403
- Severity: info · Display: field
- User sees: Permits and local activity aren't available on your account yet. *Contact support if you need access.*
ERR_WATCH_001 — Watch not found
- HTTP status: 404
- Severity: info · Display: toast
- User sees: We couldn't find that watch. *It may have been deleted — refresh the list.*
ERR_WATCH_002 — Watch needs a place and something to watch
- HTTP status: 400
- Severity: warning · Display: field
- User sees: Choose a place and at least one thing to watch. *Pick a ZIP, county or city, then select at least one trigger.*
ERR_WATCH_003 — Watch limit reached
- HTTP status: 409
- Severity: info · Display: toast
- User sees: You've reached the limit of 50 watches. *Delete a watch you no longer need, then try again.*
ERR_REF_001 — Referral limit reached
- HTTP status: 409
- Severity: info · Display: toast
- User sees: Your organization has already earned the maximum number of company-referral bonuses. *You can keep sharing CoverFi, but additional referrals won't earn bonus credits.*
ERR_REF_002 — That's a teammate, not a referral
- HTTP status: 400
- Severity: info · Display: field
- User sees: That address is on your own company's domain, so it counts as a teammate, not a company referral. *Invite them from the Members page instead — teammate invites earn their own bonus.*
ERR_CRM_001 — Contact not found
- HTTP status: 404
- Severity: warning · Display: toast
- User sees: We couldn't find that contact. It may have been deleted. *Refresh the CRM list and open the contact again.*
ERR_CRM_002 — Email already in the CRM
- HTTP status: 409
- Severity: warning · Display: field
- User sees: Another contact already uses that email address. *Search for the existing contact and update it instead, or use a different email.*
ERR_CRM_003 — Invalid owner
- HTTP status: 422
- Severity: warning · Display: field
- User sees: Contacts and tasks can only be assigned to an active admin. *Pick someone from the owner list, or leave it unassigned.*
ERR_CRM_004 — Task not found
- HTTP status: 404
- Severity: warning · Display: toast
- User sees: We couldn't find that follow-up task. It may have been deleted with its contact. *Refresh the task list and try again.*
ERR_CRM_005 — Contact needs a name, email, or company
- HTTP status: 422
- Severity: warning · Display: field
- User sees: A contact needs at least an email, a name, or a company. *Fill in one of those fields, then save again.*
ERR_CRM_006 — Company not found
- HTTP status: 404
- Severity: warning · Display: toast
- User sees: We couldn't find that company. *Refresh the companies list and try again.*
ERR_LIST_001 — Saved list not found
- HTTP status: 404
- Severity: info · Display: toast
- User sees: We couldn't find that saved list. *It may have been deleted — refresh the list.*
ERR_LIST_002 — Saved list limit reached
- HTTP status: 409
- Severity: info · Display: toast
- User sees: You've reached the limit of 50 saved lists. *Delete a list you no longer need, then try again.*
ERR_PORTFOLIO_001 — Portfolio not found
- HTTP status: 404
- Severity: info · Display: toast
- User sees: We couldn't find that portfolio. *It may have been deleted — refresh the list.*
ERR_PORTFOLIO_002 — Too many rows
- HTTP status: 400
- Severity: warning · Display: field
- User sees: A portfolio upload can include at most 5,000 rows. *Split the file so each upload stays within 5,000 rows, then try again.*
ERR_PORTFOLIO_003 — Portfolio limit reached
- HTTP status: 409
- Severity: info · Display: toast
- User sees: You've reached the limit of 20 portfolios. *Delete a portfolio you no longer need, then try again.*
ERR_PORTFOLIO_004 — Portfolio row not found
- HTTP status: 404
- Severity: info · Display: toast
- User sees: We couldn't find that portfolio row. *It may have been removed — refresh the portfolio.*
ERR_NET_001 — You're offline
- HTTP status: — (frontend-only)
- Severity: info · Display: banner · Auto-retry: 2× after 1500ms
- User sees: We can't reach the internet right now. *Check your connection — we'll retry automatically, and anything you typed is still here.*