Order Movement Audit All Ep
POST/v1/order/movement_audits/all
List Movement Audits
Returns a list of movement audits matching the provided filters. Movement audits track changes made to the completion info on an order (BOLs, Drops, etc) At least one filter is required. Results are limited to 3000 items.
Filters (at least one required):
order_ids: list[str] | None = None
Filter by specific order IDs.
order_numbers: list[int] | None = None
Filter by specific order numbers.
audit_ids: list[str] | None = None
Filter by specific movement audit IDs.
as_of: datetime | None = None
Return audits updated on or after this datetime. Mutually exclusive with between.
between: DateWindow | None = None
Return audits updated within this date range. Mutually exclusive with as_of.
has_errors: bool | None = None
Filter by whether the audit has unresolved movement validation issues.
true returns audits with errors that have not been bypassed.
false returns audits without errors or with bypassed errors.
Response
Returns a list of MovementAuditView objects.
id: str
The unique identifier of the movement audit.
order_id: str
The unique identifier of the associated order.
order_number: int
The order number.
order_version: str
The version of the order at the time of the audit.
bol_numbers: list[str]
The BOL numbers associated with the audit.
bol_ids: list[str]
The BOL IDs associated with the audit.
bols: list[BolV2]
The full BOL documents captured at audit time.
drops: list[Drop]
The drop details captured at audit time.
allocated_bols: list[AllocatedBol]
The allocated BOL details captured at audit time.
movement_validations: MovementValidationAudit | None
Movement validation details including any issues and bypass information.
updated_by: str
The user who created or updated this audit.
updated_date: datetime
When the audit was created or last updated.
Responses
- 200
- 422
Successful Response
- application/json
- Example (from schema)
[
{
"_id": "string",
"order_id": "string",
"order_number": 0,
"order_version": 0,
"bol_numbers": [
"string"
],
"bol_ids": [
"string"
],
"bols": [
{
"bol_number": "string",
"bol_number_stripped": "string",
"order_id": "string",
"terminal_id": "string",
"terminal": "string",
"site": "string",
"site_id": "string",
"state": "string",
"load_or_drop": "Load",
"date": "2026-05-11T19:25:52.470Z",
"photos": [
{
"photo": "string",
"thumbnail": "string",
"type": "bill of lading",
"note": "string",
"file_type": "image",
"updated_on": "2026-05-11T19:25:52.470Z",
"updated_by": "string"
}
],
"details": [
{
"id": "5eb7cf5a86d9755df3a6c593",
"compartment_index": 0,
"type": "Load",
"load_number": "string",
"product_id": "string",
"product": "string",
"net_volume": 0,
"gross_volume": 0,
"supplier_id": "string",
"supplier": "string",
"original_supplier_id": "string",
"original_supplier": "string",
"contract": "string",
"price_type": "string",
"price_details": {
"price": 0,
"price_id": "string",
"curve_id": "string",
"date": "2026-05-11T19:25:52.470Z",
"counterparty_id": "string",
"net_or_gross_type": "Net",
"contract_lifting_valuation_method": "TimeOfLifting"
},
"supply_owner_id": "string",
"supply_owner": "string",
"created_by": "string",
"created_date": "2026-05-11T19:25:52.470Z",
"updated_date": "2026-05-11T19:25:52.470Z",
"revision_id": "string"
}
],
"matched_ebol_id": "string",
"created_by": "string",
"created_date": "2026-05-11T19:25:52.470Z",
"updated_date": "2026-05-11T19:25:52.470Z",
"updated_on": "2026-05-11T19:25:52.470Z",
"revision_id": "string"
}
],
"drops": [
{
"location_id": "string",
"location_short_name": "string",
"location_name": "string",
"address": "string",
"postal_code": "string",
"city": "string",
"state": "string",
"phone": "string",
"compartment_indexes": [
0
],
"counterparty_id": "string",
"counterparty": "string",
"details": [
{
"id": "5eb7cf5a86d9755df3a6c593",
"product_id": "string",
"product_name": "string",
"sources": [
{
"compartment_index": 0,
"volume": 0
}
],
"tank_id": 0,
"window_start": "2026-05-11T19:25:52.471Z",
"window_start_target": "2026-05-11T19:25:52.471Z",
"window_end": "2026-05-11T19:25:52.471Z",
"window_end_target": "2026-05-11T19:25:52.471Z",
"pre_drop_ullage_target_max": 0,
"pre_drop_ullage_storage_max": 0
}
],
"executed_details": [
{
"id": "5eb7cf5a86d9755df3a6c593",
"based_drop_id": "string",
"product_id": "string",
"entry_date": "2026-05-11T19:25:52.471Z",
"product_name": "string",
"tank_id": 0,
"before_gallons": 0,
"before_stick": 0,
"before_stick_time": "2026-05-11T19:25:52.471Z",
"water_stick": 0,
"water_stick_time": "2026-05-11T19:25:52.471Z",
"after_gallons": 0,
"after_stick": 0,
"after_stick_time": "2026-05-11T19:25:52.471Z",
"volume": 0,
"updated_on": "2026-05-11T19:25:52.471Z",
"updated_by": "string",
"bol_product": "string",
"bol_number": "string"
}
],
"estimated_drop_minutes": 0,
"eta": "2026-05-11T19:25:52.471Z",
"driver": "string",
"driver_id": "string",
"driver_schedule_id": "string",
"driver_schedule_date": "2026-05-11T19:25:52.471Z",
"dsu_id": "string",
"updated": "2026-05-11T19:25:52.471Z",
"gps_arrival_date": "2026-05-11T19:25:52.471Z",
"gps_arrival_breadcrumb_id": "string",
"gps_departure_date": "2026-05-11T19:25:52.471Z",
"gps_departure_breadcrumb_id": "string",
"route_status": "unset",
"route_events": [
{
"event_type": "string",
"timestamp": "2026-05-11T19:25:52.471Z",
"lat": 0,
"lon": 0
}
],
"extra_data": {},
"photos": [
{
"filename": "string",
"thumbnail": "string",
"file_type": "image",
"updated_on": "2026-05-11T19:25:52.472Z",
"updated_by": "string",
"image_url": "string"
}
]
}
],
"allocated_bols": [
{
"timezone_data": {},
"bol_id": "string",
"bol_number": "string",
"bol_terminal": "string",
"bol_terminal_id": "string",
"bol_product": "string",
"bol_product_id": "string",
"bol_supplier": "string",
"bol_supplier_id": "string",
"bol_contract": "string",
"bol_price_type": "string",
"bol_net_volume_original": 0,
"bol_gross_volume_original": 0,
"compartment": 0,
"store_number": "string",
"store_id": "string",
"location_id": "string",
"store_tank": 0,
"store_product": "string",
"store_product_id": "string",
"store_timezone": "string",
"bol_net_volume_allocated": 0,
"bol_gross_volume_allocated": 0,
"bol_date": "2026-05-11T19:25:52.472Z",
"delivered_date": "2026-05-11T19:25:52.472Z",
"driver_schedule": "string",
"planned_ratio": 0,
"actual_ratio": 0,
"counterparty_id": "string",
"price": {
"contract": "string",
"price_type": "string",
"terminal_id": "string",
"product_id": "string",
"supplier_id": "string",
"price_id": "string",
"curve_id": "string",
"price": 0,
"date": "2026-05-11T19:25:52.472Z",
"expired": false,
"net_or_gross_type": "Net",
"contract_lifting_valuation_method": "TimeOfLifting"
},
"from_ebol": true
}
],
"movement_validations": {
"movement_validation_issues": [
{
"type": "Order Supply vs. BOL Mismatch",
"text": "string",
"last_checked": "2026-05-11T19:25:52.472Z"
}
],
"validation_bypass": false,
"validation_bypass_by": "string",
"validation_bypass_on": "2026-05-11T19:25:52.472Z",
"validation_bypass_reason": "string",
"validation_bypass_note": "string"
},
"updated_by": "string",
"updated_date": "2026-05-11T19:25:52.472Z"
}
]
Validation Error
- application/json
- Example (from schema)
{
"detail": [
{
"loc": [
"string",
0
],
"msg": "string",
"type": "string"
}
]
}