HelloBooks / Agents

Build and connect

All HelloBooks APIs, in one place.

Find an endpoint, inspect its parameters, and open its documentation. Browse public data here or connect a company through the authenticated accounting API.

31 public endpoints43 MCP tools491 accounting operations

Find an accountantCatalog JSONAccounting OpenAPIDeveloper quickstart
Clear filters

565 matching APIs

Authenticated accounting

Delete customerContactPersons record(s)

DELETE /public/v1/orgs/{orgId}/entities/{entityId}/customerContactPersons

Mounted by the generic resource factory in `routes/publicApi.routes.js` from the registry row `customerContactPersons` in `routes/publicApi.resources.js`. The request is delegated to the SAME internal controller a signed-in user hits (`controllers/GRPC/Accounting/customerContactPerson.grpc` → `deleteCustomerContactPersons`), so it inherits that controller's validation, server-side tax computation and audit trail. Guards applied, in order: bearer token (`marketplace_app` audience) → plan API-access entitlement → rate limit → AI-credit metering → permission context of the installing user → tenant path match → `requireScope("contacts:write")`.

OAuth 2.0; company authorization and operation scopes required

Authenticated accounting

Restore archived customerContactPersons record(s)

PUT /public/v1/orgs/{orgId}/entities/{entityId}/customerContactPersons/restore

Mounted by the generic resource factory in `routes/publicApi.routes.js` from the registry row `customerContactPersons` in `routes/publicApi.resources.js`. The request is delegated to the SAME internal controller a signed-in user hits (`controllers/GRPC/Accounting/customerContactPerson.grpc` → `restoreCustomerContactPersons`), so it inherits that controller's validation, server-side tax computation and audit trail. Guards applied, in order: bearer token (`marketplace_app` audience) → plan API-access entitlement → rate limit → AI-credit metering → permission context of the installing user → tenant path match → `requireScope("contacts:write")`.

OAuth 2.0; company authorization and operation scopes required

Authenticated accounting

Fetch one customerContactPersons record by id

GET /public/v1/orgs/{orgId}/entities/{entityId}/customerContactPersons/{id}

Mounted by the generic resource factory in `routes/publicApi.routes.js` from the registry row `customerContactPersons` in `routes/publicApi.resources.js`. The request is delegated to the SAME internal controller a signed-in user hits (`controllers/GRPC/Accounting/customerContactPerson.grpc` → `getCustomerContactPersonById`), so it inherits that controller's validation, server-side tax computation and audit trail. Guards applied, in order: bearer token (`marketplace_app` audience) → plan API-access entitlement → rate limit → AI-credit metering → permission context of the installing user → tenant path match → `requireScope("contacts:read")`.

OAuth 2.0; company authorization and operation scopes required

Authenticated accounting

Create customerCreditCard record(s)

POST /public/v1/orgs/{orgId}/entities/{entityId}/customerCreditCard

Mounted by the generic resource factory in `routes/publicApi.routes.js` from the registry row `customerCreditCard` in `routes/publicApi.resources.js`. The request is delegated to the SAME internal controller a signed-in user hits (`controllers/GRPC/Accounting/customerCreditCardDetail.grpc` → `createCustomerCreditCardDetails`), so it inherits that controller's validation, server-side tax computation and audit trail. Guards applied, in order: bearer token (`marketplace_app` audience) → plan API-access entitlement → rate limit → AI-credit metering → permission context of the installing user → tenant path match → `requireScope("paymentmethods:write")`.

OAuth 2.0; company authorization and operation scopes required

Authenticated accounting

Update customerCreditCard record(s)

PUT /public/v1/orgs/{orgId}/entities/{entityId}/customerCreditCard

Mounted by the generic resource factory in `routes/publicApi.routes.js` from the registry row `customerCreditCard` in `routes/publicApi.resources.js`. The request is delegated to the SAME internal controller a signed-in user hits (`controllers/GRPC/Accounting/customerCreditCardDetail.grpc` → `updateCustomerCreditCardDetails`), so it inherits that controller's validation, server-side tax computation and audit trail. Guards applied, in order: bearer token (`marketplace_app` audience) → plan API-access entitlement → rate limit → AI-credit metering → permission context of the installing user → tenant path match → `requireScope("paymentmethods:write")`.

OAuth 2.0; company authorization and operation scopes required

Authenticated accounting

Delete customerCreditCard record(s)

DELETE /public/v1/orgs/{orgId}/entities/{entityId}/customerCreditCard

Mounted by the generic resource factory in `routes/publicApi.routes.js` from the registry row `customerCreditCard` in `routes/publicApi.resources.js`. The request is delegated to the SAME internal controller a signed-in user hits (`controllers/GRPC/Accounting/customerCreditCardDetail.grpc` → `deleteCustomerCreditCardDetails`), so it inherits that controller's validation, server-side tax computation and audit trail. Guards applied, in order: bearer token (`marketplace_app` audience) → plan API-access entitlement → rate limit → AI-credit metering → permission context of the installing user → tenant path match → `requireScope("paymentmethods:write")`.

