Get Customers

GET {{baseUrl}}/aggregation/v1/customers?username=&type=&search=&start=1&limit=25

Find all customers enrolled by the current partner, where the search text is found in the customer's username or any combination of firstName and lastName fields. If no search text is provided, all customers will be returned.

Supported regions: πŸ‡ΊπŸ‡Έ

Request Params

KeyDatatypeRequiredDescription
usernamenullUsername for exact match (will return 0 or 1 record)
typenull"testing" or "active" to return only customers of that type, or leave empty to return all customers.
searchnullThe text you wish to match. Leave this empty if you wish to return all customers. Must be URL-encoded (see also: Handling Spaces in Queries).
startnumberIndex of the page of results to return
limitnumberMaximum number of results per page

HEADERS

KeyDatatypeRequiredDescription
Finicity-App-Tokenstring
Finicity-App-Keystring
Acceptstring

RESPONSES

status: OK

{"found":200,"displaying":2,"moreAvailable":true,"customers":[{"id":"1005061234","username":"customerusername1","type":"active","createdDate":"1607450357","firstName":"John","lastName":"Smith","lastModifiedDate":"1607450357"},{"id":"1005061234","username":"customerusername1","type":"active","createdDate":"1607450357","firstName":"John","lastName":"Smith","lastModifiedDate":"1607450357"}]}