Search
K
Membership API

Search Customers

Get a collection of customers based on the specified search criteria.

get
https://membership-api.centraldispatch.com/customers

Query Parameters

marketplaceinteger(int32)required

Example:10000

namestring | null

The company name of the customer. If supplied, must be at least 3 characters in length.

Default:null

>= 3 characters

Example:The Transport Co.

mcNumberstring | null

Motor carrier number (MC Number) or authority number.

Default:null

Example:MC 123456

phoneNumberstring | null

The phone number of the customer.

Default:null

Example:800-555-9090

emailstring | null

The email address of the contact. Must be a valid email address format.

Default:null

Example:trans-port@notgmail.com

usDotNumberstring | null

The US Department of Transportation (USDOT) number.

Default:null

Example:USDOT 1234567

limit(startingPoint,numberOfResults)string

The maximum number of items to be returned in the response.

  • startingPoint is 1-based integer, default 1.
  • numberOfResults is an integer, default 25, maximum 500.

Example:limit(1,10)

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.

CustomerSearchCollection

A collection of customers.

hrefstringrequired

The URL used to query the current collection of the resource.

Example:https://membership-api.centraldispatch.com/customers/?start=5&limit=1&name=acu

countinteger(int32)required

The total count of resources in the collection.

Example:23

itemsarray[object]required

A customer record.

Show Child Parameters
limitinteger(int32)required

The maximum number of items to be returned in the response.

Example:1

get/customers
 
application/json

Get Customer by ID

Get a customer by ID

get
https://membership-api.centraldispatch.com/customers/id/{customerId}

Path Parameters

customerIdstring(uuid)required

The Central Dispatch customer ID of the customer.

Example:d5c62b14-cbd1-11ee-9a0e-0242ac110002

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.

CustomerResponse

A customer record.

companyNamestring | null

The name of the company.

Example:Smart Logistics

emailstring | null

The email address of the contact. Must be a valid email address format.

Example:contact@aculogistics.com

phoneNumbersarray | null[object]

Details of a customer’s phone number.

Show Child Parameters
addressesarray | null[object]

Details of a customer’s address.

Show Child Parameters
customerAuthorityNumbersarray | null[object]

Details of a customer’s authority number.

Show Child Parameters
customerIdstring | null(uuid)

The Central Dispatch customer ID of the customer.

Example:d5c62b14-cbd1-11ee-9a0e-0242ac110002

get/customers/id/{customerId}
 
application/json

Get User

Get a user by ID.

get
https://membership-api.centraldispatch.com/users/id/{userId}

Path Parameters

userIdstring(uuid)required

The Central Dispatch user ID.

Example:d71b5750-e89b-12d3-a456-426614174000

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.

UserResponse

A user record.

hrefstring

The fully qualified URL of the user record.

Example:https://membership-api.centraldispatch.com/users/id/d71b5750-e89b-12d3-a456-426614174000

userIdstring(uuid)

The ID of the user.

Example:d71b5750-e89b-12d3-a456-426614174000

firstNamestring

The first name of the user.

Example:Mickey

lastNamestring

The last name of the user.

Example:Smith

emailAddressstring | null

The email address of the user.

Example:mickey@snoogle.com

usernamestring

The username of the user.

Example:msmith

isActiveboolean

Indicates if the user is active.

Example:true

createdOnstring(date-time)

The creation date of the user (UTC/ISO 8601).

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

updatedOnstring(date-time)

The last updated date of the user (UTC/ISO 8601).

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

phoneNumberstring | null

The phone number of the user.

Example:949-555-1323

get/users/id/{userId}
 
application/json

Get My Users

Get all the users that are associated with the customer in the Bearer token.

get
https://membership-api.centraldispatch.com/users/mine

Query Parameters

limit(startingPoint,numberOfResults)string

The maximum number of items to be returned in the response.

  • startingPoint is 1-based integer, default 1.
  • numberOfResults is an integer, default 25, maximum 500.

Example:limit(1,10)

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.

UserCollection

A paginated collection of users.

hrefstring

The URL used to query the current collection of the resource.

Example:https://membership-api.centraldispatch.com/users/mine?limit(5,1)

itemsarray[object]

A user record.

Show Child Parameters
limitinteger(int32)

The maximum number of items to be returned in the response.

Example:1

nextstring | null

The URL to the next page of the collection, if available.

Example:https://membership-api.centraldispatch.com/users/mine?limit(6,1)

previousstring | null

The URL to the previous page of the collection, if available.

Example:https://membership-api.centraldispatch.com/users/mine?limit(4,1)

firststring | null

The URL to the first page of the collection.

Example:https://membership-api.centraldispatch.com/users/mine?limit(1,1)

countinteger(int32)

The total count of resources in the collection.

Example:23

get/users/mine
 
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