---
title: "Retrieve all posts"
method: GET
path: "/api/v2/organizations/{orgSlug}/posts"
tags: ["Posts"]
---

# Retrieve all posts

`GET /api/v2/organizations/{orgSlug}/posts`

## Request

- Base URL: `https://app.officernd.com`
- URL: `https://app.officernd.com/api/v2/organizations/{orgSlug}/posts`
- Auth: OAuth 2
  - Authorization code: `https://identity.officernd.com/auth/authorize`
  - Client credentials
  - Token URL: `https://identity.officernd.com/auth/token` scopes: `flex.collaboration.posts.read`

Retrieve all posts. 

 Required scopes: `flex.collaboration.posts.read`

## Path parameters

- `orgSlug` string, required

## Query parameters

- `_id` string[]
- `locations` string[]
- `modifiedAt` string
- `createdAt` string
- `$select` string
- `$cursorNext` string
- `$cursorPrev` string
- `$limit` number

## Response `200`

- object
  - `rangeStart` number
  - `rangeEnd` number
  - `cursorNext` string
  - `cursorPrev` string
  - `results` PostResultDto[]
    - `_id` string: The _id of the post.
    - `title` string: The title of the post.
    - `description` string: The content the post.
    - `locations` string[]: An array with the ids of all locations in which the post is visible.
    - `isPinned` boolean: Shows if the post is pinned to the top.
    - `type` 'info' | 'important' | 'event': The type of the post.
    - `url` string: An additional url that is shown in the post.
    - `image` string: The url of the image of the post.
    - `member` string: The _id of the member that created the post.
    - `company` string: The _id of the company that created the post.
    - `createdBy` string: The user that created the post.
    - `createdAt` string: The time when the post was created.

---

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