Contents
Inventory Pro includes an optional REST API that enables third-party integrations, reporting tools, and automation scripts to read and write data programmatically. The API is not enabled by default - it must be deployed and configured as a separate IIS application. Contact CISS Ltd. to enable it for your installation.
| Item | Value |
|---|---|
| Base URL | https://<your_system>/api/v1 |
| Documentation | https://<your_system>/api/v1/swagger |
| Authentication | OAuth 2.0 Client Credentials |
| Default state | Disabled - requires deployment by CISS |
| Transport | HTTPS required |
The API is a separate application that is deployed alongside the Desktop application. It is not present in all installations. If your organization has not enabled it, all API endpoints will return 404 or connection errors.
When deployed, the API base URL follows this pattern:
https://<your_system>/api/v1Interactive documentation (Swagger UI) is available at:
https://<your_system>/api/v1/swaggerThe Swagger page lists all available endpoints, accepted parameters, and response schemas for your specific deployment. It is the authoritative reference for your installation’s version of the API.
The API uses OAuth 2.0 client credentials. Before making any API request:
/Token endpoint:grant_type: client_credentialsclient_id: your assigned client IDclient_secret: your assigned client secretAuthorization header of all subsequent requests:Authorization: Bearer <token>Unauthenticated requests return HTTP 401.
When deployed, the API provides endpoints across these resource groups:
| Resource Group | Operations Available |
|---|---|
| Asset | Get by ID, list all, get types, delete |
| Category | Get by ID, list all, delete |
| Customer | Get by ID, list all, delete |
| Inventory | Get by ID, stock levels, material in/out |
| Item | Get by ID, list all, create, update, delete, aliases |
| Location | Get by ID, hold, release |
| Purchase Order | Get by ID, create |
| Reason Code | Get by ID, list all, delete |
| Shipping Order | Get by ID, create |
| Vendor | Get by ID, list all, delete |
| Warehouse | Get by ID, items, inventory, locations, stock levels |
| Work Order | Get by ID |
For exact endpoint signatures, request/response formats, and current availability, consult the Swagger UI on your deployed instance.
On this page