List all Resellers

GET /v1/Resellers

Returns a list of your resellers. The resellers are returned sorted by the specified sortPropertyName. Available to the roles: csp

Headers

  • X-Tenant string Required

    This header identifies which tenant to access with this request. This value should be an existent domain for the specified tenant.

  • Authorization string Required

    JWT Authorization header using the Bearer scheme. Example: "Authorization: Bearer {token}"

    Default value is Bearer eyJ0eXAiO....

  • X-Correlation-Id string(UUID)

    This header is optional and by setting it you can correlate the audit logs made by this request.

Query parameters

  • pageNumber integer(int32)

    A cursor for pagination across multiple pages of results. The default value is 1.

  • pageSize integer(int32)

    The number of objects to be returned at each page. The size can range between 1 and 2000, and the default is 25.

  • searchValue string

    The search query string used to obtain partial matches. For example, if a reseller has company name: Reseller and you search for: seller you will obtain the reseller from the API. The search value has a maximum of 255 characters.

  • searchField string

    The property that we are using to search resellers for. The possible values are: Company.Name, InternalIdentifier or MpnId (which allows searching by the primary or secondary mpn id). If searchValue was set but searchField wasn't then by default the search will be done by Company.Name.

  • sortPropertyName string

    The name of the property to sort the resellers by. Possible values: Company.Name.

  • ascendingOrder boolean

    if set to true [ascending order].

  • customerId string(uuid)

    The GUID identifier for the customer. This property is optional only used when we want all resellers for a specific customer, to use this property you must also set the providerInstanceId.

  • providerInstanceId string(uuid)

    The GUID identifier for the provider instance. This property is optional only used when we want all resellers for a specific provider instance.

