Shippers

Optimize your shipping operations with CHRT's comprehensive delivery API

Shippers need reliable, trackable delivery solutions for their cargo. CHRT’s API enables you to create orders, connect with trusted couriers, and monitor shipments from pickup to delivery.

Quick Start

  1. Create Account: Sign up at chrt.com
  2. Get API Access: Contact us to obtain your Bearer token
  3. Set Base URL: Use https://api.chrt.com for production

Core Workflows

Organization Setup

Establish your shipping organization profile to connect with couriers and manage operations.

Register Your Organization

1POST /oort/org_connection_infos/create/shipper_org_info

View in API Reference →

1{
2  "schema_version": 1,
3  "email_address_primary": "logistics@manufacturer.com",
4  "contact_first_name": "Sarah",
5  "contact_last_name": "Johnson",
6  "phone_number_primary": "+1-555-0123",
7  "industry": "Medical Devices",
8  "job_title": "Supply Chain Manager",
9  "street_address": {
10    "type": "Feature",
11    "geometry": {
12      "type": "Point",
13      "coordinates": [-122.4194, 37.7749]
14    },
15    "properties": {
16      "address": "123 Industrial Blvd, San Francisco, CA 94107"
17    }
18  }
19}

Get Your Organization Info

1GET /oort/org_connection_infos/get/shipper_org_info

View in API Reference →

Update Organization Details

1PATCH /oort/org_connection_infos/update/shipper_org_info

View in API Reference →

Order Creation & Management

Create and manage shipment orders with detailed cargo specifications and routing requirements.

Create a New Order

1POST /oort/orders/create

View in API Reference →

1{
2  "order_client_create": {
3    "schema_version": 1
4  },
5  "task_client_creates_bundle_groupings": [
6    [
7      {
8        "task_client_create": {
9          "schema_version": 1,
10          "action": "pickup",
11          "location": {
12            "type": "Feature",
13            "geometry": {
14              "type": "Point",
15              "coordinates": [-122.4194, 37.7749]
16            },
17            "properties": {
18              "address": "123 Medical Center Dr, San Francisco, CA"
19            }
20          },
21          "primary_point_of_contact_id": "contact_123",
22          "secondary_point_of_contact_id": "contact_456",
23          "arrive_by": "2024-01-15T10:00:00Z",
24          "arrive_at": "2024-01-15T09:00:00Z",
25          "comments": "Medical equipment pickup",
26          "flight_number": null
27        },
28        "milestone_client_creates": [
29          {
30            "schema_version": 1,
31            "type": "image",
32            "requestor_comments": "Proof of pickup"
33          }
34        ],
35        "cargo_client_creates_uuids": ["cargo-uuid-1"],
36        "email_addresses": ["logistics@company.com"],
37        "flight_number": null
38      },
39      {
40        "task_client_create": {
41          "schema_version": 1,
42          "action": "deliver",
43          "location": {
44            "type": "Feature",
45            "geometry": {
46              "type": "Point",
47              "coordinates": [-118.2437, 34.0522]
48            },
49            "properties": {
50              "address": "456 Hospital Way, Los Angeles, CA"
51            }
52          },
53          "primary_point_of_contact_id": "contact_789",
54          "secondary_point_of_contact_id": "contact_012",
55          "arrive_by": "2024-01-15T18:00:00Z",
56          "arrive_at": "2024-01-15T17:00:00Z",
57          "comments": "Medical equipment delivery",
58          "flight_number": null
59        },
60        "milestone_client_creates": [
61          {
62            "schema_version": 1,
63            "type": "signature",
64            "requestor_comments": "Delivery confirmation"
65          }
66        ],
67        "cargo_client_creates_uuids": ["cargo-uuid-1"],
68        "email_addresses": ["logistics@company.com"],
69        "flight_number": null
70      }
71    ]
72  ],
73  "cargo_client_creates_map": {
74    "cargo-uuid-1": {
75      "schema_version": 1,
76      "cargo_type": "medical_devices",
77      "quantity": 2,
78      "weight_pounds": 45.5,
79      "length_inches": 24,
80      "width_inches": 18,
81      "height_inches": 12
82    }
83  },
84  "order_created_by_type": "shipper",
85  "order_dispatch_type": "dtc",
86  "transport_type": "ground",
87  "shipper_org_id": "org_abc123",
88  "shipper_user_id": "user_xyz789",
89  "courier_org_id": null
90}

