ABCS Contacts API

1.0.0OAS 3.0
REST API for managing contacts in the ABCS Accounting system. ## Authentication Flow 1. Call `POST /api/token` with your `apiKey` and `secret`. 2. Use the returned JWT token on all protected endpoints as `Authorization: Bearer <token>`. 3. Each successful contacts endpoint response returns a new `nextToken` — use it on the next request. ## Rate Limiting All endpoints (except health check) have rate limiting. Response headers include: - `X-RateLimit-Limit` - `X-RateLimit-Remaining` - `X-RateLimit-Reset`
Servers
http://localhost:3000— Current server

Health

Service health check

GET/api/healthHealth Check

Authentication

Token generation

POST/api/tokenGenerate JWT Token

Contacts

Contact CRUD operations

GET/api/contactsList Contacts🔒
POST/api/contactsCreate Contact🔒
GET/api/contacts/{id}Get Contact by ID🔒
PUT/api/contacts/{id}Update Contact🔒
DELETE/api/contacts/{id}Delete Contact (Soft Delete)🔒

Accounts Receivable

Create Invoice / ARV billing. Status: -1 = pending, 0 = approved/posted. Server computes VAT, CWT, discount, and A/R lines from user `details`. Use GET /api/lookups/invoice for dropdown predict.

GET/api/invoice-requestsList Accounts Receivable🔒
POST/api/invoice-requestsCreate Pending Invoice (ARV)🔒
GET/api/invoice-requests/{id}Get Invoice Request by ID🔒
PUT/api/invoice-requests/{id}Update Pending Invoice Request🔒
DELETE/api/invoice-requests/{id}Delete Pending Invoice Request🔒

AP Requests

Bills to Pay (AP) pending CRUD. Status: -1 = pending, 0 = posted. Dropdown values (use GET /api/lookups/ap for search): - btpType: bill type name - btpBiller: contact ID - btpPayTerms / btpPayType: payment term and type codes - btpTag1–btpTag4: tag IDs (0 if unused) - details[].btpAcctCode: chart of accounts GL code - details[].btpATC: BIR ATC code (optional) - details[].btpEWTRate: 0, 0.005, 1, 2, 5, 10, 15

GET/api/ap-requestsList AP Requests🔒
POST/api/ap-requestsCreate Pending AP Request🔒
GET/api/ap-requests/{id}Get AP Request by ID🔒
PUT/api/ap-requests/{id}Update Pending AP Request🔒
DELETE/api/ap-requests/{id}Delete Pending AP Request🔒

Lookups

Dropdown search for docs Try-it-out and API callers

GET/api/lookups/invoiceInvoice dropdown lookup🔒
GET/api/lookups/apAP dropdown lookup🔒