latestOpenAPI 3.0.12026-08-192092911.2 MB

916e669fc527

Stock

Get a list of stock movements

Retrieves a paged collection of stock movements (required scope stock:read)

get/v1/stockMovement

Query parameters

idinteger[]

Only return resources where id matches the value(s) provided (Max items: 50)

jobIdinteger[]

Only return resources where jobId matches the value(s) provided (Max items: 50)

pickUpAtFromstring date-time

Only return stock movement where pickupAt is the same or newer than this UTC value

pickUpAtTostring date-time

Only return stock movement where pickupAt is the same or older than this UTC value

dropOffAtFromstring date-time

Only return resources where 'dropOffDate' is greater than or equal to the UTC value provided

dropOffAtTostring date-time

Only return resources where 'dropOffDate' is lesser than or equal to the UTC value provided

stockDetailsIdinteger[]

Only return resources where stockDetailsId matches the value(s) provided (Max items: 50)

stockItemIdinteger[]

Only return resources where stockItemId matches the value(s) provided (Max items: 50)

vehicleIdinteger[]

Only return resources where vehicleId matches the value(s) provided (Max items: 50)

dropOffContactIdinteger[]

Only return records where 'dropOffContactId' matches the value(s) provided (Max items: 50)

dropOffVehicleIdinteger[]

Only return records where 'dropOffVehicleId' matches the value(s) provided (Max items: 50)

pageNumberinteger

The page number being requested (minimum: 1, maximum: 2147483)

pageSizeinteger

The page size being requested (minimum: 1, maximum: 1000)

Headers

Customer-Idinteger required

The customer identifier

Response

OK

pageNumberinteger

The page number of the response where 1 is the first page

pageSizeinteger

The number of items requested for the current page

pageItemCountinteger

The number of items returned in the current page

Example response

{
  "items": [
    {
      "id": 123456,
      "stockDetailsId": 876,
      "stockItemId": 384,
      "jobId": 559,
      "pickupAt": "2022-11-29T16:50:16.0000000+00:00",
      "dropOffAt": "2022-11-29T16:50:16.0000000+00:00",
      "isDropOffForSell": true,
      "pickupPosition": {
        "latitude": 51.31349,
        "longitude": -0.7464233
      },
      "dropOffPosition": {
        "latitude": 51.31349,
        "longitude": -0.7464233
      },
      "pickupVehicleId": 123,
      "vehicleId": 123,
      "dropOffVehicleId": 123,
      "dropOffStockItemId": 123,
      "pickupStockItemId": 123,
      "isEquipmentAtPickup": true,
      "isEquipmentAtDropOff": true,
      "ownerId": 74837,
      "ownerName": "John Doe",
      "invoiceId": 50012345,
      "pickupContactId": 50012345,
      "dropOffContactId": 50012345,
      "pickUpQuantity": 12.3,
      "dropOffQuantity": 13.14
    }
  ],
  "pageNumber": 2,
  "pageSize": 100,
  "pageItemCount": 55
}