Search
K
Stage - Membership API

Create Carrier Match

Requests ranked carrier recommendations for a listing and persists the match, returning up to 10 carriers enriched with ratings, tenure, contact information, preferred-network status, and advisory warnings.

👥 Customer Type

  • Shipper

📝 Important Notes

  • Requires an authorized Premium shipper account.
  • The response will contain a Location header that contains the fully qualified URL of the newly created resource. The final segment of the URL will be the ID of the resource.
  • If no carriers are matched, the response is still 201 with an empty carriers collection — the match is persisted and has an ID.
post
https://membership-api.centraldispatch.com/carrier-matches/ref/listings/id/{listingId}

Path Parameters

listingIdstringrequired

The ID of the listing.

Example:42220470

Headers

X-CoxAuto-Caller-Channelstring

Marks the source of the carrier match request. The only supported value is API; the header may also be omitted.

Example:API

X-CoxAuto-AcceptFallbackstring

Opts into a degraded response when carrier rating data is temporarily unavailable. When true, overallRating and recentRating are omitted from the response and a Warning header is returned instead of a 503.

Example:true

Content-Typestringrequired

The major version of the API to make a request against. This is a custom MIME type that contains vnd.coxauto.v[#]+. For example, to request a resource from version 1.x.x of an API, the Content-Type header should be set to application/vnd.coxauto.v1+json.

Example:application/vnd.coxauto.v1+json

Response

application/json

Created. Successful request.

CarrierMatchResourceResponse

The created carrier match, with carriers ranked and enriched.

hrefstring | null

Canonical self URL for the created carrier match.

Example:https://membership-api.centraldispatch.com/carrier-matches/id/c1a7e9d0-4b3f-4a1e-9c6d-8f2b5a7e0c14

carriersarray | null[object]

A carrier matched for a listing, enriched with rating, tenure, contact, and network information.

Show Child Parameters
post/carrier-matches/ref/listings/id/{listingId}
 
application/json

Get Carrier Match by ID

Record/reference view of a persisted carrier match — self href, listing reference href, creation time, and a collection of carrier reference hrefs. Carrier data is not re-enriched.

📝 Important Notes

  • Ownership-gated: a carrier match that exists but belongs to a different shipper is indistinguishable from one that does not exist and returns 404.
get
https://membership-api.centraldispatch.com/carrier-matches/id/{carrierMatchId}

Path Parameters

carrierMatchIdstringrequired

The ID of the carrier match.

Example:c1a7e9d0-4b3f-4a1e-9c6d-8f2b5a7e0c14

Headers

Acceptstringrequired

The major version of the API to make a request against. This is a custom MIME type that contains vnd.coxauto.v[#]+. For example, to request a resource from version 1.x.x of an API, the Accept header should be set to application/vnd.coxauto.v1+json.

Example:application/vnd.coxauto.v1+json

Response

application/json

OK. Successful request.

CarrierMatchRecordResponse

Record/reference view of a persisted carrier match.

hrefstring | null

Canonical self URL for this carrier match.

Example:https://membership-api.centraldispatch.com/carrier-matches/id/c1a7e9d0-4b3f-4a1e-9c6d-8f2b5a7e0c14

listingstring | null

Reference href to the listing this match was created for.

Example:https://membership-api.centraldispatch.com/listings/id/42220470

createdOnstring(date-time)

The creation date and time of the item, in UTC/ISO 8601 format.

Example:2024-10-15T00:00:00Z

carriersarray | null[string]

Collection of reference hrefs to the matched carriers’ customer resources. No enrichment fields.

Example:["https://membership-api.centraldispatch.com/customers/id/0ca91a43-fbee-4c05-9a6c-aa5c63888f5c"]

get/carrier-matches/id/{carrierMatchId}
 
application/json

AddressResponse

object

Details of a customer’s address.

streetAddressstring

The street address.

Example:345 W Elm St.

streetAddress2string

Additional street address line.

Example:2nd Floor

citystring

The city.

Example:Anaheim

statestring

The state.

Example:CA

zipcodestring

The ZIP code. Must be a valid United States ZIP code or Canadian postal code.

Example:92802

typestring

The type of address (e.g., PRIMARY, LOCAL, BILLING).

Example:PRIMARY

Example

AuthorityNumberResponse

object

Details of a customer’s authority number.

numberstring

The authority number assigned to the customer.

Example:DL 01-00673-10

verifiedboolean

Indicates whether the authority number is verified.

Example:true

typestring

The type of authority number.

Example:DEALER_LICENSE

Example

CarrierMatchRecordResponse

object

Record/reference view of a persisted carrier match.

hrefstring

Canonical self URL for this carrier match.

Example:https://membership-api.centraldispatch.com/carrier-matches/id/c1a7e9d0-4b3f-4a1e-9c6d-8f2b5a7e0c14

listingstring

Reference href to the listing this match was created for.

Example:https://membership-api.centraldispatch.com/listings/id/42220470

createdOnstring(date-time)

The creation date and time of the item, in UTC/ISO 8601 format.

Example:2024-10-15T00:00:00Z

carriersarray[string]

Collection of reference hrefs to the matched carriers’ customer resources. No enrichment fields.

Example:https://membership-api.centraldispatch.com/customers/id/0ca91a43-fbee-4c05-9a6c-aa5c63888f5c

Example