GrivaOne REST API · v1

Build on the GrivaOne API

GrivaOne is a cloud ERP for sales, purchasing, inventory and accounting. The same REST API that powers the product is available to your own integrations — a predictable, JSON-over-HTTPS interface with token authentication. This reference documents the endpoints that exist today.

Base URL

https://gulfpay-production.up.railway.app/api/v1

Every route is served under the /api global prefix and URI version v1. All traffic is HTTPS and all bodies are JSON.

What you can do

  • Read and write customers, items and vendors
  • Create quotations, orders, invoices and delivery notes
  • Record receipts and payments against documents
  • Retry any write safely with an idempotency key
curl · quickstart
# 1. Log in to get an access token
curl -X POST https://gulfpay-production.up.railway.app/api/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{ "email": "you@company.com", "password": "your-password" }'

# 2. Call an authenticated endpoint with the token
curl https://gulfpay-production.up.railway.app/api/v1/customers \
  -H "Authorization: Bearer <ACCESS_TOKEN>"

Explore the reference

Quickstart

Get a token and make your first authenticated call in two requests.

Read more

Authentication

Log in for an access token and send it as a Bearer credential.

Read more

API keys

How machine access works today with bearer JWTs — and what is planned.

Read more

Making requests

JSON bodies, required headers and the standard response envelope.

Read more

Pagination & filtering

Page through list endpoints and narrow results with common filters.

Read more

Idempotent requests

Retry a write safely with an Idempotency-Key; the 409 replay contract.

Read more

Rate limits

Per-IP throttling, the global window and the stricter auth limits.

Read more

Errors

The standard error envelope and every HTTP status the API returns.

Read more

Versioning & deprecation

URI versioning under /v1 and how breaking changes are handled.

Read more

SDKs & code samples

The same call in cURL, JavaScript, Node, Python and PHP.

Read more

API console

Paste a token and run a real request against the live API in your browser.

Read more

Postman & OpenAPI

Import the OpenAPI 3 spec or the Postman collection to explore the API.

Read more

Endpoints

Auth, customers, items, sales, purchasing, payments and receipts.

Read more

Webhooks

The signature-verified payment-gateway webhook: verification & retries.

Read more

Changelog

Notable platform and API changes, newest first.

Read more

Status

Where to check live availability and past incidents.

Read more

Support

How to get help, what to include and where to reach the team.

Read more

Roadmap

What isn't in the public API yet — first-class API keys, SDKs and more.

Read more