Skip to Content

Read what changed

Read several articles in one call, or page through every article that changed since a time.

Read several articles, or what changed since a time

GET/api/v1/assetsassets:read
  • ?articles=CH-1001,CH-1002: up to 100 article numbers. Ones we do not have are listed in unknown.
  • ?since=2026-10-20T00:00:00Z: every article that changed after that time, oldest change first, 100 a page. While nextCursor is not null, call again with the same since and cursor set to it.

Storing the time of your last read and asking for what changed since is the simplest way to stay in sync without events.

A product can appear in two runs in a row; write its current state, keyed on articleId.

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"

On this page