openapi: 3.0.1 info: title: TMF621 Trouble Ticket Management description: "TMF621 Trouble Ticket Management : This service provides endpoint\ \ to fetch the ticket details with ticket id, create ticket, fetch list of tickets\ \ by customer id and update the existing tickets" license: name: MADAPI url: https://developers.mtn.com/ version: 3.0.0 - Last updated date:2026-09-10 07:22:55 servers: - url: https://api.mtn.com/v1 description: Production Server security: - OAuth2: [] tags: - name: TMF621 Trouble Ticket Management paths: /incident/category: get: tags: - TMF621 Trouble Ticket Management summary: This operation retrieves a trouble ticket category and sub category description: "This operation retrieves the category of a trouble ticket. Through\ \ this operation, a ticket category and sub-category can be retrieved." operationId: TroubleTicketAggregator_get_getIncidentCategory_incidentcategory parameters: - name: category in: query required: false schema: type: string - name: categoryStatus in: query required: false schema: type: string - name: categoryType in: query required: false schema: type: string - name: field in: query required: false schema: type: string - name: lob in: query required: false schema: type: string - name: sort in: query required: false schema: type: string - name: subCategory in: query required: false schema: type: string - name: targetSystem in: header required: false schema: type: string - name: ticketType in: query required: false schema: type: string - name: transactionId in: header required: false schema: type: string - name: x-country-code in: header required: false schema: type: string responses: "200": description: HTTP 200 indicating the request succeeded; the response body follows the documented schema for this operation and includes correlation identifiers where applicable for traceability across MTN MADAPI TMF621 Trouble Ticket Management flows. content: application/json: schema: title: TroubleTicketDLCMResponse type: object properties: statusCode: type: string statusMessage: type: string transactionId: type: string pageNumber: type: integer format: int32 noOfRecords: type: integer format: int64 noOfPages: type: number format: double pageSize: type: number format: double data: type: array items: title: TaskData type: object properties: sys_id: type: string number: type: string short_description: type: string category: type: string subcategory: type: string description: type: string state: type: string assignment_group: type: string opened_at: type: string priority: type: string caller_id: type: string assigned_to: type: string change_request: type: string business_service: type: string u_root_cause_category: type: string u_rca: type: string planned_start_date: type: string planned_end_date: type: string work_start: type: string work_end: type: string close_notes: type: string work_notes: type: string change_task_type: type: string created_on: type: string updated_on: type: string closed_at: type: string opened_by: type: string "400": description: "Bad request. Invalid request parameters, missing required\ \ fields, or validation errors." content: application/json: schema: $ref: '#/components/schemas/APIError' example: statusCode: "400" statusMessage: "Bad request. Invalid request parameters, missing required\ \ fields, or validation errors." supportMessage: API_ERROR transactionId: "1234567890" sequenceNo: "20250115120000001" timestamp: 2025-01-15T12:00:00Z "401": description: "Unauthorized. Invalid or missing authorization credentials,\ \ insufficient permissions, or authentication failure." content: application/json: schema: $ref: '#/components/schemas/APIError' example: statusCode: "401" statusMessage: "Unauthorized. Invalid or missing authorization credentials,\ \ insufficient permissions, or authentication failure." supportMessage: API_ERROR transactionId: "1234567890" sequenceNo: "20250115120000001" timestamp: 2025-01-15T12:00:00Z "403": description: Forbidden. Access denied. The request is valid but the server refuses to perform it. content: application/json: schema: $ref: '#/components/schemas/APIError' example: statusCode: "403" statusMessage: Forbidden. Access denied. The request is valid but the server refuses to perform it. supportMessage: API_ERROR transactionId: "1234567890" sequenceNo: "20250115120000001" timestamp: 2025-01-15T12:00:00Z "404": description: Not found. The requested resource was not found or does not exist. content: application/json: schema: $ref: '#/components/schemas/APIError' example: statusCode: "404" statusMessage: Not found. The requested resource was not found or does not exist. supportMessage: API_ERROR transactionId: "1234567890" sequenceNo: "20250115120000001" timestamp: 2025-01-15T12:00:00Z "500": description: "Internal server error. Unexpected system failure, database\ \ connectivity issues, or external service integration problems." content: application/json: schema: $ref: '#/components/schemas/APIError' example: statusCode: "500" statusMessage: "Internal server error. Unexpected system failure,\ \ database connectivity issues, or external service integration\ \ problems." supportMessage: API_ERROR transactionId: "1234567890" sequenceNo: "20250115120000001" timestamp: 2025-01-15T12:00:00Z "502": description: Bad gateway. The server acting as a gateway received an invalid response from an upstream server. content: application/json: schema: $ref: '#/components/schemas/APIError' example: statusCode: "502" statusMessage: Bad gateway. The server acting as a gateway received an invalid response from an upstream server. supportMessage: API_ERROR transactionId: "1234567890" sequenceNo: "20250115120000001" timestamp: 2025-01-15T12:00:00Z "503": description: Service unavailable. The server is temporarily unable to handle the request due to maintenance or overload. content: application/json: schema: $ref: '#/components/schemas/APIError' example: statusCode: "503" statusMessage: Service unavailable. The server is temporarily unable to handle the request due to maintenance or overload. supportMessage: API_ERROR transactionId: "1234567890" sequenceNo: "20250115120000001" timestamp: 2025-01-15T12:00:00Z deprecated: false /incident/{id}: patch: tags: - TMF621 Trouble Ticket Management summary: This operation updates a trouble ticket category description: "This operation updates the category of a trouble ticket. Through\ \ this operation, an existing ticket category can be update as per requirements" operationId: TroubleTicketAggregator_patch_updateIncidentCategory_incidentid parameters: - name: id in: path required: true schema: type: string - name: targetSystem in: header required: false schema: type: string - name: transactionId in: header required: false schema: type: string - name: x-country-code in: header required: false schema: type: string requestBody: content: application/json: schema: title: UpdateIncidentRequest type: object properties: statusChangeReason: type: string field: type: string categoryType: type: string description: type: string assignedTo: type: string requestedFor: type: string required: true responses: "200": description: HTTP 200 indicating the request succeeded; the response body follows the documented schema for this operation and includes correlation identifiers where applicable for traceability across MTN MADAPI TMF621 Trouble Ticket Management flows. content: application/json: schema: type: object "400": description: "Bad request. Invalid request parameters, missing required\ \ fields, or validation errors." content: application/json: schema: $ref: '#/components/schemas/APIError' example: statusCode: "400" statusMessage: "Bad request. Invalid request parameters, missing required\ \ fields, or validation errors." supportMessage: API_ERROR transactionId: "1234567890" sequenceNo: "20250115120000001" timestamp: 2025-01-15T12:00:00Z "401": description: "Unauthorized. Invalid or missing authorization credentials,\ \ insufficient permissions, or authentication failure." content: application/json: schema: $ref: '#/components/schemas/APIError' example: statusCode: "401" statusMessage: "Unauthorized. Invalid or missing authorization credentials,\ \ insufficient permissions, or authentication failure." supportMessage: API_ERROR transactionId: "1234567890" sequenceNo: "20250115120000001" timestamp: 2025-01-15T12:00:00Z "403": description: Forbidden. Access denied. The request is valid but the server refuses to perform it. content: application/json: schema: $ref: '#/components/schemas/APIError' example: statusCode: "403" statusMessage: Forbidden. Access denied. The request is valid but the server refuses to perform it. supportMessage: API_ERROR transactionId: "1234567890" sequenceNo: "20250115120000001" timestamp: 2025-01-15T12:00:00Z "404": description: Not found. The requested resource was not found or does not exist. content: application/json: schema: $ref: '#/components/schemas/APIError' example: statusCode: "404" statusMessage: Not found. The requested resource was not found or does not exist. supportMessage: API_ERROR transactionId: "1234567890" sequenceNo: "20250115120000001" timestamp: 2025-01-15T12:00:00Z "500": description: "Internal server error. Unexpected system failure, database\ \ connectivity issues, or external service integration problems." content: application/json: schema: $ref: '#/components/schemas/APIError' example: statusCode: "500" statusMessage: "Internal server error. Unexpected system failure,\ \ database connectivity issues, or external service integration\ \ problems." supportMessage: API_ERROR transactionId: "1234567890" sequenceNo: "20250115120000001" timestamp: 2025-01-15T12:00:00Z "502": description: Bad gateway. The server acting as a gateway received an invalid response from an upstream server. content: application/json: schema: $ref: '#/components/schemas/APIError' example: statusCode: "502" statusMessage: Bad gateway. The server acting as a gateway received an invalid response from an upstream server. supportMessage: API_ERROR transactionId: "1234567890" sequenceNo: "20250115120000001" timestamp: 2025-01-15T12:00:00Z "503": description: Service unavailable. The server is temporarily unable to handle the request due to maintenance or overload. content: application/json: schema: $ref: '#/components/schemas/APIError' example: statusCode: "503" statusMessage: Service unavailable. The server is temporarily unable to handle the request due to maintenance or overload. supportMessage: API_ERROR transactionId: "1234567890" sequenceNo: "20250115120000001" timestamp: 2025-01-15T12:00:00Z deprecated: false /troubleTicket: get: tags: - TMF621 Trouble Ticket Management summary: This operation retrieves trouble ticket description: Retrieve list of trouble ticket. It return a list that has the data filtered by provided parameters. It provide the pagination's as well to retrieve the data in pages with required sizes. operationId: TroubleTicketAggregator_get_listTickets_troubleTicket parameters: - name: customerId in: query required: false schema: type: string - name: limit in: query required: false schema: type: string - name: offset in: query required: false schema: type: string - name: publicIdentifier in: query required: false schema: type: string - name: sort in: query required: false schema: type: string - name: status in: query required: false schema: type: string - name: transactionId in: header required: false schema: type: string - name: x-country-code in: header required: false schema: type: string responses: "200": description: HTTP 200 indicating the request succeeded; the response body follows the documented schema for this operation and includes correlation identifiers where applicable for traceability across MTN MADAPI TMF621 Trouble Ticket Management flows. content: application/json: schema: type: object "400": description: "Bad request. Invalid request parameters, missing required\ \ fields, or validation errors." content: application/json: schema: $ref: '#/components/schemas/APIError' example: statusCode: "400" statusMessage: "Bad request. Invalid request parameters, missing required\ \ fields, or validation errors." supportMessage: API_ERROR transactionId: "1234567890" sequenceNo: "20250115120000001" timestamp: 2025-01-15T12:00:00Z "401": description: "Unauthorized. Invalid or missing authorization credentials,\ \ insufficient permissions, or authentication failure." content: application/json: schema: $ref: '#/components/schemas/APIError' example: statusCode: "401" statusMessage: "Unauthorized. Invalid or missing authorization credentials,\ \ insufficient permissions, or authentication failure." supportMessage: API_ERROR transactionId: "1234567890" sequenceNo: "20250115120000001" timestamp: 2025-01-15T12:00:00Z "403": description: Forbidden. Access denied. The request is valid but the server refuses to perform it. content: application/json: schema: $ref: '#/components/schemas/APIError' example: statusCode: "403" statusMessage: Forbidden. Access denied. The request is valid but the server refuses to perform it. supportMessage: API_ERROR transactionId: "1234567890" sequenceNo: "20250115120000001" timestamp: 2025-01-15T12:00:00Z "404": description: Not found. The requested resource was not found or does not exist. content: application/json: schema: $ref: '#/components/schemas/APIError' example: statusCode: "404" statusMessage: Not found. The requested resource was not found or does not exist. supportMessage: API_ERROR transactionId: "1234567890" sequenceNo: "20250115120000001" timestamp: 2025-01-15T12:00:00Z "500": description: "Internal server error. Unexpected system failure, database\ \ connectivity issues, or external service integration problems." content: application/json: schema: $ref: '#/components/schemas/APIError' example: statusCode: "500" statusMessage: "Internal server error. Unexpected system failure,\ \ database connectivity issues, or external service integration\ \ problems." supportMessage: API_ERROR transactionId: "1234567890" sequenceNo: "20250115120000001" timestamp: 2025-01-15T12:00:00Z "502": description: Bad gateway. The server acting as a gateway received an invalid response from an upstream server. content: application/json: schema: $ref: '#/components/schemas/APIError' example: statusCode: "502" statusMessage: Bad gateway. The server acting as a gateway received an invalid response from an upstream server. supportMessage: API_ERROR transactionId: "1234567890" sequenceNo: "20250115120000001" timestamp: 2025-01-15T12:00:00Z "503": description: Service unavailable. The server is temporarily unable to handle the request due to maintenance or overload. content: application/json: schema: $ref: '#/components/schemas/APIError' example: statusCode: "503" statusMessage: Service unavailable. The server is temporarily unable to handle the request due to maintenance or overload. supportMessage: API_ERROR transactionId: "1234567890" sequenceNo: "20250115120000001" timestamp: 2025-01-15T12:00:00Z deprecated: false post: tags: - TMF621 Trouble Ticket Management summary: This operation Creates a trouble ticket description: "This operation Creates a trouble ticket with provided details.\ \ It accepts the category, description. externalId, name, priority and other\ \ fields as well. After creation this returns the details of ticket as well." operationId: TroubleTicketAggregator_post_createTicket_troubleTicket parameters: - name: targetSystem in: header required: false schema: type: string - name: transactionId in: header required: false schema: type: string - name: x-country-code in: header required: false schema: type: string requestBody: content: application/json: schema: title: CreateRequest type: object properties: category: type: string description: type: string externalId: type: string name: type: string nodeId: type: string countryInformation: title: CountryInformation type: object properties: country: type: string province: type: string city: type: string priority: type: string severity: type: string ticketType: type: string channel: title: Channel type: object properties: name: type: string id: type: string role: type: string '@schemaLocation': type: string '@referredType': type: string '@type': type: string href: type: string publicIdentifier: type: string attachment: type: array items: title: Attachments type: object properties: id: type: string validFor: title: ValidFor type: object properties: endDateTime: type: string startDateTime: type: string attachmentType: type: string content: type: string name: type: string relatedEntity: type: array items: title: RelatedEntity type: object properties: id: type: string href: type: string name: type: string '@schemaLocation': type: string '@referredType': type: string required: true responses: "200": description: HTTP 200 indicating the request succeeded; the response body follows the documented schema for this operation and includes correlation identifiers where applicable for traceability across MTN MADAPI TMF621 Trouble Ticket Management flows. content: application/json: schema: title: TroubleTicketResponse type: object properties: id: type: string name: type: string statusCode: type: string statusMessage: type: string description: type: string priority: type: string status: type: string note: type: array items: title: Note type: object properties: author: type: string date: type: string text: type: string '@type': type: string id: type: string statusChange: type: array items: title: StatusChange type: object properties: status: type: string changeDate: type: string changeReason: type: string '@type': type: string troubleTicketRelationship: title: TroubleTicketRelationship type: object properties: name: type: string href: type: string ticketType: type: string externalId: type: string resolutionDate: type: string relatedParty: type: array items: title: RelatedParty type: object properties: role: type: string id: type: string '@referredType': type: string '@schemaLocation': type: string href: type: string name: type: string text: type: string contactMedium: type: array items: title: ContactMedium type: object properties: medium: title: Medium type: object properties: type: type: string emailAddress: type: string verified: type: boolean number: type: string type: type: string role: type: string id: type: string name: type: string preferred: type: boolean engagedParty: title: EngagedParty type: object properties: id: type: string '@referredType': type: string '@schemaLocation': type: string href: type: string location: type: string relatedEntity: type: array items: $ref: '#/components/schemas/com_mtn_aggregator_models_response_listtickets_RelatedEntity' channel: $ref: '#/components/schemas/com_mtn_aggregator_models_request_Channel' creationDate: type: string lastUpdate: type: string number: type: string resolved_date: type: string attachment: type: array items: $ref: '#/components/schemas/com_mtn_aggregator_models_request_Attachments' resolution_comments: type: string '@baseType': type: string '@type': type: string '@schemaLocation': type: string statusChangeReason: type: string productId: type: array items: type: string publicIdentifier: type: array items: type: string externalSystem: type: array items: title: ExternalSystem type: object properties: id: type: string channels: type: array items: $ref: '#/components/schemas/com_mtn_aggregator_models_request_Channel' ticketActivity: type: array items: title: TicketActivity type: object properties: author: type: string date: type: string text: type: string '@type': type: string action: type: string note: type: string from: type: string to: type: string assignedUser: type: string status: type: string previousComment: type: string customFields: title: CustomFields type: object properties: country: type: string province: type: string city: type: string Name: type: string color: type: string assignees: type: array items: title: Assignees type: object properties: id: type: string href: type: string '@schemaLocation': type: string assignee: title: Assignee type: object properties: id: type: string assigned: type: boolean isRepeatedTicket: type: boolean customerId: type: array items: type: string rootCause: type: string isChild: type: boolean isSlaBreached: type: boolean workFlowRef: type: array items: title: WorkFlowRef type: object properties: formId: type: string processId: type: string groupId: type: string taskInfoId: type: string formIdentity: type: string balkanGraphId: type: string workflowId: type: string groups: type: array items: title: Groups type: object properties: id: type: string date: type: string href: type: string '@schemaLocation': type: string parentId: type: string subStatus: type: string accountId: type: array items: type: string postToRemedy: type: string expectedResolutionDate: type: string category: type: string loB: type: string dclmTroubleTicketAPIResponseList: type: array items: title: DCLMTroubleTicketAPIResponse type: object properties: id: type: string description: type: string priority: type: string status: type: string productId: type: array items: type: string publicIdentifier: type: array items: type: string statusChange: type: array items: $ref: '#/components/schemas/com_mtn_aggregator_models_response_listtickets_StatusChange' countryInformation: $ref: '#/components/schemas/com_mtn_aggregator_models_request_CountryInformation' troubleTicketRelationship: $ref: '#/components/schemas/com_mtn_aggregator_models_response_TroubleTicketRelationship' ticketRelationship: type: array items: title: TicketRelationship type: object properties: id: type: string '@baseType': type: string '@schemaLocation': type: string '@type': type: string href: type: string name: type: string relationshipType: type: string href: type: string ticketType: type: string externalId: type: string externalSystem: type: array items: $ref: '#/components/schemas/com_mtn_aggregator_models_response_dclm_ExternalSystem' relatedParty: type: array items: $ref: '#/components/schemas/com_mtn_aggregator_models_response_listtickets_RelatedParty' relatedEntity: type: array items: $ref: '#/components/schemas/com_mtn_aggregator_models_response_listtickets_RelatedEntity' attachment: type: string channel: $ref: '#/components/schemas/com_mtn_aggregator_models_request_Channel' channels: type: array items: $ref: '#/components/schemas/com_mtn_aggregator_models_request_Channel' ticketActivity: type: array items: $ref: '#/components/schemas/com_mtn_aggregator_models_response_dclm_TicketActivity' creationDate: type: string lastUpdate: type: string note: type: array items: title: Note type: object properties: id: type: string text: type: string '@baseType': type: string '@type': type: string '@schemaLocation': type: string statusChangeReason: type: string customFields: $ref: '#/components/schemas/com_mtn_aggregator_models_response_dclm_CustomFields' assignees: type: array items: $ref: '#/components/schemas/com_mtn_aggregator_models_response_dclm_Assignees' assignee: $ref: '#/components/schemas/com_mtn_aggregator_models_response_dclm_Assignee' isRepeatedTicket: type: boolean customerId: type: array items: type: string rootCause: type: string isChild: type: boolean isSlaBreached: type: boolean workFlowRef: type: array items: $ref: '#/components/schemas/com_mtn_aggregator_models_response_dclm_WorkFlowRef' groups: type: array items: $ref: '#/components/schemas/com_mtn_aggregator_models_response_dclm_Groups' parentId: type: string subStatus: type: string accountId: type: array items: type: string postToRemedy: type: string expectedResolutionDate: type: string category: type: string loB: type: string "400": description: "Bad request. Invalid request parameters, missing required\ \ fields, or validation errors." content: application/json: schema: $ref: '#/components/schemas/APIError' example: statusCode: "400" statusMessage: "Bad request. Invalid request parameters, missing required\ \ fields, or validation errors." supportMessage: API_ERROR transactionId: "1234567890" sequenceNo: "20250115120000001" timestamp: 2025-01-15T12:00:00Z "401": description: "Unauthorized. Invalid or missing authorization credentials,\ \ insufficient permissions, or authentication failure." content: application/json: schema: $ref: '#/components/schemas/APIError' example: statusCode: "401" statusMessage: "Unauthorized. Invalid or missing authorization credentials,\ \ insufficient permissions, or authentication failure." supportMessage: API_ERROR transactionId: "1234567890" sequenceNo: "20250115120000001" timestamp: 2025-01-15T12:00:00Z "403": description: Forbidden. Access denied. The request is valid but the server refuses to perform it. content: application/json: schema: $ref: '#/components/schemas/APIError' example: statusCode: "403" statusMessage: Forbidden. Access denied. The request is valid but the server refuses to perform it. supportMessage: API_ERROR transactionId: "1234567890" sequenceNo: "20250115120000001" timestamp: 2025-01-15T12:00:00Z "404": description: Not found. The requested resource was not found or does not exist. content: application/json: schema: $ref: '#/components/schemas/APIError' example: statusCode: "404" statusMessage: Not found. The requested resource was not found or does not exist. supportMessage: API_ERROR transactionId: "1234567890" sequenceNo: "20250115120000001" timestamp: 2025-01-15T12:00:00Z "500": description: "Internal server error. Unexpected system failure, database\ \ connectivity issues, or external service integration problems." content: application/json: schema: $ref: '#/components/schemas/APIError' example: statusCode: "500" statusMessage: "Internal server error. Unexpected system failure,\ \ database connectivity issues, or external service integration\ \ problems." supportMessage: API_ERROR transactionId: "1234567890" sequenceNo: "20250115120000001" timestamp: 2025-01-15T12:00:00Z "502": description: Bad gateway. The server acting as a gateway received an invalid response from an upstream server. content: application/json: schema: $ref: '#/components/schemas/APIError' example: statusCode: "502" statusMessage: Bad gateway. The server acting as a gateway received an invalid response from an upstream server. supportMessage: API_ERROR transactionId: "1234567890" sequenceNo: "20250115120000001" timestamp: 2025-01-15T12:00:00Z "503": description: Service unavailable. The server is temporarily unable to handle the request due to maintenance or overload. content: application/json: schema: $ref: '#/components/schemas/APIError' example: statusCode: "503" statusMessage: Service unavailable. The server is temporarily unable to handle the request due to maintenance or overload. supportMessage: API_ERROR transactionId: "1234567890" sequenceNo: "20250115120000001" timestamp: 2025-01-15T12:00:00Z deprecated: false /troubleTicket/category: get: tags: - TMF621 Trouble Ticket Management summary: This operation retrieves a trouble ticket category and sub category description: "This operation retrieves the category of a trouble ticket. Through\ \ this operation, a ticket category and sub-category can be retrieved." operationId: TroubleTicketAggregator_get_getTroubleTicketCategory_troubleTicketcategor parameters: - name: category in: query required: false schema: type: string - name: categoryStatus in: query required: false schema: type: string - name: categoryType in: query required: false schema: type: string - name: field in: query required: false schema: type: string - name: lob in: query required: false schema: type: string - name: sort in: query required: false schema: type: string - name: subCategory in: query required: false schema: type: string - name: targetSystem in: header required: false schema: type: string - name: ticketType in: query required: false schema: type: string - name: transactionId in: header required: false schema: type: string - name: x-country-code in: header required: false schema: type: string responses: "200": description: HTTP 200 indicating the request succeeded; the response body follows the documented schema for this operation and includes correlation identifiers where applicable for traceability across MTN MADAPI TMF621 Trouble Ticket Management flows. content: application/json: schema: $ref: '#/components/schemas/com_mtn_aggregator_models_response_TroubleTicketDLCMResponse' "400": description: "Bad request. Invalid request parameters, missing required\ \ fields, or validation errors." content: application/json: schema: $ref: '#/components/schemas/APIError' example: statusCode: "400" statusMessage: "Bad request. Invalid request parameters, missing required\ \ fields, or validation errors." supportMessage: API_ERROR transactionId: "1234567890" sequenceNo: "20250115120000001" timestamp: 2025-01-15T12:00:00Z "401": description: "Unauthorized. Invalid or missing authorization credentials,\ \ insufficient permissions, or authentication failure." content: application/json: schema: $ref: '#/components/schemas/APIError' example: statusCode: "401" statusMessage: "Unauthorized. Invalid or missing authorization credentials,\ \ insufficient permissions, or authentication failure." supportMessage: API_ERROR transactionId: "1234567890" sequenceNo: "20250115120000001" timestamp: 2025-01-15T12:00:00Z "403": description: Forbidden. Access denied. The request is valid but the server refuses to perform it. content: application/json: schema: $ref: '#/components/schemas/APIError' example: statusCode: "403" statusMessage: Forbidden. Access denied. The request is valid but the server refuses to perform it. supportMessage: API_ERROR transactionId: "1234567890" sequenceNo: "20250115120000001" timestamp: 2025-01-15T12:00:00Z "404": description: Not found. The requested resource was not found or does not exist. content: application/json: schema: $ref: '#/components/schemas/APIError' example: statusCode: "404" statusMessage: Not found. The requested resource was not found or does not exist. supportMessage: API_ERROR transactionId: "1234567890" sequenceNo: "20250115120000001" timestamp: 2025-01-15T12:00:00Z "500": description: "Internal server error. Unexpected system failure, database\ \ connectivity issues, or external service integration problems." content: application/json: schema: $ref: '#/components/schemas/APIError' example: statusCode: "500" statusMessage: "Internal server error. Unexpected system failure,\ \ database connectivity issues, or external service integration\ \ problems." supportMessage: API_ERROR transactionId: "1234567890" sequenceNo: "20250115120000001" timestamp: 2025-01-15T12:00:00Z "502": description: Bad gateway. The server acting as a gateway received an invalid response from an upstream server. content: application/json: schema: $ref: '#/components/schemas/APIError' example: statusCode: "502" statusMessage: Bad gateway. The server acting as a gateway received an invalid response from an upstream server. supportMessage: API_ERROR transactionId: "1234567890" sequenceNo: "20250115120000001" timestamp: 2025-01-15T12:00:00Z "503": description: Service unavailable. The server is temporarily unable to handle the request due to maintenance or overload. content: application/json: schema: $ref: '#/components/schemas/APIError' example: statusCode: "503" statusMessage: Service unavailable. The server is temporarily unable to handle the request due to maintenance or overload. supportMessage: API_ERROR transactionId: "1234567890" sequenceNo: "20250115120000001" timestamp: 2025-01-15T12:00:00Z deprecated: false /troubleTicket/{id}: get: tags: - TMF621 Trouble Ticket Management summary: This operation retrieves a trouble ticket description: Ticket details fetched by ticket ID. The provides the details of existing ticket with required checks. If not present then it will throw the required errors operationId: TroubleTicketAggregator_get_viewTicket_troubleTicketid parameters: - name: fields in: query required: false schema: type: string - name: id in: path required: true schema: type: string - name: sort in: query required: false schema: type: string - name: status in: query required: false schema: type: string - name: targetSystem in: header required: false schema: type: string - name: transactionId in: header required: false schema: type: string - name: x-country-code in: header required: false schema: type: string responses: "200": description: HTTP 200 indicating the request succeeded; the response body follows the documented schema for this operation and includes correlation identifiers where applicable for traceability across MTN MADAPI TMF621 Trouble Ticket Management flows. content: application/json: schema: $ref: '#/components/schemas/com_mtn_aggregator_models_response_TroubleTicketResponse' "400": description: "Bad request. Invalid request parameters, missing required\ \ fields, or validation errors." content: application/json: schema: $ref: '#/components/schemas/APIError' example: statusCode: "400" statusMessage: "Bad request. Invalid request parameters, missing required\ \ fields, or validation errors." supportMessage: API_ERROR transactionId: "1234567890" sequenceNo: "20250115120000001" timestamp: 2025-01-15T12:00:00Z "401": description: "Unauthorized. Invalid or missing authorization credentials,\ \ insufficient permissions, or authentication failure." content: application/json: schema: $ref: '#/components/schemas/APIError' example: statusCode: "401" statusMessage: "Unauthorized. Invalid or missing authorization credentials,\ \ insufficient permissions, or authentication failure." supportMessage: API_ERROR transactionId: "1234567890" sequenceNo: "20250115120000001" timestamp: 2025-01-15T12:00:00Z "403": description: Forbidden. Access denied. The request is valid but the server refuses to perform it. content: application/json: schema: $ref: '#/components/schemas/APIError' example: statusCode: "403" statusMessage: Forbidden. Access denied. The request is valid but the server refuses to perform it. supportMessage: API_ERROR transactionId: "1234567890" sequenceNo: "20250115120000001" timestamp: 2025-01-15T12:00:00Z "404": description: Not found. The requested resource was not found or does not exist. content: application/json: schema: $ref: '#/components/schemas/APIError' example: statusCode: "404" statusMessage: Not found. The requested resource was not found or does not exist. supportMessage: API_ERROR transactionId: "1234567890" sequenceNo: "20250115120000001" timestamp: 2025-01-15T12:00:00Z "500": description: "Internal server error. Unexpected system failure, database\ \ connectivity issues, or external service integration problems." content: application/json: schema: $ref: '#/components/schemas/APIError' example: statusCode: "500" statusMessage: "Internal server error. Unexpected system failure,\ \ database connectivity issues, or external service integration\ \ problems." supportMessage: API_ERROR transactionId: "1234567890" sequenceNo: "20250115120000001" timestamp: 2025-01-15T12:00:00Z "502": description: Bad gateway. The server acting as a gateway received an invalid response from an upstream server. content: application/json: schema: $ref: '#/components/schemas/APIError' example: statusCode: "502" statusMessage: Bad gateway. The server acting as a gateway received an invalid response from an upstream server. supportMessage: API_ERROR transactionId: "1234567890" sequenceNo: "20250115120000001" timestamp: 2025-01-15T12:00:00Z "503": description: Service unavailable. The server is temporarily unable to handle the request due to maintenance or overload. content: application/json: schema: $ref: '#/components/schemas/APIError' example: statusCode: "503" statusMessage: Service unavailable. The server is temporarily unable to handle the request due to maintenance or overload. supportMessage: API_ERROR transactionId: "1234567890" sequenceNo: "20250115120000001" timestamp: 2025-01-15T12:00:00Z deprecated: false patch: tags: - TMF621 Trouble Ticket Management summary: This operation updates a trouble ticket description: "This operation updates the status of a Ticket entity. Through\ \ this operation, an existing ticket can be update as per requirements. User\ \ with correct set of permission can update the ticket." operationId: TroubleTicketAggregator_patch_updateTicket_troubleTicketid parameters: - name: id in: path required: true schema: type: string - name: targetSystem in: header required: false schema: type: string - name: transactionId in: header required: false schema: type: string - name: x-country-code in: header required: false schema: type: string requestBody: content: application/json: schema: title: UpdateTicketRequest type: object properties: status: type: string note: $ref: '#/components/schemas/com_mtn_aggregator_models_response_listtickets_Note' description: type: string name: type: string priority: type: string channel: $ref: '#/components/schemas/com_mtn_aggregator_models_request_Channel' attachment: type: array items: $ref: '#/components/schemas/com_mtn_aggregator_models_request_Attachments' relatedParty: $ref: '#/components/schemas/com_mtn_aggregator_models_response_listtickets_RelatedParty' statusChangeReason: type: string required: true responses: "200": description: HTTP 200 indicating the request succeeded; the response body follows the documented schema for this operation and includes correlation identifiers where applicable for traceability across MTN MADAPI TMF621 Trouble Ticket Management flows. content: application/json: schema: title: TroubleTicketUpdateResponse type: object properties: statusCode: type: string statusMessage: type: string supportMessage: type: string transactionId: type: string timeStamped: type: string error: title: APIError type: object properties: code: type: string reason: type: string message: type: string status: type: string referenceError: type: string '@baseType': type: string '@schemaLocation': type: string '@type': type: string data: title: ServiceNowUpdateIncidentResponse type: object properties: statusMessage: type: string statusCode: type: string parent: title: LinkValue type: object properties: link: type: string value: type: string watch_list: type: string upon_reject: type: string sys_updated_on: type: string approval_history: type: string skills: type: string number: type: string u_amount_paid: type: string u_justification: type: string state: type: string sys_created_by: type: string knowledge: type: string order: type: string u_escalated_from_p2: type: string u_subcategory: type: string cmdb_ci: type: string delivery_plan: type: string contract: type: string impact: type: string active: type: string priority: type: string sys_domain_path: type: string short_description: type: string sys_class_name: type: string closed_by: $ref: '#/components/schemas/com_mtn_aggregator_models_response_LinkValue' assigned_to: $ref: '#/components/schemas/com_mtn_aggregator_models_response_LinkValue' upon_approval: type: string change_task_type: type: string planned_end_date: type: string made_sla: type: string u_resolution_time: type: string task_effective_number: type: string sys_updated_by: type: string opened_by: $ref: '#/components/schemas/com_mtn_aggregator_models_response_LinkValue' sys_created_on: type: string sys_domain: $ref: '#/components/schemas/com_mtn_aggregator_models_response_LinkValue' closed_at: type: string expected_start: type: string opened_at: type: string work_end: type: string planned_start_date: type: string assignment_group: $ref: '#/components/schemas/com_mtn_aggregator_models_response_LinkValue' x_snc_datasilos_last_maintenance: type: string description: type: string sys_id: type: string contact_type: type: string urgency: type: string u_total_tax_paid: type: string approval: type: string due_date: type: string sys_mod_count: type: string on_hold: type: string change_request: $ref: '#/components/schemas/com_mtn_aggregator_models_response_LinkValue' created_from: type: string error: $ref: '#/components/schemas/com_mtn_aggregator_models_error_APIError' "400": description: "Bad request. Invalid request parameters, missing required\ \ fields, or validation errors." content: application/json: schema: $ref: '#/components/schemas/APIError' example: statusCode: "400" statusMessage: "Bad request. Invalid request parameters, missing required\ \ fields, or validation errors." supportMessage: API_ERROR transactionId: "1234567890" sequenceNo: "20250115120000001" timestamp: 2025-01-15T12:00:00Z "401": description: "Unauthorized. Invalid or missing authorization credentials,\ \ insufficient permissions, or authentication failure." content: application/json: schema: $ref: '#/components/schemas/APIError' example: statusCode: "401" statusMessage: "Unauthorized. Invalid or missing authorization credentials,\ \ insufficient permissions, or authentication failure." supportMessage: API_ERROR transactionId: "1234567890" sequenceNo: "20250115120000001" timestamp: 2025-01-15T12:00:00Z "403": description: Forbidden. Access denied. The request is valid but the server refuses to perform it. content: application/json: schema: $ref: '#/components/schemas/APIError' example: statusCode: "403" statusMessage: Forbidden. Access denied. The request is valid but the server refuses to perform it. supportMessage: API_ERROR transactionId: "1234567890" sequenceNo: "20250115120000001" timestamp: 2025-01-15T12:00:00Z "404": description: Not found. The requested resource was not found or does not exist. content: application/json: schema: $ref: '#/components/schemas/APIError' example: statusCode: "404" statusMessage: Not found. The requested resource was not found or does not exist. supportMessage: API_ERROR transactionId: "1234567890" sequenceNo: "20250115120000001" timestamp: 2025-01-15T12:00:00Z "500": description: "Internal server error. Unexpected system failure, database\ \ connectivity issues, or external service integration problems." content: application/json: schema: $ref: '#/components/schemas/APIError' example: statusCode: "500" statusMessage: "Internal server error. Unexpected system failure,\ \ database connectivity issues, or external service integration\ \ problems." supportMessage: API_ERROR transactionId: "1234567890" sequenceNo: "20250115120000001" timestamp: 2025-01-15T12:00:00Z "502": description: Bad gateway. The server acting as a gateway received an invalid response from an upstream server. content: application/json: schema: $ref: '#/components/schemas/APIError' example: statusCode: "502" statusMessage: Bad gateway. The server acting as a gateway received an invalid response from an upstream server. supportMessage: API_ERROR transactionId: "1234567890" sequenceNo: "20250115120000001" timestamp: 2025-01-15T12:00:00Z "503": description: Service unavailable. The server is temporarily unable to handle the request due to maintenance or overload. content: application/json: schema: $ref: '#/components/schemas/APIError' example: statusCode: "503" statusMessage: Service unavailable. The server is temporarily unable to handle the request due to maintenance or overload. supportMessage: API_ERROR transactionId: "1234567890" sequenceNo: "20250115120000001" timestamp: 2025-01-15T12:00:00Z deprecated: false components: schemas: com_mtn_aggregator_models_request_CreateRequest: title: CreateRequest type: object properties: category: type: string description: type: string externalId: type: string name: type: string nodeId: type: string countryInformation: title: CountryInformation type: object properties: country: type: string province: type: string city: type: string priority: type: string severity: type: string ticketType: type: string channel: title: Channel type: object properties: name: type: string id: type: string role: type: string '@schemaLocation': type: string '@referredType': type: string '@type': type: string href: type: string publicIdentifier: type: string attachment: type: array items: title: Attachments type: object properties: id: type: string validFor: title: ValidFor type: object properties: endDateTime: type: string startDateTime: type: string attachmentType: type: string content: type: string name: type: string relatedEntity: type: array items: title: RelatedEntity type: object properties: id: type: string href: type: string name: type: string '@schemaLocation': type: string '@referredType': type: string com_mtn_aggregator_models_request_UpdateTicketRequest: title: UpdateTicketRequest type: object properties: status: type: string note: $ref: '#/components/schemas/com_mtn_aggregator_models_response_listtickets_Note' description: type: string name: type: string priority: type: string channel: $ref: '#/components/schemas/com_mtn_aggregator_models_request_Channel' attachment: type: array items: $ref: '#/components/schemas/com_mtn_aggregator_models_request_Attachments' relatedParty: $ref: '#/components/schemas/com_mtn_aggregator_models_response_listtickets_RelatedParty' statusChangeReason: type: string com_mtn_aggregator_models_response_listtickets_StatusChange: title: StatusChange type: object properties: status: type: string changeDate: type: string changeReason: type: string '@type': type: string com_mtn_aggregator_models_response_Note: title: Note type: object properties: id: type: string text: type: string com_mtn_aggregator_models_request_CountryInformation: title: CountryInformation type: object properties: country: type: string province: type: string city: type: string com_mtn_aggregator_models_response_TroubleTicketUpdateResponse: title: TroubleTicketUpdateResponse type: object properties: statusCode: type: string statusMessage: type: string supportMessage: type: string transactionId: type: string timeStamped: type: string error: title: APIError type: object properties: code: type: string reason: type: string message: type: string status: type: string referenceError: type: string '@baseType': type: string '@schemaLocation': type: string '@type': type: string data: title: ServiceNowUpdateIncidentResponse type: object properties: statusMessage: type: string statusCode: type: string parent: title: LinkValue type: object properties: link: type: string value: type: string watch_list: type: string upon_reject: type: string sys_updated_on: type: string approval_history: type: string skills: type: string number: type: string u_amount_paid: type: string u_justification: type: string state: type: string sys_created_by: type: string knowledge: type: string order: type: string u_escalated_from_p2: type: string u_subcategory: type: string cmdb_ci: type: string delivery_plan: type: string contract: type: string impact: type: string active: type: string priority: type: string sys_domain_path: type: string short_description: type: string sys_class_name: type: string closed_by: $ref: '#/components/schemas/com_mtn_aggregator_models_response_LinkValue' assigned_to: $ref: '#/components/schemas/com_mtn_aggregator_models_response_LinkValue' upon_approval: type: string change_task_type: type: string planned_end_date: type: string made_sla: type: string u_resolution_time: type: string task_effective_number: type: string sys_updated_by: type: string opened_by: $ref: '#/components/schemas/com_mtn_aggregator_models_response_LinkValue' sys_created_on: type: string sys_domain: $ref: '#/components/schemas/com_mtn_aggregator_models_response_LinkValue' closed_at: type: string expected_start: type: string opened_at: type: string work_end: type: string planned_start_date: type: string assignment_group: $ref: '#/components/schemas/com_mtn_aggregator_models_response_LinkValue' x_snc_datasilos_last_maintenance: type: string description: type: string sys_id: type: string contact_type: type: string urgency: type: string u_total_tax_paid: type: string approval: type: string due_date: type: string sys_mod_count: type: string on_hold: type: string change_request: $ref: '#/components/schemas/com_mtn_aggregator_models_response_LinkValue' created_from: type: string error: $ref: '#/components/schemas/com_mtn_aggregator_models_error_APIError' com_mtn_aggregator_models_response_DCLMTroubleTicketAPIResponse: title: DCLMTroubleTicketAPIResponse type: object properties: id: type: string description: type: string priority: type: string status: type: string productId: type: array items: type: string publicIdentifier: type: array items: type: string statusChange: type: array items: $ref: '#/components/schemas/com_mtn_aggregator_models_response_listtickets_StatusChange' countryInformation: $ref: '#/components/schemas/com_mtn_aggregator_models_request_CountryInformation' troubleTicketRelationship: $ref: '#/components/schemas/com_mtn_aggregator_models_response_TroubleTicketRelationship' ticketRelationship: type: array items: title: TicketRelationship type: object properties: id: type: string '@baseType': type: string '@schemaLocation': type: string '@type': type: string href: type: string name: type: string relationshipType: type: string href: type: string ticketType: type: string externalId: type: string externalSystem: type: array items: $ref: '#/components/schemas/com_mtn_aggregator_models_response_dclm_ExternalSystem' relatedParty: type: array items: $ref: '#/components/schemas/com_mtn_aggregator_models_response_listtickets_RelatedParty' relatedEntity: type: array items: $ref: '#/components/schemas/com_mtn_aggregator_models_response_listtickets_RelatedEntity' attachment: type: string channel: $ref: '#/components/schemas/com_mtn_aggregator_models_request_Channel' channels: type: array items: $ref: '#/components/schemas/com_mtn_aggregator_models_request_Channel' ticketActivity: type: array items: $ref: '#/components/schemas/com_mtn_aggregator_models_response_dclm_TicketActivity' creationDate: type: string lastUpdate: type: string note: type: array items: title: Note type: object properties: id: type: string text: type: string '@baseType': type: string '@type': type: string '@schemaLocation': type: string statusChangeReason: type: string customFields: $ref: '#/components/schemas/com_mtn_aggregator_models_response_dclm_CustomFields' assignees: type: array items: $ref: '#/components/schemas/com_mtn_aggregator_models_response_dclm_Assignees' assignee: $ref: '#/components/schemas/com_mtn_aggregator_models_response_dclm_Assignee' isRepeatedTicket: type: boolean customerId: type: array items: type: string rootCause: type: string isChild: type: boolean isSlaBreached: type: boolean workFlowRef: type: array items: $ref: '#/components/schemas/com_mtn_aggregator_models_response_dclm_WorkFlowRef' groups: type: array items: $ref: '#/components/schemas/com_mtn_aggregator_models_response_dclm_Groups' parentId: type: string subStatus: type: string accountId: type: array items: type: string postToRemedy: type: string expectedResolutionDate: type: string category: type: string loB: type: string com_mtn_aggregator_models_response_TaskData: title: TaskData type: object properties: sys_id: type: string number: type: string short_description: type: string category: type: string subcategory: type: string description: type: string state: type: string assignment_group: type: string opened_at: type: string priority: type: string caller_id: type: string assigned_to: type: string change_request: type: string business_service: type: string u_root_cause_category: type: string u_rca: type: string planned_start_date: type: string planned_end_date: type: string work_start: type: string work_end: type: string close_notes: type: string work_notes: type: string change_task_type: type: string created_on: type: string updated_on: type: string closed_at: type: string opened_by: type: string APIError: title: APIError required: - statusCode - statusMessage type: object properties: statusCode: type: string description: Error status code statusMessage: type: string description: Human-readable error message supportMessage: type: string description: Technical support message or error code for troubleshooting transactionId: type: string description: Transaction identifier for tracking and correlation sequenceNo: type: string description: Sequence number for request tracking timestamp: type: string description: Error timestamp in ISO 8601 format format: date-time path: type: string description: API endpoint path where the error occurred method: type: string description: HTTP method of the request that caused the error downstreamStatusCode: type: string description: Downstream service error code if applicable description: Generic MADAPI error response structure com_mtn_aggregator_models_response_dclm_CustomFields: title: CustomFields type: object properties: country: type: string province: type: string city: type: string Name: type: string color: type: string com_mtn_aggregator_models_response_UpdateIncidentRequest: title: UpdateIncidentRequest type: object properties: statusChangeReason: type: string field: type: string categoryType: type: string description: type: string assignedTo: type: string requestedFor: type: string com_mtn_aggregator_models_response_TroubleTicketRelationship: title: TroubleTicketRelationship type: object properties: name: type: string com_mtn_aggregator_models_response_dclm_EngagedParty: title: EngagedParty type: object properties: id: type: string '@referredType': type: string '@schemaLocation': type: string href: type: string com_mtn_aggregator_models_response_dclm_Assignees: title: Assignees type: object properties: id: type: string href: type: string '@schemaLocation': type: string com_mtn_aggregator_models_response_dclm_Medium: title: Medium type: object properties: type: type: string emailAddress: type: string verified: type: boolean number: type: string com_mtn_aggregator_models_response_listtickets_RelatedEntity: title: RelatedEntity type: object properties: id: type: string href: type: string name: type: string '@schemaLocation': type: string '@referredType': type: string com_mtn_aggregator_models_response_dclm_ContactMedium: title: ContactMedium type: object properties: medium: title: Medium type: object properties: type: type: string emailAddress: type: string verified: type: boolean number: type: string type: type: string role: type: string id: type: string name: type: string preferred: type: boolean com_mtn_aggregator_models_response_dclm_TicketActivity: title: TicketActivity type: object properties: author: type: string date: type: string text: type: string '@type': type: string action: type: string note: type: string from: type: string to: type: string assignedUser: type: string status: type: string previousComment: type: string com_mtn_aggregator_models_response_TroubleTicketResponse: title: TroubleTicketResponse type: object properties: id: type: string name: type: string statusCode: type: string statusMessage: type: string description: type: string priority: type: string status: type: string note: type: array items: title: Note type: object properties: author: type: string date: type: string text: type: string '@type': type: string id: type: string statusChange: type: array items: title: StatusChange type: object properties: status: type: string changeDate: type: string changeReason: type: string '@type': type: string troubleTicketRelationship: title: TroubleTicketRelationship type: object properties: name: type: string href: type: string ticketType: type: string externalId: type: string resolutionDate: type: string relatedParty: type: array items: title: RelatedParty type: object properties: role: type: string id: type: string '@referredType': type: string '@schemaLocation': type: string href: type: string name: type: string text: type: string contactMedium: type: array items: title: ContactMedium type: object properties: medium: title: Medium type: object properties: type: type: string emailAddress: type: string verified: type: boolean number: type: string type: type: string role: type: string id: type: string name: type: string preferred: type: boolean engagedParty: title: EngagedParty type: object properties: id: type: string '@referredType': type: string '@schemaLocation': type: string href: type: string location: type: string relatedEntity: type: array items: $ref: '#/components/schemas/com_mtn_aggregator_models_response_listtickets_RelatedEntity' channel: $ref: '#/components/schemas/com_mtn_aggregator_models_request_Channel' creationDate: type: string lastUpdate: type: string number: type: string resolved_date: type: string attachment: type: array items: $ref: '#/components/schemas/com_mtn_aggregator_models_request_Attachments' resolution_comments: type: string '@baseType': type: string '@type': type: string '@schemaLocation': type: string statusChangeReason: type: string productId: type: array items: type: string publicIdentifier: type: array items: type: string externalSystem: type: array items: title: ExternalSystem type: object properties: id: type: string channels: type: array items: $ref: '#/components/schemas/com_mtn_aggregator_models_request_Channel' ticketActivity: type: array items: title: TicketActivity type: object properties: author: type: string date: type: string text: type: string '@type': type: string action: type: string note: type: string from: type: string to: type: string assignedUser: type: string status: type: string previousComment: type: string customFields: title: CustomFields type: object properties: country: type: string province: type: string city: type: string Name: type: string color: type: string assignees: type: array items: title: Assignees type: object properties: id: type: string href: type: string '@schemaLocation': type: string assignee: title: Assignee type: object properties: id: type: string assigned: type: boolean isRepeatedTicket: type: boolean customerId: type: array items: type: string rootCause: type: string isChild: type: boolean isSlaBreached: type: boolean workFlowRef: type: array items: title: WorkFlowRef type: object properties: formId: type: string processId: type: string groupId: type: string taskInfoId: type: string formIdentity: type: string balkanGraphId: type: string workflowId: type: string groups: type: array items: title: Groups type: object properties: id: type: string date: type: string href: type: string '@schemaLocation': type: string parentId: type: string subStatus: type: string accountId: type: array items: type: string postToRemedy: type: string expectedResolutionDate: type: string category: type: string loB: type: string dclmTroubleTicketAPIResponseList: type: array items: title: DCLMTroubleTicketAPIResponse type: object properties: id: type: string description: type: string priority: type: string status: type: string productId: type: array items: type: string publicIdentifier: type: array items: type: string statusChange: type: array items: $ref: '#/components/schemas/com_mtn_aggregator_models_response_listtickets_StatusChange' countryInformation: $ref: '#/components/schemas/com_mtn_aggregator_models_request_CountryInformation' troubleTicketRelationship: $ref: '#/components/schemas/com_mtn_aggregator_models_response_TroubleTicketRelationship' ticketRelationship: type: array items: title: TicketRelationship type: object properties: id: type: string '@baseType': type: string '@schemaLocation': type: string '@type': type: string href: type: string name: type: string relationshipType: type: string href: type: string ticketType: type: string externalId: type: string externalSystem: type: array items: $ref: '#/components/schemas/com_mtn_aggregator_models_response_dclm_ExternalSystem' relatedParty: type: array items: $ref: '#/components/schemas/com_mtn_aggregator_models_response_listtickets_RelatedParty' relatedEntity: type: array items: $ref: '#/components/schemas/com_mtn_aggregator_models_response_listtickets_RelatedEntity' attachment: type: string channel: $ref: '#/components/schemas/com_mtn_aggregator_models_request_Channel' channels: type: array items: $ref: '#/components/schemas/com_mtn_aggregator_models_request_Channel' ticketActivity: type: array items: $ref: '#/components/schemas/com_mtn_aggregator_models_response_dclm_TicketActivity' creationDate: type: string lastUpdate: type: string note: type: array items: title: Note type: object properties: id: type: string text: type: string '@baseType': type: string '@type': type: string '@schemaLocation': type: string statusChangeReason: type: string customFields: $ref: '#/components/schemas/com_mtn_aggregator_models_response_dclm_CustomFields' assignees: type: array items: $ref: '#/components/schemas/com_mtn_aggregator_models_response_dclm_Assignees' assignee: $ref: '#/components/schemas/com_mtn_aggregator_models_response_dclm_Assignee' isRepeatedTicket: type: boolean customerId: type: array items: type: string rootCause: type: string isChild: type: boolean isSlaBreached: type: boolean workFlowRef: type: array items: $ref: '#/components/schemas/com_mtn_aggregator_models_response_dclm_WorkFlowRef' groups: type: array items: $ref: '#/components/schemas/com_mtn_aggregator_models_response_dclm_Groups' parentId: type: string subStatus: type: string accountId: type: array items: type: string postToRemedy: type: string expectedResolutionDate: type: string category: type: string loB: type: string com_mtn_aggregator_models_response_TicketRelationship: title: TicketRelationship type: object properties: id: type: string '@baseType': type: string '@schemaLocation': type: string '@type': type: string href: type: string name: type: string relationshipType: type: string com_mtn_aggregator_models_request_Attachments: title: Attachments type: object properties: id: type: string validFor: title: ValidFor type: object properties: endDateTime: type: string startDateTime: type: string attachmentType: type: string content: type: string name: type: string com_mtn_aggregator_models_response_dclm_Assignee: title: Assignee type: object properties: id: type: string assigned: type: boolean com_mtn_aggregator_models_response_TroubleTicketDLCMResponse: title: TroubleTicketDLCMResponse type: object properties: statusCode: type: string statusMessage: type: string transactionId: type: string pageNumber: type: integer format: int32 noOfRecords: type: integer format: int64 noOfPages: type: number format: double pageSize: type: number format: double data: type: array items: title: TaskData type: object properties: sys_id: type: string number: type: string short_description: type: string category: type: string subcategory: type: string description: type: string state: type: string assignment_group: type: string opened_at: type: string priority: type: string caller_id: type: string assigned_to: type: string change_request: type: string business_service: type: string u_root_cause_category: type: string u_rca: type: string planned_start_date: type: string planned_end_date: type: string work_start: type: string work_end: type: string close_notes: type: string work_notes: type: string change_task_type: type: string created_on: type: string updated_on: type: string closed_at: type: string opened_by: type: string com_mtn_aggregator_models_request_Channel: title: Channel type: object properties: name: type: string id: type: string role: type: string '@schemaLocation': type: string '@referredType': type: string '@type': type: string href: type: string com_mtn_aggregator_models_response_ValidFor: title: ValidFor type: object properties: endDateTime: type: string startDateTime: type: string com_mtn_aggregator_models_response_dclm_Groups: title: Groups type: object properties: id: type: string date: type: string href: type: string '@schemaLocation': type: string com_mtn_aggregator_models_error_APIError: title: APIError type: object properties: code: type: string reason: type: string message: type: string status: type: string referenceError: type: string '@baseType': type: string '@schemaLocation': type: string '@type': type: string com_mtn_aggregator_models_response_listtickets_Note: title: Note type: object properties: author: type: string date: type: string text: type: string '@type': type: string id: type: string com_mtn_aggregator_models_response_dclm_WorkFlowRef: title: WorkFlowRef type: object properties: formId: type: string processId: type: string groupId: type: string taskInfoId: type: string formIdentity: type: string balkanGraphId: type: string workflowId: type: string com_mtn_aggregator_models_response_dclm_ExternalSystem: title: ExternalSystem type: object properties: id: type: string com_mtn_aggregator_models_response_ServiceNowUpdateIncidentResponse: title: ServiceNowUpdateIncidentResponse type: object properties: statusMessage: type: string statusCode: type: string parent: title: LinkValue type: object properties: link: type: string value: type: string watch_list: type: string upon_reject: type: string sys_updated_on: type: string approval_history: type: string skills: type: string number: type: string u_amount_paid: type: string u_justification: type: string state: type: string sys_created_by: type: string knowledge: type: string order: type: string u_escalated_from_p2: type: string u_subcategory: type: string cmdb_ci: type: string delivery_plan: type: string contract: type: string impact: type: string active: type: string priority: type: string sys_domain_path: type: string short_description: type: string sys_class_name: type: string closed_by: $ref: '#/components/schemas/com_mtn_aggregator_models_response_LinkValue' assigned_to: $ref: '#/components/schemas/com_mtn_aggregator_models_response_LinkValue' upon_approval: type: string change_task_type: type: string planned_end_date: type: string made_sla: type: string u_resolution_time: type: string task_effective_number: type: string sys_updated_by: type: string opened_by: $ref: '#/components/schemas/com_mtn_aggregator_models_response_LinkValue' sys_created_on: type: string sys_domain: $ref: '#/components/schemas/com_mtn_aggregator_models_response_LinkValue' closed_at: type: string expected_start: type: string opened_at: type: string work_end: type: string planned_start_date: type: string assignment_group: $ref: '#/components/schemas/com_mtn_aggregator_models_response_LinkValue' x_snc_datasilos_last_maintenance: type: string description: type: string sys_id: type: string contact_type: type: string urgency: type: string u_total_tax_paid: type: string approval: type: string due_date: type: string sys_mod_count: type: string on_hold: type: string change_request: $ref: '#/components/schemas/com_mtn_aggregator_models_response_LinkValue' created_from: type: string error: $ref: '#/components/schemas/com_mtn_aggregator_models_error_APIError' com_mtn_aggregator_models_response_LinkValue: title: LinkValue type: object properties: link: type: string value: type: string com_mtn_aggregator_models_response_listtickets_RelatedParty: title: RelatedParty type: object properties: role: type: string id: type: string '@referredType': type: string '@schemaLocation': type: string href: type: string name: type: string text: type: string contactMedium: type: array items: title: ContactMedium type: object properties: medium: title: Medium type: object properties: type: type: string emailAddress: type: string verified: type: boolean number: type: string type: type: string role: type: string id: type: string name: type: string preferred: type: boolean engagedParty: title: EngagedParty type: object properties: id: type: string '@referredType': type: string '@schemaLocation': type: string href: type: string location: type: string securitySchemes: OAuth2: type: oauth2 flows: clientCredentials: tokenUrl: https://api.mtn.com/v1/oauth/access_token scopes: {} Bearer: type: http description: Bearer token received from OAuth2.0 authentication with the MADAPI scheme: bearer bearerFormat: JWT