Customer

Customer: Search

Returns a collection of Customer response objects.

For operators available on search fields, see the search fields page.

  1. Python
collection = gateway.customer.search(
    braintree.CustomerSearch.id == "the_customer_id"
)

for customer in collection.items:
    print customer.first_name
Parameters
'address_country_name'text
The country on an address associated with the customer.
'address_extended_address'text
The extended address on an address associated with the customer.
'address_first_name'text
The first name on an address associated with the customer.
'address_last_name'text
The last name on an address associated with the customer.
'address_locality'text
The locality (e.g. city) on an address associated with the customer.
'address_postal_code'text
The postal code on an address associated with the customer.
'address_region'text
The region (e.g. state) on an address associated with the customer.
'address_street_address'text
The street address on an address associated with the customer.
'cardholder_name'text
The name on a credit card associated with the customer.
'company'text
The customer's company.
'created_at'range
The date/time the customer was created.
'credit_card_expiration_date'text
The expiration date of a credit card associated with the customer.
'credit_card_number'text

The number of a credit card associated with the customer.

Card number search is restricted: starts with searches up to the first 6 digits, ends with searches last 4 digits, and contains is not allowed.

'email'text
The customer's email.
'fax'text
The customer's fax number.
'first_name'text
The customer's first name.
'id'text
A string value representing an existing customer in your Vault.
'ids'multiple
A list of customer IDs to search for.
'last_name'text
The customer's last name.
'payment_method_token'text
The payment method token of a payment method associated with the customer.
'payment_method_token_with_duplicates'text

Same as payment method token, except this will return all customers that have a credit card with the same number as the payment method being searched.

'paypal_account_email'text
The email of a PayPal account associated with the customer.
'phone'text
The customer's phone number.
'website'text
The customer's website.

Examplesanchor

Customer fieldsanchor

  1. Python
search_results = gateway.customer.search(
    braintree.CustomerSearch.company == "Acme Inc.",
    braintree.CustomerSearch.email == "john.doe@example.com",
    braintree.CustomerSearch.fax == "555-123-1234",
    braintree.CustomerSearch.first_name == "John",
    braintree.CustomerSearch.id == "the_customer_id",
    braintree.CustomerSearch.last_name == "Doe",
    braintree.CustomerSearch.phone == "555-321-4321",
    braintree.CustomerSearch.website == "http://www.example.com"
)

Address fieldsanchor

  1. Python
search_results = gateway.customer.search(
    braintree.CustomerSearch.address_first_name == "John",
    braintree.CustomerSearch.address_last_name == "Doe",
    braintree.CustomerSearch.address_street_address == "111 First St."
    braintree.CustomerSearch.address_extended_address == "Suite #3",
    braintree.CustomerSearch.address_locality == "Chicago",
    braintree.CustomerSearch.address_region == "IL",
    braintree.CustomerSearch.address_postal_code == "12345",
    braintree.CustomerSearch.address_country_name == "USA"
)

Credit card fieldsanchor

  1. Python
search_results = gateway.customer.search(
    braintree.CustomerSearch.cardholder_name == "John Doe",
    braintree.CustomerSearch.payment_method_token == "the_payment_method_token"
)

Credit card numberanchor

Searching on credit card number has a few restrictions. If you search using "starts with" you can only enter up to the first 6 digits. If you search using "ends with" you can only enter the last 4 digits. And you can't search on "contains."

  1. Python
search_results = gateway.customer.search(
    braintree.CustomerSearch.credit_card_number.starts_with("510510")
)

search_results = gateway.customer.search(
    braintree.CustomerSearch.credit_card_number.ends_with("5100")
)

Expiration dateanchor

Expiration date also has restrictions. "is" and "is not" work, while "starts with," "ends with," and "contains" do not.

  1. Python
search_results = gateway.customer.search(
    braintree.CustomerSearch.credit_card_expiration_date == "12/13"
)

search_results = gateway.customer.search(
    braintree.CustomerSearch.credit_card_expiration_date != "12/13"
)

Created atanchor

You can search for customers that were created at a certain time. For instance, you can find all customers which were created in the past 3 days.

An example:

  1. Python
search_results = gateway.customer.search(
  braintree.CustomerSearch.created_at.between(
    datetime.datetime(2009, 1, 1),
    datetime.datetime(2011, 1, 1)
  )
)

Payment method token with duplicatesanchor

You can search for customers that have duplicated credit card numbers using payment method token as a reference.

An example:

  1. Python
search_results = gateway.customer.search(
  braintree.CustomerSearch.payment_method_token_with_duplicates.is("payment_method_token_with_duplicates")
)

All customersanchor

You can get a list of all customers stored in the Vault. This will return a resource collection of customer objects. Search results are currently capped so this may not work for everybody.

  1. Python
collection = gateway.customer.all()

See also