Skip to content

List what needs checking after drivers’ stops

GET
/asset-exceptions
curl --request GET \
--url 'https://example.com/asset-exceptions?kind=work_report&limit=100&offset=0' \
--cookie __Host-bottle.session_token=<__Host-bottle.session_token>

Newest first: work reports missing something the business requires (work_report), cylinders a driver couldn’t name with their reason (unnamed), serial numbers a driver added that weren’t in the Asset register (new_serial), and other cylinders not named at a stop (stop_gap). counts is every open item by kind, whatever the filters. Dates are London days.

kind

Work_report: a work report missing something the business requires, not numbered or emailed yet. unnamed: cylinders a driver couldn’t name, with their reason. new_serial: a serial a driver recorded that wasn’t in the Asset register. stop_gap: other cylinders not named at a stop. quarantine: a cylinder that went out while still in quarantine. past_date: a cylinder delivered after one of its dates had passed, such as its expiry date.

string
Allowed values: work_report unnamed new_serial stop_gap quarantine past_date

Work_report: a work report missing something the business requires, not numbered or emailed yet. unnamed: cylinders a driver couldn’t name, with their reason. new_serial: a serial a driver recorded that wasn’t in the Asset register. stop_gap: other cylinders not named at a stop. quarantine: a cylinder that went out while still in quarantine. past_date: a cylinder delivered after one of its dates had passed, such as its expiry date.

from
string format: date
to
string format: date
limit
integer
default: 100 >= 1 <= 200
offset
integer | null
0

What needs checking

Media typeapplication/json
object
items
required
Array<object>
object
id
required

UUID v7

string format: uuid
kind
required

Work_report: a work report missing something the business requires, not numbered or emailed yet. unnamed: cylinders a driver couldn’t name, with their reason. new_serial: a serial a driver recorded that wasn’t in the Asset register. stop_gap: other cylinders not named at a stop. quarantine: a cylinder that went out while still in quarantine. past_date: a cylinder delivered after one of its dates had passed, such as its expiry date.

string
Allowed values: work_report unnamed new_serial stop_gap quarantine past_date
at
required
string format: date-time
customer
required
object
id
required

UUID v7

string format: uuid
name
required
string
orderId
required

UUID v7

string | null format: uuid
stop
required
object
roundId
required

UUID v7

string format: uuid
stopId
required

UUID v7

string format: uuid
roundDate
required
string format: date
stopNumber
required
integer
driverName
required
string | null
vehicleName
required
string | null
product
required
object
id
required

UUID v7

string format: uuid
name
required
string
quantity
required
integer | null
> 0
side
required
string | null
Allowed values: delivered collected
reason
required
string | null
Allowed values: unreadable not_listed other
note
required
string | null
serial
required
string | null
holder
required
object
kind
required
string
Allowed values: place vehicle customer supplier nowhere transit
id
required

UUID v7

string | null format: uuid
name
required
string | null
missing
required
Array<object>
object
code
required
string
Allowed values: notRecorded cylinder jobType checkUnknown check problemNote image customerSignature customerName driverSignature purchaseOrder contact cylinderDetails
cylinder
string | null
check
string | null
image
string | null
Allowed values: customerSignature driverSignature photo
total
required
integer
counts
required
object
all
required
integer
work_report
required
integer
unnamed
required
integer
new_serial
required
integer
stop_gap
required
integer
quarantine
required
integer
past_date
required
integer

Example

{
"items": [
{
"id": "019205d1-6e7a-7c3b-9f6e-3a2b1c0d9e8f",
"kind": "work_report",
"customer": {
"id": "019205d1-6e7a-7c3b-9f6e-3a2b1c0d9e8f"
},
"orderId": "019205d1-6e7a-7c3b-9f6e-3a2b1c0d9e8f",
"stop": {
"roundId": "019205d1-6e7a-7c3b-9f6e-3a2b1c0d9e8f",
"stopId": "019205d1-6e7a-7c3b-9f6e-3a2b1c0d9e8f"
},
"product": {
"id": "019205d1-6e7a-7c3b-9f6e-3a2b1c0d9e8f"
},
"side": "delivered",
"reason": "unreadable",
"holder": {
"kind": "place",
"id": "019205d1-6e7a-7c3b-9f6e-3a2b1c0d9e8f"
},
"missing": [
{
"code": "notRecorded",
"image": "customerSignature"
}
]
}
]
}

Not signed in

Media typeapplication/json
object
error
required
string
message
required
string

Example

{
"error": "not_found",
"message": "Customer not found"
}

Not an owner or admin, missing scope, or the plan does not open Assets

Media typeapplication/json
object
error
required
string
message
required
string

Example

{
"error": "not_found",
"message": "Customer not found"
}

Not found, already dealt with, or another business’s

Media typeapplication/json
object
error
required
string
message
required
string

Example

{
"error": "not_found",
"message": "Customer not found"
}

Assets is switched off, the item changed meanwhile, or a work report needs a signature the office cannot add

Media typeapplication/json
object
error
required
string
message
required
string

Example

{
"error": "not_found",
"message": "Customer not found"
}

Validation failed

Media typeapplication/json
object
error
required
string
Allowed values: validation
message
required
string
issues
required
Array<object>
object
path
required
string
message
required
string

Example

{
"error": "validation",
"issues": [
{
"path": "email",
"message": "Invalid email"
}
]
}