Error codes

HTTP status codes

Parse response code to determine further details for request status.

HTTP Status Code

Description
200 OKThe request succeeded. However, the response body may contain a <Fault> element, indicating an error. 
400 Bad requestGenerally, 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 UnauthorizedAuthentication or authorization has failed.
403 ForbiddenThe resource is forbidden.
404 Not FoundThe resource is not found.
500 Internal Server ErrorAn error occurred on the server while processing the request. Resubmit request once; if it persists, contact developer support.
503 Service UnavailableThe 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

<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:
QBODescription
ValidationFaultGenerally recoverable. Some invalid data may have been sent. If the data is corrected, the request may succeed.
SystemFaultGenerally non-recoverable. Something failed on the server that cannot be corrected by the app or developer.
AuthenticationFaultAuthentication credentials are not correct, causing a failure.
AuthorizationFaultAuthorization 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

<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.

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

Error codes

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

Success response

Error CodeMessageDetail
0SuccessSuccess Response

Authorization and authentication error codes

Error
Code
MessageDetail
100General Authentication ErrorAuthenticationErrorGeneral : XXX
110Authentication OAuth ErrorAuthenticationOAuthError: XXX
120Authorization FailureAuthorizationFailure : XXX
Accountant user was deleted while still connected to the company.
130Accessing Wrong ClusterWrongClusterError: XXX , statusCode: XXX
140Company Locked OutCompanyLockedOut: XXX , statusCode: XXX
150Company Under MaintenanceCompanyUnderMaintenance: XXX , statusCode: XXX

General error codes

Error CodeMessageDetail
500Unsupported operationOperation XXX is not supported.
600Duplicate Request IDRequestId already exists in the system, duplicate request is detected
610Object Not FoundID requested for the object does not exists in the system
620Txn ID Cannot Be LinkedTxn ID Cannot Be Linked: XXX
630Duplicate ObjectAlready object with some properties exist and it violates the unique constraint of the object
700Parent Reference InvalidParent referred is not valid reference
800Cannot delete objectObject cannot be deleted due to dependencies not deleted
900Parent cannot be childSame object cannot be parent to itself or a child to itself
1000Operation failedOperation failed, XXX
1010Create FailedObject creation failed, XXX
1020Update FailedObject update failed, XXX
1040Batch size exceeds allowed limit

Batch size is too big, The Batch Limit is XXX BatchItemRequests, requested batch has XXX BatchItemRequests

1050Invalid Content TypeThis is used when v3 messages are sent through Java Message Service queue. We support either XML or JSON format.

ValidationFault error codes

