GGCC API v1
Documentation Modules Swagger UI

Developer APIs

Gulf General Contracting Company — ERP platform APIs for HR, assets, finance, projects, and operations

Explore the API

Documentation Resources

Everything you need to integrate with the GGCC API

API Reference

Endpoints for auth, HR, assets, finance, projects, and operations — request and response shapes in OpenAPI.

View Reference

Authentication

JWT access and refresh tokens with role-based access control. Secure your requests with Bearer authorization.

Learn More

Getting Started

Base URL /api/v1 — register or login, then call protected routes with your token.

Open Swagger

Simple & Powerful

RESTful JSON APIs with consistent patterns across all ERP modules.

  • JWT-based authentication with RBAC

  • JSON request and response bodies

  • Structured error responses

  • Full audit logging on all write operations

API Request Example
POST /api/v1/auth/login
// Request body
{
"email": "user@ggcc.com",
"password": "********"
}
// Response (excerpt)
{
"accessToken": "eyJhbGciOiJIUzI1NiIs...",
"refreshToken": "...",
"data": { ... }
}

ERP Modules

Covering the full contracting lifecycle

Auth & RBAC

JWT sessions, role-based access control, and granular per-resource permissions.

HR & Payroll

Employees, departments, designations, leave, payroll runs, payslips, and advances.

Projects & Operations

Clients, projects, crossings, daily progress reports, material requests, and drilling logs.

Assets & Vehicles

Asset categories, maintenance records, PM schedules, TÜV certificates, vehicles, and KM logs.

Finance & Commercial

Invoices, payment receipts, bank accounts, tenders, contracts, purchase orders, and estimations.

Documents & Audit

Document folders, access control, file uploads, and full immutable audit logging across all modules.

Ready to Build?

Open Swagger UI for live docs and try requests against your environment.

Explore API Documentation