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
Key | Datatype | Required | Description |
---|---|---|---|
username | null | Username for exact match (will return 0 or 1 record) | |
type | null | "testing" or "active" to return only customers of that type, or leave empty to return all customers. | |
search | null | The 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). | |
start | number | Index of the page of results to return | |
limit | number | Maximum number of results per page |
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Finicity-App-Token | string | ||
Finicity-App-Key | string | ||
Accept | string |
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"}]}