# List the posts of an account

### List the posts of an account

`GET /api/v1/instagram/posts`

Operation ID: `listInstagramPosts`

Returns the posts of one account, most recent first. A username that does not exist comes back with no posts rather than an error.

**Query parameters**

- `connectedAccountId` (string · uuid, required): Connected account to act as
- `identity` (string, required): Whose posts to read, as a username without @.
- `cursor` (string, optional)
- `limit` (integer, optional): Page size, up to 100. Defaults to 20. A page can hold fewer, so follow cursor until it comes back null.

**200**: Posts.

- `posts` (object[], required)
- `cursor` (string | null, required)

**Errors**

- `400`: Bad request
- `401`: Unauthorized: missing or invalid API key
- `403`: Forbidden
- `404`: Not found
- `422`: Invalid request payload