OAuth 2.0; company authorization and operation scopes required

Authenticated accounting

Restore archived customerCreditCard record(s)

PUT /public/v1/orgs/{orgId}/entities/{entityId}/customerCreditCard/restore

Mounted by the generic resource factory in `routes/publicApi.routes.js` from the registry row `customerCreditCard` in `routes/publicApi.resources.js`. The request is delegated to the SAME internal controller a signed-in user hits (`controllers/GRPC/Accounting/customerCreditCardDetail.grpc` → `restoreCustomerCreditCardDetails`), so it inherits that controller's validation, server-side tax computation and audit trail. Guards applied, in order: bearer token (`marketplace_app` audience) → plan API-access entitlement → rate limit → AI-credit metering → permission context of the installing user → tenant path match → `requireScope("paymentmethods:write")`.

OAuth 2.0; company authorization and operation scopes required

Authenticated accounting

Fetch one customerCreditCard record by id

GET /public/v1/orgs/{orgId}/entities/{entityId}/customerCreditCard/{id}

Mounted by the generic resource factory in `routes/publicApi.routes.js` from the registry row `customerCreditCard` in `routes/publicApi.resources.js`. The request is delegated to the SAME internal controller a signed-in user hits (`controllers/GRPC/Accounting/customerCreditCardDetail.grpc` → `getCustomerCreditCardDetailById`), so it inherits that controller's validation, server-side tax computation and audit trail. Guards applied, in order: bearer token (`marketplace_app` audience) → plan API-access entitlement → rate limit → AI-credit metering → permission context of the installing user → tenant path match → `requireScope("paymentmethods:read")`.

OAuth 2.0; company authorization and operation scopes required

Authenticated accounting

Create customerDebitCard record(s)

POST /public/v1/orgs/{orgId}/entities/{entityId}/customerDebitCard

Mounted by the generic resource factory in `routes/publicApi.routes.js` from the registry row `customerDebitCard` in `routes/publicApi.resources.js`. The request is delegated to the SAME internal controller a signed-in user hits (`controllers/GRPC/Accounting/customerDebitCardDetail.grpc` → `createCustomerDebitCardDetails`), so it inherits that controller's validation, server-side tax computation and audit trail. Guards applied, in order: bearer token (`marketplace_app` audience) → plan API-access entitlement → rate limit → AI-credit metering → permission context of the installing user → tenant path match → `requireScope("paymentmethods:write")`.

OAuth 2.0; company authorization and operation scopes required

Authenticated accounting

Update customerDebitCard record(s)

PUT /public/v1/orgs/{orgId}/entities/{entityId}/customerDebitCard

Mounted by the generic resource factory in `routes/publicApi.routes.js` from the registry row `customerDebitCard` in `routes/publicApi.resources.js`. The request is delegated to the SAME internal controller a signed-in user hits (`controllers/GRPC/Accounting/customerDebitCardDetail.grpc` → `updateCustomerDebitCardDetails`), so it inherits that controller's validation, server-side tax computation and audit trail. Guards applied, in order: bearer token (`marketplace_app` audience) → plan API-access entitlement → rate limit → AI-credit metering → permission context of the installing user → tenant path match → `requireScope("paymentmethods:write")`.

OAuth 2.0; company authorization and operation scopes required

Authenticated accounting

Delete customerDebitCard record(s)

DELETE /public/v1/orgs/{orgId}/entities/{entityId}/customerDebitCard

Mounted by the generic resource factory in `routes/publicApi.routes.js` from the registry row `customerDebitCard` in `routes/publicApi.resources.js`. The request is delegated to the SAME internal controller a signed-in user hits (`controllers/GRPC/Accounting/customerDebitCardDetail.grpc` → `deleteCustomerDebitCardDetails`), so it inherits that controller's validation, server-side tax computation and audit trail. Guards applied, in order: bearer token (`marketplace_app` audience) → plan API-access entitlement → rate limit → AI-credit metering → permission context of the installing user → tenant path match → `requireScope("paymentmethods:write")`.

OAuth 2.0; company authorization and operation scopes required

Authenticated accounting

Restore archived customerDebitCard record(s)

PUT /public/v1/orgs/{orgId}/entities/{entityId}/customerDebitCard/restore

Mounted by the generic resource factory in `routes/publicApi.routes.js` from the registry row `customerDebitCard` in `routes/publicApi.resources.js`. The request is delegated to the SAME internal controller a signed-in user hits (`controllers/GRPC/Accounting/customerDebitCardDetail.grpc` → `restoreCustomerDebitCardDetails`), so it inherits that controller's validation, server-side tax computation and audit trail. Guards applied, in order: bearer token (`marketplace_app` audience) → plan API-access entitlement → rate limit → AI-credit metering → permission context of the installing user → tenant path match → `requireScope("paymentmethods:write")`.

