---
title: "Get multiple assets by IDs"
method: POST
path: "/v2/assets/batch"
tags: ["Assets"]
---

# Get multiple assets by IDs

`POST /v2/assets/batch`

## Request

- Base URL: `https://api.sync.so`
- URL: `https://api.sync.so/v2/assets/batch`
- Auth: API key in header `x-api-key`

## Request body

- BatchGetAssetsDto
  - `ids` union, required
    - string
    - string[]

## Response `200`

List of assets

- AssetDto[]
  - `id` string, required
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required
  - `deletedAt` string, date-time, nullable, required
  - `name` string, nullable, required
  - `url` string, nullable, required
  - `size` number, nullable, required
  - `format` string, nullable, required
  - `type` 'AUDIO' | 'VIDEO' | 'IMAGE', required
  - `inputType` 'UPLOAD' | 'URL' | 'RECORD' | 'TTS' | 'EXTRACT' | 'DUB' | 'DUB_SOURCE' | 'PLATFORM_IMPORT' | 'DIALOGUE_EDIT' | 'PLUGIN_PREMIERE_FILE' | 'PLUGIN_PREMIERE_TIMELINE_SELECTION' | 'PLUGIN_RESOLVE_FILE' | 'PLUGIN_RESOLVE_TIMELINE_SELECTION', nullable, required
  - `durationSeconds` number, nullable, required
  - `thumbnailUrl` string, nullable, required
  - `visibility` 'USER' | 'ORGANIZATION', required
  - `userId` string, nullable, required
  - `apiKeyId` string, nullable, required
  - `organizationId` string, required
  - `width` number, nullable, required
  - `height` number, nullable, required
  - `proxyPath` string, nullable
  - `projectId` string, nullable

## Changes

- **2026-10-19** `f2122591bafb`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sync/apis/sync-api-v2/changes/v2/assets/batch/post.md)

---

[API](https://skmtc.dev/sync/apis/sync-api-v2.md) - [All operations](https://skmtc.dev/sync/apis/sync-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/sync/apis/sync-api-v2/revisions/26662c96c138?raw)