---
search:
  tags:
    - Assets
    - GET
seo:
  description: >-
    Fetches one Asset in any status (pending, ready or failed), with its
    Registrations… Reference for the GET /library/assets/{id} endpoint in the
    AdCrunch API.
sidebar:
  label: Get one Asset
  badge: GET
title: Get one Asset
type: openapi-operation
---
Fetches one Asset in any status (`pending`, `ready` or `failed`), with its Registrations and a short-lived presigned `previewUrl` for the stored bytes of a `ready` Asset (`null` for a `pending` or `failed` Asset). An Asset belonging to another organization is reported as missing, so the surface cannot be used to discover that an id is real.

A read completes a reserved Asset. When the Asset is `pending` and its object exists, the read inspects the bytes and answers the Asset `ready` or `failed`. A read before the `PUT` answers `pending`: read again after the `PUT`.

This is also how a Registration is polled: `status` and `providerIdentifier` on each Registration settle here, and there is no separate status resource.

`GET /library/assets/{id}`

**Responses**

- `200` — The Asset, its Registrations, and a signed link to the bytes that expires in 15 minutes.
- `400` — The request does not match the schema of this operation: a field is missing or has the wrong type, or the body is not valid JSON. \`error\` is \`invalid\_request\`, and \`issues\` names each field. Nothing was changed.
- `401` — No API key, or one that does not resolve. See the security scheme. \`error\` is \`unauthorized\`.
- `402` — The organization has no active subscription. An owner subscribes at \`paywallUrl\`. \`error\` is \`organization\_unentitled\`.
- `403` — The caller does not hold \`asset:read\`. \`error\` is \`forbidden\`.
- `404` — No stored Asset with that id in this organization. \`error\` is \`not\_found\`.

Response example, 200:

```json
{
  "contentHash": "9d2f41b7c6e8a35014f7b2d9c3e6a810",
  "createdAt": 1790000000000,
  "createdBy": "usr_2e5b84",
  "deletedAt": null,
  "durationMs": 15000,
  "failureCode": null,
  "failureReason": null,
  "filename": "spring-sale.mp4",
  "height": 1920,
  "id": "ast_7c1e9a",
  "key": "org_3a7f10/ast_7c1e9a",
  "kind": "video",
  "mimeType": "video/mp4",
  "name": "Spring sale 9:16",
  "organizationId": "org_3a7f10",
  "sizeBytes": 24117248,
  "status": "ready",
  "updatedAt": 1790000120000,
  "width": 1080,
  "registrations": [
    {
      "advertiserId": "acc_1203456789012345",
      "assetId": "ast_7c1e9a",
      "createdAt": 1790000121000,
      "deletedAt": null,
      "failureCode": null,
      "failureReason": null,
      "id": "reg_4b81d2",
      "organizationId": "org_3a7f10",
      "provider": "meta",
      "providerIdentifier": "23843178520310445",
      "status": "ready",
      "updatedAt": 1790000249000,
      "uploadSessionId": "1264871528937461",
      "workflowId": "reg_4b81d2"
    }
  ],
  "previewUrl": "https://b7f3c81a29d64e0fa5c3d1e8b0947265.r2.cloudflarestorage.com/assets/org_3a7f10/ast_7c1e9a?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20260922T104000Z&X-Amz-Expires=900&X-Amz-SignedHeaders=host&X-Amz-Signature=2f9a7c1e4b8d6035a1c7e2b94f0d38615c9a7e3d2b4f81c60d5a3e9b7f1c4028"
}
```
