# customer

## Operations

| Method | Path | Summary | Details |
|--------|------|---------|----------|
| GET | `/admin/api/2020-01/customers.json` | Retrieves a list of customers. Note: As of version 2019-10, this endpoint implements pagination by using links that are provided in the response header. Sending the page parameter will return an error. To learn more, see Making requests to paginated REST Admin API endpoints. | [View](../operations/deprecated-202001-get-customers.md) |
| POST | `/admin/api/2020-01/customers.json` | Creates a customer. | [View](../operations/deprecated-202001-create-customers.md) |
| GET | `/admin/api/2020-01/customers/search.json` | Searches for customers that match a supplied query. Note: As of version 2019-10, this endpoint implements pagination by using links that are provided in the response header. Sending the page parameter will return an error. To learn more, see Making requests to paginated REST Admin API endpoints. | [View](../operations/deprecated-202001-get-customers-search.md) |
| GET | `/admin/api/2020-01/customers/{customer_id}.json` | Retrieves a single customer. | [View](../operations/deprecated-202001-get-customers-param-customer-id.md) |
| PUT | `/admin/api/2020-01/customers/{customer_id}.json` | Updates a customer. | [View](../operations/deprecated-202001-update-customers-param-customer-id.md) |
| DELETE | `/admin/api/2020-01/customers/{customer_id}.json` | Deletes a customer. A customer can't be deleted if they have existing orders. | [View](../operations/deprecated-202001-delete-customers-param-customer-id.md) |
| POST | `/admin/api/2020-01/customers/{customer_id}/account_activation_url.json` | Generate an account activation URL for a customer whose account is not yet enabled. This is useful when you've imported a large number of customers and want to send them activation emails all at once. Using this approach, you'll need to generate and send the activation emails yourself.
            The account activation URL generated by this endpoint is for one-time use and will expire after 30 days. If you make a new POST request to this endpoint, then a new URL will be generated. The new URL will be again valid for 30 days, but the previous URL will no longer be valid. | [View](../operations/deprecated-202001-create-customers-param-customer-id-account-activation-url.md) |
| POST | `/admin/api/2020-01/customers/{customer_id}/send_invite.json` | Sends an account invite to a customer. | [View](../operations/deprecated-202001-create-customers-param-customer-id-send-invite.md) |
| GET | `/admin/api/2020-01/customers/count.json` | Retrieves a count of all customers. | [View](../operations/deprecated-202001-get-customers-count.md) |
| GET | `/admin/api/2020-01/customers/{customer_id}/orders.json` | Retrieves all orders belonging to a customer. The query string parameters that are available to the  Order resource are also available to this endpoint. | [View](../operations/deprecated-202001-get-customers-param-customer-id-orders.md) |
| GET | `/admin/api/2020-04/customers.json` | Retrieves a list of customers. Note: As of version 2019-10, this endpoint implements pagination by using links that are provided in the response header. Sending the page parameter will return an error. To learn more, see Making requests to paginated REST Admin API endpoints. | [View](../operations/deprecated-202004-get-customers.md) |
| POST | `/admin/api/2020-04/customers.json` | Creates a customer. | [View](../operations/deprecated-202004-create-customers.md) |
| GET | `/admin/api/2020-04/customers/search.json` | Searches for customers that match a supplied query. Note: As of version 2019-10, this endpoint implements pagination by using links that are provided in the response header. Sending the page parameter will return an error. To learn more, see Making requests to paginated REST Admin API endpoints. | [View](../operations/deprecated-202004-get-customers-search.md) |
| GET | `/admin/api/2020-04/customers/{customer_id}.json` | Retrieves a single customer. | [View](../operations/deprecated-202004-get-customers-param-customer-id.md) |
| PUT | `/admin/api/2020-04/customers/{customer_id}.json` | Updates a customer. | [View](../operations/deprecated-202004-update-customers-param-customer-id.md) |
| DELETE | `/admin/api/2020-04/customers/{customer_id}.json` | Deletes a customer. A customer can't be deleted if they have existing orders. | [View](../operations/deprecated-202004-delete-customers-param-customer-id.md) |
| POST | `/admin/api/2020-04/customers/{customer_id}/account_activation_url.json` | Generate an account activation URL for a customer whose account is not yet enabled. This is useful when you've imported a large number of customers and want to send them activation emails all at once. Using this approach, you'll need to generate and send the activation emails yourself.
            The account activation URL generated by this endpoint is for one-time use and will expire after 30 days. If you make a new POST request to this endpoint, then a new URL will be generated. The new URL will be again valid for 30 days, but the previous URL will no longer be valid. | [View](../operations/deprecated-202004-create-customers-param-customer-id-account-activation-url.md) |
