API

REST API reference

Every endpoint that powers the iShipBiz dashboard is also available to your own apps. API access is included on Pro and Enterprise plans.

Authentication

POST
/api/auth/signup

Create a tenant + owner user + wallet + onboarding record.

POST
/api/auth/invite

Invite a staff user to your tenant.

GET
/api/auth/me

Returns current user, tenant, and role.

Rates & Labels

POST
/api/rates

Get EasyPost rates for a shipment. Server-only — your EasyPost key never leaves the backend.

POST
/api/labels/create

Buy postage. Atomic wallet deduction; rolls back on any failure.

POST
/api/labels/[id]/void

Void a label if within the carrier’s void window.

GET
/api/labels/[id]/pdf

Stream the label PDF.

POST
/api/labels/batch

Create a batch and trigger background processing.

GET
/api/labels/picklist

Generate a pick-list PDF for a list of order IDs.

Orders & CSV

GET
/api/orders

List orders with filter, sort, pagination.

POST
/api/orders

Create a manual order.

PATCH
/api/orders/[id]

Update an order (tags, notes, warehouse, hold).

POST
/api/csv/upload

Upload a CSV file to Storage and start validation.

GET
/api/csv/[importId]/status

Poll import progress.

POST
/api/csv/[importId]/confirm

Confirm and import validated rows.

Wallet

GET
/api/wallet

Current balance + recent transactions.

POST
/api/wallet/deposit/intent

Create a Stripe PaymentIntent for a wallet deposit.

GET
/api/wallet/transactions

Paginated wallet ledger.

Webhooks (inbound)

POST
/api/easypost/webhooks

Receives tracking updates and void confirmations from EasyPost.

POST
/api/stripe/webhooks

Handles payment_intent.succeeded, invoice events, subscription events.