Get Incident

Get a single incident.

The ID supplied can be either the incident's full ID, or the numeric part of its reference. For example, to get INC-123, you could use either its full ID or:

    curl \
        --get 'https://api.incident.io/v2/incidents/123.

External Documentation

To learn more, visit the incident.io documentation.

Parameters

Parameter	Description
Incident ID	Unique identifier for the incident.

Example Output

{
    "incident": {
        "call_url": "https://zoom.us/foo",
        "created_at": "2021-08-17T13:28:57.801578Z",
        "creator": {
            "api_key": {
                "id": "01FCNDV6P870EA6S7TK1DSYDG0",
                "name": "My test API key"
            },
            "user": {
                "email": "lisa@incident.io",
                "id": "01FCNDV6P870EA6S7TK1DSYDG0",
                "name": "Lisa Karlin Curtis",
                "role": "viewer",
                "slack_user_id": "U02AYNF2XJM"
            }
        },
        "custom_field_entries": [
            {
                "custom_field": {
                    "description": "Which team is impacted by this issue",
                    "field_type": "single_select",
                    "id": "01FCNDV6P870EA6S7TK1DSYDG0",
                    "name": "Affected Team",
                    "options": [
                        {
                            "custom_field_id": "01FCNDV6P870EA6S7TK1DSYDG0",
                            "id": "01FCNDV6P870EA6S7TK1DSYDG0",
                            "sort_key": 10,
                            "value": "Product"
                        }
                    ]
                },
                "values": [
                    {
                        "value_catalog_entry": {
                            "aliases": [
                                "lawrence@incident.io",
                                "lawrence"
                            ],
                            "external_id": "761722cd-d1d7-477b-ac7e-90f9e079dc33",
                            "id": "01FCNDV6P870EA6S7TK1DSYDG0",
                            "name": "Primary On-call"
                        },
                        "value_link": "https://google.com/",
                        "value_numeric": "123.456",
                        "value_option": {
                            "custom_field_id": "01FCNDV6P870EA6S7TK1DSYDG0",
                            "id": "01FCNDV6P870EA6S7TK1DSYDG0",
                            "sort_key": 10,
                            "value": "Product"
                        },
                        "value_text": "This is my text field, I hope you like it"
                    }
                ]
            }
        ],
        "duration_metrics": [
            {
                "duration_metric": {
                    "id": "01FCNDV6P870EA6S7TK1DSYD5H",
                    "name": "Lasted"
                },
                "value_seconds": 1
            }
        ],
        "external_issue_reference": {
            "issue_name": "INC-123",
            "issue_permalink": "https://linear.app/incident-io/issue/INC-1609/find-copywriter-to-write-up",
            "provider": "asana"
        },
        "id": "01FDAG4SAP5TYPT98WGR2N7W91",
        "incident_role_assignments": [
            {
                "assignee": {
                    "email": "lisa@incident.io",
                    "id": "01FCNDV6P870EA6S7TK1DSYDG0",
                    "name": "Lisa Karlin Curtis",
                    "role": "viewer",
                    "slack_user_id": "U02AYNF2XJM"
                },
                "role": {
                    "created_at": "2021-08-17T13:28:57.801578Z",
                    "description": "The person currently coordinating the incident",
                    "id": "01FCNDV6P870EA6S7TK1DSYDG0",
                    "instructions": "Take point on the incident; Make sure people are clear on responsibilities",
                    "name": "Incident Lead",
                    "required": false,
                    "role_type": "lead",
                    "shortform": "lead",
                    "updated_at": "2021-08-17T13:28:57.801578Z"
                }
            }
        ],
        "incident_status": {
            "category": "triage",
            "created_at": "2021-08-17T13:28:57.801578Z",
            "description": "Impact has been **fully mitigated**, and we're ready to learn from this incident.",
            "id": "01FCNDV6P870EA6S7TK1DSYD5H",
            "name": "Closed",
            "rank": 4,
            "updated_at": "2021-08-17T13:28:57.801578Z"
        },
        "incident_timestamp_values": [
            {
                "incident_timestamp": {
                    "id": "01FCNDV6P870EA6S7TK1DSYD5H",
                    "name": "Impact started",
                    "rank": 1
                },
                "value": {
                    "value": "2021-08-17T13:28:57.801578Z"
                }
            }
        ],
        "incident_type": {
            "create_in_triage": "always",
            "created_at": "2021-08-17T13:28:57.801578Z",
            "description": "Customer facing production outages",
            "id": "01FCNDV6P870EA6S7TK1DSYDG0",
            "is_default": false,
            "name": "Production Outage",
            "private_incidents_only": false,
            "updated_at": "2021-08-17T13:28:57.801578Z"
        },
        "mode": "standard",
        "name": "Our database is sad",
        "permalink": "https://app.incident.io/incidents/123",
        "postmortem_document_url": "https://docs.google.com/my_doc_id",
        "reference": "INC-123",
        "severity": {
            "created_at": "2021-08-17T13:28:57.801578Z",
            "description": "Issues with **low impact**.",
            "id": "01FCNDV6P870EA6S7TK1DSYDG0",
            "name": "Minor",
            "rank": 1,
            "updated_at": "2021-08-17T13:28:57.801578Z"
        },
        "slack_channel_id": "C02AW36C1M5",
        "slack_channel_name": "inc-165-green-parrot",
        "slack_team_id": "T02A1FSLE8J",
        "summary": "Our database is really really sad, and we don't know why yet.",
        "updated_at": "2021-08-17T13:28:57.801578Z",
        "visibility": "public",
        "workload_minutes_late": 40.7,
        "workload_minutes_sleeping": 0,
        "workload_minutes_total": 60.7,
        "workload_minutes_working": 20
    }
}

Workflow Library Example

Get Incident with Incidentio and Send Results Via Email

Preview this Workflow on desktop