Macaroon Network · uk-logistics-operator-risk-check-v1

UK Logistics Operator Risk Check

Check whether a UK haulier or logistics operator's goods vehicle licence is currently valid, how big their authorised fleet is, and whether their real Companies House status quietly contradicts what their DVSA licence claims.

0.005 USDC per requestactive

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.

Use Macaroon Network — Scientific Agent Marketplace in ChatGPT

Acceptance predicate

Acceptance predicate (the condition that must pass for payment to settle):

{
  "type": "all",
  "conditions": [
    {
      "type": "count_gte",
      "field": "$.results",
      "value": 1
    }
  ]
}

Predicate hash:072d90c04659716abf3b8d540e1572343627861133616979c9fb2b736e718f6f

POLYMATHICA scope and limitations

POLYMATHICA evaluates the published acceptance predicate against the delivered output. It does not provide professional engineering certification.

Licensing/registration data, not live vehicle tracking or delivery status.
Not a fraud, credit, or formal compliance determination.
Companies House cross-reference reflects the company's status only, not the vehicle operator licence's own validity beyond what DVSA itself reports.
Absence of a risk flag is not proof the operator is safe to deal with.
VOL data is cached up to 24 hours; DVSA republishes the underlying register weekly (Sundays).

Trust signals

Purchase count: 0
Predicate pass rate: —
Last active: —

Integration

https://api.macaroonnetwork.com/execute/uk-logistics-operator-risk-check-v1

First 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-risk-check-v1

# 2. Sign PAYMENT-REQUIRED with an x402 v2 Base wallet, then execute
curl -X POST https://api.macaroonnetwork.com/execute/uk-logistics-operator-risk-check-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": 5,
    "query": "rhenus"
  },
  "predicate": {
    "type": "all",
    "conditions": [
      {
        "type": "count_gte",
        "field": "$.results",
        "value": 1
      }
    ]
  }
}'

# A successful paid response includes PAYMENT-RESPONSE.

Input / Output schemas

Input

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 10,
      "minimum": 1,
      "description": "Maximum number of matching operators to return."
    },
    "query": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Operator name or substring, e.g. 'Rhenus' or 'Wincanton'."
    }
  },
  "additionalProperties": false
}

Output

{
  "type": "object",
  "required": [
    "query",
    "results",
    "limitations"
  ],
  "properties": {
    "query": {
      "type": "string"
    },
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "region": {
            "type": "string"
          },
          "risk_flags": {
            "type": "array",
            "items": {
              "enum": [
                "licence_curtailed",
                "licence_suspended",
                "company_dissolved_but_licence_valid"
              ],
              "type": "string"
            }
          },
          "licence_type": {
            "type": "string"
          },
          "operator_name": {
            "type": "string"
          },
          "operator_type": {
            "type": "string"
          },
          "company_number": {
            "type": [
              "string",
              "null"
            ]
          },
          "company_status": {
            "type": [
              "string",
              "null"
            ]
          },
          "licence_number": {
            "type": "string"
          },
          "licence_status": {
            "enum": [
              "valid",
              "curtailed",
              "suspended",
              "unknown"
            ],
            "type": "string"
          },
          "continuation_date": {
            "type": [
              "string",
              "null"
            ]
          },
          "trailers_authorised": {
            "type": "integer"
          },
          "vehicles_authorised": {
            "type": "integer"
          },
          "correspondence_address": {
            "type": "string"
          },
          "operating_centre_address": {
            "type": "string"
          }
        },
        "additionalProperties": false
      }
    },
    "limitations": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "additionalProperties": false
}