OAuth 2.0; company authorization and operation scopes required

Authenticated accounting

Fetch one customerDebitCard record by id

GET /public/v1/orgs/{orgId}/entities/{entityId}/customerDebitCard/{id}

Mounted by the generic resource factory in `routes/publicApi.routes.js` from the registry row `customerDebitCard` in `routes/publicApi.resources.js`. The request is delegated to the SAME internal controller a signed-in user hits (`controllers/GRPC/Accounting/customerDebitCardDetail.grpc` → `getCustomerDebitCardDetailById`), so it inherits that controller's validation, server-side tax computation and audit trail. Guards applied, in order: bearer token (`marketplace_app` audience) → plan API-access entitlement → rate limit → AI-credit metering → permission context of the installing user → tenant path match → `requireScope("paymentmethods:read")`.

OAuth 2.0; company authorization and operation scopes required

Authenticated accounting

List customerGroup records

GET /public/v1/orgs/{orgId}/entities/{entityId}/customerGroup

Mounted by the generic resource factory in `routes/publicApi.routes.js` from the registry row `customerGroup` in `routes/publicApi.resources.js`. The request is delegated to the SAME internal controller a signed-in user hits (`controllers/GRPC/Accounting/customerGroup.grpc` → `getCustomerGroups`), so it inherits that controller's validation, server-side tax computation and audit trail. Guards applied, in order: bearer token (`marketplace_app` audience) → plan API-access entitlement → rate limit → AI-credit metering → permission context of the installing user → tenant path match → `requireScope("contacts:read")`.

OAuth 2.0; company authorization and operation scopes required

Authenticated accounting

Create customerGroup record(s)

POST /public/v1/orgs/{orgId}/entities/{entityId}/customerGroup

Mounted by the generic resource factory in `routes/publicApi.routes.js` from the registry row `customerGroup` in `routes/publicApi.resources.js`. The request is delegated to the SAME internal controller a signed-in user hits (`controllers/GRPC/Accounting/customerGroup.grpc` → `createCustomerGroups`), so it inherits that controller's validation, server-side tax computation and audit trail. Guards applied, in order: bearer token (`marketplace_app` audience) → plan API-access entitlement → rate limit → AI-credit metering → permission context of the installing user → tenant path match → `requireScope("contacts:write")`.

OAuth 2.0; company authorization and operation scopes required

Authenticated accounting

Update customerGroup record(s)

PUT /public/v1/orgs/{orgId}/entities/{entityId}/customerGroup

Mounted by the generic resource factory in `routes/publicApi.routes.js` from the registry row `customerGroup` in `routes/publicApi.resources.js`. The request is delegated to the SAME internal controller a signed-in user hits (`controllers/GRPC/Accounting/customerGroup.grpc` → `updateCustomerGroups`), so it inherits that controller's validation, server-side tax computation and audit trail. Guards applied, in order: bearer token (`marketplace_app` audience) → plan API-access entitlement → rate limit → AI-credit metering → permission context of the installing user → tenant path match → `requireScope("contacts:write")`.

OAuth 2.0; company authorization and operation scopes required

Authenticated accounting

Delete customerGroup record(s)

DELETE /public/v1/orgs/{orgId}/entities/{entityId}/customerGroup

Mounted by the generic resource factory in `routes/publicApi.routes.js` from the registry row `customerGroup` in `routes/publicApi.resources.js`. The request is delegated to the SAME internal controller a signed-in user hits (`controllers/GRPC/Accounting/customerGroup.grpc` → `deleteCustomerGroups`), so it inherits that controller's validation, server-side tax computation and audit trail. Guards applied, in order: bearer token (`marketplace_app` audience) → plan API-access entitlement → rate limit → AI-credit metering → permission context of the installing user → tenant path match → `requireScope("contacts:write")`.

OAuth 2.0; company authorization and operation scopes required

Authenticated accounting

Restore archived customerGroup record(s)

PUT /public/v1/orgs/{orgId}/entities/{entityId}/customerGroup/restore

Mounted by the generic resource factory in `routes/publicApi.routes.js` from the registry row `customerGroup` in `routes/publicApi.resources.js`. The request is delegated to the SAME internal controller a signed-in user hits (`controllers/GRPC/Accounting/customerGroup.grpc` → `restoreCustomerGroups`), so it inherits that controller's validation, server-side tax computation and audit trail. Guards applied, in order: bearer token (`marketplace_app` audience) → plan API-access entitlement → rate limit → AI-credit metering → permission context of the installing user → tenant path match → `requireScope("contacts:write")`.

OAuth 2.0; company authorization and operation scopes required

Authenticated accounting

Fetch one customerGroup record by id

