# Customers

Use these operations to manage customers.
A customer is an entity that purchases goods or services from you (a merchant),
and is the payee in any transaction that is credited to you.
Customers are associated with payment instruments,
subscriptions, invoices, and other related resources.

In other systems, customers may be referred to as accounts,
clients, members, patrons, or players.
For information on the customer resource, see [Resources](https://www.rebilly.com/docs/dev-docs/concepts/#resources).

## Retrieve customers

 - [GET /customers](https://www.rebilly.com/docs/dev-docs/api/customers/getcustomercollection.md): Retrieves a list of customers.

## Create a customer

 - [POST /customers](https://www.rebilly.com/docs/dev-docs/api/customers/postcustomer.md): Creates a new customer and customer ID.

The customer's primary address is used as the default address for
payment instruments, subscriptions, and invoices if none are provided.

If the customer already has an identifier within your system,
and you want to create customer with a predefined ID — to
prevent duplicate customers, use the _Upsert a customer
with predefined ID_ operation. For more information, see
Prevent duplicate customers.

## Retrieve a customer

 - [GET /customers/{id}](https://www.rebilly.com/docs/dev-docs/api/customers/getcustomer.md): Retrieves a customer with a specified ID.

## Upsert a customer

 - [PUT /customers/{id}](https://www.rebilly.com/docs/dev-docs/api/customers/putcustomer.md): Creates or updates (upserts) a customer with a specified ID.

If the customer already has an identifier within your system,
and you want to create a customer with a specified ID — use this operation to prevent duplicate customers.
For more information, see Prevent duplicate customers.

## Merge and delete a customer

 - [DELETE /customers/{id}](https://www.rebilly.com/docs/dev-docs/api/customers/deletecustomer.md): Merges one duplicate customer to another target customer and deletes the former.

## Retrieve a customer's lead source

 - [GET /customers/{id}/lead-source](https://www.rebilly.com/docs/dev-docs/api/customers/getcustomerleadsource.md): Retrieves lead source data for a customer with a specified ID.

A lead source is the marketing campaign that generates customer interaction, a sale, or a trial.
For more information, see Lead source attribution.

## Create a customer's lead source

 - [PUT /customers/{id}/lead-source](https://www.rebilly.com/docs/dev-docs/api/customers/putcustomerleadsource.md): Creates a lead source for a customer with a specified ID.

A lead source is the marketing campaign that
generates customer interaction, a sale, or a trial. For more
information, see
Lead source attribution.

## Delete a customer's lead source

 - [DELETE /customers/{id}/lead-source](https://www.rebilly.com/docs/dev-docs/api/customers/deletecustomerleadsource.md): Deletes lead source data for a customer with a specified ID.

## Retrieve a customer's EDD score

 - [GET /customers/{id}/edd-score](https://www.rebilly.com/docs/dev-docs/api/customers/getcustomereddscore.md): Retrieves an EDD score for a customer with a specified ID.

## Update a customer's EDD score

 - [PATCH /customers/{id}/edd-score](https://www.rebilly.com/docs/dev-docs/api/customers/patchcustomereddscore.md): Updates an EDD score for a customer with a specified ID.

## Retrieve customer EDD search results

 - [GET /customers/{id}/edd-search-results](https://www.rebilly.com/docs/dev-docs/api/customers/getcustomereddsearchresultcollection.md): Retrieve EDD search results for a customer with a specified ID.

## Retrieve a customer's EDD search result

 - [GET /customers/{id}/edd-search-results/{searchResultId}](https://www.rebilly.com/docs/dev-docs/api/customers/getcustomereddsearchresult.md): Retrieves an EDD search result for a customer with a specified ID.

## Customer created

 - [POST customer-created](https://www.rebilly.com/docs/dev-docs/api/customers/customer-created.md)

## Customer merged

 - [POST customer-merged](https://www.rebilly.com/docs/dev-docs/api/customers/customer-merged.md)

## Customer one-time-password requested

 - [POST customer-one-time-password-requested](https://www.rebilly.com/docs/dev-docs/api/customers/customer-one-time-password-requested.md)

## Customer updated

 - [POST customer-updated](https://www.rebilly.com/docs/dev-docs/api/customers/customer-updated.md)

## Experian check performed

 - [POST experian-check-performed](https://www.rebilly.com/docs/dev-docs/api/customers/experian-check-performed.md)