Skip to content

Change cursor — products changed since a sequence number

GET
/v1/catalog/products/changes
curl --request GET \
--url 'https://api.oldsteelarsenal.com/v1/catalog/products/changes?since=&limit=5000' \
--header 'x-client-id: <x-client-id>' \
--header 'x-signature: <x-signature>' \
--header 'x-timestamp: <x-timestamp>'

Like /changes, across every distributor and by product: each product whose offers changed — or that an offer left on a UPC change — appears once. The cursor holds one sequence number per distributor (each house commits in sequence order; the global sequence does not): omit since on the first call, then pass back cursor while more. limit is per distributor. Scope: catalog:read.

since
Since
string
"" <= 500 characters
limit
Limit
integer
default: 5000 >= 1 <= 5000
x-client-id
Any of:
string
x-timestamp
Any of:
string
x-signature
Any of:
string

Successful Response

Media typeapplication/json
ProductChangesResponse
object
cursor
required
Cursor

One sequence number per distributor (rsr:120;ss:95) — pass it back as since.

string
keys
required
Keys
Array<string>
more
required
More
boolean
Examplegenerated
{
"cursor": "example",
"keys": [
"example"
],
"more": true
}

Validation Error

Media typeapplication/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
ctx
Context
object
input
Input
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
Examplegenerated
{
"detail": [
{
"ctx": {},
"input": "example",
"loc": [
"example"
],
"msg": "example",
"type": "example"
}
]
}