---
title: "List the agent's social posts"
method: GET
path: "/social/posts"
tags: ["social"]
---

# List the agent's social posts

`GET /social/posts`

## Request

- Base URL: `https://app.tascan.io/api/v1`
- URL: `https://app.tascan.io/api/v1/social/posts`
- Auth: HTTP bearer

The calling key's agent (api_keys.agent_id) queue and history, newest first, at most 100. Optional status filter and since (ISO time; posts updated after it). Read tier. Statuses: pending_approval (waits for the owner's Approve card) -> queued -> publishing -> published | failed | cancelled | rejected.

## Query parameters

- `status` 'pending_approval' | 'queued' | 'publishing' | 'published' | 'failed' | 'cancelled' | 'rejected'
- `since` string, date-time

## Response `200`

Success. JSON body: { data: ... } or an error object { error, message }.

## Other responses

- `4XX`: Client error (validation, auth, scope, rate limit).

---

[API](https://skmtc.dev/tascan/apis/tascan-api.md) · [All operations](https://skmtc.dev/tascan/apis/tascan-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tascan/apis/tascan-api/revisions/56fcd2861498?raw)