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
andcode
uses an exact match.Filtering by
name
uses a "LIKE" expression.Filters are not case sensitive.
Related Articles
-
Delete a Prebook 1.0 (API)
-
-
-
Add Inventory (API)
-
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"
}
}
]
}