# Get a planned Instagram post

`GET https://app.whatsetter.com/api/v1/instagram/posts/{id}`

One post planned through WhatSetter, to follow it after
`POST /instagram/posts`: its `status`, its `permalink` once published,
its first comment, and its copy on the Facebook Page (`facebook`: its
own status, permalink and `error_code`). A cancelled post, or one of
another workspace, answers `404`. Requires scope `instagram:read`.

## Example request

```bash
curl --request GET \
  --url 'https://app.whatsetter.com/api/v1/instagram/posts/{id}' \
  --header 'Authorization: Bearer ws_live_…'
```

## Responses

### 200: The planned post

```json
{
  "data": {
    "id": "",
    "account_id": "",
    "account_username": "",
    "kind": "image",
    "caption": "",
    "media": [
      {
        "type": "image",
        "url": ""
      }
    ],
    "status": "scheduled",
    "publish_at": "",
    "published_at": "",
    "permalink": "",
    "instagram_media_id": "",
    "error_code": "",
    "automation": {
      "keyword": "",
      "message": ""
    },
    "first_comment": {
      "message": "",
      "status": "pending",
      "error_code": ""
    },
    "trial": false,
    "collaborators": [
      ""
    ],
    "user_tags": [
      {
        "username": "",
        "x": 0,
        "y": 0
      }
    ],
    "alt_texts": [
      ""
    ],
    "audio_name": "",
    "share_to_feed": false,
    "comments_enabled": false,
    "mode": "auto",
    "reminded_at": "",
    "facebook": {
      "status": "pending",
      "page_name": "",
      "permalink": "",
      "published_at": "",
      "error_code": ""
    },
    "source": "app",
    "created_at": ""
  }
}
```

### 401: Missing, unknown or revoked API key

```json
{
  "error": {
    "code": "",
    "message": ""
  }
}
```

### 403: The key lacks the required scope (`insufficient_scope`), the plan does not have this part of the API (`not_in_plan`), or Instagram is not enabled on the workspace (`instagram_not_enabled`, Instagram routes)

```json
{
  "error": {
    "code": "",
    "message": ""
  }
}
```

### 404: Resource not found in this workspace

```json
{
  "error": {
    "code": "",
    "message": ""
  }
}
```


Source: https://docs.whatsetter.com/api-reference/operations/getinstagrampost/
