List Assets

Returns a paginated list of all assets belonging to the authenticated workspace. Results are ordered by creation date (newest first).

GET /v1/assets

assets:read

Query Parameters

Parameter	Type	Required	Default	Description
limit	integer	No	50	Number of assets to return (1 – 200).
offset	integer	No	0	Number of assets to skip for pagination.

Request Examples

curl

curl -X GET "https://xqr.co/api/v1/assets?limit=20&offset=0" \
  -H "Authorization: Bearer xqr_pk_a1b2c3d4.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

TypeScript

const params = new URLSearchParams({ limit: "20", offset: "0" });

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

const { data, meta } = await response.json();
console.log(`Fetched ${data.length} assets`);

Python

import httpx

response = httpx.get(
    "https://xqr.co/api/v1/assets",
    headers={
        "Authorization": "Bearer xqr_pk_a1b2c3d4.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    },
    params={"limit": 20, "offset": 0},
)

data = response.json()["data"]
print(f"Fetched {len(data)} assets")

Response

200 OK

An array of asset objects.

{
  "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"
    },
    {
      "id": "f7e8d9c0-b1a2-3456-7890-abcdef123456",
      "filename": "banner-summer.jpg",
      "mime_type": "image/jpeg",
      "file_size": 215040,
      "status": "confirmed",
      "is_public": false,
      "public_url": null,
      "tags": ["campaign"],
      "created_at": "2026-03-15T14:22:00Z",
      "updated_at": "2026-03-15T14:22:00Z"
    }
  ],
  "meta": {
    "request_id": "req_9a8b7c6d5e4f3210",
    "rate_limit": {
      "limit": 600,
      "remaining": 598,
      "reset": 1742572800
    }
  }
}