Error codes

How to fix an error

If you encounter an error and are not sure how to fix it, please use our Error Resolver tool: Error Resolver Tool for a list of possible solutions.

HTTP status codes

Parse response code to determine further details for request status.

HTTP Status Code Description
200 OK The request succeeded. However, the response body may contain a <Fault> element, indicating an error.
400 Bad request Generally, the request cannot be fulfilled due to bad syntax. In some cases, this response code is returned for a request with bad authorization data.
401 Unauthorized Authentication or authorization has failed.
403 Forbidden The resource is forbidden.
404 Not Found The resource is not found.
500 Internal Server Error An error occurred on the server while processing the request. Resubmit request once; if it persists, contact developer support.
503 Service Unavailable The service is temporarily unavailable.

The <Fault> element is contained in either the <IntuitResponse> or <BatchItemResp> element of the response body when an error occurs.

Fault and error elements

1
2
3
4
5
6
<Fault type="faultType">
   <Error code="code" element="element">
      <Message>User-readable text that briefly describes the error.</Message>
      <Detail>Defines details of the exact error.</Detail>
   </Error>
</Fault>

where

  • faultType—The type of the fault:
QBO Description
ValidationFault Generally recoverable. Some invalid data may have been sent. If the data is corrected, the request may succeed.
SystemFault Generally non-recoverable. Something failed on the server that cannot be corrected by the app or developer.
AuthenticationFault Authentication credentials are not correct, causing a failure.
AuthorizationFault Authorization has failed. For example, a request from a QuickBooks Online user tried to access an Estimate entity
  • code—A number that indicates the cause of the error. For a list of allowed values, see Error codes.
  • element—The name of the property (field) associated with this error, if applicable.

Example

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
<IntuitResponse xmlns="http://schema.intuit.com/finance/v3" time="2013-03-29T15:58:08.976-07:00">
   <Fault type="ValidationFault">
      <Error code="2050" element="firstname">
         <Message>Length exceeds limit</Message>
         <Detail>Length of the field exceeds 21 chars</Detail>
      </Error>
      <Error code="2080" element="postalcode">
         <Message>Illegal number format</Message>
         <Detail>ZipCode should be a number with at least 5 digits</Detail>
      </Error>
   </Fault>
</IntuitResponse>

The following tables list the error codes contained in an <Error>element. The Error Code column of the tables list the values of the code attribute of the <Error> element. The”Message column of the tables list the values of the <Message> elements. The following XML shows the code attribute and <Message> element.

1
2
3
4
<Error code="2050" element="firstname">
   <Message>Length exceeds limit</Message>
   <Detail>Length of the field exceeds 21 chars</Detail>
</Error>

Error codes

Range General Meaning
0 Success response
1-499 Authorization and authentication error codes
500-1999 General error codes
2000-9999 Validation error codes
10000+ System faults

Success response

Error Code Message Detail
0 Success Success Response

Authorization and authentication error codes

ErrorCode Message Detail
100 General Authentication Error AuthenticationErrorGe neral : XXX
110 Authentication OAuth Error AuthenticationOAuthEr ror: XXX
120 Authorization Failure AuthorizationFailure : XXX Accountant user was deleted while still connected to the company.
130 Accessing Wrong Cluster WrongClusterError: XXX , statusCode: XXX
140 Company Locked Out CompanyLockedOut: XXX , statusCode: XXX
150 Company Under Maintenance CompanyUnderMaintenan ce: XXX , statusCode: XXX

General error codes

Error Code Message Detail
500 Unsupported operation Operation XXX is not supported.
600 Duplicate Request ID RequestId already exists in the system, duplicate request is detected
610 Object Not Found ID requested for the object does not exists in the system
620 Txn ID Cannot Be Linked Txn ID Cannot Be Linked: XXX
630 Duplicate Object Already object with some properties exist and it violates the unique constraint of the object
700 Parent Reference Invalid Parent referred is not valid reference
800 Cannot delete object Object cannot be deleted due to dependencies not deleted
900 Parent cannot be child Same object cannot be parent to itself or a child to itself
1000 Operation failed Operation failed, XXX
1010 Create Failed Object creation failed, XXX
1020 Update Failed Object update failed, XXX
1040 Batch size exceeds allowed limit Batch size is too big, The Batch Limit is XXX BatchItemRequests, requested batch has XXX BatchItemRequests
1050 Invalid Content Type This is used when v3 messages are sent through Java Message Service queue. We support either XML or JSON format.

