# Query pickups, inventory adjustments, and deliveries for a trip

Endpoint: GET /fuel/dispatchGroup/{dispatchGroupId}
Version: 1.0.0
Security: M2X_auth_application

## Path parameters:

  - `dispatchGroupId` (string, required)
    GroupId to inspect

## Response 200 fields (application/json):

  - `pickups` (array)

  - `pickups.id` (string)
    Example: "D001"

  - `pickups.constraintId` (string,null)
    Example: "D001"

  - `pickups.externalId` (string,null)

  - `pickups.dispatchGroupId` (string,null)
    Example: "ABC1123-asdasdasd-123213"

  - `pickups.deleted` (boolean)

  - `pickups.vehicleId` (string)
    Example: "D001"

  - `pickups.vehicleExternalId` (any)

  - `pickups.driver` (any)

  - `pickups.location` (object)

  - `pickups.location.locationKind` (string,null)
    Enum: "Farm", "Carrier", "Port", "Warehouse", "Sale Yard", "Holding Yard", "Works", "Weighbridge", "Accommodation", "Quarry", "Mine", "Store", "Plant", "Forest", "Ranch", "Growyard", "Elevator", "Feedyard", "Depot", "Pack Site", "Container Depot"

  - `pickups.location.shortName` (string, required)
    Example: "Dreamy Farm"

  - `pickups.location.areaName` (string,null)
    Example: "Mystery Creek"

  - `pickups.location.facilityName` (string,null)
    Example: "Main Yards"

  - `pickups.location.addressText` (string,null)
    Example: "Main Yards"

  - `pickups.location.latitude` (number,null)
    If null or not provided, the latitude from the current location will be retained.  If there is no current latitude, it will be resolved by geocoding.

  - `pickups.location.longitude` (number,null)
    If null or not provided, the longitude from the current location will be retained.  If there is no current longitude, it will be resolved by geocoding.

  - `pickups.location.externalId` (string,null)
    An optional external identifier assigned to the location. This ID can be provided when creating the location and is typically used for cross-system referencing or integration with external data sources.

  - `pickups.location.inboundIntegrationIds` (array,null)

  - `pickups.location.disabled` (boolean, required)

  - `pickups.location.onHold` (boolean)

  - `pickups.location.customer` (object,null)
    At least one field needs to be provided to resolve the customer

  - `pickups.location.customer.customerId` (string)
    M2X customer ID

  - `pickups.location.customer.customerName` (string)
    Customer name

  - `pickups.location.customer.integrationId` (string)
    Customer integration ID

  - `pickups.location.customer.externalId` (string)
    External customer ID

  - `pickups.location.mobile` (string,null)
    Location mobile number
    Example: "+33 123"

  - `pickups.location.phone` (string,null)
    Location phone number
    Example: "+33 123"

  - `pickups.location.email` (string,null)
    Location email
    Example: "asd@asd.asd"

  - `pickups.location.hazards` (string,null)
    Hazards descriptions

  - `pickups.location.notes` (string,null)
    Notes

  - `pickups.location.properties` (object,null)
    A key value store containing bespoke properties usable for pricing and optimisation

  - `pickups.location.requirements` (object,null)
    A key value store containing bespoke properties usable for pricing and optimisation

  - `pickups.location.restrictions` (object,null)
    A key value store containing bespoke properties usable for pricing and optimisation

  - `pickups.location.metadata` (object,null)
    Opaque passenger data

  - `pickups.location.readonlyFields` (object,null)
    Specifies which field should not be touched by the user

  - `pickups.location.readonlyFields.latitude` (boolean)

  - `pickups.location.readonlyFields.longitude` (boolean)

  - `pickups.location.readonlyFields.notes` (boolean)

  - `pickups.location.readonlyFields.hazards` (boolean)

  - `pickups.location.readonlyFields.customer` (boolean)

  - `pickups.location.readonlyFields.mobile` (boolean)

  - `pickups.location.readonlyFields.phone` (boolean)

  - `pickups.location.readonlyFields.email` (boolean)

  - `pickups.location.readonlyFields.gtnCaptureRequiredPickup` (boolean)

  - `pickups.location.readonlyFields.gtnCaptureRequiredDelivery` (boolean)

  - `pickups.location.readonlyFields.openingHours` (boolean)

  - `pickups.location.accessLatitude` (number,null)

  - `pickups.location.accessLongitude` (number,null)

  - `pickups.location.maxIncomingWeight` (number,null)

  - `pickups.location.maxOutgoingWeight` (number,null)

  - `pickups.location.minIncomingWeight` (number,null)

  - `pickups.location.minOutgoingWeight` (number,null)

  - `pickups.location.offRoadDistance` (number,null)

  - `pickups.location.offRoadDuration` (number,null)

  - `pickups.location.waitTime` (number,null)

  - `pickups.location.contactName` (string,null)

  - `pickups.location.contactNotes` (string,null)

  - `pickups.location.dairySupplyGeneration` (object,null)

  - `pickups.location.geofenceType` (string,null)
    Enum: "Circular", "Polygon", null

  - `pickups.location.polygonGeofence` (string,null)
    If geofenceType is "Polygon" uses this WKT closed polygon (last and first lat/long pair must match)
    Example: "POLYGON ((-105.0105 39.7617,-105.0108 39.7614,-105.0111 39.7616,-105.0105 39.7617))"

  - `pickups.location.radius` (integer,null)
    If geofenceType is "Circular" uses this integer radius in meters around the determined or provided lat/long
    Example: 300

  - `pickups.location.geofenceAlerting` (object,null)

  - `pickups.location.geofenceAlerting.enabled` (boolean, required)

  - `pickups.location.geofenceAlerting.emails` (array,null)
    A list of email addresses
    Example: ["abc@example.com"]

  - `pickups.location.geofenceAlerting.mobileNumbers` (array,null)
    A list of mobile numbers
    Example: [64211234567]

  - `pickups.location.gtnCaptureRequiredPickup` (string,null)
    Policy for weighbridge input on pickup
    Enum: "MANDATORY", "OPTIONAL", "NONE", null

  - `pickups.location.gtnCaptureRequiredDelivery` (string,null)
    Policy for weighbridge input on delivery
    Enum: "MANDATORY", "OPTIONAL", "NONE", null

  - `pickups.location.weeklySupplyGeneration` (object,null)

  - `pickups.location.weeklySupplyGeneration.interactionsInstructions` (array,null)

  - `pickups.location.weeklySupplyGeneration.interactionsInstructions.storageId` (string, required)

  - `pickups.location.weeklySupplyGeneration.interactionsInstructions.storageName` (string,null)

  - `pickups.location.weeklySupplyGeneration.interactionsInstructions.capacity` (object)

  - `pickups.location.weeklySupplyGeneration.interactionsInstructions.capacity.capacityFuelMinPumpableLitres` (number,null)

  - `pickups.location.weeklySupplyGeneration.interactionsInstructions.capacity.capacityFuelSafeFillLitres` (number,null)

  - `pickups.location.weeklySupplyGeneration.interactionsInstructions.capacity.capacityFuelSafetyStockLitres` (number,null)

  - `pickups.location.weeklySupplyGeneration.interactionsInstructions.capacity.capacityLitres` (number,null)

  - `pickups.location.weeklySupplyGeneration.interactionsInstructions.product` (object)

  - `pickups.location.weeklySupplyGeneration.interactionsInstructions.product.productCodeId` (string, required)

  - `pickups.location.weeklySupplyGeneration.interactionsInstructions.product.productCodeName` (string, required)

  - `pickups.location.weeklySupplyGeneration.interactionsInstructions.product.productId` (string, required)

  - `pickups.location.weeklySupplyGeneration.interactionsInstructions.product.productLinearRate` (number,null)

  - `pickups.location.weeklySupplyGeneration.interactionsInstructions.productLinearRateCalculated` (boolean)

  - `pickups.location.weeklySupplyGeneration.defaultProductEnabled` (boolean)

  - `pickups.location.weeklySupplyGeneration.dayCollectionWindow` (object,null)

  - `pickups.location.weeklySupplyGeneration.dayCollectionWindow.startTime` (string,null)
    The start of the collection/delivery time window.  May extend past 24:00 for overnight time windows.
    Example: "07:00"

  - `pickups.location.weeklySupplyGeneration.dayCollectionWindow.endTime` (string,null)
    The end of the collection/delivery time window.  May extend past 24:00 for overnight time windows.
    Example: "28:00"

  - `pickups.location.weeklySupplyGeneration.generationBasis` (string,null)
    Enum: "PATTERN", "SAFETY_STOCK"

  - `pickups.location.weeklySupplyGeneration.patternType` (string,null)
    Enum: "TWICE_WEEKLY", "WEEKLY", "FORTNIGHTLY", "THIRD_WEEK", "FOURTH_WEEK", "FIVE_DAYS", "CUSTOM"

  - `pickups.location.weeklySupplyGeneration.pattern` (array,null)

  - `pickups.location.weeklySupplyGeneration.pattern.monday` (object, required)

  - `pickups.location.weeklySupplyGeneration.pattern.monday.day` (boolean)

  - `pickups.location.weeklySupplyGeneration.pattern.monday.night` (boolean)

  - `pickups.location.weeklySupplyGeneration.pattern.tuesday` (object, required)

  - `pickups.location.weeklySupplyGeneration.pattern.wednesday` (object, required)

  - `pickups.location.weeklySupplyGeneration.pattern.thursday` (object, required)

  - `pickups.location.weeklySupplyGeneration.pattern.friday` (object, required)

  - `pickups.location.weeklySupplyGeneration.pattern.saturday` (object, required)

  - `pickups.location.weeklySupplyGeneration.pattern.sunday` (object, required)

  - `pickups.location.weeklySupplyGeneration.patternStartDay` (string,null)
    YYYY-MM-DD
    Example: "2024-01-01"

  - `pickups.location.weeklySupplyGeneration.customPriority` (string,null)
    Enum: "HIGH", "MEDIUM", "LOW"

  - `pickups.location.weeklySupplyGeneration.isTopupSite` (boolean)

  - `pickups.location.weeklySupplyGeneration.productQuantity` (number,null)

  - `pickups.location.updated` (string,null)

  - `pickups.products` (array)

  - `pickups.products.transportRequirementsId` (string)
    M2X internal tracking id for the product type

  - `pickups.products.productCode` (string,null)
    M2X internal tracking id for the product code used

  - `pickups.products.productCodeExternalId` (string,null)
    External Id for product tracking

  - `pickups.products.productCodeName` (string,null)
    M2X name for the product code used

  - `pickups.products.quantity` (integer)
    The entered quantity

  - `pickups.shiftMetadata` (object)

  - `pickups.shiftMetadata.serviceDay` (string)

  - `pickups.shiftMetadata.shiftId` (string)

  - `pickups.shiftMetadata.totalShifts` (integer)

  - `pickups.shiftMetadata.shiftIndex` (integer)

  - `pickups.actual` (object,null)

  - `pickups.actual.inboundProducts` (array)

  - `pickups.actual.inboundInventory` (object,null)

  - `pickups.actual.inboundInventory.compartments` (array)

  - `pickups.actual.inboundInventory.compartments.compartmentId` (string)

  - `pickups.actual.outboundInventory` (object,null)

  - `pickups.actual.truckReference` (string,null)
    Example: "D001"

  - `pickups.actual.bolLoadingReferences` (any)

  - `pickups.actual.attachments` (array)

  - `pickups.actual.timestamp` (string,null)

  - `pickups.actual.odometerDistanceKm` (number,null)
    The odometer distance reading in kilometers

  - `deliveries` (array)

  - `inventoryAdjust` (array)

  - `inventoryAdjust.reasonCode` (any)

## Response 400 fields (application/json):

  - `message` (string)
    Example: "missing data"