View Your Orders

1GET /oort/orders/list/by_shipper_org_id

View in API Reference →

Returns all orders created by your organization.

Get Complete Order Details

1GET /oort/orders/list/by_shipper_org_id/full

View in API Reference →

Get comprehensive tracking information including:

  • Real-time courier location
  • Milestone progress updates
  • Estimated delivery times
  • Proof of delivery documentation

Get Specific Order Details

1GET /oort/orders/{order_id_or_short_id}/full

View in API Reference →

Get detailed information for a specific order including all task groups, tasks, milestones, and cargo.

Cancel an Order

1PUT /oort/orders/{order_id_or_short_id}/cancel

View in API Reference →

Cancel orders before pickup or in emergency situations.

User Management

Manage team members who can create and track shipments on behalf of your organization.

Add Team Member

1POST /oort/shipper_user_info/create

View in API Reference →

1{
2  "schema_version": 1,
3  "shipper_org_id": "org_abc123",
4  "shipper_user_id": "user_xyz789",
5  "company_name": "Medical Supply Co",
6  "industry": "Medical Devices",
7  "street_address": {
8    "type": "Feature",
9    "geometry": {
10      "type": "Point",
11      "coordinates": [-122.4194, 37.7749]
12    },
13    "properties": {
14      "address": "123 Industrial Blvd, San Francisco, CA 94107"
15    }
16  },
17  "contact_first_name": "John",
18  "contact_last_name": "Smith",
19  "phone_number_primary": "+1-555-0456",
20  "job_title": "Logistics Coordinator"
21}

List Team Members

1GET /oort/shipper_user_info/list/by_org_id/{org_id}

View in API Reference →

Update Team Member Info

1PATCH /oort/shipper_user_info/update

View in API Reference →

Courier Connections

Build relationships with reliable courier networks to ensure consistent delivery capacity.

View Available Couriers

1GET /oort/connections/connections_info_for_shippers

View in API Reference →

Browse courier partners in your service areas with their capabilities and specializations.

Connect with Couriers

1POST /oort/connections/create_connection_to_courier

View in API Reference →

Establish partnerships with courier organizations that match your shipping needs.

Rate Management

Access and manage pricing for your shipments across different courier networks.

View Rate Sheets

1GET /rate_sheets/by_shipper_org_id/{org_id}

View in API Reference →

See pricing structures for different courier partners and cargo types.

Cargo Types & Specifications

CHRT supports comprehensive cargo classification for proper handling and pricing:

Medical & Healthcare

  • pharmaceuticals - Temperature-sensitive medications requiring cold chain
  • medical_devices - Sensitive medical equipment and instruments
  • lab_specimen - Laboratory samples requiring careful handling
  • blood - Blood products with strict temperature and time requirements
  • organ - Time-critical organ transport with priority routing

Industrial & Manufacturing

  • manufacturing_equipment - Heavy machinery and industrial equipment
  • aircraft_parts - Aviation components requiring certified handling
  • spare_parts - Automotive and equipment replacement parts
  • electronics - Sensitive electronic devices and components

Specialized Handling

  • hazardous_materials - Dangerous goods requiring permits and special handling
  • perishable - Time-sensitive perishable goods requiring refrigeration
  • frozen - Frozen goods requiring maintained cold chain
  • documents - Important legal, financial, or business documents
  • chemicals - Chemical products requiring proper containment

