# List pins and highlights

Returns pinned post IDs ordered by pin time (newest first). By default returns only top-level Pins (postOnly=true). Set postOnly=false to include reply Highlights as well. When ownerId is provided, returns pins for that scope owner after access checks.

Endpoint: GET /api/v1/posts/pins
Version: 1.0
Security: header

## Query parameters:

  - `ownerId` (string,null)
    Optional scope owner ID used to list pins in a specific scope (supported: USER, EVENT).
    Example: "us_01hxcvk1hjexere4pvtrj0ymqq"

  - `postOnly` (boolean,null)
    If true (default), return only top-level pins. If false, return both top-level pins and reply highlights.

## Response 401 fields (application/json):

  - `errorCode` (string, required)
    Error code

  - `message` (string, required)
    Error message

  - `docUrl` (string)
    Link to documentation

## Response 403 fields (application/json):

  - `errorCode` (string, required)
    Error code

  - `message` (string, required)
    Error message

  - `docUrl` (string)
    Link to documentation

## Response 404 fields (application/json):

  - `errorCode` (string, required)
    Error code

  - `message` (string, required)
    Error message

  - `docUrl` (string)
    Link to documentation