---
title: Check Post Status - Monitor Carousel Generation
description: Track the progress of your carousel generation requests. Get real-time status updates and processing logs for PostNitro API requests.
canonical: https://postnitro.ai/docs/embed/api/request-status
---

# Check Post Status

**GET** `https://embed-api.postnitro.ai/post/status/{embedPostId}`

Retrieves the current status and processing logs for a specific post. Use this to poll the progress of a carousel after initiating it via [AI Generation](https://postnitro.ai/docs/embed/api/initiate/generate) or [Content Import](https://postnitro.ai/docs/embed/api/initiate/import).

#### Headers
- `embed-api-key: your-api-key-here` (required)

#### Path Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `embedPostId` | string | Yes | ID of the embed post to check |

#### Example Request

```bash
curl --location 'https://embed-api.postnitro.ai/post/status/[embed-post-id]' \
--header 'embed-api-key: pn-plnnepb6v9omx2ik88v793ak'
```

#### Response

```json
{
    "success": true,
    "data": {
        "embedPostId": "post123",
        "embedPost": {
            "id": "post123",
            "postType": "CAROUSEL",
            "status": "COMPLETED",
            "createdAt": "2024-01-15T10:30:00Z",
            "updatedAt": "2024-01-15T10:35:00Z"
        },
        "logs": [
            {
                "id": "log1",
                "embedPostId": "post123",
                "step": "INITIATED",
                "status": "SUCCESS",
                "message": "Post generation initiated",
                "timestamp": "2024-01-15T10:30:00Z"
            },
            {
                "id": "log2",
                "embedPostId": "post123",
                "step": "PROCESSING",
                "status": "SUCCESS",
                "message": "Content generated successfully",
                "timestamp": "2024-01-15T10:32:00Z"
            },
            {
                "id": "log3",
                "embedPostId": "post123",
                "step": "COMPLETED",
                "status": "SUCCESS",
                "message": "Post generation completed",
                "timestamp": "2024-01-15T10:35:00Z"
            }
        ]
    }
}
```

#### Post Status Values

| Status | Meaning | What to do |
|--------|---------|------------|
| `PENDING` | The post is queued or still being generated | Keep polling this endpoint (a few seconds between polls is sufficient; generation typically completes well under a minute) |
| `COMPLETED` | Generation finished successfully | Call [Get Post Output](https://postnitro.ai/docs/embed/api/post-output) to retrieve the files |
| `FAILED` | Generation failed | Inspect the `logs` array in the response for the failing step and error message, then retry or contact [support@postnitro.ai](mailto:support@postnitro.ai) |