# Get status and outage information of a service

<mark style="color:blue;">`GET`</mark> `https://isdown.app/api/v2/services/{service_name}`

#### Path Parameters

| Name                                            | Type   | Description                                                                                                                                                 |
| ----------------------------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| service\_name<mark style="color:red;">\*</mark> | String | Parameterize name for the service. Get the service\_name from the url of a service. E.g., <https://isdown.app/services/digitalocean> it's **digitalocean.** |

#### Headers

| Name                                            | Type   | Description     |
| ----------------------------------------------- | ------ | --------------- |
| Authorization<mark style="color:red;">\*</mark> | String | Bearer API\_KEY |

{% tabs %}
{% tab title="200: OK When status is OK" %}

```json
{
    "data": {
        "id": "10000",
        "type": "service",
        "attributes": {
            "name": "Demo Service",
            "status": "ok",
            "status_page_url": "https://status.demo-service.com/",
            "isdown_url": "https://isdown.app/integrations/demo-service"
        }
    }
}
```

{% endtab %}

{% tab title="401: Unauthorized When authorization is missing or is invalid" %}

```json
{
    "errors": [
        {
            "status": 401,
            "title": "Unauthorized access",
            "detail": "You are not authorized to access this resource"
        }
    ]
}
```

{% endtab %}

{% tab title="404: Not Found When we don't find the resource" %}

```json
{
    "errors": [
        {
            "status": 404,
            "title": "Resource not found",
            "detail": "The resource you are looking for does not exist"
        }
    ]
}
```

{% endtab %}

{% tab title="200: OK When status is any other than OK" %}

```json
{
    "data": {
        "id": "10000",
        "type": "service",
        "attributes": {
            "name": "Demo Service",
            "status": "major",
            "status_page_url": "https://status.demo-service.com/",
            "ongoing_incidents": {
                "data": [
                    {
                        "id": "10001",
                        "type": "incident",
                        "attributes": {
                            "url": "https://status.demo-service.com/incidents/10000",
                            "title": "Demo Incident 2",
                            "status": "minor",
                            "resolved": false,
                            "created_at": "2022-09-13T06:56:45.523+01:00",
                            "description": "This is a demo incident 2",
                            "resolved_at": "2022-09-13T07:26:45.523+01:00"
                        }
                    }
                ]
            },
            "isdown_url": "https://isdown.app/integrations/demo-service"
        }
    }
}
```

{% endtab %}
{% endtabs %}
