Search
K
Stage - Membership API

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

CarrierMatchResourceResponse

object

The created carrier match, with carriers ranked and enriched.

hrefstring

Canonical self URL for the created carrier match.

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

carriersarray[object]

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

Show Child Parameters
Example