Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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 = 612001

  • Notice with a certain id is not found.
    NoticeNotFound = 612002

  • Unable to get all notices.
    GetNoticesFailed = 612003

  • Adding a new notice failed.
    AddNoticeFailed = 612004

  • Updating a notice failed.
    UpdateNoticeFailed = 612005

  • Delete notice failed.
    DeleteNoticeFailed = 612006

  • Notice 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 = 620001

  • Call to check whether user exists or not has failed
    UserExistsFailed = 620001

  • Associate internal user to organization failed
    AssociateInternalUserToOrganizationFails = 620003

  • Retrieving users has failed
    RetrievingUsersFailed = 62000

  • Retrieving user using id has failed
    RetrievingUserByIdFailed = 620005

  • Retrieving user using PKI has failed
    RetrievingUserByPkiFailed = 620006

  • Retrieving users using email has failed
    RetrievingUsersByEmailFailed = 620007

  • Retrieving user using passed credentials has failed
    RetrievingUserByAuthInfoFailed = 620008

  • Retrieving request for user has failed
    RetrievingRequestsForUserFailed = 620009

  • Adding or updating user information has failed
    AddingOrUpdatingUserFailed = 620010

  • Deleting user has failed
    DeletingUserFailed = 620011

  • Retrieving organizations information for a user has failed
    RetrievingOrganizationsForUserFailed = 620012

  • Retrieving business systems information for a user has failed
    RetrievingBusinessSystemsForUserFailed = 620013

  • Retrieving services for a user has failed
    RetrievingServicesByUserFailed = 620014

  • Adding permission to service has failed
    AddingPermissionToServiceFailed = 620015

  • Deleting service permission has failed
    DeletingServicePermissionFailed = 620016

  • Retrieving notices for a user has failed
    RetrievingNoticesForUserFailed = 620017

  • Retrieving permissions of a user has failed
    RetrievingPermissionsByUserFailed = 620018

  • Retrieving permissions for a user's service has failed
    RetrievingPermissionsByUserAndServiceFailed = 620019

  • Searching users has failed
    UserSearchFailed = 620019

...

  • Unable to get all notice types.
    GetNoticeTypesFailed = 612008

  • The start date should be before the end date.
    NoticeStartDateShouldBeBeforeEndDate = 612009

  • The display date should be before the end date.
    NoticeDisplayDateShouldBeBeforeEndDate = 612010

  • Only one service has to be selected for WarningNotice or InformationNotice.
    NoticeOneServiceShouldSelectedBeForWarningOrInfo = 612011

  • Header and Body are required for WarningNotice or InformationNotice.
    NoticeHeaderBodyRequired = 612012

  • Notice header for WarningNotice or InformationNotice should be less than the maximum character limit (150 characters).
    NoticeHeaderOverMaxCharacterLimit = 612013

  • Notice 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 = 620001

  • Call to check whether user exists or not has failed
    UserExistsFailed = 620001

  • Associate internal user to organization failed
    AssociateInternalUserToOrganizationFails = 620003

  • Retrieving users has failed
    RetrievingUsersFailed = 62000

  • Retrieving user using id has failed
    RetrievingUserByIdFailed = 620005

  • Retrieving user using PKI has failed
    RetrievingUserByPkiFailed = 620006

  • Retrieving users using email has failed
    RetrievingUsersByEmailFailed = 620007

  • Retrieving user using passed credentials has failed
    RetrievingUserByAuthInfoFailed = 620008

  • Retrieving request for user has failed
    RetrievingRequestsForUserFailed = 620009

  • Adding or updating user information has failed
    AddingOrUpdatingUserFailed = 620010

  • Deleting user has failed
    DeletingUserFailed = 620011

  • Retrieving organizations information for a user has failed
    RetrievingOrganizationsForUserFailed = 620012

  • Retrieving business systems information for a user has failed
    RetrievingBusinessSystemsForUserFailed = 620013

  • Retrieving services for a user has failed
    RetrievingServicesByUserFailed = 620014

  • Adding permission to service has failed
    AddingPermissionToServiceFailed = 620015

  • Deleting service permission has failed
    DeletingServicePermissionFailed = 620016

  • Retrieving notices for a user has failed
    RetrievingNoticesForUserFailed = 620017

  • Retrieving permissions of a user has failed
    RetrievingPermissionsByUserFailed = 620018

  • Retrieving permissions for a user's service has failed
    RetrievingPermissionsByUserAndServiceFailed = 620019

  • Searching users has failed
    UserSearchFailed = 620019

  • Retrieving granted applications by user id has failed.
    RetrievingExpiredNoticesForUserFailed = 620020

  • Adding Or Updating User Failed Because Email Already Taken
    AddingOrUpdatingUserFailedBecauseEmailAlreadyTaken = 620021

  • Retrieving granted applications by user id has failed.
    GetApplicationsFailed = 620022

  • Retrieving 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 = 623000

  • Get 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 = 623007

  • Get users by application id failed
    GetUsersByApplicationIdFailed = 620338