04 · Send dispatch offer to carrier

POST

/api/v1/super-dispatch/dispatches/{uuid}/shares

Last modified:2026-09-18 19:26:21

Creates/reuses a child order, then sends an offer to the native carrier USDOT; the vendor may notify the carrier by email/SMS. Repeated successful submissions return the existing child. A failed post/offer preserves order_guid. No native fields change. Native data is re-read at submission time. Localhost is not a vendor sandbox.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Successful response

Bodyapplication/json

🟠401401

🟠404404

🟠409409

🟠422422

🟠429429

🔴500500

🔴502502

🔴503503

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://connect.dispatchable.com/super-dispatch/api/v1/super-dispatch/dispatches/33333333-3333-4333-8333-333333333333/shares' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "account_uuid": "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa",
    "confirm_share": true
}'

Response Example

200 - Success

{
    "success": true,
    "data": {
        "id": 1,
        "uuid": "44444444-4444-4444-8444-444444444444",
        "company_uuid": "demo-company",
        "account_uuid": "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa",
        "parent_type": "dispatches",
        "parent_uuid": "33333333-3333-4333-8333-333333333333",
        "load_uuid": "22222222-2222-4222-8222-222222222222",
        "order_guid": "55555555-5555-4555-8555-555555555555",
        "offer_guid": "66666666-6666-4666-8666-666666666666",
        "status": "pending",
        "is_posted": false,
        "last_error": null,
        "synced_at": "2026-09-18T16:00:00.000000Z",
        "created_at": "2026-09-18T16:00:00.000000Z",
        "updated_at": "2026-09-18T16:00:00.000000Z"
    }
}

Modified at 2026-09-18 19:26:21

List dispatche shares

05 · Refresh vendor status