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
565 matching APIs
Authenticated accountingDelete 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 accountingRestore 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 accountingFetch 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 accountingCreate 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 accountingUpdate 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 accountingDelete 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 accountingRestore 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 accountingFetch 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 accountingCreate 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 accountingUpdate 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 accountingDelete 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 accountingRestore 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 accountingFetch 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 accountingList 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 accountingCreate 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 accountingUpdate 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 accountingDelete 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 accountingRestore 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 accountingFetch 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 accountingList 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 accountingCreate 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 accountingList 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 accountingCreate 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 accountingUpdate 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 accountingDelete 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 accountingRestore 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 accountingFetch 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 accountingCreate 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 accountingUpdate 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 accountingDelete 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 accountingRestore 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 accountingFetch 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 accountingCreate 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 accountingUpdate 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 accountingDelete 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 accountingRestore 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 accountingFetch 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 accountingNext 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 accountingList 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 accountingCreate 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 accountingUpdate 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 accountingDelete 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 accountingRestore 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 accountingFetch 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 accountingList 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 accountingCreate 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 accountingUpdate 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 accountingDelete 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 accountingRestore 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 accountingFetch 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