Skip to main content
👩‍💻Developer platform

Build on
CouthActs.

A clean REST API, real-time webhooks, 9 tracking layers, and a playground that doesn’t hate you. Plug global transportation straight into your software.

Get API keys Enterprise API

Plans

Pick your lane.

🌱

Starter

Free

Testing and prototyping.

  • 1,000 API calls / month
  • Public tracking endpoint
  • Standard rate limits
  • Community support
Get started
🚀Popular

Growth

$299/mo

Production integrations.

  • 5,000 API calls / month + $0.20/call overage
  • Webhook notifications
  • All tracking layers
  • Email support
  • Sandbox environment
Start building
💎

Enterprise

Custom

Large-scale operations.

  • Unlimited API calls
  • Custom SLA
  • Dedicated support engineer
  • White-label tracking
  • SSO + IP allowlisting
  • Custom webhook filters
Contact sales

Quick start

Three steps to your first call.

Step 01🔑

Get your API key

Sign in, Settings, generate a Provider API key. Starts with ca_live_ or ca_test_.

Step 02⚡

Make your first request

Use your key in Authorization: Bearer. Start with GET /api/provider/v1/jobs.

Step 03🪝

Set up webhooks

Configure webhook URLs in Settings to get real-time job and tracking updates.

Example request

curl -X GET https://couthacts.com/api/provider/v1/jobs \
  -H "Authorization: Bearer ca_live_your_key_here" \
  -H "Content-Type: application/json"

# Response
{
  "success": true,
  "data": {
    "jobs": [
      {
        "id": "clx...",
        "title": "Freight: Dallas, TX → Houston, TX",
        "mode": "FREIGHT_TRUCKING",
        "budgetUsd": 2500,
        "origin": "Dallas, TX",
        "destination": "Houston, TX",
        "scheduledPickup": "2026-04-05T08:00:00Z",
        "trackingLayers": ["MOBILE_GPS", "ELD_INTEGRATION"],
        "bidsCount": 3
      }
    ]
  }
}

Endpoints

Full reference.

POST/api/v1/jobs

Create a new transportation job with full mode-specific workflow.

API Key
GET/api/v1/jobs

List your jobs with filtering by status, mode, and date range.

API Key
GET/api/v1/wallet

Check wallet balance, transaction history, and escrow holds.

API Key
POST/api/provider/v1/tracking

Push GPS/AIS/flight tracking updates for active bookings.

Provider API Key
GET/api/provider/v1/bookings

List provider bookings with status, escrow, and tracking data.

Provider API Key
GET/api/provider/v1/jobs

Browse available jobs matching your registered transport modes.

Provider API Key
GET/api/provider/v1/wallet

Provider wallet balance, earnings, and advance eligibility.

Provider API Key
GET/api/track/{code}

Public tracking endpoint. No authentication required.

None

Tracking API

Nine layers. One stream.

Push tracking from any layer. Each event is timestamped, geotagged, and streamed in real-time to the customer.

📍MOBILE_GPS

Mobile GPS

Real-time ground vehicle GPS coordinates

⚓AIS_MARITIME

AIS Maritime

Automatic Identification System for vessels

✈️FLIGHT_TRACKING

Flight Tracking

ADS-B transponder data for aircraft

🚚ELD_INTEGRATION

ELD Integration

Electronic Logging Device for commercial trucks

🔐QR_PIN_CONFIRMATION

QR/PIN Confirmation

Cryptographic pickup/delivery proof

🌡️IOT_DEVICE

IoT Device

Temperature, humidity, shock sensors

🛰️SATELLITE

Satellite

GPS + GLONASS for low-coverage areas

📄DOCUMENT_POD_AI

Document POD/AI

Proof of delivery with AI verification

👤BIOMETRIC

Biometric

Identity confirmation at handoff

Push a tracking event

POST /api/provider/v1/tracking
Authorization: Bearer ca_live_your_key_here

{
  "bookingId": "clx...",
  "lat": 32.7767,
  "lng": -96.7970,
  "layer": "MOBILE_GPS",
  "status": "IN_TRANSIT",
  "note": "Departed Dallas warehouse"
}

# Maritime example
{
  "bookingId": "clx...",
  "lat": 29.7604,
  "lng": -95.3698,
  "layer": "AIS_MARITIME",
  "status": "UNDERWAY",
  "note": "Passing Houston Ship Channel"
}

Auth & security

Secure by default.

🔑

API key auth

Every request needs Authorization: Bearer. Generated in Settings, revocable anytime.

🔒

HTTPS only

All API traffic encrypted in transit. Plaintext HTTP rejected.

🛡️

Rate limiting

Per-key. Starter: 100/day. Growth: 10K/day. Enterprise: custom.

👁️

Audit logging

Every call logged with timestamp, IP, endpoint, response code. Viewable in dashboard.

🌍

CORS & IP allowlist

Enterprise plans restrict access to specific origins and IP ranges.

✍️

Webhook signatures

Outbound webhooks include HMAC signatures. Verify the payload is really us.

Response format

Consistent. Predictable.

Success (2xx)

{
  "success": true,
  "data": { ... },
  "meta": {
    "requestId": "req_...",
    "timestamp": "2026-04-01T..."
  }
}

Error (4xx/5xx)

{
  "success": false,
  "error": {
    "code": "INVALID_INPUT",
    "message": "bookingId required"
  },
  "meta": {
    "requestId": "req_...",
    "timestamp": "2026-04-01T..."
  }
}
🛠️Builders welcome

Ready to integrate?

Get your API key and start building in minutes. Enterprise customers get a dedicated support engineer and custom SLA.

Get API keys Enterprise API