Skip to Content

Read many articles, or what changed

Needs the scope assets:read

Pass articles (up to 100, comma separated) to read several at once, or since to get every article that changed after that time, oldest change first, 100 a page. With since, keep calling with cursor set to nextCursor until it is null. A product can appear in two runs in a row; write its current state, keyed on articleId.

Query Parameters

articles?string

Up to 100 article numbers, comma separated.

since?string

An ISO 8601 time with a zone. Every article that changed after it.

Formatdate-time
cursor?string

With since: the nextCursor of the previous page.

Response Body

OK

application/json
  1. response
client*

The company the key belongs to.

assets*array<>
unknown*array<string>

Article numbers you asked for that we do not have.

nextCursor*|

Pass it as cursor for the next page. null when there is no more.

Example Request
curl -sS "https://platform.charpstar.co/api/v1/assets?articles=CH-1001,CH-1002" \  -H "Authorization: Bearer $CHARPSTAR_API_KEY"curl -sS "https://platform.charpstar.co/api/v1/assets?since=2026-10-20T00:00:00Z" \  -H "Authorization: Bearer $CHARPSTAR_API_KEY"
Example Response
{  "client": {    "id": "e2b7c1d4-5a6f-4b8c-9d0e-1f2a3b4c5d6e",    "name": "Your Company"  },  "assets": [    {      "articleId": "CH-1001",      "name": "Oslo lounge chair",      "status": "delivered",      "deliveryDate": "2026-10-20",      "updatedAt": "2026-10-20T09:30:00.000Z",      "glbUrl": "https://cdn.charpstar.net/YourCompany/Android/CH-1001.glb",      "usdzUrl": "https://cdn.charpstar.net/YourCompany/iOS/CH-1001.usdz",      "usdzReady": true,      "thumbnailUrl": "https://cdn.charpstar.net/YourCompany/Thumbnails/CH-1001.png",      "viewerUrl": "https://platform.charpstar.co/agent-viewer?glb=https%3A%2F%2Fcdn.charpstar.net%2FYourCompany%2FAndroid%2FCH-1001.glb&name=Oslo%20lounge%20chair&viewer=default",      "arUrl": "https://platform.charpstar.co/ar/0b6c9f0e-5d1a-4c47-9f4e-2a1d3c4b5e6f",      "embed": {        "dataClient": "YourCompany",        "dataArticleId": "CH-1001",        "snippet": "<script src=\"https://js.charpstar.net/V2/charpstAR-Base.js\" data-client=\"YourCompany\" data-language=\"en-gb\" defer></script>\n<charpstar-viewer data-articleid=\"CH-1001\"></charpstar-viewer>"      },      "images": [        {          "id": "8d2f4c1a-packshot",          "type": "packshot",          "variant": "Oak",          "url": "https://cdn.charpstar.net/YourCompany/Packshots/CH-1001-front.png",          "fileName": "CH-1001_packshot_front_1.png",          "width": 2048,          "height": 2048,          "bytes": 412331,          "createdAt": "2026-10-20T09:00:00.000Z",          "approved": true,          "primary": true,          "jobId": null        },        {          "id": "thumbnail:0b6c9f0e-5d1a-4c47-9f4e-2a1d3c4b5e6f",          "type": "thumbnail",          "variant": null,          "url": "https://cdn.charpstar.net/YourCompany/Thumbnails/CH-1001.png",          "fileName": "CH-1001_thumbnail_1.png",          "width": null,          "height": null,          "bytes": 88120,          "createdAt": "2026-10-20T08:55:00.000Z",          "approved": true,          "primary": false,          "jobId": null        }      ],      "variations": [        {          "articleId": "CH-1001-B",          "status": "in_production",          "thumbnailUrl": null,          "glbUrl": null        }      ]    }  ],  "unknown": [    "CH-1003"  ],  "nextCursor": null}

The result

An answer for a delivered article carries viewerUrl. This is that address for an article of our Demo company.

Resultlive from our Demo companyOpen
The viewer behind viewerUrl. Drag to turn the model.