Search Customers
POST/customers/search
> The customers search endpoint is only available on the Propeller cloud version.
Retrieves a list of customers by using the search fields below. Results will be paginated.
Field | Type |
---|---|
debtorIds | array(string) |
dateCreated | DateFilter |
dateModified | DateFilter |
offset | integer |
page | integer |
Date filter
A date filter is a special date search object that can search through a range:
{
"from": "2020-12-12T00:00:00",
"to": "2022-12-12T00:00:00"
}
Request
Query Parameters
Use expands
as a query parameter to fetch additional information for customers like sources, parent, etc.
sources
: if the "expands" parameter contains this value, the response from the API will return additional source information describing where this resource is imported from. If there are no sources for this resource then the sources
property in the response will be just an empty array.
- application/json
Body
dateCreated
object
dateModified
object
Responses
- 200
- 400
Search Customers - 200
Response Headers
Alt-Svc
string
Via
string
alt-svc
string
content-length
string
date
string
return-format
string
x-request-id
string
- application/json
- Schema
- Example (from schema)
- Search Customers - 200
Schema
Array [
]
data
object[]
{
"data": [
{
"abbreviation": "MM",
"dateCreated": "2023-05-23T11:35:59",
"dateModified": "2023-05-23T11:54:56",
"dateOfBirth": "August, 28 1993 00:00:00 +0000",
"debtorId": "12345",
"email": "miles@propel.us",
"fax": "",
"firstName": "Miles",
"gender": "M",
"id": 25494,
"lastName": "McCoy",
"login": "miles@propel.us",
"middleName": "",
"mobile": "0032445888",
"name": "Miles McCoy",
"phone": "0032445888",
"pricelistAmount": "",
"pricelistPercentage": "",
"primaryLanguage": "EN",
"ssn": "",
"title": "Mr."
},
{
"abbreviation": "SV",
"dateCreated": "2023-06-07T13:40:40",
"dateModified": "2023-08-31T13:22:19",
"dateOfBirth": "August, 28 1993 00:00:00 +0000",
"debtorId": "12345",
"email": "sander.v@gmail.com",
"fax": "",
"firstName": "Sander",
"gender": "M",
"id": 25513,
"lastName": "Vleugelhof",
"login": "sander.v@gmail.com",
"middleName": "",
"mobile": "0032445888",
"name": "Sander Vleugelhof",
"phone": "0032445888",
"pricelistAmount": "",
"pricelistPercentage": "",
"primaryLanguage": "EN",
"ssn": "",
"title": "Mr."
}
],
"end": 2,
"itemsFound": 2,
"messages": [
"Completed"
],
"offset": 12,
"page": 1,
"pages": 1,
"start": 1,
"total": 2
}
{
"data": [
{
"abbreviation": "MM",
"dateCreated": "2023-05-23T11:35:59",
"dateModified": "2023-05-23T11:54:56",
"dateOfBirth": "August, 28 1993 00:00:00 +0000",
"debtorId": "12345",
"email": "miles@propel.us",
"fax": "",
"firstName": "Miles",
"gender": "M",
"id": 25494,
"lastName": "McCoy",
"login": "miles@propel.us",
"middleName": "",
"mobile": "0032445888",
"name": "Miles McCoy",
"phone": "0032445888",
"pricelistAmount": "",
"pricelistPercentage": "",
"primaryLanguage": "EN",
"ssn": "",
"title": "Mr."
},
{
"abbreviation": "SV",
"dateCreated": "2023-06-07T13:40:40",
"dateModified": "2023-08-31T13:22:19",
"dateOfBirth": "August, 28 1993 00:00:00 +0000",
"debtorId": "12345",
"email": "sander.v@gmail.com",
"fax": "",
"firstName": "Sander",
"gender": "M",
"id": 25513,
"lastName": "Vleugelhof",
"login": "sander.v@gmail.com",
"middleName": "",
"mobile": "0032445888",
"name": "Sander Vleugelhof",
"phone": "0032445888",
"pricelistAmount": "",
"pricelistPercentage": "",
"primaryLanguage": "EN",
"ssn": "",
"title": "Mr."
}
],
"end": 2,
"itemsFound": 2,
"messages": [
"Completed"
],
"offset": 12,
"page": 1,
"pages": 1,
"start": 1,
"total": 2
}
Search Customers - 400
Response Headers
Alt-Svc
string
Via
string
alt-svc
string
content-length
string
date
string
return-format
string
x-request-id
string
- application/json
- Schema
- Example (from schema)
- Search Customers - 400
Schema
error
object
{
"error": {
"code": 10007,
"messages": [
"#: extraneous key [name] is not permitted"
],
"moreInfo": "https://www.propel.us/docs/errors/10007",
"status": 400,
"type": "SchemaValidationException"
}
}
{
"error": {
"code": 10007,
"messages": [
"#: extraneous key [name] is not permitted"
],
"moreInfo": "https://www.propel.us/docs/errors/10007",
"status": 400,
"type": "SchemaValidationException"
}
}