Status codes provide extra information when a request is made to the MTAPI. The response code will be provided when a request has been successfully completed.
...
Response Headers
{
"cache-control": "no-cache",
"content-length": "123",
"content-type": "application/json; charset=utf-8",
"date": "Tue, 20 Apr 2021 11:28:03 GMT",
"expires": "-1",
"mtapistatus": "-1",
"pragma": "no-cache",
"server": "Microsoft-IIS/8.5",
"x-aspnet-version": "4.0.30319",
"x-powered-by": "ASP.NET"
}
...
ServiceRequestNotFound = 4041001
4041001 is a generic MTAPI status used in more than one controller. 4041001 is returned when an end-point expects a valid Service Request identifier, however the passed identifier cannot find any Service Request.FileAttachmentNotFound = 4041002
4041002 is a generic MTAPI status used in more than one controller. 4041002 is returned when an end-point expects a valid file attachment identifier, however the passed identifier cannot find any matching file attachment.ServiceRequestNotFound = 4041001, // not found errors starts with 404 followed by 4 digit code 1001, leaving an opportunity use sub status codes below 1000
UserNotFound = 4041003, // not found errors starts with 404 followed by 4 digit code
ServiceNotFound = 4041004, // not found errors starts with 404 followed by 4 digit code
ServiceSettingNotFound = 4041005
ServicePreferenceNotFound = 4041006
ClientServiceNotFound = 4041007
OrganizationNoFound = 4041008
ArtifactNoFound = 4041009
ServiceRequestIdNotFound = 4041010
DocumentNotFound = 4041011
MetadataStructureNotFound = 4041013
StructureColumnKeyNameNotFound = 4041014
Generic/Reusable Statuses - can be used in any controller (901000-902999)
...
At least one service must be provided.
Minimum1ServiceRequired = 612001Notice with a certain id is not found.
NoticeNotFound = 612002Unable to get all notices.
GetNoticesFailed = 612003Adding a new notice failed.
AddNoticeFailed = 612004Updating a notice failed.
UpdateNoticeFailed = 612005Delete notice failed.
DeleteNoticeFailed = 612006Notice object is null.
NoticeIsNull = 612007
Permissions Controller (613000-613999)
RetrievingAllPermissionsFailed = 613001
Retrieving all permissions failed
RetrievingUserByPermissionsFailed = 613002
Get User by permissions failed
Portal Capabilities Controller (614000-614999)
Get portal capabilities failed.
GetPortalCapabilitiesFailed = 614000
Service Preferences Controller (615000-615999)
RetrievingServicePreferenceFailed = 615001
Retrieving service preferences failed
CreateOrUpdateServicePreferenceFailed = 615002
Create or Update service preference failed
DeletingServicePreferenceFailed = 615003
Deleting service preference failed
InvalidServicePreferenceFailed = 615004
Invalid service preference
Service Regulated Entities Controller (616000-616999)
InvalidRegulatedEntityType = 616001
Invalid regulated entity type.RetrievingRegulatedEntityFailed = 616002
Retrieving regulated entity failed.AddRegulatedEntityFailed = 616003
Add regulated entity failed.UpdateRegulatedEntityFailed = 616004
Update regulated entity failed.
Service Requests Controller (617000-617999)
RetrievingServiceRequestFailed = 617001
Retrieving service request has failed.RetrievingServiceRequestsByServicesFailed = 617002
Retrieving service requests by services has failed.RetrievingServiceRequestStatusesFailed = 617003
Retrieving service request statuses has failed.RetrievingServiceRequestStatusHistoryFailed = 617004
Retrieving service request status history has failed.RetrievingServiceArtifactsFailed = 617005
Retrieving service request artifacts has failed.AddServiceRequestFailed = 617006
Add service request has failed.ServiceRequestsQueryFailed = 617007
Service request query has failed.UpdateServiceRequestFailed = 617008
Service Request couldn't be updated.ServiceRequestsByServiceFailed = 617009
Retrieving service requests by service has failed.UpdateServiceRequestStatusFailed = 617010
Service Request status couldn't be updated.DeleteServiceRequestFailed = 617011
Service Request couldn't be deleted.InitiateTransferFailed = 617012
Service Request couldn't be initiated.CompleteTransferFailed = 617013
Service Request couldn't be completed.FileAttachmentByServiceRequestFailed = 617014
Retrieving file attachment by service request has failed.NoRequesterId = 617015
Retrieving file attachment by service request has failed.NoRequesterDetails = 617016
Retrieving file attachment by service request has failed.RetrievingUserAssignmentsFailed = 617017
Retrieving user assignments has failed.RetrievingStatusHistoryExFailed = 617018
Retrieving extended status history has failed.RetrievingStatusHistoryExByGuidFailed = 617019
Retrieving extended status history by guid has failed.UpdateDateCannotBeInFuture = 617020
Update date cannot be in future.ServiceRequestStatusLogNotFound = 617021
Service Request status log not Found.UpdateDateShouldBeAfterPreviousDate = 617022
The update date should be greater than the previous date.UpdateDateShouldBeBeforeNewerDate = 617023
The update date should be less than the newer date.UpdateDateShouldBeAfterPreviousDateAndBeforeNewerDate = 617024
The update date should be greater than the previous date and less than the newer date.UpdateStatusHistoryFailed = 617025
Service Request Status couldn't be updated.UserAssignmentExists = 617026
User Assignment already exist.AddUserAssignmentFailed = 617027
User Assignments couldn't be added.RemoveUserAssignmentFailed = 617028
User Assignments couldn't be removed.InvalidServiceStandard = 617029
ServiceStandardId is not valid for the service.InvalidServiceId = 617030
Changing ServiceId not allowed.DeletedStatus= 617031
Changing ServiceId not allowed.UpdateServiceRequestFail = 617032
Update ServiceRequest failed.RetrievingAuditHistoryFailed = 617033
Retrieving audit history has failed.InvalidServiceRequestId = 6170034
Invalid ServiceRequest Id.InvalidServiceRequestRevisedCreatedDate = 617035
The Specified Revised Created Date is invalid.ServiceRequestIdIsZero = 617036
Service Request Id is zero.AddMultipleUserAssignmentsFailed = 617037
Multiple User Assignments couldn't be added.RemoveMultipleUserAssignmentsFailed = 617038
Multiple User Assignments couldn't be removed.
Services Controller (618000-618999)
InvalidDatetime = 618001
future deactivation dateTime should be greater than the current dateTime
EnrollmentDeactivationFailed = 618002
Enrollment deactivation fails
RetrievingServiceInformationFailed = 618004
Retrieving service information failed
RetrievingActivitiesFailed = 618005
Retrieving activities failed
EnrollUserInServiceFailed = 618006
Enroll User In Service Failed
WithdrawUserFromServiceFailed = 618007
Withdraw User from a service Failed
ActivateUserInServiceFailed = 618008
Activate User in a Service Failed
DeactivateUserFromServiceFailed = 618009
Deactivate User from a Service Failed
InvalidReturnUrl = 618010
Return url Failed
InitiateInviteFailed = 618011
Initiate invite Failed
CompleteInviteWithInvalidArgumentFailed = 618012
Complete invite with invalid argument Failed
InviteWithInternalUserFailed = 618013
Invite with internal user failed
RetrievingUserFailed = 618014
Retrieving user failed
RetrievingNoticesByServiceFailed = 618015
Retrieving notices by service failed
RetrievingServicePermissionFailed = 618016
Retrieving service permissions failed
AddingServicePermissionFailed = 618017
Adding service permission failed
UpdateServicePermissionFailed = 618018
Update service permission failed
DeleteServicePermissionFailed = 618019
Delete service permissions failed
RetrievingServiceRegulatedEntityFailed = 618020
Retrieve the list of service regulated entities failed
RetrievingServiceCatalogFailed = 618021
Retrieving all services failed
Service Settings Controller (619000-619999)
RetrievingServiceSettingFailed = 619001
Retrieving service setting failed
DeletingServiceSettingFailed = 619002
Deleting service setting failed
CreateOrUpdateServiceSettingFailed = 619003
Create or Update service setting failed
Users Controller (620000-620999)
Call to check whether user exists or not has failed
UserExistsFailed = 620001Call to check whether user exists or not has failed
UserExistsFailed = 620001Associate internal user to organization failed
AssociateInternalUserToOrganizationFails = 620003Retrieving users has failed
RetrievingUsersFailed = 62000Retrieving user using id has failed
RetrievingUserByIdFailed = 620005Retrieving user using PKI has failed
RetrievingUserByPkiFailed = 620006Retrieving users using email has failed
RetrievingUsersByEmailFailed = 620007Retrieving user using passed credentials has failed
RetrievingUserByAuthInfoFailed = 620008Retrieving request for user has failed
RetrievingRequestsForUserFailed = 620009Adding or updating user information has failed
AddingOrUpdatingUserFailed = 620010Deleting user has failed
DeletingUserFailed = 620011Retrieving organizations information for a user has failed
RetrievingOrganizationsForUserFailed = 620012Retrieving business systems information for a user has failed
RetrievingBusinessSystemsForUserFailed = 620013Retrieving services for a user has failed
RetrievingServicesByUserFailed = 620014Adding permission to service has failed
AddingPermissionToServiceFailed = 620015Deleting service permission has failed
DeletingServicePermissionFailed = 620016Retrieving notices for a user has failed
RetrievingNoticesForUserFailed = 620017Retrieving permissions of a user has failed
RetrievingPermissionsByUserFailed = 620018Retrieving permissions for a user's service has failed
RetrievingPermissionsByUserAndServiceFailed = 620019Searching users has failed
UserSearchFailed = 620019
...
Unable to get all notice types.
GetNoticeTypesFailed = 612008The start date should be before the end date.
NoticeStartDateShouldBeBeforeEndDate = 612009The display date should be before the end date.
NoticeDisplayDateShouldBeBeforeEndDate = 612010Only one service has to be selected for WarningNotice or InformationNotice.
NoticeOneServiceShouldSelectedBeForWarningOrInfo = 612011Header and Body are required for WarningNotice or InformationNotice.
NoticeHeaderBodyRequired = 612012Notice header for WarningNotice or InformationNotice should be less than the maximum character limit (150 characters).
NoticeHeaderOverMaxCharacterLimit = 612013Notice body for WarningNotice or InformationNotice should be less than the maximum character limit (500 characters).
NoticeBodyOverMaxCharacterLimit = 612014
Header and Body shouldn't be entered for planned or unplanned outage.
NoticeHeaderBodyShouldBeNullForOutageNotice = 612015
Permissions Controller (613000-613999)
RetrievingAllPermissionsFailed = 613001
Retrieving all permissions failed
RetrievingUserByPermissionsFailed = 613002
Get User by permissions failed
Portal Capabilities Controller (614000-614999)
Get portal capabilities failed.
GetPortalCapabilitiesFailed = 614000
Service Preferences Controller (615000-615999)
RetrievingServicePreferenceFailed = 615001
Retrieving service preferences failed
CreateOrUpdateServicePreferenceFailed = 615002
Create or Update service preference failed
DeletingServicePreferenceFailed = 615003
Deleting service preference failed
InvalidServicePreferenceFailed = 615004
Invalid service preference
Service Regulated Entities Controller (616000-616999)
InvalidRegulatedEntityType = 616001
Invalid regulated entity type.RetrievingRegulatedEntityFailed = 616002
Retrieving regulated entity failed.AddRegulatedEntityFailed = 616003
Add regulated entity failed.UpdateRegulatedEntityFailed = 616004
Update regulated entity failed.
Service Requests Controller (617000-617999)
RetrievingServiceRequestFailed = 617001
Retrieving service request has failed.RetrievingServiceRequestsByServicesFailed = 617002
Retrieving service requests by services has failed.RetrievingServiceRequestStatusesFailed = 617003
Retrieving service request statuses has failed.RetrievingServiceRequestStatusHistoryFailed = 617004
Retrieving service request status history has failed.RetrievingServiceArtifactsFailed = 617005
Retrieving service request artifacts has failed.AddServiceRequestFailed = 617006
Add service request has failed.ServiceRequestsQueryFailed = 617007
Service request query has failed.UpdateServiceRequestFailed = 617008
Service Request couldn't be updated.ServiceRequestsByServiceFailed = 617009
Retrieving service requests by service has failed.UpdateServiceRequestStatusFailed = 617010
Service Request status couldn't be updated.DeleteServiceRequestFailed = 617011
Service Request couldn't be deleted.InitiateTransferFailed = 617012
Service Request couldn't be initiated.CompleteTransferFailed = 617013
Service Request couldn't be completed.FileAttachmentByServiceRequestFailed = 617014
Retrieving file attachment by service request has failed.NoRequesterId = 617015
Retrieving file attachment by service request has failed.NoRequesterDetails = 617016
Retrieving file attachment by service request has failed.RetrievingUserAssignmentsFailed = 617017
Retrieving user assignments has failed.RetrievingStatusHistoryExFailed = 617018
Retrieving extended status history has failed.RetrievingStatusHistoryExByGuidFailed = 617019
Retrieving extended status history by guid has failed.UpdateDateCannotBeInFuture = 617020
Update date cannot be in future.ServiceRequestStatusLogNotFound = 617021
Service Request status log not Found.UpdateDateShouldBeAfterPreviousDate = 617022
The update date should be greater than the previous date.UpdateDateShouldBeBeforeNewerDate = 617023
The update date should be less than the newer date.UpdateDateShouldBeAfterPreviousDateAndBeforeNewerDate = 617024
The update date should be greater than the previous date and less than the newer date.UpdateStatusHistoryFailed = 617025
Service Request Status couldn't be updated.UserAssignmentExists = 617026
User Assignment already exist.AddUserAssignmentFailed = 617027
User Assignments couldn't be added.RemoveUserAssignmentFailed = 617028
User Assignments couldn't be removed.InvalidServiceStandard = 617029
ServiceStandardId is not valid for the service.InvalidServiceId = 617030
Changing ServiceId not allowed.DeletedStatus= 617031
Changing ServiceId not allowed.UpdateServiceRequestFail = 617032
Update ServiceRequest failed.RetrievingAuditHistoryFailed = 617033
Retrieving audit history has failed.InvalidServiceRequestId = 6170034
Invalid ServiceRequest Id.InvalidServiceRequestRevisedCreatedDate = 617035
The Specified Revised Created Date is invalid.ServiceRequestIdIsZero = 617036
Service Request Id is zero.AddMultipleUserAssignmentsFailed = 617037
Multiple User Assignments couldn't be added.RemoveMultipleUserAssignmentsFailed = 617038
Multiple User Assignments couldn't be removed.FilterByMetadataFailed = 617039
Filter service request by metadata has failed.
Services Controller (618000-618999)
InvalidDatetime = 618001
future deactivation dateTime should be greater than the current dateTime
EnrollmentDeactivationFailed = 618002
Enrollment deactivation fails
RetrievingServiceInformationFailed = 618004
Retrieving service information failed
RetrievingActivitiesFailed = 618005
Retrieving activities failed
EnrollUserInServiceFailed = 618006
Enroll User In Service Failed
WithdrawUserFromServiceFailed = 618007
Withdraw User from a service Failed
ActivateUserInServiceFailed = 618008
Activate User in a Service Failed
DeactivateUserFromServiceFailed = 618009
Deactivate User from a Service Failed
InvalidReturnUrl = 618010
Return url Failed
InitiateInviteFailed = 618011
Initiate invite Failed
CompleteInviteWithInvalidArgumentFailed = 618012
Complete invite with invalid argument Failed
InviteWithInternalUserFailed = 618013
Invite with internal user failed
RetrievingUserFailed = 618014
Retrieving user failed
RetrievingNoticesByServiceFailed = 618015
Retrieving notices by service failed
RetrievingServicePermissionFailed = 618016
Retrieving service permissions failed
AddingServicePermissionFailed = 618017
Adding service permission failed
UpdateServicePermissionFailed = 618018
Update service permission failed
DeleteServicePermissionFailed = 618019
Delete service permissions failed
RetrievingServiceRegulatedEntityFailed = 618020
Retrieve the list of service regulated entities failed
RetrievingServiceCatalogFailed = 618021
Retrieving all services failed
Service Settings Controller (619000-619999)
RetrievingServiceSettingFailed = 619001
Retrieving service setting failed
DeletingServiceSettingFailed = 619002
Deleting service setting failed
CreateOrUpdateServiceSettingFailed = 619003
Create or Update service setting failed
Users Controller (620000-620999)
Call to check whether user exists or not has failed
UserExistsFailed = 620001Call to check whether user exists or not has failed
UserExistsFailed = 620001Associate internal user to organization failed
AssociateInternalUserToOrganizationFails = 620003Retrieving users has failed
RetrievingUsersFailed = 62000Retrieving user using id has failed
RetrievingUserByIdFailed = 620005Retrieving user using PKI has failed
RetrievingUserByPkiFailed = 620006Retrieving users using email has failed
RetrievingUsersByEmailFailed = 620007Retrieving user using passed credentials has failed
RetrievingUserByAuthInfoFailed = 620008Retrieving request for user has failed
RetrievingRequestsForUserFailed = 620009Adding or updating user information has failed
AddingOrUpdatingUserFailed = 620010Deleting user has failed
DeletingUserFailed = 620011Retrieving organizations information for a user has failed
RetrievingOrganizationsForUserFailed = 620012Retrieving business systems information for a user has failed
RetrievingBusinessSystemsForUserFailed = 620013Retrieving services for a user has failed
RetrievingServicesByUserFailed = 620014Adding permission to service has failed
AddingPermissionToServiceFailed = 620015Deleting service permission has failed
DeletingServicePermissionFailed = 620016Retrieving notices for a user has failed
RetrievingNoticesForUserFailed = 620017Retrieving permissions of a user has failed
RetrievingPermissionsByUserFailed = 620018Retrieving permissions for a user's service has failed
RetrievingPermissionsByUserAndServiceFailed = 620019Searching users has failed
UserSearchFailed = 620019Retrieving granted applications by user id has failed.
RetrievingExpiredNoticesForUserFailed = 620020Adding Or Updating User Failed Because Email Already Taken
AddingOrUpdatingUserFailedBecauseEmailAlreadyTaken = 620021Retrieving granted applications by user id has failed.
GetApplicationsFailed = 620022Retrieving granted applications by user id has failed because of an invalid role id.
GetApplicationsFailedByInvalidRoleId = 620023
Virus Scan Controller (621000-621999)
UserApplicationManagement Controller (623000 - 623999)
Note: This only for MTOA Platform team
Get application information with roles failed.
GetApplicationByAppIdFailed = 623000Get application information with roles and permission failed.
ApplicationNotFound = 623001
Enroll user in application failed.
EnrollUserInApplicationFailed = 623002
Manage account of this application is not enabled.
ManageAccountNotEnabled = 623003
Unable to enroll the user in the application role.
User has already the application role.
UserHasApplicationRole = 623004
The Role is not currently supported for the application role enrollment.
ApplicationRoleNotSupported = 623005
User cannot have more than one role per application (other than role 1 or 2).
CannotNotHaveMoreThanOneAppRole = 623006
CreatedByUser does not have the role to manage the application user account.
MustHaveRoleToManageUser = 623007Get users by application id failed
GetUsersByApplicationIdFailed = 620338