# Retrieve a reseller

**GET /v1/Resellers/{resellerId}**

Retrieves a Reseller with the specified GUID identifier.
**Available to the roles:** csp, reseller


## Servers
- https://api.cloudcockpit.com: https://api.cloudcockpit.com ()


## Authentication methods
- Bearer auth


## Parameters
### Headers
- **X-Tenant** (string)
  The domain used to access the portal.
- **Authorization** (string)
  JWT Authorization header using the Bearer scheme. Example: "Authorization: Bearer {token}"
- **X-Correlation-Id** (string(uuid))
  This header is optional and by setting it you can correlate the audit logs made by this request.

### Path parameters
- **resellerId** (string(uuid))
  GUID Unique identifier for the reseller.



## Responses
### 200
OK

#### Body: application/json (object)
- **id** (string(uuid))
  The reseller Id.
- **companyName** (string | null)
  The name of the company associated to the reseller. This may be up to 255 characters.
- **country** (string | null)
  The company country. Must be in standard iso 3166-1 alpha 2.
- **addressLine1** (string | null)
  The company address line 1. This may be up to 255 characters.
- **addressLine2** (string | null)
  The company address line 2. This may be up to 255 characters.
- **city** (string | null)
  The company city. This may be up to 255 characters.
- **state** (string | null)
  The company state. This may be up to 255 characters.
- **zipCode** (string | null)
  The company ZIP. Should be a valid zip according to the company country. This may be up to 30 characters.
- **firstName** (string | null)
  The company primary contact first name. This may be up to 255 characters.
- **lastName** (string | null)
  The company primary contact last name. This may be up to 255 characters.
- **email** (string | null)
  The company primary contact email. This may be up to 255 characters.
- **phone** (string | null)
  The company primary contact phone. Should be a valid phone according to the company country. This may be up to 30 characters.
- **internalIdentifier** (string | null)
  The company internal identifier. This may be up to 255 characters.
- **taxId** (string | null)
  The tax id of the company. This may be up to 255 characters.
- **providerResellers** (array[object] | null)
  The provider resellers. A list containing the info about this reseller in one or more provider instances.
- **customDomain** (object)


### 400
Bad Request

#### Body: application/json (object)
- **statusCode** (integer(int32))
  The HTTP status code that represents a specific error scenario.
- **type** (string | null)
  The type of error that occurred.
- **description** (string | null)
  Describes the error scenario that occurred.
- **correlationId** (string | null)
  The correlationId of the request that originated the error.
- **errors** (array[object] | null)
  A list containing the detail of the errors that occurred in this error scenario.

### 401
Unauthorized

### 403
Forbidden

### 500
Internal Server Error

#### Body: application/json (object)
- **statusCode** (integer(int32))
  The HTTP status code that represents a specific error scenario.
- **type** (string | null)
  The type of error that occurred.
- **description** (string | null)
  Describes the error scenario that occurred.
- **correlationId** (string | null)
  The correlationId of the request that originated the error.
- **errors** (array[object] | null)
  A list containing the detail of the errors that occurred in this error scenario.


[Powered by Bump.sh](https://bump.sh)