Method: customers.get

Gets a customer account.

Use this operation to see a customer account already in your reseller management, or to see the minimal account information for an existing customer that you do not manage. For more information about the API response for existing customers, see retrieving a customer account.

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



This can be either the customer's primary domain name or the customer's unique identifier. If the domain name for a customer changes, the old domain name cannot be used to access the customer, but the customer's unique identifier (as returned by the API) can always be used. We recommend storing the unique identifier in your systems where applicable.

Request body

The request body must be empty.

Response body

If successful, the response body contains an instance of Customer.

Authorization scopes

Requires one of the following OAuth scopes:


For more information, see the Authorization guide.