Membership API

CustomerResponse

object

A customer record.

companyNamestring

The name of the company.

Example:Smart Logistics

emailstring

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

Example:contact@aculogistics.com

phoneNumbersarray[object]

Details of a customerโ€™s phone number.

Show Child Parameters
addressesarray[object]

Details of a customerโ€™s address.

Show Child Parameters
customerAuthorityNumbersarray[object]

Details of a customerโ€™s authority number.

Show Child Parameters
customerIdstring(uuid)

The Central Dispatch customer ID of the customer.

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

accessPausedboolean

Indicates if the company has temporarily lost access to their account due to security reasons.

Example:true

Example
{
  "companyName": "Smart Logistics",
  "email": "contact@aculogistics.com",
  "phoneNumbers": [
    {
      "phoneNumber": "949-555-1323",
      "type": "LOCAL",
      "extension": "303",
      "notes": "Primary contact number"
    }
  ],
  "addresses": [
    {
      "streetAddress": "345 W Elm St.",
      "streetAddress2": "2nd Floor",
      "city": "Anaheim",
      "state": "CA",
      "zipcode": "92802",
      "type": "PRIMARY"
    }
  ],
  "customerAuthorityNumbers": [
    {
      "number": "DL 01-00673-10",
      "verified": true,
      "type": "DEALER_LICENSE"
    }
  ],
  "customerId": "d5c62b14-cbd1-11ee-9a0e-0242ac110002",
  "accessPaused": true
}

CustomerSearchCollection

object

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

Example
{
  "href": "https://membership-api.centraldispatch.com/customers/?start=5&limit=1&name=acu",
  "count": 23,
  "items": [
    {
      "customerName": "Acu Logistics",
      "customerId": "d5c62b14-cbd1-11ee-9a0e-0242ac110002",
      "email": "trans-port@notgmail.com",
      "phoneNumbers": [
        {
          "phoneNumber": "949-555-1323",
          "type": "LOCAL",
          "extension": "303",
          "notes": "Primary contact number"
        }
      ],
      "addresses": [
        {
          "streetAddress": "345 W Elm St.",
          "streetAddress2": "2nd Floor",
          "city": "Anaheim",
          "state": "CA",
          "zipcode": "92802",
          "type": "PRIMARY"
        }
      ],
      "customerAuthorityNumbers": [
        {
          "number": "DL 01-00673-10",
          "verified": true,
          "type": "DEALER_LICENSE"
        }
      ]
    }
  ],
  "limit": 1
}

CustomerSearchResponse

object

A customer record.

customerNamestring

The customerโ€™s name.

Example:Acu Logistics

customerIdstring

The Central Dispatch customer ID of the customer.

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

emailstring

The email address of the customer.

Example:trans-port@notgmail.com

phoneNumbersarray[object]

Details of a customerโ€™s phone number.

Show Child Parameters
addressesarray[object]

Details of a customerโ€™s address.

Show Child Parameters
customerAuthorityNumbersarray[object]

Details of a customerโ€™s authority number.

Show Child Parameters
Example
{
  "customerName": "Acu Logistics",
  "customerId": "d5c62b14-cbd1-11ee-9a0e-0242ac110002",
  "email": "trans-port@notgmail.com",
  "phoneNumbers": [
    {
      "phoneNumber": "949-555-1323",
      "type": "LOCAL",
      "extension": "303",
      "notes": "Primary contact number"
    }
  ],
  "addresses": [
    {
      "streetAddress": "345 W Elm St.",
      "streetAddress2": "2nd Floor",
      "city": "Anaheim",
      "state": "CA",
      "zipcode": "92802",
      "type": "PRIMARY"
    }
  ],
  "customerAuthorityNumbers": [
    {
      "number": "DL 01-00673-10",
      "verified": true,
      "type": "DEALER_LICENSE"
    }
  ]
}

Error

object

Details of an error or issue.

codestring

The code used for the issue.

Example:resource.issue_type

messagestring

A detailed message.

Example:The issue happened because something is wrong.

propertystring

The property to which the issue is associated.

Example:person

propertiesobject

Additional properties related to the issue.

Example:{"firstName":"D0nn@","lastName":"Sm!th"}

Example
{
  "code": "resource.issue_type",
  "message": "The issue happened because something is wrong.",
  "property": "person",
  "properties": {
    "firstName": "D0nn@",
    "lastName": "Sm!th"
  }
}

Errors

object

An error occurred, and the request could not be completed.

errorsarray[object]

Details of an error or issue.

Show Child Parameters
Example
{
  "errors": [
    {
      "code": "resource.issue_type",
      "message": "The issue happened because something is wrong.",
      "property": "person",
      "properties": {
        "firstName": "D0nn@",
        "lastName": "Sm!th"
      }
    }
  ]
}