# gram status

The `status` command checks the status of a deployment in a Gram project. If
no deployment ID is provided, the command shows the status of the latest
deployment.

<Callout type="info">
    The `gram status` command requires you to specify an API key and project
    slug. For more information on these values, see the [global CLI
    options](/docs/mcp/reference/command-line#global-options).
</Callout>

## Usage

Check the status of the latest deployment:

```bash
gram status --api-key YOUR_API_KEY --project my-project
```

Check the status of a specific deployment:

```bash
gram status --id deployment-123 --api-key YOUR_API_KEY --project my-project
```

Get deployment status as JSON:

```bash
gram status --json --api-key YOUR_API_KEY --project my-project
```

## Options

### <code>id</code>

This adds a deployment ID to specify which deployment you are checking the status for. If not provided, the command shows the status of the latest deployment.

```bash
gram status --id deployment-123 [other options]
```

### <code>json</code>

This option outputs the deployment status as JSON, which is useful for scripting and
automation.

```bash
gram status --json [other options]
```