---
title: "List post syncs"
method: GET
path: "/api/profiles/{id}/post_syncs"
tags: ["Profiles"]
---

# List post syncs

`GET /api/profiles/{id}/post_syncs`

## Request

- Base URL: `https://api.postproxy.dev`
- URL: `https://api.postproxy.dev/api/profiles/{id}/post_syncs`
- Auth: HTTP bearer

Retrieves post sync runs for a profile, newest first. Runs are kept for 30 days.

## Path parameters

- `id` string, required

## Query parameters

- `profile_group_id` string
- `trigger` 'connect' | 'scheduled' | 'backfill'
- `status` 'pending' | 'running' | 'completed' | 'failed'
- `page` integer
- `per_page` integer

## Response `200`

Paginated list of post sync runs

- object
  - `total` integer
  - `page` integer
  - `per_page` integer
  - `data` ProfilePostSync[]
    - `id` string: Unique sync identifier.
    - `profile_id` string: Profile this run belongs to.
    - `kind` 'posts': Always posts today.
    - `trigger` 'connect' | 'scheduled' | 'backfill'
    - `status` 'pending' | 'running' | 'completed' | 'failed'
    - `started_at` string, nullable: ISO 8601 timestamp when the run began.
    - `completed_at` string, nullable: ISO 8601 timestamp when it finished or failed.
    - `posts_seen` integer: Posts the platform returned across the run.
    - `posts_imported` integer: Posts that were new and got created. Lower than posts_seen whenever the run re-read posts you already have.
    - `backfill_from` string, nullable: The date floor requested. null for connect and scheduled runs.
    - `oldest_posted_at` string, nullable: Publish date of the oldest post the run reached - how far back it has walked.
    - `error` string, nullable: Platform error message when status is failed.
    - `created_at` string: ISO 8601 timestamp.

## Other responses

- `401`: Invalid, missing, or insufficient API key permissions.

---

[API](https://skmtc.dev/postproxy/apis/postproxy-social-media-api.md) - [All operations](https://skmtc.dev/postproxy/apis/postproxy-social-media-api/llms.txt) - [OpenAPI document](https://skmtc.dev/postproxy/apis/postproxy-social-media-api/revisions/d54482ac4ce7?raw)