GET /public/v1/orgs/{orgId}/entities/{entityId}/customerGroup/{id}

Mounted by the generic resource factory in `routes/publicApi.routes.js` from the registry row `customerGroup` in `routes/publicApi.resources.js`. The request is delegated to the SAME internal controller a signed-in user hits (`controllers/GRPC/Accounting/customerGroup.grpc` → `getCustomerGroupById`), so it inherits that controller's validation, server-side tax computation and audit trail. Guards applied, in order: bearer token (`marketplace_app` audience) → plan API-access entitlement → rate limit → AI-credit metering → permission context of the installing user → tenant path match → `requireScope("contacts:read")`.

OAuth 2.0; company authorization and operation scopes required

Authenticated accounting

List customers (hand-written route)

GET /public/v1/orgs/{orgId}/entities/{entityId}/customers

Predates the generic factory. NOTE THE PLURAL: the factory's registry seg is `customer` (singular), so `GET .../customer` and `GET .../customers` are two different live routes reaching the same controller. This one has no field contract and is declared in UNCONTRACTED_ROUTE_PREFIXES. DECLARED FIELD-CONTRACT GAP: this route is listed in `UNCONTRACTED_ROUTE_PREFIXES` in `middlewares/publicApiSerialize.middleware.js`. The response field allowlist does not apply to it; only the deny-key floor does. It is named here rather than omitted.

OAuth 2.0; company authorization and operation scopes required

Authenticated accounting

Create customers (hand-written route)

POST /public/v1/orgs/{orgId}/entities/{entityId}/customers

Predates the generic factory; see the GET. The route normalises a bare object or a bare array into `{ Customers: [...] }` before calling the internal controller, so all three body forms are accepted. DECLARED FIELD-CONTRACT GAP: this route is listed in `UNCONTRACTED_ROUTE_PREFIXES` in `middlewares/publicApiSerialize.middleware.js`. The response field allowlist does not apply to it; only the deny-key floor does. It is named here rather than omitted.

OAuth 2.0; company authorization and operation scopes required

Authenticated accounting

List deliveryChallan records

GET /public/v1/orgs/{orgId}/entities/{entityId}/deliveryChallan

Mounted by the generic resource factory in `routes/publicApi.routes.js` from the registry row `deliveryChallan` in `routes/publicApi.resources.js`. The request is delegated to the SAME internal controller a signed-in user hits (`controllers/GRPC/Accounting/deliveryChallan.grpc` → `getDeliveryChallans`), so it inherits that controller's validation, server-side tax computation and audit trail. Guards applied, in order: bearer token (`marketplace_app` audience) → plan API-access entitlement → rate limit → AI-credit metering → permission context of the installing user → tenant path match → `requireScope("sales:read")`.

OAuth 2.0; company authorization and operation scopes required

Authenticated accounting

Create deliveryChallan record(s)

POST /public/v1/orgs/{orgId}/entities/{entityId}/deliveryChallan

Mounted by the generic resource factory in `routes/publicApi.routes.js` from the registry row `deliveryChallan` in `routes/publicApi.resources.js`. The request is delegated to the SAME internal controller a signed-in user hits (`controllers/GRPC/Accounting/deliveryChallan.grpc` → `createDeliveryChallans`), so it inherits that controller's validation, server-side tax computation and audit trail. Guards applied, in order: bearer token (`marketplace_app` audience) → plan API-access entitlement → rate limit → AI-credit metering → permission context of the installing user → tenant path match → `requireScope("sales:write")`.

OAuth 2.0; company authorization and operation scopes required

Authenticated accounting

Update deliveryChallan record(s)

PUT /public/v1/orgs/{orgId}/entities/{entityId}/deliveryChallan

Mounted by the generic resource factory in `routes/publicApi.routes.js` from the registry row `deliveryChallan` in `routes/publicApi.resources.js`. The request is delegated to the SAME internal controller a signed-in user hits (`controllers/GRPC/Accounting/deliveryChallan.grpc` → `updateDeliveryChallans`), so it inherits that controller's validation, server-side tax computation and audit trail. Guards applied, in order: bearer token (`marketplace_app` audience) → plan API-access entitlement → rate limit → AI-credit metering → permission context of the installing user → tenant path match → `requireScope("sales:write")`.

OAuth 2.0; company authorization and operation scopes required

Authenticated accounting

Delete deliveryChallan record(s)

DELETE /public/v1/orgs/{orgId}/entities/{entityId}/deliveryChallan

Mounted by the generic resource factory in `routes/publicApi.routes.js` from the registry row `deliveryChallan` in `routes/publicApi.resources.js`. The request is delegated to the SAME internal controller a signed-in user hits (`controllers/GRPC/Accounting/deliveryChallan.grpc` → `deleteDeliveryChallans`), so it inherits that controller's validation, server-side tax computation and audit trail. Guards applied, in order: bearer token (`marketplace_app` audience) → plan API-access entitlement → rate limit → AI-credit metering → permission context of the installing user → tenant path match → `requireScope("sales:write")`.

