API reference / Stock transfers

Stock transfers API

8 endpoints. Scopes: Scalar360.stock-transfers.READ, .CREATE, .UPDATE, .DELETE or .ALL. All calls need Authorization: Scalar360-oauthtoken <access_token> — see Authentication.

GET

List

/api/v1/stock-transfers

Scope: Scalar360.stock-transfers.READ

Example request

curl -X GET "https://api.scalar360.com/api/v1/stock-transfers" \
  -H "Authorization: Scalar360-oauthtoken $ACCESS_TOKEN"

POST

Create

/api/v1/stock-transfers

Scope: Scalar360.stock-transfers.CREATE

Body field	Type	Required	Notes
`sourceWarehouseId`	string (uuid)	Yes
`destWarehouseId`	string (uuid)	Yes
`transferDate`	string (date)	Yes
`notes`	string
`items`	array of object	Yes	required, not empty
`items[].inventoryItemId`	string (uuid)
`items[].quantity`	number	Yes	required

Example request

curl -X POST "https://api.scalar360.com/api/v1/stock-transfers" \
  -H "Authorization: Scalar360-oauthtoken $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"sourceWarehouseId":"3f1c2b9e-7a1d-4c3e-9b2a-1e5f6a7b8c9d","destWarehouseId":"3f1c2b9e-7a1d-4c3e-9b2a-1e5f6a7b8c9d","transferDate":"2026-10-12","items":[{"inventoryItemId":"3f1c2b9e-7a1d-4c3e-9b2a-1e5f6a7b8c9d","quantity":100}]}'

GET

Get

/api/v1/stock-transfers/{id}

Scope: Scalar360.stock-transfers.READ

Parameter	In	Type	Required
`id`	path	string (uuid)	Yes

Example request

curl -X GET "https://api.scalar360.com/api/v1/stock-transfers/{id}" \
  -H "Authorization: Scalar360-oauthtoken $ACCESS_TOKEN"

PUT

Update

/api/v1/stock-transfers/{id}

Scope: Scalar360.stock-transfers.UPDATE

Parameter	In	Type	Required
`id`	path	string (uuid)	Yes

Body field	Type	Required	Notes
`sourceWarehouseId`	string (uuid)
`destWarehouseId`	string (uuid)
`transferDate`	string (date)
`notes`	string
`items`	array of object	Yes	required, not empty
`items[].inventoryItemId`	string (uuid)
`items[].quantity`	number	Yes	required

Example request

curl -X PUT "https://api.scalar360.com/api/v1/stock-transfers/{id}" \
  -H "Authorization: Scalar360-oauthtoken $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"sourceWarehouseId":"3f1c2b9e-7a1d-4c3e-9b2a-1e5f6a7b8c9d","destWarehouseId":"3f1c2b9e-7a1d-4c3e-9b2a-1e5f6a7b8c9d","transferDate":"2026-10-12","notes":"string","items":[{"inventoryItemId":"3f1c2b9e-7a1d-4c3e-9b2a-1e5f6a7b8c9d","quantity":100}]}'

DELETE

Delete

/api/v1/stock-transfers/{id}

Scope: Scalar360.stock-transfers.DELETE

Parameter	In	Type	Required
`id`	path	string (uuid)	Yes

Example request

curl -X DELETE "https://api.scalar360.com/api/v1/stock-transfers/{id}" \
  -H "Authorization: Scalar360-oauthtoken $ACCESS_TOKEN"

POST

Cancel

/api/v1/stock-transfers/{id}/cancel

Scope: Scalar360.stock-transfers.CREATE

Parameter	In	Type	Required
`id`	path	string (uuid)	Yes

Example request

curl -X POST "https://api.scalar360.com/api/v1/stock-transfers/{id}/cancel" \
  -H "Authorization: Scalar360-oauthtoken $ACCESS_TOKEN"

POST

Dispatch

/api/v1/stock-transfers/{id}/dispatch

Scope: Scalar360.stock-transfers.CREATE

Parameter	In	Type	Required
`id`	path	string (uuid)	Yes

Example request

curl -X POST "https://api.scalar360.com/api/v1/stock-transfers/{id}/dispatch" \
  -H "Authorization: Scalar360-oauthtoken $ACCESS_TOKEN"

POST

Receive

/api/v1/stock-transfers/{id}/receive

Scope: Scalar360.stock-transfers.CREATE

Parameter	In	Type	Required
`id`	path	string (uuid)	Yes

Example request

curl -X POST "https://api.scalar360.com/api/v1/stock-transfers/{id}/receive" \
  -H "Authorization: Scalar360-oauthtoken $ACCESS_TOKEN"