> ## 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.

# List posts

> List the posts published by the Page.

Lists the Page's posts, newest first.

## Authentication

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

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

## Path parameters

<ParamField path="pageId" type="string" required>
  The connected Page id.
</ParamField>

## Query parameters

<ParamField query="fields" type="string">
  Comma-separated fields. Use `id,message,created_time,permalink_url,status_type`.
</ParamField>

<ParamField query="limit" type="integer">
  Page size, up to 100.
</ParamField>

<ParamField query="after" type="string">
  Cursor from a previous response's `paging.cursors.after`.
</ParamField>

## Example

```bash theme={null}
curl "https://gateway.hookmyapp.com/meta/v25.0/{PAGE_ID}/posts?fields=id,message,created_time,permalink_url,status_type" \
  -H "Authorization: Bearer hmat_..."
```

## Successful response

```json theme={null}
{
  "data": [
    {
      "id": "100000000000001_500000000000001",
      "message": "We are open today until 8pm.",
      "created_time": "2026-09-15T09:10:49+0000",
      "permalink_url": "https://www.facebook.com/...",
      "status_type": "mobile_status_update"
    }
  ],
  "paging": { "cursors": { "before": "...", "after": "..." } }
}
```