ValidationFault error codes

Error Code Message Detail
2000 Invalid or unsupported object name Object Name: XXX **** specified is unsupported or invalid
2010 Request has invalid or unsupported property Property Name: XXX specified is unsupported or invalid
2020 Required param missing, need to supply the required value for the API Required parameter XXX is missing in the request
2030 Invalid ID Id should be a valid number. Supplied value: XXX
2040 Invalid String. The String may contain unsupported or illegal characters Element contains invalid characters. XXX
2050 Invalid String Length String length specified does not match the supported length. Min: XXX Max: XXX supported. Supplied length: XXX
2060 Invalid Date Format The format of the date supplied is invalid.
2070 Invalid Date Value should be a valid date value:Supplied value: XXX
2080 Invalid Number Format Number format supplied is invalid
2090 Invalid Number Number supplied may be correct form but value is not supported by the API
2100 Invalid Decimal Format Decimal format supplied is invalid
2110 Invalid Decimal Decimal supplied may be correct form but value is not supported by the API
2120 Invalid Type Type is not compatible or supported by the API
2130 Invalid Request Id Format The format of request Id is invalid and not supported by the API
2140 Invalid Amount Amount value supplied is not supported by the API
2150 Invalid Percent Invalid percent value, not supported by the API
2160 Invalid Quantity Invalid quantity value, not supported by the API
2170 Invalid Enumeration Invalid enumeration value, not supported by the API
2180 Invalid String Range Invalid String range (don’t know what it is but QBD needs it)
2190 Invalid Date Range Invalid date range
2200 Malformed Website Address Format Web Site URL does not have correct format. Supplied value: XXX
2210 Invalid Email Address Format Email Addressdoes not conform to the syntax rules of RFC 822. Supplied value: XXX
2220 Invalid Currency Type The currency type specified is not valid.
2230 Invalid Boolean The boolean value specified is not valid.
2240 Invalid Number Range The number specified is not in the valid range. Supplied value: XXX
2250 Missing lines You must fill out at least one split line.
2260 MissingPostingType Posting Type is required and valid values are Credit or Debit
2270 MissingTaxApplicableO n TaxApplicableOn is required and valid values are Credit or Debit
2280 MissingTaxAmount Tax amount is required with TaxCodeRef is applied
2290 NegativeAmount Negative amount not supported on a transaction line
2300 Amount on debits not equal to credits Please balance your debits and credits
2500 Invalid Reference Id Invalid Reference ID: XXX
2600 Invalid Request Conflict Element in Request Conflict elements found in the request
3000 Invalid Custom Field Custom Field specified is not valid for this object
3200 ApplicationAuthentica tionFailed SignatureBaseString: XXX
3202 EmptyField oauth_token
4000 The query cannot be parsed, refer to detailed message for reasons Query Parser Error: XXX
4001 The query is invalid QueryValidationError: XXX
4002 The query could not be processed due to unexpected errors QueryProcessingError: XXX

Specific error codes