OAuth 2.0; company authorization and operation scopes required

Authenticated accounting

Restore archived deliveryChallan record(s)

PUT /public/v1/orgs/{orgId}/entities/{entityId}/deliveryChallan/restore

Mounted by the generic resource factory in `routes/publicApi.routes.js` from the registry row `deliveryChallan` in `routes/publicApi.resources.js`. The request is delegated to the SAME internal controller a signed-in user hits (`controllers/GRPC/Accounting/deliveryChallan.grpc` → `restoreDeliveryChallans`), so it inherits that controller's validation, server-side tax computation and audit trail. Guards applied, in order: bearer token (`marketplace_app` audience) → plan API-access entitlement → rate limit → AI-credit metering → permission context of the installing user → tenant path match → `requireScope("sales:write")`.

OAuth 2.0; company authorization and operation scopes required

Authenticated accounting

Fetch one deliveryChallan record by id

GET /public/v1/orgs/{orgId}/entities/{entityId}/deliveryChallan/{id}

Mounted by the generic resource factory in `routes/publicApi.routes.js` from the registry row `deliveryChallan` in `routes/publicApi.resources.js`. The request is delegated to the SAME internal controller a signed-in user hits (`controllers/GRPC/Accounting/deliveryChallan.grpc` → `getDeliveryChallanById`), so it inherits that controller's validation, server-side tax computation and audit trail. Guards applied, in order: bearer token (`marketplace_app` audience) → plan API-access entitlement → rate limit → AI-credit metering → permission context of the installing user → tenant path match → `requireScope("sales:read")`.

OAuth 2.0; company authorization and operation scopes required

Authenticated accounting

Create deliveryChallanAddress record(s)

POST /public/v1/orgs/{orgId}/entities/{entityId}/deliveryChallanAddress

Mounted by the generic resource factory in `routes/publicApi.routes.js` from the registry row `deliveryChallanAddress` in `routes/publicApi.resources.js`. The request is delegated to the SAME internal controller a signed-in user hits (`controllers/GRPC/Accounting/deliveryChallanAddress.grpc` → `createDeliveryChallanAddresses`), so it inherits that controller's validation, server-side tax computation and audit trail. Guards applied, in order: bearer token (`marketplace_app` audience) → plan API-access entitlement → rate limit → AI-credit metering → permission context of the installing user → tenant path match → `requireScope("sales:write")`.

OAuth 2.0; company authorization and operation scopes required

Authenticated accounting

Update deliveryChallanAddress record(s)

PUT /public/v1/orgs/{orgId}/entities/{entityId}/deliveryChallanAddress

Mounted by the generic resource factory in `routes/publicApi.routes.js` from the registry row `deliveryChallanAddress` in `routes/publicApi.resources.js`. The request is delegated to the SAME internal controller a signed-in user hits (`controllers/GRPC/Accounting/deliveryChallanAddress.grpc` → `updateDeliveryChallanAddresses`), so it inherits that controller's validation, server-side tax computation and audit trail. Guards applied, in order: bearer token (`marketplace_app` audience) → plan API-access entitlement → rate limit → AI-credit metering → permission context of the installing user → tenant path match → `requireScope("sales:write")`.

OAuth 2.0; company authorization and operation scopes required

Authenticated accounting

Delete deliveryChallanAddress record(s)

DELETE /public/v1/orgs/{orgId}/entities/{entityId}/deliveryChallanAddress

Mounted by the generic resource factory in `routes/publicApi.routes.js` from the registry row `deliveryChallanAddress` in `routes/publicApi.resources.js`. The request is delegated to the SAME internal controller a signed-in user hits (`controllers/GRPC/Accounting/deliveryChallanAddress.grpc` → `deleteDeliveryChallanAddresses`), so it inherits that controller's validation, server-side tax computation and audit trail. Guards applied, in order: bearer token (`marketplace_app` audience) → plan API-access entitlement → rate limit → AI-credit metering → permission context of the installing user → tenant path match → `requireScope("sales:write")`.

OAuth 2.0; company authorization and operation scopes required

Authenticated accounting

Restore archived deliveryChallanAddress record(s)

PUT /public/v1/orgs/{orgId}/entities/{entityId}/deliveryChallanAddress/restore

Mounted by the generic resource factory in `routes/publicApi.routes.js` from the registry row `deliveryChallanAddress` in `routes/publicApi.resources.js`. The request is delegated to the SAME internal controller a signed-in user hits (`controllers/GRPC/Accounting/deliveryChallanAddress.grpc` → `restoreDeliveryChallanAddresses`), so it inherits that controller's validation, server-side tax computation and audit trail. Guards applied, in order: bearer token (`marketplace_app` audience) → plan API-access entitlement → rate limit → AI-credit metering → permission context of the installing user → tenant path match → `requireScope("sales:write")`.