| POST | `/admin/api/2020-04/customers/{customer_id}/send_invite.json` | Sends an account invite to a customer. | [View](../operations/deprecated-202004-create-customers-param-customer-id-send-invite.md) |
| GET | `/admin/api/2020-04/customers/count.json` | Retrieves a count of all customers. | [View](../operations/deprecated-202004-get-customers-count.md) |
| GET | `/admin/api/2020-04/customers/{customer_id}/orders.json` | Retrieves all orders belonging to a customer. The query string parameters that are available to the  Order resource are also available to this endpoint. | [View](../operations/deprecated-202004-get-customers-param-customer-id-orders.md) |
| GET | `/admin/api/2020-07/customers.json` | Retrieves a list of customers. Note: As of version 2019-10, this endpoint implements pagination by using links that are provided in the response header. Sending the page parameter will return an error. To learn more, see Making requests to paginated REST Admin API endpoints. | [View](../operations/deprecated-202007-get-customers.md) |
| POST | `/admin/api/2020-07/customers.json` | Creates a customer. | [View](../operations/deprecated-202007-create-customers.md) |
| GET | `/admin/api/2020-07/customers/search.json` | Searches for customers that match a supplied query. Note: As of version 2019-10, this endpoint implements pagination by using links that are provided in the response header. Sending the page parameter will return an error. To learn more, see Making requests to paginated REST Admin API endpoints. | [View](../operations/deprecated-202007-get-customers-search.md) |
| GET | `/admin/api/2020-07/customers/{customer_id}.json` | Retrieves a single customer. | [View](../operations/deprecated-202007-get-customers-param-customer-id.md) |
| PUT | `/admin/api/2020-07/customers/{customer_id}.json` | Updates a customer. | [View](../operations/deprecated-202007-update-customers-param-customer-id.md) |
| DELETE | `/admin/api/2020-07/customers/{customer_id}.json` | Deletes a customer. A customer can't be deleted if they have existing orders. | [View](../operations/deprecated-202007-delete-customers-param-customer-id.md) |
| POST | `/admin/api/2020-07/customers/{customer_id}/account_activation_url.json` | Generate an account activation URL for a customer whose account is not yet enabled. This is useful when you've imported a large number of customers and want to send them activation emails all at once. Using this approach, you'll need to generate and send the activation emails yourself.
            The account activation URL generated by this endpoint is for one-time use and will expire after 30 days. If you make a new POST request to this endpoint, then a new URL will be generated. The new URL will be again valid for 30 days, but the previous URL will no longer be valid. | [View](../operations/deprecated-202007-create-customers-param-customer-id-account-activation-url.md) |
