Ticketing

Create various types of tickets, view all tickets, and create ticket comments.

Create ticket

Create a ticket against your service. Associate your service via the serviceId, componentId, or circuitId returned from the Service Inventory route.

SecurityBearerToken or OAuthClientCredentials
Request
Request Body schema: application/json

Ticket request body. There are different request bodies for each ticket type. Prerequisites include having reference to your service from the service inventory route and pass in either the serviceId, componentId, or circuitId key value pair in the request.

Any of:
ticketType
required
string
Array of objects [ 1 .. 20 ] items
customerReferenceId
string

Ticket reference specific to customer.

description
string

This will be the description of the Zayo ticket. Please provide a detailed statement of work.

downtimeInitialDate
required
string <date>

ISO format date string of initial downtime.

downtimeInitialTime
required
string <time>

ISO format time string of initial downtime.

circuitId
required
string

Either circuitId, serviceId, or componentId is required. You can get all values from the service inventory route.

serviceId
string
componentId
string
serviceState
required
string

The state of your service you are creating a ticket against. Impaired = Degraded or Erroring but still usable. Hard Down = Service degraded to the point of being unusable or completely hard down. Request Against Service = Incident investigation (service bounced but cleared before the ticket was opened) and information requests or questions related to the configuration of an active service.

Enum: "Hard Down" "Impaired" "Request Against Service"
subject
string

Summary of request, this will be the subject of the Zayo ticket.

object
Responses
200

Success - Technical Support ticket type

400

Bad Request

post/services/service-management/v1/create-ticket
Request samples
application/json
{
  • "ticketType": "Technical Support",
  • "contacts": [
    • {
      • "contactType": "Primary",
      • "fullName": "Devon Holt",
      • "email": "devon.holt@zayo.com",
      • "phone": "123-456-7890"
      }
    ],
  • "customerReferenceId": "Zayo-1398732",
  • "description": "TESTING API",
  • "downtimeInitialDate": "2022-06-29",
  • "downtimeInitialTime": "20:20:39+00:00",
  • "circuitId": "ETYX/TEST011/ZYO",
  • "serviceId": "a0M0z00000PiJ3SEAV",
  • "componentId": "a1X0z000004aLc6EAE",
  • "serviceState": "Impaired",
  • "subject": "TESTING",
  • "troubleshooting": {
    • "circuitPassTraffic": false,
    • "disconnectedFibers": false,
    • "gearOn": true,
    • "interfaceReset": false,
    • "verifyLightLevels": false
    }
}
Response samples
application/json
{
  • "apiVersion": "v1",
  • "data": {
    • "status": "New",
    • "ticketId": "5004z00001dIuveAAC",
    • "ticketNumber": "TTN-0005833575",
    • "customerReferenceId": "Zayo-239823",
    • "dateTimeOpened": "2022-04-25T20:29:49.000+0000"
    }
}

Create ticket comment

Add a ticket comment to directly communicate with the Zayo NOC team. Once a comment is added on a ticket, the ticket status will update to Action Required, so that it notifies our NOC teams.

SecurityBearerToken or OAuthClientCredentials
Request
Request Body schema: application/json

Ticket comment request body. Either ticketId or ticketNumber is required.

required
string or string^500

Ticket unique identifier. Either ticketId or ticketNumber is required.

ticketNumber
required
string

Ticket unique Identifier, also used in Tranzact portal. Either ticketId or ticketNumber is required.

commentBody
required
string

Comment content.

contactEmail
required
string <email>

Email of the user who is posting the comment.

contactName
required
string

Name of the user who is posting the comment.

customerReferenceId
string

Internal reference identifier.

Responses
200

Success

400

Bad Request

post/services/service-management/v1/ticket-comment
Request samples
application/json
{
  • "ticketId": "5000x00000BHrN2AAL",
  • "ticketNumber": "TTN-0003449133",
  • "commentBody": "The problem was not resolved, please address.",
  • "contactEmail": "wwhite@company.com",
  • "contactName": "Walter White",
  • "customerReferenceId": "Ticket 1029342"
}
Response samples
application/json
{
  • "apiVersion": "v1",
  • "data": {
    • "message": "Ticket comment was successfully created",
    • "success": true
    }
}

Get all tickets

Retrieve all tickets based on filter options and pagination.

SecurityBearerToken or OAuthClientCredentials
Request
Request Body schema: application/json

Optional request body to apply filters to return a list of all tickets. Pagination with top and skip options.

object

Object to define filter options.

object

Object to define pagination for the number of records per page, and how many records to skip. Follows odata pagination standards.

search
string >= 3 characters
Responses
200

Success

400

Bad Request

post/services/service-management/v1/all-tickets
Request samples
application/json
{
  • "filter": {
    • "or": [
      • {
        • "status": "New"
        },
      • {
        • "status": "Isolation and Repair"
        }
      ]
    },
  • "paging": {
    • "top": 50,
    • "skip": 0
    }
}
Response samples
application/json
{
  • "apiVersion": "v1",
  • "data": {
    • "records": [
      • {
        • "circuitId": "ETYX/TEST012/ZYO",
        • "componentId": "a1X0z000004aLcBEAU",
        • "customerReferenceId": "test",
        • "description": "Issue: Slow Service - Constant Description: test Customer Reported Initial Down time : Jun 27, 2022 2:59 PM",
        • "legacyCircuitId": null,
        • "serviceId": "a0M0z00000PiJ3XEAV",
        • "serviceName": "559513",
        • "status": "Service Restored",
        • "subject": "Test Account - GBP / ETYX/TEST012/ZYO / Hard Down",
        • "dateTimeOpened": "2022-06-27T15:01:30.000Z",
        • "dateTimeClosed": "2022-06-27T14:15:52.000Z",
        • "ticketId": "5004z00001dBSudAAG",
        • "ticketNumber": "TTN-0005993810",
        • "ticketType": "Technical Support"
        }
      ],
    • "metadata": {
      • "top": 5,
      • "skip": 0,
      • "currentPage": 1,
      • "totalPages": 4964,
      • "totalRecordCount": 24818
      }
    }
}