List exceptions

GET /api/v1/exceptions read:inventory

Lists operational exceptions affecting your account — intake discrepancies, fulfillment exceptions, mis-picks, lost or damaged inventory — newest detected first. Response windows are set by your agreement and are shorter for fulfillment_exception than for the other kinds; sla_due_at reflects the applicable window (business days, warehouse local time). A subtype of api_issue marks an exception opened automatically by an API failure on one of your writes — the same event surfaced by GET /integration-status. Only MATERIAL intake discrepancies and fulfillment exceptions count toward the monthly report; minor ones are recorded here but excluded there.

Try it GET /api/v1/exceptions?limit=10

These inputs are shared across all docs pages, so an id entered here carries over.

response

Not run yet. Press Run to make a live call against https://service.rip.fun (through this demo's server-side proxy; the API key never reaches the browser).

curl (tracks the inputs above)
curl -X GET 'https://service.rip.fun/api/v1/exceptions?limit=10' \
  -H 'X-API-Key: rip_…'

Request fields

FieldTypeRequiredDescription
kindquery stringintake_discrepancy | fulfillment_exception | mis_pick | lost_or_damaged — matched exactly; an unrecognized value returns 400 listing the accepted ones
statusquery stringOPEN | INVESTIGATING | RESOLVED
limit / offsetquery intlimit 1..100 default 50; offset 0..10_000 default 0. Non-integer values are a 400 (invalid_pagination). The response carries a pagination object { limit, offset, has_more, next_offset } beside the array

Response fields (data)

FieldDescription
exceptions[].id / kind / subtype / severity / statusseverity "minor" | "material"; status OPEN | INVESTIGATING | RESOLVED
exceptions[].tenant_card_id / tenant_order_id / quantity / detailWhat the exception is about
exceptions[].detected_at / sla_due_at / reported_to_tenant_atWhen detected + the response deadline
exceptions[].resolution / resolved_atSet once RESOLVED

Errors

StatusCodeWhen
400invalid filterkind or status is not one of the accepted values

See Errors for the response envelope and the full code list.