| POST | `/admin/api/2020-07/customers/{customer_id}/send_invite.json` | Sends an account invite to a customer. | [View](../operations/deprecated-202007-create-customers-param-customer-id-send-invite.md) |
| GET | `/admin/api/2020-07/customers/count.json` | Retrieves a count of all customers. | [View](../operations/deprecated-202007-get-customers-count.md) |
| GET | `/admin/api/2020-07/customers/{customer_id}/orders.json` | Retrieves all orders belonging to a customer. The query string parameters that are available to the  Order resource are also available to this endpoint. | [View](../operations/deprecated-202007-get-customers-param-customer-id-orders.md) |
| GET | `/admin/api/2020-10/customers.json` | Retrieves a list of customers. Note: As of version 2019-10, this endpoint implements pagination by using links that are provided in the response header. Sending the page parameter will return an error. To learn more, see Making requests to paginated REST Admin API endpoints. | [View](../operations/get-customers.md) |
| POST | `/admin/api/2020-10/customers.json` | Creates a customer. | [View](../operations/create-customers.md) |
| GET | `/admin/api/2020-10/customers/search.json` | Searches for customers that match a supplied query. Note: As of version 2019-10, this endpoint implements pagination by using links that are provided in the response header. Sending the page parameter will return an error. To learn more, see Making requests to paginated REST Admin API endpoints. | [View](../operations/get-customers-search.md) |
| GET | `/admin/api/2020-10/customers/{customer_id}.json` | Retrieves a single customer. | [View](../operations/get-customers-param-customer-id.md) |
| PUT | `/admin/api/2020-10/customers/{customer_id}.json` | Updates a customer. | [View](../operations/update-customers-param-customer-id.md) |
| DELETE | `/admin/api/2020-10/customers/{customer_id}.json` | Deletes a customer. A customer can't be deleted if they have existing orders. | [View](../operations/delete-customers-param-customer-id.md) |
| POST | `/admin/api/2020-10/customers/{customer_id}/account_activation_url.json` | Generate an account activation URL for a customer whose account is not yet enabled. This is useful when you've imported a large number of customers and want to send them activation emails all at once. Using this approach, you'll need to generate and send the activation emails yourself.
            The account activation URL generated by this endpoint is for one-time use and will expire after 30 days. If you make a new POST request to this endpoint, then a new URL will be generated. The new URL will be again valid for 30 days, but the previous URL will no longer be valid. | [View](../operations/create-customers-param-customer-id-account-activation-url.md) |
| POST | `/admin/api/2020-10/customers/{customer_id}/send_invite.json` | Sends an account invite to a customer. | [View](../operations/create-customers-param-customer-id-send-invite.md) |
| GET | `/admin/api/2020-10/customers/count.json` | Retrieves a count of all customers. | [View](../operations/get-customers-count.md) |
| GET | `/admin/api/2020-10/customers/{customer_id}/orders.json` | Retrieves all orders belonging to a customer. The query string parameters that are available to the  Order resource are also available to this endpoint. | [View](../operations/get-customers-param-customer-id-orders.md) |
| GET | `/admin/api/2021-01/customers.json` | Retrieves a list of customers. Note: As of version 2019-10, this endpoint implements pagination by using links that are provided in the response header. Sending the page parameter will return an error. To learn more, see Making requests to paginated REST Admin API endpoints. | [View](../operations/deprecated-202101-get-customers.md) |
| POST | `/admin/api/2021-01/customers.json` | Creates a customer. | [View](../operations/deprecated-202101-create-customers.md) |
| GET | `/admin/api/2021-01/customers/search.json` | Searches for customers that match a supplied query. Note: As of version 2019-10, this endpoint implements pagination by using links that are provided in the response header. Sending the page parameter will return an error. To learn more, see Making requests to paginated REST Admin API endpoints. | [View](../operations/deprecated-202101-get-customers-search.md) |
| GET | `/admin/api/2021-01/customers/{customer_id}.json` | Retrieves a single customer. | [View](../operations/deprecated-202101-get-customers-param-customer-id.md) |
| PUT | `/admin/api/2021-01/customers/{customer_id}.json` | Updates a customer. | [View](../operations/deprecated-202101-update-customers-param-customer-id.md) |
| DELETE | `/admin/api/2021-01/customers/{customer_id}.json` | Deletes a customer. A customer can't be deleted if they have existing orders. | [View](../operations/deprecated-202101-delete-customers-param-customer-id.md) |
| POST | `/admin/api/2021-01/customers/{customer_id}/account_activation_url.json` | Generate an account activation URL for a customer whose account is not yet enabled. This is useful when you've imported a large number of customers and want to send them activation emails all at once. Using this approach, you'll need to generate and send the activation emails yourself.
            The account activation URL generated by this endpoint is for one-time use and will expire after 30 days. If you make a new POST request to this endpoint, then a new URL will be generated. The new URL will be again valid for 30 days, but the previous URL will no longer be valid. | [View](../operations/deprecated-202101-create-customers-param-customer-id-account-activation-url.md) |
