Get Asset

Returns the full details of a single asset identified by its unique ID.

GET /v1/assets/{asset_id}

assets:read

Path Parameters

Parameter	Type	Required	Description
asset_id	string	Yes	The unique identifier of the asset (UUID).

Request Examples

curl

curl -X GET https://xqr.co/api/v1/assets/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  -H "Authorization: Bearer xqr_pk_a1b2c3d4.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

TypeScript

const assetId = "a1b2c3d4-e5f6-7890-abcd-ef1234567890";

const response = await fetch(`https://xqr.co/api/v1/assets/${assetId}`, {
  headers: {
    Authorization: "Bearer xqr_pk_a1b2c3d4.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  },
});

const { data } = await response.json();
console.log(data.filename); // "logo-dark.png"

Python

import httpx

asset_id = "a1b2c3d4-e5f6-7890-abcd-ef1234567890"

response = httpx.get(
    f"https://xqr.co/api/v1/assets/{asset_id}",
    headers={
        "Authorization": "Bearer xqr_pk_a1b2c3d4.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    },
)

data = response.json()["data"]
print(data["filename"])  # "logo-dark.png"

Response

200 OK

The asset object.

{
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "filename": "logo-dark.png",
    "mime_type": "image/png",
    "file_size": 48210,
    "status": "confirmed",
    "is_public": true,
    "public_url": "https://cdn.xqr.co/tenants/ws_abc/originals/a1b2c3d4.png",
    "tags": ["branding", "logo"],
    "created_at": "2026-03-18T10:15:00Z",
    "updated_at": "2026-03-19T08:30:00Z"
  },
  "meta": {
    "request_id": "req_1a2b3c4d5e6f7890",
    "rate_limit": {
      "limit": 600,
      "remaining": 597,
      "reset": 1742572800
    }
  }
}