OAuth 2.0; company authorization and operation scopes required

Authenticated accounting

Fetch one deliveryChallanAddress record by id

GET /public/v1/orgs/{orgId}/entities/{entityId}/deliveryChallanAddress/{id}

Mounted by the generic resource factory in `routes/publicApi.routes.js` from the registry row `deliveryChallanAddress` in `routes/publicApi.resources.js`. The request is delegated to the SAME internal controller a signed-in user hits (`controllers/GRPC/Accounting/deliveryChallanAddress.grpc` → `getDeliveryChallanAddressById`), so it inherits that controller's validation, server-side tax computation and audit trail. Guards applied, in order: bearer token (`marketplace_app` audience) → plan API-access entitlement → rate limit → AI-credit metering → permission context of the installing user → tenant path match → `requireScope("sales:read")`.

OAuth 2.0; company authorization and operation scopes required

Authenticated accounting

Create deliveryChallanLine record(s)

POST /public/v1/orgs/{orgId}/entities/{entityId}/deliveryChallanLine

Mounted by the generic resource factory in `routes/publicApi.routes.js` from the registry row `deliveryChallanLine` in `routes/publicApi.resources.js`. The request is delegated to the SAME internal controller a signed-in user hits (`controllers/GRPC/Accounting/deliveryChallanLine.grpc` → `createDeliveryChallanLines`), so it inherits that controller's validation, server-side tax computation and audit trail. Guards applied, in order: bearer token (`marketplace_app` audience) → plan API-access entitlement → rate limit → AI-credit metering → permission context of the installing user → tenant path match → `requireScope("sales:write")`.

OAuth 2.0; company authorization and operation scopes required

Authenticated accounting

Update deliveryChallanLine record(s)

PUT /public/v1/orgs/{orgId}/entities/{entityId}/deliveryChallanLine

Mounted by the generic resource factory in `routes/publicApi.routes.js` from the registry row `deliveryChallanLine` in `routes/publicApi.resources.js`. The request is delegated to the SAME internal controller a signed-in user hits (`controllers/GRPC/Accounting/deliveryChallanLine.grpc` → `updateDeliveryChallanLines`), so it inherits that controller's validation, server-side tax computation and audit trail. Guards applied, in order: bearer token (`marketplace_app` audience) → plan API-access entitlement → rate limit → AI-credit metering → permission context of the installing user → tenant path match → `requireScope("sales:write")`.

OAuth 2.0; company authorization and operation scopes required

Authenticated accounting

Delete deliveryChallanLine record(s)

DELETE /public/v1/orgs/{orgId}/entities/{entityId}/deliveryChallanLine

Mounted by the generic resource factory in `routes/publicApi.routes.js` from the registry row `deliveryChallanLine` in `routes/publicApi.resources.js`. The request is delegated to the SAME internal controller a signed-in user hits (`controllers/GRPC/Accounting/deliveryChallanLine.grpc` → `deleteDeliveryChallanLines`), so it inherits that controller's validation, server-side tax computation and audit trail. Guards applied, in order: bearer token (`marketplace_app` audience) → plan API-access entitlement → rate limit → AI-credit metering → permission context of the installing user → tenant path match → `requireScope("sales:write")`.

OAuth 2.0; company authorization and operation scopes required

Authenticated accounting

Restore archived deliveryChallanLine record(s)

PUT /public/v1/orgs/{orgId}/entities/{entityId}/deliveryChallanLine/restore

Mounted by the generic resource factory in `routes/publicApi.routes.js` from the registry row `deliveryChallanLine` in `routes/publicApi.resources.js`. The request is delegated to the SAME internal controller a signed-in user hits (`controllers/GRPC/Accounting/deliveryChallanLine.grpc` → `restoreDeliveryChallanLines`), so it inherits that controller's validation, server-side tax computation and audit trail. Guards applied, in order: bearer token (`marketplace_app` audience) → plan API-access entitlement → rate limit → AI-credit metering → permission context of the installing user → tenant path match → `requireScope("sales:write")`.

OAuth 2.0; company authorization and operation scopes required

Authenticated accounting

Fetch one deliveryChallanLine record by id

GET /public/v1/orgs/{orgId}/entities/{entityId}/deliveryChallanLine/{id}

Mounted by the generic resource factory in `routes/publicApi.routes.js` from the registry row `deliveryChallanLine` in `routes/publicApi.resources.js`. The request is delegated to the SAME internal controller a signed-in user hits (`controllers/GRPC/Accounting/deliveryChallanLine.grpc` → `getDeliveryChallanLineById`), so it inherits that controller's validation, server-side tax computation and audit trail. Guards applied, in order: bearer token (`marketplace_app` audience) → plan API-access entitlement → rate limit → AI-credit metering → permission context of the installing user → tenant path match → `requireScope("sales:read")`.

