---
title: "List a user's posts"
method: GET
path: "/v1/{account_id}/users/{user_id}/posts"
tags: ["Posts"]
---

# List a user's posts

`GET /v1/{account_id}/users/{user_id}/posts`

## Request

- Base URL: `https://api.curviate.com`
- URL: `https://api.curviate.com/v1/{account_id}/users/{user_id}/posts`
- Auth: HTTP bearer

Returns posts authored by this account. Use `user_id="me"` for the caller's own account, or another LinkedIn user's identifier for read-only access. The activity feed (including reposts) semantics for a non-own user are unconfirmed pending live verification.

## Path parameters

- `account_id` string, required
- `user_id` string, required

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

Returns posts authored by this account (user_id="me") or another LinkedIn user, plus the next-page cursor. Post text is returned verbatim.

- object
  - `object` 'post_list': Response type discriminator.
  - `items` object[]: Page of posts.
    - `object` 'post': Response type discriminator.
    - `id` string: The post's own identifier as returned on this surface, use this value as the post_id path param on sub-resource endpoints. Its exact value can differ between two responses about the same post, so compare `urn` rather than `id` when you need to tell whether two responses describe one post.
    - `urn` string, nullable: Stable identifier for the post itself, in `urn:li:activity:ID` or `urn:li:ugcPost:ID` form. Unlike `id`, this value is the same however you reached the post, so compare it to decide whether two responses describe the same post; a comment's `parent_post.urn` joins to it directly. For a repost it names the post being reshared, so reshares of one post share a `urn` while each keeps its own `created_at`. It is also accepted as the post_id path param on every operation that takes one, reads and writes alike, exactly like `id` is. null when the post carries no resolvable identity, and two nulls are not a match: treat null as unknown, never as equal.
    - `share_url` string, nullable: Shareable URL for the post.
    - `title` string, nullable: Post title, or null if not set.
    - `text` string, nullable: Full post text (content pass-through, never stored).
    - `created_at` string, nullable: ISO-8601 UTC datetime this post was published, or null when it cannot be told reliably. Derived from the post's own activity identity, so it does not change with the route you used to reach it. null when the post carries no activity identity of its own (often a video or image post), never a guess. For a repost this is when the repost was made, not when the post it reshares was.
    - `comment_count` number, nullable: Total comment count, or null when the platform hides it.
    - `reactions` object[]: Per-reaction-type count buckets.
      - `type` 'like' | 'celebrate' | 'support' | 'love' | 'insightful' | 'funny': Reaction type (unified lowercase enum).
      - `count` number: Count of this reaction type on the post.
    - `reaction_count` number, nullable: Total reaction count, the sum of reactions[].count, or null when the platform hides it.
    - `repost_count` number, nullable: Total repost count, or null when the platform hides it.
    - `impressions_count` number, nullable: Total impression count, or null if not available.
    - `user_reacted` 'like' | 'celebrate' | 'support' | 'love' | 'insightful' | 'funny' | 'null', nullable: The authenticated account's own reaction (unified lowercase enum), or null if not reacted.
    - `author` object: Author of the post or comment. Two shapes reach this field, so read the display name as `name` when it is present and `display_name` otherwise.
      - `id` string: LinkedIn profile identifier.
      - `name` string: Author's display name. Absent on the shape that carries `display_name` instead.
      - `display_name` string: Author's display name. Absent on the shape that carries `name` instead.
      - `object` string: Author entity discriminator, on the shape that carries one.
      - `type` string: Author entity type (for example individual or organization), on the shape that carries one.
      - `profile_picture_url` string, nullable: Author's profile picture URL, or null if not set.
    - `written_by` object, nullable: The member who wrote the post (may differ from author for organization posts), or null.
    - `permissions` object, nullable: Interaction permissions for the authenticated account, or null.
      - `can_react` boolean: true if the account can react to this post.
      - `can_share` boolean: true if the account can share this post.
      - `can_post_comments` boolean: true if the account can comment on this post.
    - `is_repost` boolean: true if this post is a repost of another post.
    - `repost_id` string, nullable: id of the original post if is_repost is true, else null.
    - `reposted_by` object, nullable: Profile of the account that reposted, or null.
    - `repost_content` object, nullable: Embedded original post content for reposts, or null.
    - `attachments` object[]: Media attachments on the post.
    - `poll` object, nullable: Poll data if the post contains a poll, or null.
    - `specifics` object, nullable: Job-posting or article context on the post, present only when applicable.
  - `cursor` string, nullable: Next-page cursor; null on the last page.
  - `safety_warning` SafetyWarning: Present on a successful response when this account crossed an account-safety ceiling while the affected budget row is on the default warn posture. The action still happened. Field-identical to the BUDGET_EXHAUSTED error body except that blocked is false and hint.message describes the outcome, so one branch handles both postures and switching the account to enforce is a configuration change rather than a client rewrite.
    - `row` string, nullable, required: The budget row that breached, for example profile_views or pending_invites. Null when the breach is not about a row: an activity_window warning on an action that spends no budget of its own (editing a message, dismissing a notification, a Recruiter or Sales Navigator admin action) is still governed by the hours the account works in. Read hint.parameter for what to change; whenever this is null it names posture, because the activity window edges are set per action type and this action has none, so the levers that reach it are the account timezone and posture.
    - `reset_at` string, nullable, required: The instant the refusal lifts: the window roll on a ceiling refusal, the next window open on an activity-window one. Null in the two cases no clock frees, the pending_invites gauge and InMail credits (row inmail).
    - `hint` object, required
      - `parameter` string, required: The settable parameter on PATCH /v1/{account_id}/safety-policy.
      - `message` string, required: What the condition is and what changing that parameter would do. This is the one field whose text differs from the BUDGET_EXHAUSTED refusal: here it says the action went through, and on a ceiling breach how far past the ceiling this row now stands, rather than telling you to set posture to warn when it already is. Branch on parameter, reason and blocked, never on this text.
    - `reason` 'ceiling' | 'activity_window', required: Which rule was crossed. ceiling means the row's configured limit is spent; activity_window means the account is outside the hours it works in, which is a different fact with a different remedy. hint.parameter names the right setting for each.
    - `blocked` boolean, required: Always false here. True on the BUDGET_EXHAUSTED refusal carrying the same payload.

## Other responses

- `400`: limit out of range (1-50), malformed cursor, or an unknown query param (before/after are removed in v2).
- `401`: Missing or invalid API key.
- `404`: The account_id does not belong to this tenant (ACCOUNT_NOT_FOUND), or the user_id could not be resolved (RESOURCE_NOT_FOUND). An id whose connection was replaced or removed also stops resolving here, and it is already absent from the list, so re-read `GET /v1/accounts` for the current id.
- `429`: Rate limited, slow down and retry after the hinted delay.
- `500`: Internal error.
- `502`: A temporary error occurred. Please try again.
- `503`: Service unavailable.
- `504`: Gateway timeout.

---

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