Responses

  • 200

    Success

    Hide response attributes Show response attributes object

    Helper class to be used on paged collection entities

    • items array[object] | null

      The items for this page.

      Hide items attributes Show items attributes object

      View model that represents a reseller.

      • id string(uuid)

        The reseller Id.

      • companyName string | null Required

        The name of the company associated to the reseller. This may be up to 255 characters.

      • country string | null Required

        The company country. Must be in standard iso 3166-1 alpha 2.

      • addressLine1 string | null Required

        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 Required

        The company city. This may be up to 255 characters.

      • state string | null Required

        The company state. This may be up to 255 characters.

      • zipCode string | null Required

        The company ZIP. Should be a valid zip according to the company country. This may be up to 30 characters.

      • firstName string | null Required

        The company primary contact first name. This may be up to 255 characters.

      • lastName string | null Required

        The company primary contact last name. This may be up to 255 characters.

      • email string | null Required

        The company primary contact email. This may be up to 255 characters.

      • phone string | null Required

        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 Required

        The provider resellers. A list containing the info about this reseller in one or more provider instances.

        Hide providerResellers attributes Show providerResellers attributes object
        • providerInstanceId string(uuid) Required

          The id of the provider instance to which the reseller with ResellerId is associated to. Must always be set.

        • priceMargin object Required

          This value object contains the price margin for this entity.

          Hide priceMargin attributes Show priceMargin attributes object
        • offerTypeMargins object | null

          Contains as key the name of the offer type and as value the price margin applied to each offer type for this specific provider instance. Price margins applied at the offer type level will override the price margin applied at the provider instance level. If no price margin is applied to a specific offer type of this provider instance then it will not be in the dictionary. This dictionary is optional.

          Hide offerTypeMargins attributes Show offerTypeMargins attributes object | null
        • providerResellerId string | null

          An id that identifies the reseller has on the provider instance. For a Microsoft Tier 2 provider instance set ProviderResellerId to the primary mpn id of the reseller, which is the mpn id that will be used for new subscription purchases. When adding a provider instance to a reseller for a Microsoft Tier 1 environment or a generic provider, don't pass this property on the creation request.

        • resellerProviderData string | null Required

          A json formatted string which contains specific data for the reseller association to the provider instance. For Microsoft Tier 1 resellers, this property can be a empty json: "{}". On Microsoft Tier 2 resellers, this property will be a json with the following format: {"IndirectResellerId":string,"SecondaryMpnIds":string[]}

        • status object

          The status for this entity. Possible values: Processing, Success, Failed

          Hide status attributes Show status attributes object
        • Additional properties are NOT allowed
      • customDomain object
        Hide customDomain attributes Show customDomain attributes object
      • Additional properties are NOT allowed
    • paginationParameters object

      A model that is used to encapsulate the parameters needed to perform pagination queries.

      Hide paginationParameters attributes Show paginationParameters attributes object
    • totalPages integer(int32)

      The total number of pages available for the specified parameters and page size.

    • totalCount integer(int32)

      The total number of results available for the specified parameters. Note this is typically not equal to the Count of items in the Items property, will only be equal if all the items fit in the first page.

    • hasPreviousPage boolean

      Indicates if there is a previous page.

    • hasNextPage boolean

      Indicates if there is a next page.

    • continuationToken string | null

      The token to continue to retrieve the paginated items.

    • Additional properties are NOT allowed
    Hide response attributes Show response attributes object

    Helper class to be used on paged collection entities

    • items array[object] | null

      The items for this page.

      Hide items attributes Show items attributes object

      View model that represents a reseller.

      • id string(uuid)

        The reseller Id.

      • companyName string | null Required

        The name of the company associated to the reseller. This may be up to 255 characters.

      • country string | null Required

        The company country. Must be in standard iso 3166-1 alpha 2.

      • addressLine1 string | null Required

        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 Required

        The company city. This may be up to 255 characters.

      • state string | null Required

        The company state. This may be up to 255 characters.

      • zipCode string | null Required

        The company ZIP. Should be a valid zip according to the company country. This may be up to 30 characters.

      • firstName string | null Required

        The company primary contact first name. This may be up to 255 characters.

      • lastName string | null Required

        The company primary contact last name. This may be up to 255 characters.

      • email string | null Required

        The company primary contact email. This may be up to 255 characters.

      • phone string | null Required

        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 Required

        The provider resellers. A list containing the info about this reseller in one or more provider instances.

        Hide providerResellers attributes Show providerResellers attributes object
        • providerInstanceId string(uuid) Required

          The id of the provider instance to which the reseller with ResellerId is associated to. Must always be set.

        • priceMargin object Required

          This value object contains the price margin for this entity.

          Hide priceMargin attributes Show priceMargin attributes object
        • offerTypeMargins object | null

          Contains as key the name of the offer type and as value the price margin applied to each offer type for this specific provider instance. Price margins applied at the offer type level will override the price margin applied at the provider instance level. If no price margin is applied to a specific offer type of this provider instance then it will not be in the dictionary. This dictionary is optional.

          Hide offerTypeMargins attributes Show offerTypeMargins attributes object | null
        • providerResellerId string | null

          An id that identifies the reseller has on the provider instance. For a Microsoft Tier 2 provider instance set ProviderResellerId to the primary mpn id of the reseller, which is the mpn id that will be used for new subscription purchases. When adding a provider instance to a reseller for a Microsoft Tier 1 environment or a generic provider, don't pass this property on the creation request.

        • resellerProviderData string | null Required

          A json formatted string which contains specific data for the reseller association to the provider instance. For Microsoft Tier 1 resellers, this property can be a empty json: "{}". On Microsoft Tier 2 resellers, this property will be a json with the following format: {"IndirectResellerId":string,"SecondaryMpnIds":string[]}

        • status object

          The status for this entity. Possible values: Processing, Success, Failed

          Hide status attributes Show status attributes object
        • Additional properties are NOT allowed
      • customDomain object
        Hide customDomain attributes Show customDomain attributes object
      • Additional properties are NOT allowed
    • paginationParameters object

      A model that is used to encapsulate the parameters needed to perform pagination queries.

      Hide paginationParameters attributes Show paginationParameters attributes object
    • totalPages integer(int32)

      The total number of pages available for the specified parameters and page size.

    • totalCount integer(int32)

      The total number of results available for the specified parameters. Note this is typically not equal to the Count of items in the Items property, will only be equal if all the items fit in the first page.

    • hasPreviousPage boolean

      Indicates if there is a previous page.

    • hasNextPage boolean

      Indicates if there is a next page.

    • continuationToken string | null

      The token to continue to retrieve the paginated items.

    • Additional properties are NOT allowed
    Hide response attributes Show response attributes object

    Helper class to be used on paged collection entities

    • items array[object] | null

      The items for this page.

      Hide items attributes Show items attributes object

      View model that represents a reseller.

      • id string(uuid)

        The reseller Id.

      • companyName string | null Required

        The name of the company associated to the reseller. This may be up to 255 characters.

      • country string | null Required

        The company country. Must be in standard iso 3166-1 alpha 2.

      • addressLine1 string | null Required

        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 Required

        The company city. This may be up to 255 characters.

      • state string | null Required

        The company state. This may be up to 255 characters.

      • zipCode string | null Required

        The company ZIP. Should be a valid zip according to the company country. This may be up to 30 characters.

      • firstName string | null Required

        The company primary contact first name. This may be up to 255 characters.

      • lastName string | null Required

        The company primary contact last name. This may be up to 255 characters.

      • email string | null Required

        The company primary contact email. This may be up to 255 characters.

      • phone string | null Required

        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 Required

        The provider resellers. A list containing the info about this reseller in one or more provider instances.

        Hide providerResellers attributes Show providerResellers attributes object
        • providerInstanceId string(uuid) Required

          The id of the provider instance to which the reseller with ResellerId is associated to. Must always be set.

        • priceMargin object Required

          This value object contains the price margin for this entity.

          Hide priceMargin attributes Show priceMargin attributes object
        • offerTypeMargins object | null

          Contains as key the name of the offer type and as value the price margin applied to each offer type for this specific provider instance. Price margins applied at the offer type level will override the price margin applied at the provider instance level. If no price margin is applied to a specific offer type of this provider instance then it will not be in the dictionary. This dictionary is optional.

          Hide offerTypeMargins attributes Show offerTypeMargins attributes object | null
        • providerResellerId string | null

          An id that identifies the reseller has on the provider instance. For a Microsoft Tier 2 provider instance set ProviderResellerId to the primary mpn id of the reseller, which is the mpn id that will be used for new subscription purchases. When adding a provider instance to a reseller for a Microsoft Tier 1 environment or a generic provider, don't pass this property on the creation request.

        • resellerProviderData string | null Required

          A json formatted string which contains specific data for the reseller association to the provider instance. For Microsoft Tier 1 resellers, this property can be a empty json: "{}". On Microsoft Tier 2 resellers, this property will be a json with the following format: {"IndirectResellerId":string,"SecondaryMpnIds":string[]}

        • status object

          The status for this entity. Possible values: Processing, Success, Failed

          Hide status attributes Show status attributes object
        • Additional properties are NOT allowed
      • customDomain object
        Hide customDomain attributes Show customDomain attributes object
      • Additional properties are NOT allowed
    • paginationParameters object

      A model that is used to encapsulate the parameters needed to perform pagination queries.

      Hide paginationParameters attributes Show paginationParameters attributes object
    • totalPages integer(int32)

      The total number of pages available for the specified parameters and page size.

    • totalCount integer(int32)

      The total number of results available for the specified parameters. Note this is typically not equal to the Count of items in the Items property, will only be equal if all the items fit in the first page.

    • hasPreviousPage boolean

      Indicates if there is a previous page.

    • hasNextPage boolean

      Indicates if there is a next page.

    • continuationToken string | null

      The token to continue to retrieve the paginated items.

    • Additional properties are NOT allowed
  • 400

    Bad Request

    Hide response attributes Show response attributes object

    This class represents the response which is returned to consumers in case of an error, containing details about it, as well as the correlationId of the performed request so that consumers can supply us that id for us to provide support.

    • 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.

      Hide errors attributes Show errors attributes object

      This class is used to represent the details of an error and specifies the name of the property and the description of each of the errors associated with that property.

    • Additional properties are NOT allowed
    Hide response attributes Show response attributes object

    This class represents the response which is returned to consumers in case of an error, containing details about it, as well as the correlationId of the performed request so that consumers can supply us that id for us to provide support.

    • 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.

      Hide errors attributes Show errors attributes object

      This class is used to represent the details of an error and specifies the name of the property and the description of each of the errors associated with that property.

    • Additional properties are NOT allowed
    Hide response attributes Show response attributes object

    This class represents the response which is returned to consumers in case of an error, containing details about it, as well as the correlationId of the performed request so that consumers can supply us that id for us to provide support.

    • 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.

      Hide errors attributes Show errors attributes object

      This class is used to represent the details of an error and specifies the name of the property and the description of each of the errors associated with that property.

    • Additional properties are NOT allowed
  • 401

    Unauthorized

  • 403

    Forbidden

  • 500

    Server Error

    Hide response attributes Show response attributes object

    This class represents the response which is returned to consumers in case of an error, containing details about it, as well as the correlationId of the performed request so that consumers can supply us that id for us to provide support.

    • 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.

      Hide errors attributes Show errors attributes object

      This class is used to represent the details of an error and specifies the name of the property and the description of each of the errors associated with that property.

    • Additional properties are NOT allowed
    Hide response attributes Show response attributes object

    This class represents the response which is returned to consumers in case of an error, containing details about it, as well as the correlationId of the performed request so that consumers can supply us that id for us to provide support.

    • 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.

      Hide errors attributes Show errors attributes object

      This class is used to represent the details of an error and specifies the name of the property and the description of each of the errors associated with that property.

    • Additional properties are NOT allowed
    Hide response attributes Show response attributes object

    This class represents the response which is returned to consumers in case of an error, containing details about it, as well as the correlationId of the performed request so that consumers can supply us that id for us to provide support.

    • 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.

      Hide errors attributes Show errors attributes object

      This class is used to represent the details of an error and specifies the name of the property and the description of each of the errors associated with that property.

    • Additional properties are NOT allowed
