---
title: "List posts for the authenticated user"
method: GET
path: "/posts"
tags: ["Posts"]
---

# List posts for the authenticated user

`GET /posts`

## Request

- Base URL: `https://socialrobot.io/api/v1`
- URL: `https://socialrobot.io/api/v1/posts`
- Auth: API key in header `x-api-key`

Returns the authenticated user’s draft, scheduled, publishing, or published posts with optional filtering and cursor-based pagination.

## Query parameters

- `status` string
- `platform` string
- `limit` integer
- `cursor` string

## Headers

- `x-api-key` string, required

## Response `200`

Posts fetched successfully

- object
  - `posts` object[], required
  - `nextCursor` string

---

[API](https://skmtc.dev/socialrobot/apis/socialrobot-io-scheduler-api.md) · [All operations](https://skmtc.dev/socialrobot/apis/socialrobot-io-scheduler-api/llms.txt) · [OpenAPI document](https://skmtc.dev/socialrobot/apis/socialrobot-io-scheduler-api/revisions/c2e9cdf5e75e?raw)