Polling: Returns

GET/api/v1/resources/returns

Read Returns through the same cursor contract for both initial and incremental sync.

Incremental reads with cursors

Do not send a cursor on the first request. Persist next_cursor and send it in the next request. Merge records idempotently by domain_id + id.

Required scope

returns.read

cURLJavaScriptPython

REQUEST

curl --request GET
  --url 'https://stage-integration.tica.tr/api/v1/resources/returns?limit=100&cursor=<NEXT_CURSOR>'
  --header 'Authorization: Bearer <INSTALLATION_ACCESS_TOKEN>'

Response

BodyHeaderscURL

JSON OUTPUT

{"data":[{"id":"returns_...","domain_id":42,"updated_at":"2026-08-10T16:00:00Z"}],"next_cursor":"eyJ1cGRhdGVkX2F0IjoiLi4uIn0","has_more":true}