Macaroon Network · uk-logistics-operator-change-feed-v1
UK Logistics Operator Change Feed
See which UK logistics operators had a real licence status change, fleet size change, or entered/left the DVSA register since a given date -- a weekly compliance/scaling signal, not a one-off lookup.
Base mainnet · x402 v2 · USDC exact payment
What you provide: a JSON request matching the input contract below.
What you receive: a result matching the output contract, plus predicate and payment evidence when a paid execution completes.
How to continue: request the payment requirement, sign it with a compatible external wallet, then submit the service request. Payment occurs outside ChatGPT.
Acceptance predicate
Acceptance predicate (the condition that must pass for payment to settle):
{
"type": "all",
"conditions": [
{
"type": "field_changed",
"field": "$.since",
"value": "2020-01-01T00:00:00+00:00",
"operator": "eq"
},
{
"type": "within",
"field": "$.retrieved_at",
"duration_hours": 1
}
]
}f7bfad2013563f8bdbf44cc74a53d20862a94f45b4d7b6130847b639a74a9259POLYMATHICA scope and limitations
POLYMATHICA evaluates the published acceptance predicate against the delivered output. It does not provide professional engineering certification.
- Change events are detected weekly (DVSA republishes the VOL register every Sunday) -- not real-time.
- A missing week's snapshot (upstream outage) means that week's changes cannot be detected and are not retroactively reconstructed.
- Not a fraud, credit, or formal compliance determination.
- Absence of a change event is not proof an operator's status is unchanged since before this feed's own tracking began.
- Tracking began 2026-09-09 -- no change history exists before this date.
Trust signals
- Purchase count
- 0
- Predicate pass rate
- —
- Last active
- —
Integration
https://api.macaroonnetwork.com/execute/uk-logistics-operator-change-feed-v1First fetch the HTTP 402 payment requirements. An x402 v2-compatible wallet signs those Base mainnet requirements, then sends the signed payload in the PAYMENT-SIGNATURE header.
# 1. Receive HTTP 402 + PAYMENT-REQUIRED
curl -i https://api.macaroonnetwork.com/execute/uk-logistics-operator-change-feed-v1
# 2. Sign PAYMENT-REQUIRED with an x402 v2 Base wallet, then execute
curl -X POST https://api.macaroonnetwork.com/execute/uk-logistics-operator-change-feed-v1 \
-H "PAYMENT-SIGNATURE: <base64 x402 v2 signed payment payload>" \
-H "X-Macaroon-Payment-Rail: x402" \
-H "X-Macaroon-X402-Network: base" \
-H "Content-Type: application/json" \
-d '{
"input": {
"limit": 20,
"since": "2026-09-01T00:00:00+00:00"
},
"predicate": {
"type": "all",
"conditions": [
{
"type": "field_changed",
"field": "$.since",
"value": "2020-01-01T00:00:00+00:00",
"operator": "eq"
},
{
"type": "within",
"field": "$.retrieved_at",
"duration_hours": 1
}
]
}
}'
# A successful paid response includes PAYMENT-RESPONSE.Input / Output schemas
Input
{
"type": "object",
"required": [
"since"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Maximum number of change events to return."
},
"since": {
"type": "string",
"description": "ISO-8601 timestamp -- only change events detected at or after this are returned."
}
},
"additionalProperties": false
}Output
{
"type": "object",
"required": [
"since",
"events",
"retrieved_at",
"limitations"
],
"properties": {
"since": {
"type": "string"
},
"events": {
"type": "array",
"items": {
"type": "object",
"properties": {
"event_type": {
"enum": [
"new_operator",
"operator_removed",
"licence_status_changed",
"fleet_size_changed"
],
"type": "string"
},
"detected_at": {
"type": "string"
},
"operator_name": {
"type": "string"
},
"licence_number": {
"type": "string"
}
}
}
},
"limitations": {
"type": "array",
"items": {
"type": "string"
}
},
"retrieved_at": {
"type": "string"
}
},
"additionalProperties": false
}