---
title: "Get a Deployment Status and Information"
method: GET
path: "/v1/status/{request_id}"
tags: ["Deployments"]
---

# Get a Deployment Status and Information

`GET /v1/status/{request_id}`

## Request

- Base URL: `https://api.edgegap.com`
- URL: `https://api.edgegap.com/v1/status/{request_id}`
- Auth: API key in header `authorization`

[Rate Limit: 20/second] Retrieve the information for a deployment.

## Path parameters

- `request_id` string, required

## Response `200`

Success

- Status
  - `request_id` string, required: The Unique ID of the Deployment's request
  - `fqdn` string, required: The FQDN that allow to connect to your Deployment
  - `app_name` string, required: The name of the deployed App
  - `app_version` string, required: The version of the deployed App
  - `current_status` string, required: The current status of the Deployment
  - `running` boolean, required: True if the current Deployment is ready to be connected and running
  - `whitelisting_active` boolean, required: True if the current Deployment is ACL protected
  - `start_time` string, required: Timestamp of the Deployment when it is up and running
  - `removal_time` string: Timestamp of the end of the Deployment
  - `elapsed_time` integer, required: Time since the Deployment is up and running in seconds
  - `last_status` string: The last status of the Deployment
  - `error` boolean, required: True if there is an error with the Deployment
  - `error_detail` string: The error details of the Deployment
  - `ports` object
  - `public_ip` string, required: The public IP
  - `sessions` DeploymentSessionContext[]: List of Active Sessions if Deployment App is Session Based
    - `session_id` string, required: Unique UUID
    - `status` string, required: Current status of the session
    - `ready` boolean, required: If the session is linked to a Ready deployment
    - `linked` boolean, required: If the session is linked to a deployment
    - `kind` string, required: Type of session created
    - `user_count` integer, required: Count of user this session currently have
  - `location` DeploymentLocation
    - `city` string, required: City of the deployment
    - `country` string, required: Country of the deployment
    - `continent` string, required: Continent of the deployment
    - `administrative_division` string, required: Administrative division of the deployment
    - `timezone` string, required: Timezone of the deployment
    - `latitude` number, required: Latitude of the deployment
    - `longitude` number, required: Longitude of the deployment
  - `tags` string[]: List of tags associated with the deployment
  - `sockets` integer: The Capacity of the Deployment
  - `sockets_usage` integer: The Capacity Usage of the Deployment
  - `command` string: The command to use in the container, null mean it will take the default of the container
  - `arguments` string: The arguments to use in the container, null mean it will take the default of the container
  - `max_duration` integer, required: The deployment's maximum duration is the time, in minutes, that the deployment will remain active before automatically closing.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `500`: Internal Server Error

---

[API](https://skmtc.dev/edgegap/apis/edgegap-v1.md) · [All operations](https://skmtc.dev/edgegap/apis/edgegap-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/edgegap/apis/edgegap-v1/revisions/9fa2b393a6be?raw)