GET /v1/Resellers 
curl \
 -X GET https://app-cloudcockpitapi-prod-01.azurewebsites.net/v1/Resellers \
 -H "X-Tenant: string" \
 -H "Authorization: Bearer eyJ0eXAiO..." \
 -H "X-Correlation-Id: string"
Response examples (200) 
{
  "items": [
    {
      "id": "string",
      "companyName": "string",
      "country": "string",
      "addressLine1": "string",
      "addressLine2": "string",
      "city": "string",
      "state": "string",
      "zipCode": "string",
      "firstName": "string",
      "lastName": "string",
      "email": "string",
      "phone": "string",
      "internalIdentifier": "string",
      "taxId": "string",
      "providerResellers": [
        {
          "priceMargin": {
            "value": 8,
            "marginRule": {
              "name": "markup"
            }
          },
          "offerTypeMargins": {
            "Value": {
              "license": {
                "Value": 10,
                "MarginRule": {
                  "Name": "markup"
                }
              }
            }
          },
          "providerInstanceId": "cb3cd15b-1d6e-45be-b493-c71549cbfd87",
          "providerResellerId": "968bd16f-7eca-494d-b29f-440b9ef5cf5d",
          "resellerProviderData": "{\"indirectResellerId\" : \"f94f06fd-dc98-47fb-bd49-63bc98bd87f2\",\"secondaryMpnIds\": [ \"123456\", \"654321\"]}"
        }
      ],
      "customDomain": {
        "customDomain": "string",
        "status": {
          "name": "string"
        }
      }
    }
  ],
  "paginationParameters": {
    "pageNumber": 42,
    "pageSize": 42
  },
  "totalPages": 42,
  "totalCount": 42,
  "hasPreviousPage": true,
  "hasNextPage": true,
  "continuationToken": "string"
}
Response examples (200) 
{
  "items": [
    {
      "id": "string",
      "companyName": "string",
      "country": "string",
      "addressLine1": "string",
      "addressLine2": "string",
      "city": "string",
      "state": "string",
      "zipCode": "string",
      "firstName": "string",
      "lastName": "string",
      "email": "string",
      "phone": "string",
      "internalIdentifier": "string",
      "taxId": "string",
      "providerResellers": [
        {
          "priceMargin": {
            "value": 8,
            "marginRule": {
              "name": "markup"
            }
          },
          "offerTypeMargins": {
            "Value": {
              "license": {
                "Value": 10,
                "MarginRule": {
                  "Name": "markup"
                }
              }
            }
          },
          "providerInstanceId": "cb3cd15b-1d6e-45be-b493-c71549cbfd87",
          "providerResellerId": "968bd16f-7eca-494d-b29f-440b9ef5cf5d",
          "resellerProviderData": "{\"indirectResellerId\" : \"f94f06fd-dc98-47fb-bd49-63bc98bd87f2\",\"secondaryMpnIds\": [ \"123456\", \"654321\"]}"
        }
      ],
      "customDomain": {
        "customDomain": "string",
        "status": {
          "name": "string"
        }
      }
    }
  ],
  "paginationParameters": {
    "pageNumber": 42,
    "pageSize": 42
  },
  "totalPages": 42,
  "totalCount": 42,
  "hasPreviousPage": true,
  "hasNextPage": true,
  "continuationToken": "string"
}
Response examples (400) 
{
  "statusCode": 42,
  "type": "string",
  "description": "string",
  "correlationId": "string",
  "errors": [
    {
      "propertyName": "string",
      "description": [
        "string"
      ]
    }
  ]
}
Response examples (400) 
{
  "statusCode": 42,
  "type": "string",
  "description": "string",
  "correlationId": "string",
  "errors": [
    {
      "propertyName": "string",
      "description": [
        "string"
      ]
    }
  ]
}
Response examples (500) 
{
  "statusCode": 42,
  "type": "string",
  "description": "string",
  "correlationId": "string",
  "errors": [
    {
      "propertyName": "string",
      "description": [
        "string"
      ]
    }
  ]
}
Response examples (500) 
{
  "statusCode": 42,
  "type": "string",
  "description": "string",
  "correlationId": "string",
  "errors": [
    {
      "propertyName": "string",
      "description": [
        "string"
      ]
    }
  ]
}