KongNet Telco API

Get the customer's line and router health

Returns line sync speeds against the package, drops and errors in the last 24 hours, whether the router is online, the last reboot time and wifi channel details. Use it to decide whether a problem is the line, the router or wifi.

get
/me/service-health

Response

200 application/json

Successful Response

200 application/json

Check for outages and planned work at the customer's postcode

Returns live incidents and planned work affecting the customer’s postcode, each with status, summary and the estimated fix time. Always call this before saying anything about an outage or a fix time.

get
/me/network-status

Response

200 application/json

Successful Response

200 application/json

List the customer's support tickets

Returns the customer’s tickets, newest first, with reference, category, status and summary. Call this before creating a ticket so you can add a note to an existing open one instead of raising a duplicate.

get
/me/tickets

Query Parameters

statusstring

Filter by status

Allowed values:openclosedall

Default:all

Response

application/json

Successful Response

application/json

Create a support ticket for the customer

Raises a ticket after troubleshooting has not fixed the problem and the customer has confirmed. Include steps tried and diagnostics. If an open ticket already exists in the same category the request is rejected with 409 and the existing reference: add a note to that ticket instead.

post
/me/tickets

Body

application/json

TicketCreate

categorystringrequired

Ticket category

Allowed values:outageconnectionwifispeedtvbillingaccountother

summarystringrequired

One line summary in the customer’s words

>= 5 characters<= 140 characters

detailsstring

What the customer reported and what was found

Default:

<= 4000 characters

steps_triedarray[string]

Troubleshooting steps already tried, in order

diagnosticsobject

Results from line test or wifi scan, if run

* Additional properties are allowed.
model_aliasAny Of

Model alias that handled the conversation

Variant 1string
trace_idAny Of

Gateway trace id for the conversation

Variant 1string

Response

application/json

Successful Response

application/json

Get one ticket with its notes

Returns full ticket details including steps tried, diagnostics and notes. Only the ticket owner or staff can read it.

get
/tickets/{ticket_id}

Path Parameters

ticket_idstringrequired

Response

application/json

Successful Response

application/json