Account & fee config

GET /api/v1/account read:inventory

Your account profile and the fee and rate configuration currently in effect — the source of truth for every rate the other endpoints reference. All of these are per-account and set by your agreement; read them at runtime rather than hardcoding them.

Try it GET /api/v1/account
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/account' \
  -H 'X-API-Key: rip_…'

Response fields (data)

FieldDescription
account.id / name / slug / legal_nameAccount identity
account.billing_street1 … billing_countryBilling address on file
account.notice_emailWhere declared-value, exception and maintenance notices are emailed
account.term_started_at / inventory_scopeAgreement start + the inventory categories it covers
account.billing_currency / payment_terms_daysInvoice currency + days from issue to due date
account.redemption_rate_client_cents / redemption_rate_riphouse_centsPer-card redemption fee when YOU supply packaging vs when RIP.FUN does
account.packaging_supplier_default / packaging_low_stock_thresholdWhich rate applies by default + resupply alert threshold (null = no alerting)
account.intake_rate_cents / holding_rate_cents / holding_period_months / holding_free_periodsPer-card intake fee (charged once at scan-in, non-refundable) + storage fee per holding period and the free periods before billing starts
account.tax_rate_bps / tax_labelSales/use/VAT in basis points (825 = 8.25%), applied to fee lines only, never to pass-through. 0 = no tax
account.declared_value_threshold_centsAbove this, extra insurance/handling is billable pass-through (null = no threshold)
account.declared_value_auto_accept_max_centsDeclared values at or below this are accepted on submit without review (null = every submission is reviewed)

Errors

StatusCodeWhen
403Tenant API key requiredkey is not tenant-scoped, or lacks read:inventory

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