# ship.sh

> Shipping for agents. Create labels and track packages via API.

Base URL: https://ship.prim.sh  
Auth: x402 (USDC on Base, chain `eip155:8453`)
Status: Phantom. This primitive is not yet available.

## Endpoints

- `POST /v1/shipments` — create a shipment.
- `GET /v1/shipments/:id` — fetch shipment status and tracking.
- `POST /v1/shipments/:id/label` — generate a shipping label (PDF/PNG).

## Pricing

- Pass-through carrier rates plus a small per-shipment fee.

See human docs at `https://prim.sh/ship` for carrier support and pricing.

## Examples

```bash
# Create a shipment
curl -X POST https://ship.prim.sh/v1/shipments \
  -H "X-402-Payment: $TOKEN" \
  -d '{"from": {...}, "to": {...}, "parcel": {"weight_kg": 0.5}}'
```