---
title: "Get an app"
method: GET
path: "/v1/projects/{project_id}"
tags: ["Apps"]
---

# Get an app

`GET /v1/projects/{project_id}`

## Request

- Base URL: `https://api.liara.ir`
- URL: `https://api.liara.ir/v1/projects/{project_id}`
- Auth: HTTP bearer

Returns an app's details, including its environment variables and settings. Team permission: any project permission.

## Path parameters

- `project_id` string, required

## Query parameters

- `teamID` string: 24-character hexadecimal ID.

## Response `200`

The app.

- object
  - `project` App
    - `_id` string: The app's ID.
    - `project_id` string: The app's name.
    - `type` 'node' | 'next' | 'react' | 'vue' | 'angular' | 'static' | 'laravel' | 'php' | 'django' | 'flask' | 'python' | 'netcore' | 'dotnet' | 'go' | 'docker': The app's platform.
    - `scale` integer: `1` if the app is on, `0` if it's off.
    - `planID` string
    - `bundlePlanID` string
    - `status` 'ACTIVE' | 'FROZEN' | 'UNFREEZING' | 'CRASH_LOOP' | 'SUSPENDED': `ACTIVE`: running normally. `FROZEN`: stopped, for example because the balance ran out. `UNFREEZING`: being reactivated. `CRASH_LOOP`: keeps crashing on start. `SUSPENDED`: suspended by Liara.
    - `network` object
      - `_id` string
      - `name` string
    - `isDeployed` boolean: Whether the app has ever been deployed.
    - `created_at` string, date-time
    - `envs` EnvVar[]
      - `key` string, required
      - `value` string, required
    - `readOnlyRootFilesystem` boolean
    - `defaultSubdomain` boolean: Whether the app is reachable at `<name>.liara.run`.
    - `defaultSubdomainExpired` boolean: Whether the default subdomain has expired and can no longer be turned on.
    - `zeroDowntime` boolean
    - `fixedIPStatus` 'ACTIVE' | 'DISABLED'
    - `outboundIp` string: The fixed outbound IP, when `fixedIPStatus` is `ACTIVE`.
    - `dns` string[]: Custom DNS servers.
    - `hourlyPrice` number: Hourly cost of the app's plan.
    - `bundleHourlyPrice` number: Hourly cost of the app's bundle plan.
    - `reservedDiskSpace` number: Total size of the app's disks, in GB.

## Other responses

- `400`: `teamID` isn't a valid ID.
- `401`: The API token is missing, invalid or expired.
- `403`: With `teamID`: you aren't a member of the team (`team_not_found`), or you don't have the required permission on this app (`no_permission`).
- `404`: The app doesn't exist.

---

[API](https://skmtc.dev/liara-cloud/apis/paas.md) - [All operations](https://skmtc.dev/liara-cloud/apis/paas/llms.txt) - [OpenAPI document](https://skmtc.dev/liara-cloud/apis/paas/revisions/610162e8a623?raw)