OAuth 2.0; company authorization and operation scopes required

Authenticated accounting

Next auto-number per document module

GET /public/v1/orgs/{orgId}/entities/{entityId}/document-sequence-numbers

Returns the next sequence number for Invoice, Bill, Quote, SalesOrder and the other numbered modules. Call this BEFORE a create: the internal controllers reject an invoice with no InvoiceNumber. Declared field-contract gap. DECLARED FIELD-CONTRACT GAP: this route is listed in `UNCONTRACTED_ROUTE_PREFIXES` in `middlewares/publicApiSerialize.middleware.js`. The response field allowlist does not apply to it; only the deny-key floor does. It is named here rather than omitted.

OAuth 2.0; company authorization and operation scopes required

Authenticated accounting

List employee records

GET /public/v1/orgs/{orgId}/entities/{entityId}/employee

Mounted by the generic resource factory in `routes/publicApi.routes.js` from the registry row `employee` in `routes/publicApi.resources.js`. The request is delegated to the SAME internal controller a signed-in user hits (`controllers/GRPC/Accounting/employee.grpc` → `getEmployees`), so it inherits that controller's validation, server-side tax computation and audit trail. Guards applied, in order: bearer token (`marketplace_app` audience) → plan API-access entitlement → rate limit → AI-credit metering → permission context of the installing user → tenant path match → `requireScope("payroll:read")`.

OAuth 2.0; company authorization and operation scopes required

Authenticated accounting

Create employee record(s)

POST /public/v1/orgs/{orgId}/entities/{entityId}/employee

Mounted by the generic resource factory in `routes/publicApi.routes.js` from the registry row `employee` in `routes/publicApi.resources.js`. The request is delegated to the SAME internal controller a signed-in user hits (`controllers/GRPC/Accounting/employee.grpc` → `createEmployees`), so it inherits that controller's validation, server-side tax computation and audit trail. Guards applied, in order: bearer token (`marketplace_app` audience) → plan API-access entitlement → rate limit → AI-credit metering → permission context of the installing user → tenant path match → `requireScope("payroll:write")`.

OAuth 2.0; company authorization and operation scopes required

Authenticated accounting

Update employee record(s)

PUT /public/v1/orgs/{orgId}/entities/{entityId}/employee

Mounted by the generic resource factory in `routes/publicApi.routes.js` from the registry row `employee` in `routes/publicApi.resources.js`. The request is delegated to the SAME internal controller a signed-in user hits (`controllers/GRPC/Accounting/employee.grpc` → `updateEmployees`), so it inherits that controller's validation, server-side tax computation and audit trail. Guards applied, in order: bearer token (`marketplace_app` audience) → plan API-access entitlement → rate limit → AI-credit metering → permission context of the installing user → tenant path match → `requireScope("payroll:write")`.

OAuth 2.0; company authorization and operation scopes required

Authenticated accounting

Delete employee record(s)

DELETE /public/v1/orgs/{orgId}/entities/{entityId}/employee

Mounted by the generic resource factory in `routes/publicApi.routes.js` from the registry row `employee` in `routes/publicApi.resources.js`. The request is delegated to the SAME internal controller a signed-in user hits (`controllers/GRPC/Accounting/employee.grpc` → `deleteEmployees`), so it inherits that controller's validation, server-side tax computation and audit trail. Guards applied, in order: bearer token (`marketplace_app` audience) → plan API-access entitlement → rate limit → AI-credit metering → permission context of the installing user → tenant path match → `requireScope("payroll:write")`.

OAuth 2.0; company authorization and operation scopes required

Authenticated accounting

Restore archived employee record(s)

PUT /public/v1/orgs/{orgId}/entities/{entityId}/employee/restore

Mounted by the generic resource factory in `routes/publicApi.routes.js` from the registry row `employee` in `routes/publicApi.resources.js`. The request is delegated to the SAME internal controller a signed-in user hits (`controllers/GRPC/Accounting/employee.grpc` → `restoreEmployees`), so it inherits that controller's validation, server-side tax computation and audit trail. Guards applied, in order: bearer token (`marketplace_app` audience) → plan API-access entitlement → rate limit → AI-credit metering → permission context of the installing user → tenant path match → `requireScope("payroll:write")`.

OAuth 2.0; company authorization and operation scopes required

Authenticated accounting

Fetch one employee record by id

GET /public/v1/orgs/{orgId}/entities/{entityId}/employee/{id}

Mounted by the generic resource factory in `routes/publicApi.routes.js` from the registry row `employee` in `routes/publicApi.resources.js`. The request is delegated to the SAME internal controller a signed-in user hits (`controllers/GRPC/Accounting/employee.grpc` → `getEmployeeById`), so it inherits that controller's validation, server-side tax computation and audit trail. Guards applied, in order: bearer token (`marketplace_app` audience) → plan API-access entitlement → rate limit → AI-credit metering → permission context of the installing user → tenant path match → `requireScope("payroll:read")`.

