Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/CodexaCP/DG_BACK/llms.txt

Use this file to discover all available pages before exploring further.

The Stock API provides read access to the current stock ledger (CurrentStock table) for a given tenant. Two endpoints are available — a minimal projection and an enriched projection that joins item, bin, and location metadata into every row.

GET /api/stock

Returns a paginated list of raw stock records for the authenticated company. Each record includes item ID, bin ID, and stock quantity. Use GET /api/stock/enriched when you need human-readable item numbers and location codes. Authentication: Authorization: Bearer <token> (required).
companyId
string (uuid)
Tenant company ID. Resolved from the JWT claims if omitted.
pageNumber
integer
1-based page number. Defaults to 1.
pageSize
integer
Records per page. Defaults to 20.
data
array
Paginated list of stock rows.
pageNumber
integer
Current page number.
pageSize
integer
Requested page size.
totalRecords
integer
Total number of stock records for the company.
totalPages
integer
Total number of pages.
curl -X GET "https://api.example.com/api/stock?companyId=3fa85f64-5717-4562-b3fc-2c963f66afa6&pageNumber=1&pageSize=50" \
  -H "Authorization: Bearer <token>"

GET /api/stock/enriched

Returns a paginated list of stock records enriched with item attributes (number, description, UOM, type, tracking flags, weight, volume) and bin/location attributes (bin code, description, type, location code, picking/putaway flags). Supports free-text search. Authentication: Authorization: Bearer <token> (required).
companyId
string (uuid)
Tenant company ID. Resolved from JWT if omitted.
Free-text filter matched against item number, item description, bin code, and location code.
pageNumber
integer
1-based page number. Defaults to 1.
pageSize
integer
Records per page. Defaults to 20.
data
array
Paginated enriched stock rows.
pageNumber
integer
Current page.
pageSize
integer
Page size.
totalRecords
integer
Total matching records.
totalPages
integer
Total pages.
curl -X GET "https://api.example.com/api/stock/enriched?companyId=3fa85f64-5717-4562-b3fc-2c963f66afa6&search=widget&pageSize=25" \
  -H "Authorization: Bearer <token>"

Build docs developers (and LLMs) love