Get Send Planner Settings
GET/api/send-planner/settings
Get the account-wide send planner defaults.
send-plans:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Authentication: Bearer Personal Access Token with the send-plans:read scope. The token's user also needs permission to view the send planner.
Settings:
- reserve_days: days of self-fulfilled demand (orders you ship from your own warehouses: web store, eBay, Amazon FBM, wholesale…) kept back at the source warehouses.
- protect_local: when false only open orders and backorders are protected, not forecast demand.
- include_inbound_days: count open purchase / manufacturing orders arriving within this many days as sendable supply (0 = on hand only).
- velocity_window_days: sales window used for velocity.
- stale_inventory_hours: a network stock snapshot older than this fails the plan unless plan_anyway is set.
- hold_ttl_hours: how long a stock hold lasts before it expires if not handed to a draft.
- rounding_mode: nearest | down | up | none — default case-pack rounding.
- run_day_of_week (0 = Sunday … 6 = Saturday, null = off) and run_time (HH:MM): the weekly send run.
- run_auto_draft_clean_lines: on a send run, automatically draft lines with no exceptions.
- run_digest_user_ids: users who receive the send run's exception digest.
- transfer_destination_warehouse_ids: your own warehouses stocked by transfer (see Get Transfer Destinations).
- next_run_at: when the next weekly send run starts (ISO 8601, UTC), or null when none is scheduled.
Request
Responses
- 200
- 401
- 403
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.