| POST | `/admin/api/2021-01/customers/{customer_id}/send_invite.json` | Sends an account invite to a customer. | [View](../operations/deprecated-202101-create-customers-param-customer-id-send-invite.md) |
| GET | `/admin/api/2021-01/customers/count.json` | Retrieves a count of all customers. | [View](../operations/deprecated-202101-get-customers-count.md) |
| GET | `/admin/api/2021-01/customers/{customer_id}/orders.json` | Retrieves all orders belonging to a customer. The query string parameters that are available to the  Order resource are also available to this endpoint. | [View](../operations/deprecated-202101-get-customers-param-customer-id-orders.md) |
| GET | `/admin/api/unstable/customers.json` | Retrieves a list of customers. Note: As of version 2019-10, this endpoint implements pagination by using links that are provided in the response header. Sending the page parameter will return an error. To learn more, see Making requests to paginated REST Admin API endpoints. | [View](../operations/deprecated-unstable-get-customers.md) |
| POST | `/admin/api/unstable/customers.json` | Creates a customer. | [View](../operations/deprecated-unstable-create-customers.md) |
| GET | `/admin/api/unstable/customers/search.json` | Searches for customers that match a supplied query. Note: As of version 2019-10, this endpoint implements pagination by using links that are provided in the response header. Sending the page parameter will return an error. To learn more, see Making requests to paginated REST Admin API endpoints. | [View](../operations/deprecated-unstable-get-customers-search.md) |
| GET | `/admin/api/unstable/customers/{customer_id}.json` | Retrieves a single customer. | [View](../operations/deprecated-unstable-get-customers-param-customer-id.md) |
| PUT | `/admin/api/unstable/customers/{customer_id}.json` | Updates a customer. | [View](../operations/deprecated-unstable-update-customers-param-customer-id.md) |
| DELETE | `/admin/api/unstable/customers/{customer_id}.json` | Deletes a customer. A customer can't be deleted if they have existing orders. | [View](../operations/deprecated-unstable-delete-customers-param-customer-id.md) |
| POST | `/admin/api/unstable/customers/{customer_id}/account_activation_url.json` | Generate an account activation URL for a customer whose account is not yet enabled. This is useful when you've imported a large number of customers and want to send them activation emails all at once. Using this approach, you'll need to generate and send the activation emails yourself.
            The account activation URL generated by this endpoint is for one-time use and will expire after 30 days. If you make a new POST request to this endpoint, then a new URL will be generated. The new URL will be again valid for 30 days, but the previous URL will no longer be valid. | [View](../operations/deprecated-unstable-create-customers-param-customer-id-account-activation-url.md) |
| POST | `/admin/api/unstable/customers/{customer_id}/send_invite.json` | Sends an account invite to a customer. | [View](../operations/deprecated-unstable-create-customers-param-customer-id-send-invite.md) |
| GET | `/admin/api/unstable/customers/count.json` | Retrieves a count of all customers. | [View](../operations/deprecated-unstable-get-customers-count.md) |
| GET | `/admin/api/unstable/customers/{customer_id}/orders.json` | Retrieves all orders belonging to a customer. The query string parameters that are available to the  Order resource are also available to this endpoint. | [View](../operations/deprecated-unstable-get-customers-param-customer-id-orders.md) |
