REST API

API Reference

Integrate Venderaa into your applications using our simple, powerful REST API.

Authentication

All API requests must include your JWT in the Authorization header: Authorization: Bearer <token>

Base URL

https://venderaa.com

Authentication

POST
/api/auth/login

Authenticate a vendor and receive a JWT.

POST
/api/auth/register

Create a new vendor account.

POST
/api/auth/refresh

Refresh an expired access token.

POST
/api/auth/logout

Invalidate the current session token.

Products

GET
/api/products

List all products for the authenticated vendor.

POST
/api/products

Create a new product.

GET
/api/products/:id

Retrieve a single product by ID.

PUT
/api/products/:id

Update a product.

DELETE
/api/products/:id

Delete a product.

Orders

GET
/api/orders

List all orders for the authenticated vendor.

GET
/api/orders/:id

Get a specific order by ID.

PUT
/api/orders/:id/status

Update order status.

Store

GET
/api/store

Get the current vendor's store details.

PUT
/api/store

Update store settings.

GET
/api/stores/:slug

Public store data by slug.

Payments

POST
/api/payment/initiate

Start a payment session.

POST
/api/payment/verify

Verify a completed payment.

GET
/api/payments

List payment records.

Webhooks

Receive real-time notifications for events like new orders, payment confirmations and subscription changes by registering a webhook endpoint in your vendor dashboard.

order.createdorder.updatedpayment.successpayment.failedsubscription.renewedproduct.created

Need help integrating?

Our developer support team can help you get up and running fast.

Get Developer Support