visionHub API

API Reference · v1

visionHub API

JSON over HTTPS. Bearer token auth. Stable, versioned endpoints.

Base: https://api.visionhub.app/v1Auth: Bearer <token>Rate limit: 600 req/min99.98% uptime SLA

Authentication

POST/v1/auth/session

Create a session for the current user.

DELETE/v1/auth/session

Terminate the active session.

GET/v1/auth/me

Return the authenticated user profile.

{
  "id": "u_9f3", "role": "seller",
  "sellerId": "s_1", "email": "rafael@visionhub.app"
}

Sellers

POST/v1/sellers

GET/v1/sellers

List sellers. Supports ?status=pending|approved|rejected|blocked.

GET/v1/sellers/:id

Fetch a single seller.

PATCH/v1/sellers/:id/status

Approve, reject or block. Admin only.

{
  "status": "approved"
}

PATCH/v1/sellers/:id/commission

Override marketplace commission for this seller.

Products

GET/v1/products

Search products across the marketplace.

POST/v1/products

Create a product (seller only).

PATCH/v1/products/:id

Update fields.

DELETE/v1/products/:id

Delete a product.

Orders

POST/v1/orders

Place an order. Automatically split into suborders.

GET/v1/orders

Scoped to caller: customers get own, sellers get suborders, admins get all.

GET/v1/orders/:id

Fetch an order with its suborders.

PATCH/v1/orders/:id/suborders/:sellerId

Update fulfillment status.

{
  "status": "shipped",
  "trackingCode": "BR934821761"
}

Commissions & Settlements

GET/v1/commissions

Fetch global marketplace commission.

PUT/v1/commissions

Update global commission percent. Admin only.

GET/v1/settlements

List settlements (filter by sellerId).

POST/v1/settlements

Create a settlement entry for a seller balance.

PATCH/v1/settlements/:id/paid

Mark settlement as paid.

Shipping (Correios)

POST/v1/shipping/quote

Calculate shipping options for a CEP.

POST/v1/shipping/labels

Generate a shipping label for a suborder.

GET/v1/shipping/track/:code