HTTP Error Messages
The following is the list of HTTP error codes for which a precision was added as well as additional messages to ensure that you can better understand why the request resulted in a HTTP error:
HTTP status code |
Type |
Messages |
Description of the error |
400 Bad request
|
Client error
|
{Missing Field Name} is required. |
Error returned when a mandatory field is not included in a request. |
Request is invalid. |
Error returned when the request does not respect the JSON structure. |
||
Return status ID is invalid. |
Error returned when a return status ID is invalid and does not respect the GUID structure. |
||
Return ID: {ReturnId} is invalid. |
Error returned when a return ID provided in the body of a request is invalid. |
||
Document ID: {id} is invalid. |
Error returned when a document ID provided in the body of a roll forward request is invalid and does not respect the GUID structure. |
||
Cannot pass "FirstName" and "LastName" parameters together with "Name." Pass either "FirstName" and "LastName" or "Name" only. |
Error returned when sending a request to create a Forms document using the firstName, lastName and name parameters:
|
||
Cannot pass both "newClient" and "existingClientCode" parameters at the same time. |
Error returned when the newClient parameter is provided in the same request as the existingClientCode parameter. The newClient parameter is used to create a new contact while the existingClientCode parameter is used for an existing contact. |
||
Note: The expected format of the tax reference number for the Forms product varies depending on the type of contact. Here is the expected format of each type:
|
Error returned when a request is sent to create a Forms document for a new contact and the tax reference number provided does not comply with the format expected. |
||
'newClient' parameter is required if the parameter "existingClientCode" is not included in the request. |
Error returned when both newClient and existingClientCode parameters are missing in a request to create a new document. |
||
The date entered in the "overridePrintedDate" parameter must be in the ISO-8601 format: YYYY-MM-DD. |
Error returned when the date entered in the overridePrintedDate parameter is provided in a format other than the ISO-8601 format. |
||
The language must be English or French. |
Error returned when the language set is other than French or English. |
||
The print format with ID: '{id}' was not found for {product}-{Year}. |
Error returned when a print format ID does not exist for the product and version requested. |
||
Print format ID: {id} is invalid. |
Error returned when a print format ID is invalid and does not respect the structure of a GUID. |
||
Cannot include more than 20 documents per request. |
Error returned when more than 20 documents are included in a request using the "Print a batch of documents to PDF endpoint" |
||
Cannot roll forward more than 200 documents per request. |
Error returned when more than 200 documents are included in a request using the "Roll forward" endpoint. |
||
Preparer profile with ID: '{id}' not found for {product} product. |
Error returned when a preparer profile ID cannot be found for the specified product. |
||
Electronic services identification profile with ID: '{id}' not found. |
Error returned when an electronic services identification profile cannot be found. |
||
The {product} product is not supported by this endpoint. |
Error returned when using an endpoint not supported in the specified product. |
||
The data type is invalid. |
Error returned when an invalid data type is input with the "Print document slips to PDF" endpoint. |
||
Review filter : ‘{filterName}’ is invalid. |
Error returned when an invalid filter name is input with the “Review Filter” endpoint. |
||
The '{dataType}' data type cannot be used with the '{formName}' form. |
Error returned when using the data type requested is not supported for a particular form. |
||
The '{formName}' form is not supported for printing in this version of the {product} product. |
Error returned when using a form that is not supported by the version of the document. |
||
Cannot filter the column with ID: {columnID}. |
Error returned when attempting to filter on a column that does not support filtering. See the List of column IDs to use for filtering and sorting for more details. |
||
Cannot sort the column with ID: {columnID}. |
Error returned when attempting to sort on a column that does not support sorting. See the List of column IDs to use for filtering and sorting for more details. |
||
The column with ID: {columnID} is invalid. |
Error returned when attempting to sort or filter on a columnID that does not exist. |
||
The sortOrder {sortOrderDeclared} is invalid. |
Error returned when the sortOrder input is invalid. |
||
Product ID: {id} is invalid. |
Error returned when the product type input is invalid. |
||
The perPage parameter value entered must be within the accepted range (1-500) |
Error returned when the value provided with the perPage parameter is not between 1 and 500. |
||
The value used to filter on the column with id {columnID} is invalid. |
Error returned when filtering on a column using a string value that does not correspond to an existing value. |
||
The type of value entered with the '{columnID} column ID is invalid. Provide a {valueType} value type. |
Error returned when filtering on a column with the wrong type of value. See the List of column IDs to use for filtering and sorting for the type of value to use per column. |
||
Label ID is invalid. |
Error returned when the Label ID in the request body is not valid and does not fit the structure of a GUID. |
||
Label with ID: ‘{id}’ not found for [product] product. |
Error returned when the Label in the request body does not exist for the product specified in the URL. |
||
The sorting functionality is currently not available. Remove the 'sortColumn' parameter from the request and launch the request again. |
Error returned when the sort function is currently not available. The parameters sortColumn and sortOder must be removed from the request and the request must be resent. |
||
The provided documents cannot belong to different tax years. |
Error returned when attempting to couple a document with another where both documents belong to different tax years. |
||
The provided documents cannot belong to different product types. |
Error returned when attempting to couple a document with another where both documents belong to different product types. |
||
The taxpayer must be spouse or dependant. |
Error returned when the property taxpayer is set to a value other than spouse or dependant. |
||
401 Unauthorized Client error |
Client error |
You are not authorized to execute this action. |
Error returned when an authentication is required to use an endpoint:
|
403 Forbidden |
Client error |
Insufficient privileges to execute this request. |
Error returned when the access is insufficient:
|
You do not have access to this product. |
Error returned when the request targets a product for which the Web API is not active. |
||
You do not have access to the TP1 product. |
Error returned when attempting to use the TP1 product when the TP1 product is not active for the site. |
||
You do not have access to the TP-646 product. |
Error returned when attempting to use the TP-646 product when the TP-646 product is not active for the site. |
||
404 Not found |
Client error |
Resource ID '{resourceId}' not found in the system. |
Error returned when a resource provided is not found. For example, the GUID of a document that was deleted is provided in a request for the GetData endpoint. |
Return ID '{returnId}' not found for document ID {documentId}. |
Error returned when the provided returnId does not exist for a specific document. |
||
ReturnStatus ID '{resourceId}' not found in the system for the specified product. |
Error returned when the returnStatusId provided does not exist for a specific product. |
||
Requested endpoint not found. |
Error returned when targeting an endpoint that does not exist. |
||
Resource not found in the system. |
Error returned when targeting a resource to which user does not have contact security access or return visibility access. |
||
405 Method not allowed |
Client error |
The requested resource does not support http method '{Method}'. |
Error returned when the HTTP verb used to send the request is not supported by the endpoint. |
409 Conflict |
Client error |
Concurrent access. Re-submit request. |
Error returned when the sent request could not be executed because of another action that occurred at the same time. |
429 Too many requests |
Client error |
Request limit has been reached. Try again later. |
Error returned when the number of requests limit per minute or second was reached. |
500 Internal Server Error |
Server error |
Something went wrong while processing your request. We apologize for the inconvenience. |
Error returned when the server could not correctly handle the request. |
503 Service Unavailable |
Server error |
The service is currently not available. Try again later. |
Error returned when the server is unable to handle the request due to a temporary overload or scheduled maintenance. |