Uploaded July 2021 | Updated September 2026, 3 hours ago
With customer profiles stored in a Square account, you have several options to find them and view detailed customer information using the Customers API. These options involve calling the ListCustomers, RetrieveCustomer, and SearchCustomers.
Here you will learn how to use the Search Customers API to search for customer profiles using one or more of the supported query filters. You can search by using an email address, phone number, or reference ID.
This is really helpful, since you can then use other search endpoints to lookup things like a customer’s order history or invoices.
Search for Customer Profiles: developer.squareup.com/docs/customers-api/use-the-api/search-customers
Square Developer Forums – developer.squareup.com/forums
Square Developer Community – https://squ.re/slack
Square Developer Twitter – twitter.com/squaredev
Square Developer Blog – developer.squareup.com/blog
With customer profiles stored in a Square account, you have several options to find them and view detailed customer information using the Customers API. These options involve calling the ListCustomers, RetrieveCustomer, and SearchCustomers.
Here you will learn how to use the Search Customers API to search for customer profiles using one or more of the supported query filters. You can search by using an email address, phone number, or reference ID.
This is really helpful, since you can then use other search endpoints to lookup things like a customer’s order history or invoices.
Search for Customer Profiles: developer.squareup.com/docs/customers-api/use-the-api/search-customers
Square Developer Forums – developer.squareup.com/forums
Square Developer Community – https://squ.re/slack
Square Developer Twitter – twitter.com/squaredev
Square Developer Blog – developer.squareup.com/blog










