List customers

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

This query gets a list of all of the customers in your account with their customer IDs so that you can later lookup individual customers. It doesn't return subscription information as this sits in the subscription elements, but it does retrieve the customer IDs, which you can then use to get subscription information in separate calls.

You can filter the results from this API by name (full or partial) but this is not a required field.

Customers are returned in pages. The first part of the results describes which page you're on, the total number of pages, the size of the page and how many rows are in the page. Then, each result is provided within the array.

Returned variables

Variable nameDescription
customerIdThe unique identifier of the customer in the Billsby platform
firstNameThe customer's first name
lastNameThe customer's last name
emailThe customer's registered email address
createdOnThe date on which the customer account was created
statusThe status of the customer; active or inactive
phoneNumberThe customers phone number
phoneNumberDialCodeThe dial code of the customers phone number
phoneNumberCodeCountryThe country of the dial code of the customers phone number
billingAddressThe customers billing address
addressLine1The first line of the customers address
addressLine2The second line of the customers address
cityThe city of the customers address
countryThe country of the customers address
stateThe state of the customers address
postCodeThe post code of the customers address
Path Params
string
required

Your companies Billsby subdomain - for example, if you login at widgets.billsby.com, your companyDomain is widgets

Query Params
int32
required

The page of customers you would like to view

int32
required

The number of records to return per page (max 100)

string

Filter customers by name (this can be a partial name)

Response

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json