Get Started
Developer API

Swagger API Reference

Browse and try the routes registered by this application. Sign in with an API token to call protected endpoints.

Authorize requests

Run POST /auth/token with your own account email and password. Copy the returned token, select Authorize, and enter the token. Passwords are entered only in the request and are not saved in this page.

Tokens expire after 8 hours. Public location endpoints need no token; role and permission checks still apply to protected routes.

Quickstart

Make your first authenticated call in under 2 minutes.

curl https://globalbusiness.veerit.com/api/suppliers \
    -H "ApiToken: Bearer YOUR_TOKEN" \
    -H "Accept: application/json"

Authentication

Send API tokens with the ApiToken header using the Bearer scheme. Generate keys in your dashboard.

ApiToken: Bearer YOUR_TOKEN

The standard Authorization bearer header is also accepted when your hosting environment allows it.

API Reference

Suppliers

GET/v1/suppliersList suppliers
GET/v1/suppliers/{id}Retrieve supplier

Products

GET/v1/productsSearch catalog
POST/v1/productsCreate product

RFQs

GET/api/rfqsList RFQs visible to the authenticated role
POST/api/rfqsCreate a buyer RFQ draft
GET/api/rfqs/{rfq}Retrieve an authorized RFQ
POST/api/rfqs/{rfq}/itemsAdd an item to a buyer's draft

RFQ creation accepts title, description, category_id, delivery location, required date, budget, currency, and submission deadline. The authenticated buyer profile is assigned by the server; clients must not submit a buyer ID.

Quotes

GET/api/rfqs/{rfq}/responsesList authorized supplier quotes
POST/api/rfqs/{rfq}/responsesSubmit a supplier quotation
POST/api/rfq-responses/{response}/acceptAccept a quote as its RFQ buyer

All RFQ and quote endpoints require a Sanctum bearer token. Buyers see their own RFQs and quotes; suppliers see open RFQs and only their own submitted quotes.

Orders

POST/v1/ordersCreate order
DELETE/v1/orders/{id}Cancel order

Webhooks

Subscribe to events like quote.accepted, order.shipped, supplier.verified.

{
    "event": "order.shipped",
    "data": { "order_id": "ord_9F2A", "carrier": "DHL", "tracking": "1Z999..." }
  }

Rate limits

Default: 600 requests/minute per API key. Enterprise plans unlock higher throughput.