> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hookmyapp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get container status

> Poll a media container until it is ready to publish.

Step 2 of the publish flow. Poll about once per minute until `status_code` is `FINISHED`.<br />
Images usually finish immediately. Videos take longer.

There is no publish webhook — polling is the only way to know a container is ready.

## Authentication

Use the `hmat_` channel token from `GET /meta/channels/{id}/token` or `hookmyapp channels env <channel>`. Do not use an `hmok_` API key for this call.

```bash theme={null}
Authorization: Bearer hmat_...
```

## Path parameters

<ParamField path="containerId" type="string" required>
  The container ID returned by [Create a media container](/instagram/api/publishing/create-media-container).
</ParamField>

## Example

```bash theme={null}
curl "https://gateway.hookmyapp.com/meta/v25.0/17900000000000001?fields=status_code" \
  -H "Authorization: Bearer hmat_..."
```

## Successful response

```json theme={null}
{ "status_code": "FINISHED", "id": "17900000000000001" }
```

`status_code` values: `IN_PROGRESS`, `FINISHED`, `ERROR`, `EXPIRED`.