Error Code Message Explanation
5000 Deprecated field Deprecated field is used in the request
5010 Stale Object Stale object requested for update. Client needs to refresh the object.
5020 Permission Denied You do not have permissions to access this feature
5030 Feature Not Supported Requested feature is not supported.
6000 Business Validation Error BusinessValidationErr or: XXX
6010 Invalid Account.AccountType && Account.SubType Either an Account.AccountType or an Account.AccountSubTyp e must be specified
6020 Content length missing in request We cannot find the content-length header in the request
6030 Upload request size exceeds allowed limit The file upload request should not exceed 100MB in size. The current request size is XXX
6040 The file metadata must be of Attachable type The file metadata submitted must be of Attachable type. Supplied Type: XXX, request parameter: XXX.
6041 Invalid Uploaded File The uploaded file is invalid. Supplied Content Type: File Content Type:xxx, File Name: File Name:rxxx See Attach images and notes for a list of accepted file types.
6050 The entity reference type is unsupported for Attachable The entity reference type XXX is unsupported for Attachable
6060 Account.OpenBalanceDa te must be specified with Account.OpenBalance An Account.OpenBalanceDa te is required when specifying an Account.OpenBalance
6070 Amount calculation incorrect in the request Amount is not equal to Qty * UnitPrice. Supplied value: XXX
6080 No Name Provided Title, GivenName, MiddleName, FamilyName, DisplayName, Suffix - one of these must be non-empty
6090 Discount Line missing required info. Discount amount or percent should be provided.
6100 Invalid Line TaxCode in the request Valid Line TaxCodes for US should be TAX or NON. Supplied value: XXX
6110 MAS Transaction cannot be updated The requested transaction cannot be updated since its a MAS transaction
6120 MAS Transaction cannot be deleted The requested transaction cannot be deleted since its a MAS transaction
6130 Cannot change who customer bills with You cannot change who this customer bills with because there are invoices for the parent that include charges for this customer, or there are payments from the parent that pay off invoices for this customer. Delete all payments or invoices to this customer’s parent which link to this customer.
6140 Duplicate Doc Num You must specify a different number. This number has already been used.
6150 ParentRef Required Validation Error ParentRef is required or not if XXX is true of false.
6160 Invalid TaxCodeRef Error ‘CustomSalesTax’ id cannot be used for creating a transaction.
6170 Invalid TxnTaxDetail Error TxnTaxDetail not allowed when GlobalTaxCalculation is set to NotApplicable.
6180 Sub Level Limit You can only nest 5 levels deep.
6190 Invalid Company Status Error Subscription period has ended or canceled or there was a billing problem. See QuickBooks Online subscriptionstates for further information.
6200 Account Period Closed Error The account period has closed
6210 Account Period Closed Required Password Error The account period has closed. Please provide password to update the account.
6220 Delete Entity Has Balance Error The entity you are trying to delete has an open balance.
6230 Invalid TaxCodeRef Error Cannot update transaction to use CustomSalesTax id.
6240 Duplicate Name Exists Error The name supplied already exists. XXX
6250 InvalidSalesCustomer The customer you have specified has been deleted. XXX
6270 InventoryTxnDatedBefo reItemStartDate Transactions with inventory (QOH) products can’t be dated earlier than the ‘Inventory Start Date’ for the product
6280 Delete Customer Has Unbilled Expenses Error Cannot delete Customer. : This customer cannot be deleted because there are unbilled charges for this customer.
6290 InvalidEmployeeOrVend or Employee or Vendor need to be provided. Both cannot be present. XXX
6300 InvalidEmployeeOrVend orName Invalid or missing name. Should be Employee or Vendor. XXX
6310 MissingCustomer Customer required if billable: XXX
6320 InvalidBillable Invalid billable status: XXX
6330 MissingBillingRate Invalid hourly rate: XXX
6340 InvalidTime Time (hours:minutes) needs to be provided : XXX
6350 MissingTime Time (hours:minutes) missing:XXX
6360 InvalidStartOrEndTime Please enter a valid Start time and End time. Also, make sure Break time isn’t longer than the elapsed time. XXX
6370 StartTimeAfterEndTime Start time is after End time: XXX
6380 InvalidDuration The time duration is not in the valid range: XXX
6390 InvalidMultipleDurati ons Invalid multiple time durations. Provide either hours:minutes or start time, endtime XXX
6400 Deleting linkedPurchase results in invalid Invoice The purchase cannot be deleted as it would make the invoice to which it is linked invalid.
6420 Email address is required. Since delivery type is email, an email address is required for this customer.
6430 Invalid account type used Invalid account type: XXX
6440 Transaction Detail Information Required You must select a product/service or an account for each split line with either an amount or a billable customer.
6450 Attempt to Void Transaction failed Transaction has already settled, so you can no longer void it
6460 Invoice MAS Transaction Deposit Amount mismatch Invoice deposit amount XXX and credit card amount YYY do not match
6470 TaxLiabilityAccount or TaxRateError You have either selected a tax on a transaction where it’s not allowed, or haven’t specified a taxrate along with it.
6480 Matched Tranasction Delete Error You can not delete this transaction because it is matched to a transaction that was downloaded into a different account
6490 MultipleBudgetSeconda ryListTypes  
6500 MissingBudgetDetails  
6510 BudgetAccountMismatch  
6520 Missing Tracked Inventory Item Quantity Tracked Inventory Line item should have a Qty.
6530 Found raw Credit Card Numbering request Raw Credit Card Number not supported. Tokenized Credit Card Number Required.
6540 Deposited Transaction cannot be changed This transaction has been deposited. If you want to change or delete it, you must edit the deposit it appears on and remove it first

Severe error codes

Error Code Message Detail
10000 An application error has occurred while processing your request. System Failure Error: XXX
10100 Result Set Big Result set for the query is too big
10200 Company Reset Company has been reset. Request for CUD is stale.