Error Codes
The XML API and SOAP API return error codes to indicate problems with your request or specific to a query or action on a particular object. The following tables list the error codes, the commands or methods and the type of objects that can result in the error, and the error descriptions.
0 – 199 | 200 – 399 | 400 – 599 | 600 – 799 | 800 – 899 | 900 – 999 | 1000 – 1199 | 1200 – 1999 | 2000 – 2999
0 – 199
Error Code |
Command |
Object Type |
Short Message |
More Information |
---|---|---|---|---|
0 |
— |
— |
Success |
The operation completed successfully. |
1 |
— |
— |
Unknown Error |
An unknown error occurred. Try again and if the problem persists, contact OpenAir Customer Support. |
2 |
— |
— |
not logged in |
The operation requires authentication but the authentication command was not successful or was omitted in the API request. |
3 |
— |
— |
too many arguments |
The API request included too many arguments for one of the commands. Verify the commands and the arguments for each command included in your request. |
4 |
— |
— |
too few arguments |
The API request did not include enough arguments for one of the commands. Verify the commands and the arguments for each command included in your request. |
5 |
— |
— |
Unknown Command |
One of the commands in your API request uses an unknown method. Verify the commands and ensure only supported methods are used in your request. |
6 |
— |
— |
Access from an invalid URL |
The URL used to access the API is not valid. Verify the URL. |
7 |
— |
— |
Invalid OffLine version |
The version of OpenAir OffLine is not supported. Install the latest version of the OpenAir OffLine add-on on your computer. |
8 |
— |
— |
Failure + Dynamic Message |
The operation was unsuccessful. Review the Error record included in the response. This code is reserved for dynamically generated error codes. |
9 |
— |
— |
Logged out |
The |
10 |
— |
— |
Invalid parameters |
Invalid parameters used. Verify your API request. |
200 – 399
Error Code |
Command |
Object Type |
Short Message |
More Information |
---|---|---|---|---|
201 |
invalid company |
The account with the Company ID [ |
||
202 |
duplicate user nick |
There is already a user with the same User ID [ |
||
203 |
too few arguments |
Both a company object and a user object must be specified. |
||
204 |
Namespace error |
Users must be created in the same namespace as the company. |
||
205 |
Workschedule error |
Invalid account workschedule specified |
||
206 |
Role error |
Invalid role specified |
||
303 |
please pick a different password |
The password specified does not meet the minimum password policy requirements configured for the OpenAir account. Review the password policy and use a password that meets the policy requirements. |
||
304 |
|
— |
Not enabled |
Reserved usage. The |
305 |
Not enabled to edit password |
The password cannot be modified or the user is set up to use SAML single sign-on for authentication. |
400 – 599
Error Code |
Command |
Object Type |
Short Message |
More Information |
---|---|---|---|---|
401 |
— |
Auth failed |
Access denied. The combination of company ID [ |
|
409 |
— |
Account Canceled |
The account with company ID |
|
411 |
— |
Account conflict, contact customer service |
There is a problem with the account. Contact OpenAir Customer Support. |
|
413 |
— |
Account not privileged to access API |
API access is not permitted for this OpenAir account or user. |
|
414 |
— |
Temporarily unavailable |
The service is temporarily unavailable. Try again in a few minutes and if the problem persists, contact OpenAir Customer Support. |
|
415 |
— |
Account archived |
The account with company ID |
|
417 |
— |
Restricted IP address |
Access is not allowed from the client IP address. The IP address is not in the IP address allowlist for the authenticating or authenticated user. See IP Restriction. |
|
418 |
— |
Invalid uid session |
The |
|
419 |
— |
Authentication failed, please retry |
Unexpected authentication failure. Try again later. If you are using session-based authentication or OAuth2.0 access token authorization, renew the |
|
420 |
— |
— |
Authentication failed |
SAML single sign-on authentication error. If the problem persists, contact the identity provider services vendor. |
421 |
— |
— |
Account misconfiguration or invalid assertion |
SAML single sign-on authentication error. Verify your identity provider configuration and the SAML integration configuration in OpenAir. If the problem persists, contact the identity provider services vendor. |
423 |
— |
— |
No permissions to read ServerStatus data |
Reserved usage. Server status information is not accessible to OpenAir customers. |
424 |
— |
No permissions to modify data |
The authenticated user is not an account administrator or the owner of the object and the account is configured to prevent the creation, modification or deletion of an object owned by a different user. |
|
425 |
— |
Functionality not available |
The functionality is not available for your OpenAir account. For example, the API returns this error if you attempt to modify proxy user information and your account is not configured to allow proxy modification using the API, or if you attempt to add or modify project task estimate objects and the Hours Remaining on Tasks feature is not enabled for your account. |
|
426 |
— |
You must use account-specific domain |
All connections to your OpenAir account must use the account-specific domain
|
|
501 |
— |
— |
API authentication required |
API access must first be authenticated. |
503 |
— |
— |
Invalid or missing key attribute |
A valid API key must be specified. |
504 |
— |
— |
Invalid or missing namespace attribute |
A valid API namespace must be specified. |
505 |
— |
— |
The namespace and key do not match |
The API namespace and API key combination is not valid. |
506 |
— |
— |
Authentication key disabled |
This API key is disabled. For more information, contact OpenAir Customer Support |
555 |
— |
— |
You have exceeded the limit set for the account for input objects |
The maximum number of object you can add or modify in a single request is |
556 |
— |
— |
API rate limit exceeded |
The maximum number of requests allowed for your OpenAir account in a 24-hour window or in a 60-seconds window has been reached. Try again later. |
600 – 799
Error Code |
Command |
Object Type |
Short Message |
More Information |
---|---|---|---|---|
601 |
|
All |
Invalid id/code |
Could not find an object matching the internal ID or the criteria specified in your request. |
602 |
All |
Invalid field |
One or more of the property names listed for inclusion in the response are not valid. Verify the fields listed in your API request. |
|
603 |
All |
Invalid type or method |
Either the object |
|
604 |
Attachment size exceeds space available |
The OpenAir account does not have enough storage space available to add the attachment. Contact your account administrator to increase the storage space for your account or free some of the account storage space. |
||
605 |
All |
Limit clause must be specified and be less than the account limit for output data |
The maximum number of object you can read in a single request is |
|
606 |
Projections are running, please try again in a few minutes |
Revenue projection objects can only be read using the API if there are no charge projection runs in progress. This is because the data may be incomplete until the charge projection job completes. |
||
701 |
All |
Cannot delete, failed dependency check |
All dependencies (objects of the same or other types directly or indirectly referencing this object by internal ID) must be deleted before this object can be deleted. |
|
702 |
Invalid note |
The preference could not be deleted. |
800 – 899
Error Code |
Command |
Object Type |
Short Message |
More Information |
---|---|---|---|---|
800 |
Synchronization failed |
Failed to propagate the changes to the identity service. Please try again later. |
||
801 |
Not a valid Customer ID |
The customer with internal ID |
||
802 |
This Envelope number is already taken |
An expense report with tracking number |
||
803 |
This user does not have permission to modify the record |
The authenticated user must be an account administrator or have sufficient role and access permissions to modify this record. |
||
804 |
Not a valid Item type |
The expense item |
||
805 |
Reference number in use |
A receipt with tracking number A resource request (queue) with tracking number |
||
806 |
Already accepted by signer |
The receipt or time entry was accepted by a signer and cannot be modified. |
||
807 |
— |
Invalid payment type |
The payment type passed is not valid (possibly inactive, or deleted). |
|
808 |
Invalid preference |
To modify a preference you must set a valid |
||
809 |
Invalid Timesheet |
The timesheet with internal ID |
||
810 |
Invalid index |
The index you specified does not exist in that table. |
||
811 |
Invalid predecessor |
One or more internal IDs in the |
||
812 |
Invalid parentid |
The internal ID of the immediate ancestor [ |
||
813 |
Invalid projectid |
The project with internal ID |
||
814 |
duplicate id_number |
This user-defined task number |
||
815 |
Projecttask does not exist |
The project task with internal ID |
||
816 |
User role/type does not exist |
The |
||
817 |
Invalid envelope |
The expense report with internal ID |
||
818 |
duplicate user nick |
A user with the same |
||
819 |
Slip cannot be deleted |
This slip cannot be deleted because it is part of an invoice. |
||
820 |
Envelope not open |
The expense report cannot be modified because it is has been submitted for approval (no longer open). |
||
821 |
Timesheet not open |
This error is returned under the following conditions:
|
||
822 |
Slip cannot be modified |
The charge cannot be edited. |
||
823 |
Slip, bad invoice id |
The charge is already part of an invoice and cannot be moved to a different invoice. |
||
824 |
Must specify name or company |
The customer or prospect must have a valid |
||
825 |
Invalid invoice |
The invoice with internal ID |
||
826 |
Date is required |
A |
||
827 |
Reimbursements can only be applied after the envelope is approved |
The status of the expense report with internal ID |
||
828 |
This Invoice number is already taken |
This user-defined invoice number |
||
829 |
Not a valid user |
The user with internal ID |
||
830 |
Not a valid booking type |
|
||
831 |
No startdate or enddate specified |
A start date and an end date are both required. |
||
832 |
Illegal date range |
The start date must be before the end date. |
||
833 |
Percentage not specified |
A |
||
834 |
Hours not specified |
|
||
835 |
Only owner can edit this project |
The authenticated user must be the project's owner to modify this project or project task. |
||
836 |
Not allowed to add entity |
The authenticated user does not have sufficient permission to add a record. |
||
837 |
All objects with currency property |
Not a valid account currency |
The |
|
838 |
Not allowed to have more than one current costs per user |
Only one loaded cost can be the current loaded cost for the same user. |
||
839 |
|
The base 64 encoded binary data of the attachment file [ |
||
840 |
Not a valid primary filter set |
A valid primary filter set [ |
||
841 |
Invalid email |
|
||
842 |
— |
Invalid period |
Period is a required field. |
|
843 |
— |
Invalid timing |
Timing is a required field. |
|
844 |
Invalid leave accrual rule |
A |
||
845 |
Invalid task |
A |
||
846 |
Cannot create non-po purchase items |
The Quick PO functionality must be enabled for your OpenAir account and you must have sufficient permission to add or modify a "quick PO" or "non-po purchase item". |
||
847 |
Purhaseorderid must be blank |
|
||
848 |
Only non_po purchase items can be added/modified |
|
||
849 |
Another record with the same date range already exists |
The period between start and end dates overlap with that of another record, and period overlaps are not allowed. Verify the |
||
850 |
Another record already exists as a default for this user and group |
There is already one default entity tag record associated with the user with internal ID |
||
851 |
Not a valid tag_group_attribute |
The tag group attribute with internal ID |
||
852 |
Duplicate external_id |
Another record with the same |
||
853 |
Invalid Loaded Cost parameters |
When |
||
854 |
All object types |
Too many records requested |
— The number of records requested is larger than the maximum allowed. Limit the data returned using filter parameters. |
|
856 |
Date overlaps with existing record |
The period between start and end dates overlap with that of another record. Verify the |
||
857 |
Date range exceeded maximum |
The period between start and end dates exceeds the maximum length allowed. |
||
858 |
ForexInput error |
Update error. Record could not be saved. |
||
859 |
Invalid customer id |
The customer with internal ID |
||
860 |
default_for_entity and start and end dates are mutually exclusive |
Male sure either |
||
861 |
Invalid customer id |
The |
||
862 |
Invalid project id |
The customer associated with the project with internal ID |
||
863 |
Only one project per invoice |
The invoice this charge is part of (invoice with internal ID |
||
864 |
Error while saving user workschedule |
Error saving the user workschedule. Record could not be saved. |
||
865 |
Invalid workdays |
Workdays must be a comma-separated list of values, containing digits between 0 (Monday) and 6 (Sunday). |
||
866 |
Invalid workdays or workshours |
Both |
||
867 |
Distinct workhours not enabled |
|
||
868 |
Invalid type specified |
The hierarchy must be associated with a record |
||
869 |
Invalid value for primary_user_filter |
|
||
870 |
Invalid value for primary_ |
|
||
871 |
— |
Invalid number of read arguments supplied |
[Read error] — The number of argument objects must be equal to the number of filter clauses. |
|
872 |
Invalid cost type |
The cost type with internal ID |
||
873 |
Invalid period |
A |
||
874 |
Schedule request error |
Error saving the record. Record could not be saved. |
||
875 |
Repeat error |
Error saving the record. Record could not be saved. |
||
876 |
Attachment too small |
Attachment size is too small. Returned when attempting to save an empty backup file for OpenAir Integration Manager. |
||
877 |
— |
Invalid project group |
The project assignment group with internal ID |
|
878 |
— |
Purchaseorder not open |
The purchase order cannot be modified because it is no longer open. |
|
879 |
Invalid purchase order |
The purchase order with internal ID |
||
880 |
Invalid purchase item |
Quick POs or"non-PO" purchase items must have a positive |
||
881 |
Invalid attachment |
The immediate ancestor attachment with internal ID |
||
882 |
Invalid reference slip ID |
The original charge with internal ID |
||
883 |
Invalid portfolio project ID |
The project with internal ID |
||
884 |
Invalid portfolio link |
A portfolio project cannot be subordinated to another portfolio project. |
||
885 |
Invalid purchase item |
The |
||
886 |
Project task type mismatch |
The project task type with internal ID |
||
887 |
Wrong project assignment profile name |
A project assignment profile with the same |
||
888 |
Timesheet task invalid date |
The time entry date is not within the project task assignment date range. Requirement set a the project task level when the Time Entries Match Task Assignments feature is in use. |
||
889 |
Ticket cannot be modified |
The receipt associated with this attachment cannot be edited. |
||
890 |
User cannot be modified |
The user associated with this attachment cannot be edited |
||
891 |
Invalid user |
The associated user does not exist or is marked as deleted. Verify the user internal ID. |
||
892 |
Invalid envelope |
The associated expense report does not exist or is marked as deleted. Verify the expense report internal ID. |
||
893 |
Invalid receipt |
The associated receipt does not exist or is marked as deleted. Verify the receipt internal ID. |
||
894 |
Invalid timesheet |
The associated timesheet does not exist or is marked as deleted. Verify the timesheet internal ID. |
||
895 |
Invalid customerpo |
The associated customer PO does not exist or is marked as deleted. Verify the customer PO internal ID. |
||
896 |
Agreement cannot be modified |
The agreement associated with this attachment cannot be edited. |
||
897 |
Customerpo cannot be modified |
The customer PO associated with this attachment cannot be edited. |
||
898 |
Invalid workspace |
The workspace with internal ID |
||
899 |
Invalid expense policy |
The expense policy with internal ID |
900 – 999
Error Code |
Command |
Object Type |
Short Message |
More Information |
---|---|---|---|---|
900 |
Invalid item |
The expense item with internal ID |
||
901 |
— |
The combination of uid, app, arg, and page is not valid |
[makeURL error] — The values passed don't combine to represent a valid page, check the values and try again |
|
902 |
— |
A valid record could not be created from the arg passed |
[makeURL error] — Check to make sure the required fields are being passed in the arg record |
|
903 |
— |
The user does not have access to that page |
[makeURL error] — That combination of app, arg, and page is not valid for this user |
|
904 |
This number is already taken |
The user-defined number [ |
||
905 |
Invalid purchaseorder |
The purchase order with internal ID |
||
906 |
Invalid Cost Center |
The cost center with internal ID |
||
907 |
Invalid Contact |
First name, Last name and email are required fields. |
||
908 |
Invalid Name |
A name [ |
||
909 |
Invalid Contact |
One of the associated contacts does not exist or is not associated with the customer. Verify all contact internal IDs. |
||
910 |
— |
Lookup record not located |
[Lookup error] — There is no record of the specified type matching one or more lookup field values. |
|
911 |
No Timesheet specified |
The internal ID of the associated timesheet [ |
||
912 |
Invalid type specified |
A valid |
||
913 |
Invalid project task specified for a project |
The project task with internal ID A A |
||
914 |
Invalid resourceprofile_type_id specified |
A valid |
||
915 |
Invalid type specified |
Both |
||
916 |
— |
Table specified does not have external_id field |
[Lookup error] — Either the record type (table) does not exist or the lookup field does not exist for the record type. |
|
917 |
This Issue number is already taken |
The user-defined number [ |
||
918 |
No description specified |
The issue must have a |
||
919 |
Only one default issue stage is permitted |
There is already one issue stage record with |
||
920 |
No rate card ID specified |
A |
||
921 |
Job code in use for rate card |
There is already one rate card item with the same |
||
922 |
Invalid job code specified |
The job code with internal ID |
||
923 |
Invalid rate card specified |
The rate card with internal ID |
||
924 |
No job code ID specified |
A |
||
925 |
Invalid template project ID specified |
The project with internal ID |
||
926 |
Invalid value for user cost |
|
||
927 |
Invalid user cost start date |
|
||
928 |
Invalid project group ID for workspace user |
The project assignment group with internal ID |
||
929 |
Workspace user cannot contain both project group ID and user ID |
Either |
||
930 |
Generic flag cannot be modified |
|
||
931 |
Duplicate project assignment |
The user with internal ID |
||
932 |
Only admin users may update proxies |
The authenticated user must be an account administrator to add, modify or delete proxy information. |
||
933 |
Not a valid proxy user |
The user with internal ID |
||
934 |
Error while creating project from template |
Error creating a project from template. Project could not be added. |
||
935 |
Invalid user tag start date |
|
||
936 |
Error while creating project group assignments |
Error creating project assignment group. The project assignment group could not be added. |
||
937 |
Invalid agreement ID specified |
An |
||
938 |
Duplicate agreement_to_project |
The |
||
939 |
— |
View is not allowed for this user |
[MakeURL error] — The authenticated user does not have sufficient permission (role or filter set) to view this dashboard, invoice, or trimesheet. |
|
940 |
— |
Dashboard view is not allowed for this project |
[MakeURL error] — The dashboard is not enabled for projects in this stage. Verify the project stage configuration and the project stage for the project. |
|
941 |
Invalid timezone specified for user |
The |
||
942 |
Loaded costs not allowed for generic resources |
The user with internal ID |
||
943 |
Project names must be unique by customer |
A project with the same |
||
944 |
Invalid date |
Either the start or end date is not valid. Verify the start and end date. |
||
945 |
Invalid Project budget group ID specified |
A |
||
946 |
Invalid project budget rule ID specified |
A |
||
947 |
Project already has an expense policy |
There is already one expense policy associated with the project with internal ID |
||
948 |
Duplicate itemid for expense policy |
There is already one expense item with the same |
||
949 |
Invalid Resourceprofile_type ID specified |
The resource profile type with internal ID |
||
950 |
Invalid Attribute ID specified |
The attribute with internal ID |
||
951 |
Duplicate Attribute for Resourceprofile_type |
There is already one attribute with the same |
||
952 |
Duplicate entry for user |
|
||
953 |
Missing labor subcategory |
A |
||
954 |
Invalid Project billing rule ID specified |
A |
||
960 |
Invalid Resource attachment type |
The resource attachment |
||
961 |
Duplicate entry for user |
There is already one resource attachment record with the same |
||
962 |
ResourceAttachment cannot by modified |
The authenticated user does not have sufficient permission to add or modify a resource attachment, or the resource attachment cannot be edited. |
||
963 |
Invalid attachment id |
The attachment with internal ID |
||
964 |
Invalid ResourceAttachment id |
The resource attachment with internal ID |
||
965 |
File could not be saved |
The attachment record was created but marked as deleted because the file could not be saved to disk. Try adding the attachment again and if the error persists, contact OpenAir Customer Support. |
1000 – 1199
Error Code |
Command |
Object Type |
Short Message |
More Information |
---|---|---|---|---|
1001 |
|
Invalid state |
Submit, Approve or Reject operation could not be completed. Transaction objects can only be submitted if the approval status is |
|
1002 |
|
Submit/ |
The transaction object could not be submitted, approved, or rejected. Some of the possible reasons for this error include but are not limited to the following:
|
|
1003 |
|
Submit/ |
The transaction object could not be submitted, approved, or rejected because there are warnings associated with this transaction and it is not allowed to submit a transaction with warnings. |
|
1050 |
Invalid hierarchy node specified |
The hierarchy node specified is not valid. If the object is a hierarchy node, verify the following conditions
If the object is a user, verify that all hierarchy nodes with internal IDs specified in |
||
1051 |
You cannot assign multiple nodes within one hierarchy |
The same object cannot be associated with more than one hierarchy node in the same hierarchy. If the object is a user, verify that all hierarchy nodes with internal IDs specified in |
||
1100 |
|
Invalid value specified for a checkbox custom field |
The custom field type is a checkbox and the value specified for a checkbox custom field must be either |
|
1101 |
|
Value specified is not on the list of values for this custom field |
The value specified for this custom field must be one of the values defined in the custom field properties. Value options can be defined for custom fields of the following types: allocation grid, dropdown, dropdown and text, multiple selection, radio group, tag. |
|
1102 |
Custom field could not be saved |
The custom field properties could not be saved. Check returned error description for details. This error is also returned if you specify |
||
1103 |
Modification of the field specified is not supported |
Custom field property other than |
||
1104 |
|
This custom field value is not unique |
The custom field value must be unique and the value specified is already used for another object of this type. Use a different value. Date, text and URL custom fields can be set up so that each record must have a unique value held in the custom field. |
|
1105 |
|
Value specified is not on the list of values in the source pick list defined for this custom field |
The custom field type is a pick list, and the value specified must be an integer and the internal ID of an existing record of the type selected in the custom field List source property, or in the case of a pick list sourced from projects, the value specified must follow the format |
|
1106 |
|
One or more inline custom fields failed to be updated |
One or more custom field values could not be saved. Check returned error description for details. |
1200 – 1999
Error Code |
Command |
Object Type |
Short Message |
More Information |
---|---|---|---|---|
1200 |
|
Condition not met |
The condition was not met and the object was not modified. The API response includes the read and unmodified object. |
|
1300 |
— |
Invalid filter set specified |
One or more of the filter set internal IDs specified is not valid. Verify that all filter sets with internal IDs specified in |
|
1400 |
Missing start_end_month_ts flag |
|
||
1401 |
Invalid associated_tmid |
The timesheet with internal ID |
||
1402 |
Non-overlapping timesheet |
To specify |
||
1403 |
Cannot modify timesheet with associated_tmid |
The following properties cannot be modified for either part of a split timesheet at month end (that is, if |
||
1404 |
Invalid time |
Either |
||
1405 |
Illegal time range |
The |
||
1406 |
No permission to edit time data |
To set |
||
1407 |
Invalid hours |
The duration set using either |
||
1408 |
Invalid newsfeed |
The newsfeed with internal ID |
||
1409 |
Both author or editor not set |
Either |
||
1410 |
Deactivate ns integration user |
The user is a NetSuite integration administrator and cannot deactivated ( |
||
1411 |
Change admin role of ns integration user |
The user is a NetSuite integration administrator and must be an account administrator ( |
||
1412 |
Invalid quantity |
The |
||
1413 |
Invalid payment terms |
The internal ID of the associated payment terms To specify |
||
1414 |
Invalid approval status |
The |
||
1415 |
Phase cannot be assigned |
A project phase cannot have project task assignments. A project task assignment cannot be associated to the project task with internal ID |
||
1416 |
Invalid cap by customer PO |
You can only set or modify the
|
||
1417 |
Invalid project task id |
You can only set or modify the
|
||
1418 |
Invalid preference settings format |
The preference settings format is not valid. |
||
1419 |
No full user licenses available |
User cannot be granted access to modules other than Account, Expenses and Timesheets. |
||
1420 |
No T&E or full user licenses available |
Cannot add T&E user or mark T&E user as active. |
||
1421 |
No guest or full user licenses available |
Cannot add guest user or mark guest user as active. |
2000 – 2999
Error Code |
Command |
Object Type |
Short Message |
More Information |
---|---|---|---|---|
2001 |
— |
— |
Invalid argument passed |
There is a problem with one or more arguments in your API request. Verify the arguments. |
2002 |
— |
— |
Invalid format passed |
There is a problem with the format of your API request. Verify the format of your API request. |