OAuth 2.0; company authorization and operation scopes required

Authenticated accounting

List employeeAddress records

GET /public/v1/orgs/{orgId}/entities/{entityId}/employeeAddress

Mounted by the generic resource factory in `routes/publicApi.routes.js` from the registry row `employeeAddress` in `routes/publicApi.resources.js`. The request is delegated to the SAME internal controller a signed-in user hits (`controllers/GRPC/Accounting/employeeAddress.grpc` → `getEmployeeAddresses`), so it inherits that controller's validation, server-side tax computation and audit trail. Guards applied, in order: bearer token (`marketplace_app` audience) → plan API-access entitlement → rate limit → AI-credit metering → permission context of the installing user → tenant path match → `requireScope("payroll:read")`.

OAuth 2.0; company authorization and operation scopes required

Authenticated accounting

Create employeeAddress record(s)

POST /public/v1/orgs/{orgId}/entities/{entityId}/employeeAddress

Mounted by the generic resource factory in `routes/publicApi.routes.js` from the registry row `employeeAddress` in `routes/publicApi.resources.js`. The request is delegated to the SAME internal controller a signed-in user hits (`controllers/GRPC/Accounting/employeeAddress.grpc` → `createEmployeeAddresses`), so it inherits that controller's validation, server-side tax computation and audit trail. Guards applied, in order: bearer token (`marketplace_app` audience) → plan API-access entitlement → rate limit → AI-credit metering → permission context of the installing user → tenant path match → `requireScope("payroll:write")`.

OAuth 2.0; company authorization and operation scopes required

Authenticated accounting

Update employeeAddress record(s)

PUT /public/v1/orgs/{orgId}/entities/{entityId}/employeeAddress

Mounted by the generic resource factory in `routes/publicApi.routes.js` from the registry row `employeeAddress` in `routes/publicApi.resources.js`. The request is delegated to the SAME internal controller a signed-in user hits (`controllers/GRPC/Accounting/employeeAddress.grpc` → `updateEmployeeAddresses`), so it inherits that controller's validation, server-side tax computation and audit trail. Guards applied, in order: bearer token (`marketplace_app` audience) → plan API-access entitlement → rate limit → AI-credit metering → permission context of the installing user → tenant path match → `requireScope("payroll:write")`.

OAuth 2.0; company authorization and operation scopes required

Authenticated accounting

Delete employeeAddress record(s)

DELETE /public/v1/orgs/{orgId}/entities/{entityId}/employeeAddress

Mounted by the generic resource factory in `routes/publicApi.routes.js` from the registry row `employeeAddress` in `routes/publicApi.resources.js`. The request is delegated to the SAME internal controller a signed-in user hits (`controllers/GRPC/Accounting/employeeAddress.grpc` → `deleteEmployeeAddresses`), so it inherits that controller's validation, server-side tax computation and audit trail. Guards applied, in order: bearer token (`marketplace_app` audience) → plan API-access entitlement → rate limit → AI-credit metering → permission context of the installing user → tenant path match → `requireScope("payroll:write")`.

OAuth 2.0; company authorization and operation scopes required

Authenticated accounting

Restore archived employeeAddress record(s)

PUT /public/v1/orgs/{orgId}/entities/{entityId}/employeeAddress/restore

Mounted by the generic resource factory in `routes/publicApi.routes.js` from the registry row `employeeAddress` in `routes/publicApi.resources.js`. The request is delegated to the SAME internal controller a signed-in user hits (`controllers/GRPC/Accounting/employeeAddress.grpc` → `restoreEmployeeAddresses`), so it inherits that controller's validation, server-side tax computation and audit trail. Guards applied, in order: bearer token (`marketplace_app` audience) → plan API-access entitlement → rate limit → AI-credit metering → permission context of the installing user → tenant path match → `requireScope("payroll:write")`.

OAuth 2.0; company authorization and operation scopes required

Authenticated accounting

Fetch one employeeAddress record by id

GET /public/v1/orgs/{orgId}/entities/{entityId}/employeeAddress/{id}

Mounted by the generic resource factory in `routes/publicApi.routes.js` from the registry row `employeeAddress` in `routes/publicApi.resources.js`. The request is delegated to the SAME internal controller a signed-in user hits (`controllers/GRPC/Accounting/employeeAddress.grpc` → `getEmployeeAddressById`), so it inherits that controller's validation, server-side tax computation and audit trail. Guards applied, in order: bearer token (`marketplace_app` audience) → plan API-access entitlement → rate limit → AI-credit metering → permission context of the installing user → tenant path match → `requireScope("payroll:read")`.

OAuth 2.0; company authorization and operation scopes required