Error CodeMessageDetail
2000Invalid or unsupported object nameObject Name: XXX specified is unsupported or invalid
2010Request has invalid or unsupported propertyProperty Name: XXX specified is unsupported or invalid
2020Required param missing, need to supply the required value for the APIRequired parameter XXX is missing in the request
2030Invalid IDId should be a valid number. Supplied value: XXX
2040Invalid String. The String may contain unsupported or illegal charactersElement contains invalid characters. XXX
2050Invalid String LengthString length specified does not match the supported length. Min: XXX Max: XXX supported. Supplied length: XXX
2060Invalid Date FormatThe format of the date supplied is invalid.
2070Invalid DateValue should be a valid date value:Supplied value: XXX
2080Invalid Number FormatNumber format supplied is invalid
2090Invalid NumberNumber supplied may be correct form but value is not supported by the API
2100Invalid Decimal FormatDecimal format supplied is invalid
2110Invalid DecimalDecimal supplied may be correct form but value is not supported by the API
2120Invalid TypeType is not compatible or supported by the API
2130Invalid Request Id FormatThe format of request Id is invalid and not supported by the API
2140Invalid AmountAmount value supplied is not supported by the API
2150Invalid PercentInvalid percent value, not supported by the API
2160Invalid QuantityInvalid quantity value, not supported by the API
2170Invalid EnumerationInvalid enumeration value, not supported by the API
2180Invalid String RangeInvalid String range (don't know what it is but QBD needs it)
2190Invalid Date RangeInvalid date range
2200Malformed Website Address FormatWeb Site URL does not have correct format. Supplied value: XXX
2210Invalid Email Address FormatEmail Addressdoes not conform to the syntax rules of RFC 822. Supplied value: XXX
2220Invalid Currency TypeThe currency type specified is not valid.
2230Invalid BooleanThe boolean value specified is not valid.
2240Invalid Number RangeThe number specified is not in the valid range. Supplied value: XXX
2250Missing linesYou must fill out at least one split line.
2260MissingPostingTypePosting Type is required and valid values are Credit or Debit
2270MissingTaxApplicableOnTaxApplicableOn is required and valid values are Credit or Debit
2280MissingTaxAmountTax amount is required with TaxCodeRef is applied
2290NegativeAmountNegative amount not supported on a transaction line
2300Amount on debits not equal to creditsPlease balance your debits and credits
2500Invalid Reference IdInvalid Reference ID: XXX
2600Invalid Request Conflict Element in RequestConflict elements found in the request
3000Invalid Custom FieldCustom Field specified is not valid for this object
3200ApplicationAuthenticationFailedSignatureBaseString: XXX
3202EmptyFieldoauth_token
4000The query cannot be parsed, refer to detailed message for reasonsQuery Parser Error: XXX
4001The query is invalidQueryValidationError: XXX
4002The query could not be processed due to unexpected errorsQueryProcessingError: XXX

Specific error codes

Error CodeMessageExplanation
5000Deprecated fieldDeprecated field is used in the request
5010Stale ObjectStale object requested for update. Client needs to refresh the object.
5020Permission DeniedYou do not have permissions to access this feature
5030Feature Not SupportedRequested feature is not supported.
6000Business Validation ErrorBusinessValidationError: XXX
6010Invalid Account.AccountType && Account.SubTypeEither an Account.AccountType or an Account.AccountSubType must be specified
6020Content length missing in requestWe cannot find the content-length header in the request
6030Upload request size exceeds allowed limitThe file upload request should not exceed 100MB in size. The current request size is XXX
6040The file metadata must be of Attachable typeThe file metadata submitted must be of Attachable type. Supplied Type: XXX, request parameter: XXX.
6041Invalid 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.

6050The entity reference type is unsupported for AttachableThe entity reference type XXX is unsupported for Attachable
6060Account.OpenBalanceDate must be specified with Account.OpenBalanceAn Account.OpenBalanceDate is required when specifying an Account.OpenBalance
6070Amount calculation incorrect in the requestAmount is not equal to Qty * UnitPrice. Supplied value: XXX
6080No Name ProvidedTitle, GivenName, MiddleName, FamilyName, DisplayName, Suffix - one of these must be non-empty
6090Discount Line missing required info.Discount amount or percent should be provided.
6100Invalid Line TaxCode in the requestValid Line TaxCodes for US should be TAX or NON. Supplied value: XXX
6110MAS Transaction cannot be updatedThe requested transaction cannot be updated since its a MAS transaction
6120MAS Transaction cannot be deletedThe requested transaction cannot be deleted since its a MAS transaction
6130Cannot change who customer bills withYou 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.
6140Duplicate Doc NumYou must specify a different number. This number has already been used.
6150ParentRef Required Validation ErrorParentRef is required or not if XXX is true of false.
6160Invalid TaxCodeRef Error'CustomSalesTax' id cannot be used for creating a transaction.
6170Invalid TxnTaxDetail ErrorTxnTaxDetail not allowed when GlobalTaxCalculation is set to NotApplicable.
6180Sub Level LimitYou can only nest 5 levels deep.
6190Invalid Company Status ErrorSubscription period has ended or canceled or there was a billing problem. See QuickBooks Online subscription states for further information.
6200Account Period Closed ErrorThe account period has closed
6210Account Period Closed Required Password ErrorThe account period has closed. Please provide password to update the account.
6220Delete Entity Has Balance ErrorThe entity you are trying to delete has an open balance.
6230Invalid TaxCodeRef ErrorCannot update transaction to use CustomSalesTax id.
6240Duplicate Name Exists ErrorThe name supplied already exists. XXX
6250InvalidSalesCustomerThe customer you have specified has been deleted. XXX
6270InventoryTxnDatedBeforeItemStartDateTransactions with inventory (QOH) products can't be dated earlier than the 'Inventory Start Date' for the product
6280Delete Customer Has Unbilled Expenses ErrorCannot delete Customer. : This customer cannot be deleted because there are unbilled charges for this customer.
6290InvalidEmployeeOrVendorEmployee or Vendor need to be provided. Both cannot be present. XXX
6300InvalidEmployeeOrVendorNameInvalid or missing name. Should be Employee or Vendor. XXX
6310MissingCustomerCustomer required if billable: XXX
6320InvalidBillableInvalid billable status: XXX
6330MissingBillingRateInvalid hourly rate: XXX
6340InvalidTimeTime (hours:minutes) needs to be provided : XXX
6350MissingTimeTime (hours:minutes) missing:XXX
6360InvalidStartOrEndTimePlease enter a valid Start time and End time. Also, make sure Break time isn't longer than the elapsed time. XXX
6370StartTimeAfterEndTimeStart time is after End time: XXX
6380InvalidDurationThe time duration is not in the valid range: XXX
6390InvalidMultipleDurationsInvalid multiple time durations. Provide either hours:minutes or start time, endtime XXX
6400Deleting linkedPurchase results in invalid InvoiceThe purchase cannot be deleted as it would make the invoice to which it is linked invalid.
6420Email address is required.Since delivery type is email, an email address is required for this customer.
6430Invalid account type usedInvalid account type: XXX
6440Transaction Detail Information RequiredYou must select a product/service or an account for each split line with either an amount or a billable customer.
6450Attempt to Void Transaction failedTransaction has already settled, so you can no longer void it
6460Invoice MAS Transaction Deposit Amount mismatchInvoice deposit amount XXX and credit card amount YYY do not match
6470TaxLiabilityAccount or TaxRateErrorYou have either selected a tax on a transaction where it's not allowed, or haven't specified a taxrate along with it.
6480Matched Tranasction Delete ErrorYou can not delete this transaction because it is matched to a transaction that was downloaded into a different account
6490MultipleBudgetSecondaryListTypes 
6500MissingBudgetDetails 
6510BudgetAccountMismatch 
6520Missing Tracked Inventory Item QuantityTracked Inventory Line item should have a Qty.
6530Found raw Credit Card Numbering requestRaw 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 CodeMessageDetail
10000An application error has occurred while processing your request.System Failure Error: XXX
10100Result Set BigResult set for the query is too big
10200Company ResetCompany has been reset.  Request for CUD is stale.

 

 Got Questions? Get Answers in our developer forums.