Developer Platform

Build on
CouthActs.

RESTful API with webhooks, real-time tracking streams across 9 layers, and programmatic job management. Integrate global transportation into your software.

Get API keys Enterprise API

Plans

Choose your API tier.

Starter

Free

For testing and prototyping.

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

Growth

$299/mo

For production integrations.

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

Enterprise

Custom

For 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 API call.

01

Get your API key

Sign in, go to Settings, and generate a Provider API key. Your key starts with ca_live_ or ca_test_.

02

Make your first request

Use your API key in the Authorization: Bearer header. Start with GET /api/provider/v1/jobs to list available jobs.

03

Set up webhooks

Configure webhook URLs in Settings to receive real-time notifications for job status changes 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 API 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

9 tracking layers via API.

Push tracking events 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"
}

Authentication & Security

Secure by default.

API Key Authentication

Every request requires an Authorization: Bearer header. Keys are generated in Settings and can be revoked at any time.

HTTPS Only

All API traffic is encrypted in transit. Plaintext HTTP requests are rejected.

Rate Limiting

Requests are rate-limited per key. Starter: 100/day. Growth: 10K/day. Enterprise: custom.

Audit Logging

Every API call is logged with timestamp, IP, endpoint, and response code. Available in your dashboard.

CORS & IP Allowlisting

Enterprise plans can restrict API access to specific origins and IP ranges.

Webhook Signatures

Outbound webhooks include HMAC signatures so you can verify the payload originated from CouthActs.

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..."
  }
}

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