# Error codes

This document provides a list of error codes used in the 1099policy API, along with descriptions to help understand their context and usage.

| Error Code | Description |
| --- | --- |
| `general_error` | An unspecified error occurred. Please try again later or contact support. |
| `invalid_api_key` | The provided API key is not valid. Ensure you are using a correct key. |
| `resource_not_found` | The requested resource could not be located. Check the resource ID and try again. |
| `database_operational_error` | A database issue occurred. Please try again later or contact support. |
| `insufficient_permissions` | You lack the necessary permissions to perform this action. |
| `invalid_input` | The input data is not valid. Check the data and try again. |
| `bad_request` | The request could not be processed due to a client error. Verify the request parameters. |
| `effective_date_invalid` | The effective date is not valid. This can occur if the effective coverage date is set in the past. |
| `end_date_invalid` | The end date is not valid. This can occur if the coverage end date is set after the effective date or is more than one year from the effective date. |
| `duplicate_email` | You already have a contractor with that same email address in the system. Use a different email address or modify the existing contractor record. |
| `missing_job_category_code` | The job category code is missing. You can find your approved list of job codes on your dashboard. |
| `invalid_job_category_code` | No active coverage with matching job category code. Check that the job is assigned a job category code with active coverage. |
| `job_category_not_approved` | The job category code has not been approved which is required before proceeding. Contact us if you need help getting the job category code approved. |
| `invoice_exists` | You can't edit a job after the invoice for that job is created. Instead create a new job or, if you need to update amount earned for the job, you can modify the invoice for that job. |
| `invalid_entity_id` | The entity ID is not valid. Verify the entity ID and try again. |
| `contract_has_matching_policy` | The contractor already has an active policy that matches the quote that you're trying to create. Since duplicate coverage is not allowed, you'll want to create a new assignment and attach that to the existing policy or update your `quote` POST request. |
| `policy_already_exists` | You can no longer edit the quote after coverage for that quote is issued. Instead you'll want to create a new quote. |
| `invalid_quote_id` | The quote ID is not valid. Verify the quote ID and try again. |
| `invalid_session_id` | The session ID is not valid. Verify the session ID and try again. |
| `session_expired` | The session has expired. Please start a new session. |
| `application_already_complete` | The application process is already complete. No further action is needed. |
| `custom_applications_disabled` | The create policy endpoint exclusively for custom policy application workflows. Contact us if you need to customize the insurance policy application. |
| `invalid_contractor_id` | The contractor ID is not valid. Verify the contractor ID and try again. |
| `invalid_policy_id` | The policy ID is not valid. Verify the policy ID and try again. |
| `invalid_job_id` | The job ID is not valid. Verify the job ID and try again. |
| `job_is_used` | The job ID provided is currently being used for an assignment with active coverage. You'll need to create a new job ID to continue. |
| `invalid_assignment_id` | The assignment ID is not valid. Verify the assignment ID and try again. |
| `invoice_already_paid` | You can't edit the assignment after the assignment for that invoice has already been paid in full. Contact us if you need additional help. |
| `invalid_coverage_type` | One or more invalid coverage type. Supported coverage types include "workers-comp" and "general". |
| `invalid_event_id` | The webhook event ID is not valid. Verify the webhook event ID and try again. |
| `invalid_paycycle_startdate` | The pay cycle start date is not valid. Check the date format and try again. |
| `invalid_paycycle_enddate` | The pay cycle end date is not valid. Check the date format and try again. |
| `no_active_policy` | No active policy was found for the provided contractor ID. Check that the contractor has an active policy. |
| `invalid_invoice_id` | The invoice ID is not valid. Verify the invoice ID and try again. |
| `invoice_uneditable_already_exists` | The invoice doesn't need to be updated since an invoice with the same gross pay for this job already exists. |
| `missing_job` | The job id ID missing. You'll need to provide the job ID to continue. |
| `missing_contractor` | The contractor ID is missing. You'll need to provide the contractor ID to continue. |
| `invalid_webhook_endpoint_id` | The webhook endpoint ID is not valid. Verify the endpoint ID and try again. |
| `missing_contractor_id` | The contractor ID is missing. Please provide the necessary contractor ID. |
| `missing_certificate` | The certificate is missing. Please provide the necessary certificate. |
| `no_insurance_requirement_found` | No insurance requirement found. We'll need at least one set of insurance requirements on file in order to review the certificate provided. |
| `invalid_mime_type` | The MIME type is not valid. Ensure the MIME type is supported. |
| `invalid_file_size` | The file size is not valid. Ensure the file size is within the allowed limits. |
| `ineligible_state` | The state provided is not a state where we offer coverage. |
| `invalid_coverage_type` | One or more invalid coverage type. The coverage type provided is not one that is currently active for your account. |
| `assignment_already_started` | Cannot cancel assignment after its start date.