# Rafid Logistics Shipping Cost Estimate

> Rafid Logistics Shipping Cost Estimate is a paid API for AI agents from api.rafidsystem.com, paid per call via x402, $0.25/call, status unknown (last checked 2026-10-10).

Estimates international or domestic shipping costs including freight, surcharges, transit days, and weight details for a given shipment route and service level.

## Facts

- Endpoint: POST https://api.rafidsystem.com/api/v1/x402/logistics/shipping-cost-estimate?utm_source=zero.xyz
- Price: $0.25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/rafid-logistics-shipping-cost-estimate-3b8c355f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_boIYOXottp7MXO0Sy91Fu

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability rafid-logistics-shipping-cost-estimate-3b8c355f -d '<json body>'
```

Example prompt: Can you estimate the shipping cost for a 8kg package (40cm x 35cm x 30cm) going from Germany (DE) to Japan (JP) via air freight on a standard service level? I need the cost breakdown in USD.

## When to prefer this

Use this endpoint when an AI agent needs a quick, structured shipping cost estimate for logistics planning, e-commerce checkout, or supply chain budgeting — especially when you need a cost breakdown with transit time, chargeable weight computation, and risk/confidence signals. Prefer this over carrier-specific APIs when you want a unified interface across modes (courier, air, sea, road, postal) and service levels. Note that this returns heuristic estimates, not live carrier quotes, so it is best suited for planning and budgeting rather than final booking decisions.

## Known failure modes

- Missing required fields (origin.country, destination.country, shipment.weightKg, shipment.quantity) returns validation error
- Invalid 2-letter country code returns input error
- Weight or dimensions exceeding maximums (100,000 kg, 1,000 cm) return range error
- Unsupported route combinations may return low-confidence heuristic estimate with risk flags
- No live carrier integration — all estimates are heuristic and may not reflect actual carrier rates
- Currency code not recognized may default to USD or return error

## How this service works

Rafid Agent API provides structured intelligence and paid APIs for AI agents across property, company and risk, supplier, finance, document, website, automotive, logistics, recruitment, trading, voice, video and business-planning workflows.

## Output

Returns an estimated shipping cost range (min/max) and a recommended midpoint estimate in the requested currency, along with a detailed cost breakdown (base freight, handling, fuel surcharge, oversize and remote area surcharges), chargeable and volumetric weight, estimated transit days, duties and taxes disclaimer, confidence level, rate source, risk flags (e.g. HEURISTIC_ESTIMATE), and key assumptions about the estimate.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "origin": {
   "type": "object",
   "required": [
    "country"
   ],
   "properties": {
    "city": {
     "type": "string",
     "maxLength": 100,
     "minLength": 1
    },
    "country": {
     "type": "string",
     "maxLength": 2,
     "minLength": 1
    },
    "postalCode": {
     "type": "string",
     "maxLength": 20,
     "minLength": 1
    }
   },
   "additionalProperties": false
  },
  "currency": {
   "type": "string",
   "default": "USD",
   "maxLength": 3,
   "minLength": 1
  },
  "shipment": {
   "type": "object",
   "required": [
    "weightKg",
    "quantity"
   ],
   "properties": {
    "widthCm": {
     "type": "number",
     "maximum": 1000,
     "exclusiveMinimum": 0
    },
    "category": {
     "type": "string",
     "maxLength": 60,
     "minLength": 1
    },
    "heightCm": {
     "type": "number",
     "maximum": 1000,
     "exclusiveMinimum": 0
    },
    "lengthCm": {
     "type": "number",
     "maximum": 1000,
     "exclusiveMinimum": 0
    },
    "quantity": {
     "type": "integer",
     "default": 1,
     "maximum": 10000,
     "minimum": 1
    },
    "weightKg": {
     "type": "number",
     "maximum": 100000,
     "exclusiveMinimum": 0
    },
    "declaredValue": {
     "type": "number",
     "maximum": 100000000,
     "minimum": 0
    }
   },
   "additionalProperties": false
  },
  "destination": {
   "type": "object",
   "required": [
    "country"
   ],
   "properties": {
    "city": {
     "type": "string",
     "maxLength": 100,
     "minLength": 1
    },
    "country": {
     "type": "string",
     "maxLength": 2,
     "minLength": 1
    },
    "postalCode": {
     "type": "string",
     "maxLength": 20,
     "minLength": 1
    }
   },
   "additionalProperties": false
  },
  "serviceLevel": {
   "enum": [
    "economy",
    "standard",
    "express",
    "auto"
   ],
   "type": "string",
   "default": "auto"
  },
  "shippingMode": {
   "enum": [
    "courier",
    "air",
    "sea",
    "road",
    "postal",
    "auto"
   ],
   "type": "string",
   "default": "auto"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "options": [],
  "provider": null,
  "riskFlags": [
   {
    "code": "HEURISTIC_ESTIMATE",
    "message": "This is a heuristic estimate, not an official carrier quote.",
    "severity": "medium"
   }
  ],
  "confidence": {
   "level": "low",
   "reason": "Illustrative heuristic data; no live carrier quote or configured internal route rate is assumed."
  },
  "rateSource": "heuristic_estimate",
  "assumptions": [
   "Illustrative example only; no live carrier quote."
  ],
  "generatedAt": "2026-01-01T00:00:00.000Z",
  "serviceLevel": "standard",
  "shippingMode": "air",
  "costBreakdown": {
   "handling": 6,
   "baseFreight": 48,
   "fuelSurcharge": 9,
   "oversizeSurcharge": 0,
   "estimatedOtherFees": 4,
   "remoteAreaSurcharge": 0
  },
  "estimatedCost": {
   "max": 78,
   "min": 55,
   "currency": "USD"
  },
  "actualWeightKg": 8,
  "dutiesAndTaxes": {
   "note": "Import duties and taxes are not included in the shipping estimate.",
   "included": false,
   "estimatedAmount": null
  },
  "chargeableWeightKg": 9.45,
  "volumetricWeightKg": 9.45,
  "recommendedEstimate": 66.5,
  "estimatedTransitDays": {
   "max": 8,
   "min": 4
  },
  "recommendedOptionReason": null
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/rafid-logistics-shipping-cost-estimate-3b8c355f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.rafidsystem.com](https://www.zero.xyz/host/api.rafidsystem.com/llms.txt)