Search Users
POST/users/search
> The users search endpoint is only available on the Propeller cloud version.
Retrieves a list of users 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 users 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 Users - 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 Users - 200
Schema
Array [
]
data
object[]
{
"data": [
{
"abbreviation": "MM",
"cocNumber": "",
"company": "",
"dateCreated": "2023-05-12T20:07:04",
"dateModified": "2023-05-12T20:07:03",
"dateOfBirth": "August, 28 1993 00:00:00 +0000",
"debtorId": "12345",
"email": "miles@propel.us",
"fax": "",
"firstName": "Miles",
"fullName": "Miles McCoy",
"gender": "M",
"iban": "",
"id": 25474,
"lastName": "McCoy",
"login": "miles@propel.us",
"middleName": "",
"mobile": "0038975648",
"phone": "0032445888",
"pricelistAmount": "",
"pricelistPercentage": "",
"primaryLanguage": "EN",
"ssn": "",
"taxNumber": "",
"title": "Mr."
},
{
"abbreviation": "MM",
"cocNumber": "",
"company": "",
"dateCreated": "2023-07-14T20:18:56",
"dateModified": "2023-07-14T20:18:55",
"dateOfBirth": "August, 28 1993 00:00:00 +0000",
"debtorId": "12345",
"email": "miles@propel.us",
"fax": "",
"firstName": "Miles",
"fullName": "Miles McCoy",
"gender": "M",
"iban": "",
"id": 25515,
"lastName": "McCoy",
"login": "miles@propel.us",
"middleName": "",
"mobile": "0038975648",
"phone": "0032445888",
"pricelistAmount": "",
"pricelistPercentage": "",
"primaryLanguage": "EN",
"ssn": "",
"taxNumber": "",
"title": "Mr."
},
{
"abbreviation": "MM",
"cocNumber": "",
"company": "",
"dateCreated": "2023-07-14T20:19:28",
"dateModified": "2023-07-14T20:19:27",
"dateOfBirth": "August, 28 1993 00:00:00 +0000",
"debtorId": "12345",
"email": "1.miles@propel.us",
"fax": "",
"firstName": "Miles",
"fullName": "Miles McCoy",
"gender": "M",
"iban": "",
"id": 25516,
"lastName": "McCoy",
"login": "miles@propel.us",
"middleName": "",
"mobile": "0038975648",
"phone": "0032445888",
"pricelistAmount": "",
"pricelistPercentage": "",
"primaryLanguage": "EN",
"ssn": "",
"taxNumber": "",
"title": "Mr."
},
{
"abbreviation": "MM",
"cocNumber": "",
"company": "",
"dateCreated": "2023-07-14T20:19:46",
"dateModified": "2023-07-14T20:19:46",
"dateOfBirth": "August, 28 1993 00:00:00 +0000",
"debtorId": "12345",
"email": "miles@propel.us.com",
"fax": "",
"firstName": "Miles",
"fullName": "Miles McCoy",
"gender": "M",
"iban": "",
"id": 25517,
"lastName": "McCoy",
"login": "miles@propel.us",
"middleName": "",
"mobile": "0038975648",
"phone": "0032445888",
"pricelistAmount": "",
"pricelistPercentage": "",
"primaryLanguage": "EN",
"ssn": "",
"taxNumber": "",
"title": "Mr."
},
{
"abbreviation": "MM",
"cocNumber": "",
"company": "",
"dateCreated": "2023-07-14T20:21:01",
"dateModified": "2023-07-14T20:21:00",
"dateOfBirth": "August, 28 1993 00:00:00 +0000",
"debtorId": "12345",
"email": "miles@propel.us.com",
"fax": "",
"firstName": "Miles",
"fullName": "Miles McCoy",
"gender": "M",
"iban": "",
"id": 25518,
"lastName": "McCoy",
"login": "miles@propel.us",
"middleName": "",
"mobile": "0038975648",
"phone": "0032445888",
"pricelistAmount": "",
"pricelistPercentage": "",
"primaryLanguage": "EN",
"ssn": "",
"taxNumber": "",
"title": "Mr."
}
],
"end": 5,
"itemsFound": 5,
"messages": [
"Completed"
],
"offset": 12,
"page": 1,
"pages": 1,
"start": 1,
"total": 5
}
{
"data": [
{
"abbreviation": "MM",
"cocNumber": "",
"company": "",
"dateCreated": "2023-05-12T20:07:04",
"dateModified": "2023-05-12T20:07:03",
"dateOfBirth": "August, 28 1993 00:00:00 +0000",
"debtorId": "12345",
"email": "miles@propel.us",
"fax": "",
"firstName": "Miles",
"fullName": "Miles McCoy",
"gender": "M",
"iban": "",
"id": 25474,
"lastName": "McCoy",
"login": "miles@propel.us",
"middleName": "",
"mobile": "0038975648",
"phone": "0032445888",
"pricelistAmount": "",
"pricelistPercentage": "",
"primaryLanguage": "EN",
"ssn": "",
"taxNumber": "",
"title": "Mr."
},
{
"abbreviation": "MM",
"cocNumber": "",
"company": "",
"dateCreated": "2023-07-14T20:18:56",
"dateModified": "2023-07-14T20:18:55",
"dateOfBirth": "August, 28 1993 00:00:00 +0000",
"debtorId": "12345",
"email": "miles@propel.us",
"fax": "",
"firstName": "Miles",
"fullName": "Miles McCoy",
"gender": "M",
"iban": "",
"id": 25515,
"lastName": "McCoy",
"login": "miles@propel.us",
"middleName": "",
"mobile": "0038975648",
"phone": "0032445888",
"pricelistAmount": "",
"pricelistPercentage": "",
"primaryLanguage": "EN",
"ssn": "",
"taxNumber": "",
"title": "Mr."
},
{
"abbreviation": "MM",
"cocNumber": "",
"company": "",
"dateCreated": "2023-07-14T20:19:28",
"dateModified": "2023-07-14T20:19:27",
"dateOfBirth": "August, 28 1993 00:00:00 +0000",
"debtorId": "12345",
"email": "1.miles@propel.us",
"fax": "",
"firstName": "Miles",
"fullName": "Miles McCoy",
"gender": "M",
"iban": "",
"id": 25516,
"lastName": "McCoy",
"login": "miles@propel.us",
"middleName": "",
"mobile": "0038975648",
"phone": "0032445888",
"pricelistAmount": "",
"pricelistPercentage": "",
"primaryLanguage": "EN",
"ssn": "",
"taxNumber": "",
"title": "Mr."
},
{
"abbreviation": "MM",
"cocNumber": "",
"company": "",
"dateCreated": "2023-07-14T20:19:46",
"dateModified": "2023-07-14T20:19:46",
"dateOfBirth": "August, 28 1993 00:00:00 +0000",
"debtorId": "12345",
"email": "miles@propel.us.com",
"fax": "",
"firstName": "Miles",
"fullName": "Miles McCoy",
"gender": "M",
"iban": "",
"id": 25517,
"lastName": "McCoy",
"login": "miles@propel.us",
"middleName": "",
"mobile": "0038975648",
"phone": "0032445888",
"pricelistAmount": "",
"pricelistPercentage": "",
"primaryLanguage": "EN",
"ssn": "",
"taxNumber": "",
"title": "Mr."
},
{
"abbreviation": "MM",
"cocNumber": "",
"company": "",
"dateCreated": "2023-07-14T20:21:01",
"dateModified": "2023-07-14T20:21:00",
"dateOfBirth": "August, 28 1993 00:00:00 +0000",
"debtorId": "12345",
"email": "miles@propel.us.com",
"fax": "",
"firstName": "Miles",
"fullName": "Miles McCoy",
"gender": "M",
"iban": "",
"id": 25518,
"lastName": "McCoy",
"login": "miles@propel.us",
"middleName": "",
"mobile": "0038975648",
"phone": "0032445888",
"pricelistAmount": "",
"pricelistPercentage": "",
"primaryLanguage": "EN",
"ssn": "",
"taxNumber": "",
"title": "Mr."
}
],
"end": 5,
"itemsFound": 5,
"messages": [
"Completed"
],
"offset": 12,
"page": 1,
"pages": 1,
"start": 1,
"total": 5
}
Search Users - 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 Users - 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"
}
}