General Cargo

  • clothing - Apparel and textile products
  • other - Miscellaneous items not fitting other categories
  • unspecified - General cargo without specific classification

Task Actions & Milestones

Task Actions

Orders are structured around specific task actions:

  • pickup - Collect cargo from origin location
  • deliver - Deliver cargo to destination
  • transfer - Transfer cargo between vehicles or facilities
  • consolidate - Combine multiple shipments
  • tender - Hand over to another carrier
  • recover - Retrieve cargo from temporary storage
  • hold - Temporarily store cargo
  • other - Custom task actions

Milestone Types

Track progress with various milestone types:

  • image - Photo documentation (pickup/delivery proof)
  • signature - Digital signature confirmation
  • barcode_scan - Barcode scanning for tracking
  • qr_code_scan - QR code scanning for verification
  • user_action - Manual user confirmation
  • detected_by_app - Automatic app detection
  • order_in_progress - Order status milestone
  • other - Custom milestone types

Tracking & Notifications

Stay informed about your shipments with real-time updates and automated notifications.

Configure Notification Preferences

1POST /oort/notification_preferences/create

View in API Reference →

1{
2  "schema_version": 1,
3  "email_on_pickup": true,
4  "email_on_delivery": true,
5  "email_on_exception": true,
6  "sms_on_delivery": true,
7  "notification_email_ids": [
8    "logistics@company.com",
9    "customer@recipient.com"
10  ]
11}

Track Order Progress

Orders automatically update through key milestones:

  • Order Created - Order submitted to courier network
  • Pickup Scheduled - Courier assigned and pickup scheduled
  • Pickup Complete - Cargo collected and in transit
  • In Transit - Real-time location updates during transport
  • Delivery Complete - Cargo delivered with proof of delivery

Advanced Features

Multi-Cargo Shipments

  • Combine multiple cargo types in single orders
  • Specify individual handling requirements for each item
  • Optimize routing for complex delivery requirements

Temperature Monitoring

For temperature-sensitive cargo:

  • Real-time temperature logging during transport
  • Automated alerts for temperature excursions
  • Compliance documentation for regulatory requirements

Priority Routing

  • Express delivery options for time-critical shipments
  • Dedicated courier assignment for high-priority orders
  • Real-time routing optimization for fastest delivery

Chain of Custody

  • Complete audit trail from pickup to delivery
  • Digital signatures and photo documentation
  • Tamper-evident tracking for sensitive cargo

SDKs & Integration

Integrate CHRT into your existing systems with our official SDKs:

TypeScript:

$npm i -s @chrt-inc/typescript-sdk

See our SDK documentation for detailed examples and advanced configuration options.

Common Use Cases

1. Medical Supply Chain

  • Cargo types: pharmaceuticals, medical_devices, lab_specimen
  • Key features: Temperature monitoring, expedited delivery, compliance tracking
  • Best practices: Real-time monitoring, automated exception alerts, complete documentation

2. Manufacturing Logistics

  • Cargo types: manufacturing_equipment, spare_parts, electronics
  • Key features: Dimensional cargo handling, just-in-time delivery, industrial routing
  • Best practices: Precise scheduling, capacity planning, damage prevention

3. E-commerce Fulfillment

  • Cargo types: electronics, clothing, documents
  • Key features: Multi-destination routing, proof of delivery, customer notifications
  • Best practices: Automated tracking updates, delivery confirmations, exception handling

Best Practices

  • Provide accurate cargo dimensions for proper vehicle assignment and pricing
  • Use detailed pickup/delivery addresses including contact information and special instructions
  • Set up automated notifications to keep customers informed without manual intervention
  • Monitor temperature-sensitive shipments in real-time for compliance and quality
  • Maintain current team member information for proper access control and communication
  • Build relationships with multiple couriers to ensure delivery capacity and competitive pricing

Support

Need help with a specific integration? Contact our support team.