---
title: "Retrieve filtered content items by id in bulk, including restricted ones."
method: POST
path: "/mydelivery/v1/content/bulk_retrieve"
tags: ["Delivery content"]
---

# Retrieve filtered content items by id in bulk, including restricted ones.

`POST /mydelivery/v1/content/bulk_retrieve`

Returns an array of requested filtered content items. This route is restricted to authenticated users and allows to access restricted content items too.

Sample request body for retrieving id and title fields of two content items with id '7f2335cc-d91d-4f52-9e26-2d9402e463c0' and '1067771c-ec05-4671-951b-18f503953f2d':

    {
      "ids": ["7f2335cc-d91d-4f52-9e26-2d9402e463c0", "1067771c-ec05-4671-951b-18f503953f2d"],
      "fields": ["id", "title"]
    }

For each `content item` requested ..

* If a content item is not found for a specified `id`, the content retrieval for that id is skipped.
* If a specified `field` is not found in the content, it will not be present in the response.
* If no fields are specified for filtering, the whole content item is returned.
* The `ids` array cannot be empty and hence, there should be at least one id specified for lookup.
* A maximum of 25 content items can be retrieved at once. If the `ids` field is found to have more entries, only the first 25 content items requested are returned.
<br />User roles: admin, manager, editor, viewer, authenticatedVisitor

## Headers

- `Content-Type` string, required

## Request body

- object
  - `ids` string[], required — An array of ids that should be retrieved by this bulk request.
  - `fields` string[] — An array of fields that should be returned by this bulk request.

## Response `200`

Success

- object[] — An array of JSON objects that contain the requested content items.
  - `id` string — The ID of the content item.
  - `name` string — The name of the content item.
  - `description` string — The description text for this content item.
  - `classification` string — The classification defines the document type. For content items, all documents are classified as "content".
  - `typeId` string — The ID of the content type this item belongs to.
  - `locale` string — locale of the document (e.g "en", or "de").
  - `lastModified` string, date-time — The last modified date of this content item in ISO 8601 with the format YYYY-MM-DDTHH:mm:ss.sssZ.
  - `lastModifierId` string — name of user for now, this property may change once user management is defined.
  - `created` string, date-time — The created date of this content item in ISO 8601 with the format YYYY-MM-DDTHH:mm:ss.sssZ.
  - `creatorId` string — The Id of the user that created this content item.
  - `tags` string[] — The tags which has been set for this content item.
  - `elements` object — Defined by the type and capture in the schema given by the type, in a real content, this property will be filled with more information.
  - `kind` string[] — The tags which has been set by AI.
  - `type` string — This is the Id of the content type document this content is based on.

## Other responses

- `400` — Bad request
- `429` — Too Many Requests, the server has reached a limit, the request must be sent again at a later time.
- `default` — Unexpected error

---

[API](https://skmtc.net/goacoustic/apis/acoustic-content-api.md) · [All operations](https://skmtc.net/goacoustic/apis/acoustic-content-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/goacoustic/acoustic-content-api/revisions/677305266d89/schema)