# Get a deployment status

From **GitHub v3 REST API**.

`GET /repos/{owner}/{repo}/deployments/{deployment_id}/statuses/{status_id}`

Users with pull access can view a deployment status for a deployment:

## Parameters

### `owner`

- Location: path
- Required: true
- Type: `string`

### `repo`

- Location: path
- Required: true
- Type: `string`

### `deployment_id`

- Location: path
- Required: true
- Type: `integer`

deployment_id parameter

### `status_id`

- Location: path
- Required: true
- Type: `integer`

## Responses

### `200`

Response

### `application/json`

- Type: `object`

The status of a deployment.

```json
{
  "created_at": "2012-07-20T01:19:13Z",
  "creator": {
    "avatar_url": "https://github.com/images/error/octocat_happy.gif",
    "events_url": "https://api.github.com/users/octocat/events{/privacy}",
    "followers_url": "https://api.github.com/users/octocat/followers",
    "following_url": "https://api.github.com/users/octocat/following{/other_user}",
    "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
    "gravatar_id": "",
    "html_url": "https://github.com/octocat",
    "id": 1,
    "login": "octocat",
    "node_id": "MDQ6VXNlcjE=",
    "organizations_url": "https://api.github.com/users/octocat/orgs",
    "received_events_url": "https://api.github.com/users/octocat/received_events",
    "repos_url": "https://api.github.com/users/octocat/repos",
    "site_admin": false,
    "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
    "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
    "type": "User",
    "url": "https://api.github.com/users/octocat"
  },
  "deployment_url": "https://api.github.com/repos/octocat/example/deployments/42",
  "description": "Deployment finished successfully.",
  "environment": "production",
  "environment_url": "https://test-branch.lab.acme.com",
  "id": 1,
  "log_url": "https://example.com/deployment/42/output",
  "node_id": "MDE2OkRlcGxveW1lbnRTdGF0dXMx",
  "repository_url": "https://api.github.com/repos/octocat/example",
  "state": "success",
  "target_url": "https://example.com/deployment/42/output",
  "updated_at": "2012-07-20T01:19:13Z",
  "url": "https://api.github.com/repos/octocat/example/deployments/42/statuses/1"
}
```

```json
{"description":"The status of a deployment.","properties":{"created_at":{"example":"2012-07-20T01:19:13Z","format":"date-time","type":"string"},"creator":{"$ref":"#/components/schemas/nullable-simple-user"},"deployment_url":{"example":"https://api.github.com/repos/octocat/example/deployments/42","format":"uri","type":"string"},"description":{"default":"","description":"A short description of the status.","example":"Deployment finished successfully.","maxLength":140,"type":"string"},"environment":{"default":"","description":"The environment of the deployment that the status is for.","example":"production","type":"string"},"environment_url":{"default":"","description":"The URL for accessing your environment.","example":"https://staging.example.com/","format":"uri","type":"string"},"id":{"example":1,"type":"integer"},"log_url":{"default":"","description":"The URL to associate with this status.","example":"https://example.com/deployment/42/output","format":"uri","type":"string"},"node_id":{"example":"MDE2OkRlcGxveW1lbnRTdGF0dXMx","type":"string"},"performed_via_github_app":{"$ref":"#/components/schemas/nullable-integration"},"repository_url":{"example":"https://api.github.com/repos/octocat/example","format":"uri","type":"string"},"state":{"description":"The state of the status.","enum":["error","failure","inactive","pending","success","queued","in_progress"],"example":"success","type":"string"},"target_url":{"default":"","description":"Deprecated: the URL to associate with this status.","example":"https://example.com/deployment/42/output","format":"uri","type":"string"},"updated_at":{"example":"2012-07-20T01:19:13Z","format":"date-time","type":"string"},"url":{"example":"https://api.github.com/repos/octocat/example/deployments/42/statuses/1","format":"uri","type":"string"}},"required":["id","node_id","state","creator","description","deployment_url","target_url","repository_url","url","created_at","updated_at"],"title":"Deployment Status","type":"object"}
```

### `404`

Resource not found

### `application/json`

- Type: `object`

Basic Error

```json
{"description":"Basic Error","properties":{"documentation_url":{"type":"string"},"message":{"type":"string"},"status":{"type":"string"},"url":{"type":"string"}},"title":"Basic Error","type":"object"}
```

## Request examples

### cURL

```shell
curl --request GET \
  --url {protocol}://{hostname}/api/v3/repos/{owner}/{repo}/deployments/{deployment_id}/statuses/{status_id}
```