Index

This method allows you to retrieve a list of incidents for your organization. For data to exist, you must have established a ServiceNow Integration.

Method URL
GET /api/v2/incidents.json
GET /api/v2/incidents.json?page=1&per_page=2

Parameters

Param Type Required Notes
page integer No Displays results based on specified page number (default 1, 1-indexed).
per_page integer No Number of results per page (defaults to 20 results).

Example Response

Code Status
200 OK

Example Response

[
  {
    "id": 35,
    "external_id": "9c573169c611228700193229fff72400",
    "short_description": "Can't read email",
    "started_at": "2015-06-02T12:09:51-11:00",
    "ended_at": "2015-06-03T12:10:06-11:00",
    "url": "https://yoursubdomainat.service-now.com//nav_to.do?uri=incident.do?sys_id=9c573169c611228700193229fff72400"
  },
  {
    "id": 36,
    "external_id": "9d385017c611228701d22104cc95c371",
    "short_description": "Unable to get to network file shares",
    "started_at": "2015-05-27T12:07:12-11:00",
    "ended_at": null,
    "url": "https://yoursubdomainat.service-now.com//nav_to.do?uri=incident.do?sys_id=9d385017c611228701d22104cc95c371"
  },
  {
    "id": 37,
    "external_id": "e8caedcbc0a80164017df472f39eaed1",
    "short_description": "Wireless access is down in my area",
    "started_at": "2015-06-03T12:07:30-11:00",
    "ended_at": null,
    "url": "https://yoursubdomainat.service-now.com//nav_to.do?uri=incident.do?sys_id=e8caedcbc0a80164017df472f39eaed1"
  },
  ...
]

Show

This method returns details of the incident specified by the incident ID in the URL. The data returned for this incident record is retrieved from ServiceNow records.

Method URL
GET /api/v2/incidents/[incident_id].json

Example Response

Code Status
200 OK

Example Response JSON

{
  "id": 36,
  "external_id": "9d385017c611228701d22104cc95c371",
  "short_description": "Unable to get to network file shares",
  "started_at": "2015-05-27T16:07:12-07:00",
  "ended_at": null,
  "data": {
    ...
  },
  "url": "https://yoursubdomainat.service-now.com//nav_to.do?uri=incident.do?sys_id=9d385017c611228701d22104cc95c371"
}
Tags: incidents