G-Ledger

حساب الأستاذ — لكل القطاعات

Home Login

REST API v1

G-Ledger Public API v1

Connect your external systems (Odoo, Bayzat, Workday, etc.) directly to G-Ledger via REST API

Base URL

https://app.g-ledger.com/api/v1/

Authentication

All requests require an API key sent in the Authorization header as a Bearer Token. Get your key from Settings.

Authorization: Bearer glk_your_api_key_here

Get your API key from Settings→

Endpoints

Method	Endpoint	Description
GET	/api/v1/accounts	List chart of accounts
GET	/api/v1/journal-entries	List journal entries
POST	/api/v1/journal-entries	Create journal entry
GET	/api/v1/customers	List customers
POST	/api/v1/customers	Create customer
GET	/api/v1/vendors	List vendors
POST	/api/v1/vendors	Create vendor
GET	/api/v1/products	List products
POST	/api/v1/products	Create product
GET	/api/v1/invoices	List invoices
POST	/api/v1/invoices	Create invoice
GET	/api/v1/employees	List employees
GET	/api/v1/webhooks	List available webhook events
POST	/api/v1/webhooks	Register webhook to receive events

Response Format

All responses are JSON with a data field containing the results and a total field for count.

{ "data": [...], "total": 42, "page": 1, "limit": 50, "pages": 1 }

Pagination

Endpoints that support pagination accept page and limit parameters. Maximum limit is 100.

GET /api/v1/journal-entries?page=2&limit=25

Code Examples

GET Example

curl -X GET "https://app.g-ledger.com/api/v1/accounts" \
  -H "Authorization: Bearer glk_your_api_key_here" \
  -H "Content-Type: application/json"

POST Example

curl -X POST "https://app.g-ledger.com/api/v1/journal-entries" \
  -H "Authorization: Bearer glk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "date": "2026-03-30",
    "description": "Sales revenue",
    "lines": [
      { "accountId": "acc_cash", "debit": 1150, "credit": 0 },
      { "accountId": "acc_revenue", "debit": 0, "credit": 1000 },
      { "accountId": "acc_vat", "debit": 0, "credit": 150 }
    ]
  }'

Error Codes

Code	Description
401	Unauthorized — invalid or missing API key
400	Bad Request — missing or invalid data
404	Not Found — resource does not exist
429	Too Many Requests — wait before retrying
500	Server Error — try again later

Rate Limiting

100 requests per minute per API key. When exceeded, you will receive a 429 Too Many Requests response.

Ready to Integrate?

Start Free Get your API key from Settings