api-docs v5.116.0
API Docs
Table of contents
Inventory_Tracker
Tracker - Delete
Delete an inventory-tracker's details
DELETE /inventory-trackers/:id
Headers - Header
Name | Type | Description |
---|---|---|
Authorization | string |
key to place the API token to using the grant 'Bearer' |
Header examples
Authorization-Example
{
"Authorization": "Bearer <your-api-token>"
}
Parameters - Parameter
Name | Type | Description |
---|---|---|
id | string |
id of inventory-tracker |
Examples
Example usage:
curl "https://yourdomain.com/inventory-trackers/<inventory-tracker-id>" \
-X DELETE \
-H "Authorization: Bearer <your-api-token>"
Success response
Success response - Success 200
Name | Type | Description |
---|---|---|
id | String |
|
externalId | String |
control number, batch id or external identifier |
createdAt | Date |
|
createdBy | String |
|
organization | String |
parent organization |
warehouse | String |
relevant warehouse (branch if branch specific) |
sku | String |
variant sku |
quantity | Number |
|
parent | String |
parent tracked item, for linking 'consumed' trackers with original |
status | String |
track status |
expiresAt | Date |
track expiration |
Success response example
Success response example - Success-Response:
HTTP/1.1 200 OK
{
"id": "service-id",
"warehouse": "facility-id",
"quantity": 1
}
Tracker - Find
Get array of inventory-trackers
GET /inventory-trackers
Headers - Header
Name | Type | Description |
---|---|---|
Authorization | string |
key to place the API token to using the grant 'Bearer' |
Header examples
Authorization-Example
{
"Authorization": "Bearer <your-api-token>"
}
Examples
Example usage:
curl "https://yourdomain.com/inventory-trackers" \
-X GET \
-H "Authorization: Bearer <your-api-token>"
Success response
Success response - Success 200
Name | Type | Description |
---|---|---|
inventoryTrackers | Object[] |
array of inventory tracker |
inventoryTrackers.id | String |
|
inventoryTrackers.externalId | String |
control number, batch id or external identifier |
inventoryTrackers.createdAt | Date |
|
inventoryTrackers.createdBy | String |
|
inventoryTrackers.organization | String |
parent organization |
inventoryTrackers.warehouse | String |
relevant warehouse (branch if branch specific) |
inventoryTrackers.sku | String |
variant sku |
inventoryTrackers.quantity | Number |
|
inventoryTrackers.parent | String |
parent tracked item, for linking 'consumed' trackers with original |
inventoryTrackers.status | String |
track status |
inventoryTrackers.expiresAt | Date |
track expiration |
Success response example
Success response example - Success-Response:
HTTP/1.1 200 OK
[
{
"id": "service-id",
"warehouse": "facility-id",
"quantity": 1
},
{
"id": "service-id",
"warehouse": "facility-id",
"quantity": 1
}
]
Tracker - Get
Get an inventory-tracker's details
GET /inventory-trackers/:id
Headers - Header
Name | Type | Description |
---|---|---|
Authorization | string |
key to place the API token to using the grant 'Bearer' |
Header examples
Authorization-Example
{
"Authorization": "Bearer <your-api-token>"
}
Parameters - Parameter
Name | Type | Description |
---|---|---|
id | string |
id of inventory-tracker |
Examples
Example usage:
curl "https://yourdomain.com/inventory-trackers/<inventory-tracker-id>" \
-X GET \
-H "Authorization: Bearer <your-api-token>"
Success response
Success response - Success 200
Name | Type | Description |
---|---|---|
id | String |
|
externalId | String |
control number, batch id or external identifier |
createdAt | Date |
|
createdBy | String |
|
organization | String |
parent organization |
warehouse | String |
relevant warehouse (branch if branch specific) |
sku | String |
variant sku |
quantity | Number |
|
parent | String |
parent tracked item, for linking 'consumed' trackers with original |
status | String |
track status |
expiresAt | Date |
track expiration |
Success response example
Success response example - Success-Response:
HTTP/1.1 200 OK
{
"id": "service-id",
"warehouse": "facility-id",
"quantity": 1
}
Tracker - Patch
Update an inventory-tracker
PATCH /inventory-trackers/:id
Headers - Header
Name | Type | Description |
---|---|---|
Authorization | string |
key to place the API token to using the grant 'Bearer' |
Header examples
Authorization-Example
{
"Authorization": "Bearer <your-api-token>"
}
Parameters - Parameter
Name | Type | Description |
---|---|---|
id | string |
id of inventory-tracker |
externalId | String |
optional |
createdAt | Date |
optional Default value: currentTime |
createdBy | String |
optional |
organization | String |
optional parent organization |
warehouse | String |
relevant warehouse (branch if branch specific) |
quantity | Number |
optional Default value: 1 |
status | String |
optional track status |
expiresAt | Date |
optional track expiration |
Examples
Example usage:
curl "https://yourdomain.com/inventory-trackers/<inventory-tracker-id>" \
-X PATCH \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <your-api-token>" \
-d '{
"name": "Updated Name"
}'
Parameters examples
json
- Request-Example
{
"name": "Updated Name"
}
Success response
Success response - Success 200
Name | Type | Description |
---|---|---|
id | String |
|
externalId | String |
control number, batch id or external identifier |
createdAt | Date |
|
createdBy | String |
|
organization | String |
parent organization |
warehouse | String |
relevant warehouse (branch if branch specific) |
sku | String |
variant sku |
quantity | Number |
|
parent | String |
parent tracked item, for linking 'consumed' trackers with original |
status | String |
track status |
expiresAt | Date |
track expiration |
Success response example
Success response example - Success-Response:
HTTP/1.1 200 OK
{
"id": "service-id",
"warehouse": "facility-id",
"quantity": 1
}
Tracker - Post
Create an inventory-tracker
POST /inventory-trackers
Headers - Header
Name | Type | Description |
---|---|---|
Authorization | string |
key to place the API token to using the grant 'Bearer' |
Header examples
Authorization-Example
{
"Authorization": "Bearer <your-api-token>"
}
Parameters - Parameter
Name | Type | Description |
---|---|---|
id | String |
optional auto-generated if not provided |
externalId | String |
optional |
createdAt | Date |
optional Default value: currentTime |
createdBy | String |
optional |
organization | String |
optional parent organization |
warehouse | String |
relevant warehouse (branch if branch specific) |
sku | String |
variant sku |
quantity | Number |
optional Default value: 1 |
parent | String |
optional parent tracked item, for linking 'consumed' trackers with original |
status | String |
optional track status |
expiresAt | Date |
optional track expiration |
Examples
Example usage:
curl "https://yourdomain.com/inventory-trackers" \
-X POST \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <your-api-token>" \
-d '{
"warehouse": "facility-id",
"name": "Product 1"
}'
Parameters examples
json
- Request-Example
{
"warehouse": "facility-id",
"name": "Product 1"
}
Success response
Success response - Success 200
Name | Type | Description |
---|---|---|
id | String |
|
externalId | String |
control number, batch id or external identifier |
createdAt | Date |
|
createdBy | String |
|
organization | String |
parent organization |
warehouse | String |
relevant warehouse (branch if branch specific) |
sku | String |
variant sku |
quantity | Number |
|
parent | String |
parent tracked item, for linking 'consumed' trackers with original |
status | String |
track status |
expiresAt | Date |
track expiration |
Success response example
Success response example - Success-Response:
HTTP/1.1 200 OK
{
"id": "service-id",
"warehouse": "facility-id",
"quantity": 1
}