/
Get a Customer list

Get a Customer list

Use this method to get a list of Customers.

Valid Tokens: Company and Vendor.

You can send parameters such as the id, code and name in order to filter the results.

Take the following statements into account when applying filters:

  • Filtering by id and code uses an exact match.

  • Filtering by name uses a "LIKE" expression.

  • Filters are not case sensitive.


Request


URL: https://api.kometsales.com/api/customer.list

Method: GET

Content-Type: URL Parameters


Input parameters

authenticationToken (required)(string:50)

Komet Sales security token.


id (optional)(integer:20)

Komet Sales internal Customer ID.


name (optional)(string:200)

Customer’s name.


code (optional)(string:10)

Customer’s code.


salesPersonId (optional)(integer:20)

Komet Sales internal Salesperson ID.


includeInactive (optional)(boolean)

Include inactive Customers.

Valid values: 1 = Yes | 0 = No 


locationId (optional)(integer:20)

Komet Sales internal Location ID. Only applies to Multi-Location companies.

You can get this value from the location.list API method.


updateAsOf (optional) (date)

Include only Customers that were updated on or after a specific date.

Date format: YYYY-MM-DD

https://api.kometsales.com/api/customer.list? authenticationToken=token_info_goes_here

 


Response


status (integer:1)

Transaction status.

Valid values: 1 = Success | 0 = Failure


message (string:500)

Transaction status description.


customers (array)

An array containing Customers.


id (integer:20)

Komet Sales internal Customer ID.


name (string:200)

Customer’s name.


code (string:10)

Customer code.


salesPerson (string:200)

Salesperson name.


salesPersonId (integer:20)

Salesperson ID.


customerType (string:200)

Customer type.

Example: Retailer, Wholesaler, etc.


active (boolean:1)

If the Customer is active.

Valid values: 1 = Active | 0 = Inactive


updatedOn (datetime)

Date when the Customer was last updated.

Date format: YYYY-MM-DD'T'hh:mm:ss


accountingCode (string:20)

Customer’s accounting code.


currency (string)

Customer’s currency.


exchangeRate (float)

Assigned exchange rate.


daysOfService (array)

Customer’s days of service and carriers for each day.


Sunday (string)

Carrier assigned for this day.


Monday (string)

Carrier assigned for this day.


Tuesday (string)

Carrier assigned for this day.


Wednesday (string)

Carrier assigned for this day.


Thursday (string)

Carrier assigned for this day.


Friday (string)

Carrier assigned for this day.


Saturday (string)

Carrier assigned for this day.


{ "status":"1", "message":"OK", "customers":[ { "id":"561333", "name":"ABC Flowers - EURO1", "code":"561333", "salesPerson":"", "customerType":"", "active":"1", "updatedOn":"2025-02-11T21:01:52", "accountingCode":"", "currency":"EUR", "exchangeRate":1.0, "daysOfService":{ "Sunday":"Armellini", "Monday":"Prime Floral", "Tuesday":"Prime Floral", "Wednesday":"Prime Floral", "Thursday":"Prime Floral", "Friday":"Armellini", "Saturday":"Prime Floral" } } ] }

 

Peacock

Related content