---
title: "GET /subscriptions/{subscriptionId}/providers/Microsoft.BotService/botServices"
method: GET
path: "/subscriptions/{subscriptionId}/providers/Microsoft.BotService/botServices"
tags: ["Bot"]
---

# GET /subscriptions/{subscriptionId}/providers/Microsoft.BotService/botServices

`GET /subscriptions/{subscriptionId}/providers/Microsoft.BotService/botServices`

Returns all the resources of a particular type belonging to a subscription.

## Path parameters

- `subscriptionId` string, required

## Query parameters

- `api-version` string, required

## Response `200`

The resource provider should return 200 (OK) to indicate that the operation completed successfully. For other errors (e.g. internal errors) use the appropriate HTTP error code.
The nextLink field is expected to point to the URL the client should use to fetch the next page (per server side paging). This matches the OData guidelines for paged responses. If a resource provider does not support paging, it should return the same body but leave nextLink empty for future compatibility.
For a detailed explanation of each field in the response body, please refer to the request body description in the PUT resource section.

- BotResponseList — The list of bot service operation response.
  - `nextLink` string — The link used to get the next page of bot service resources.
  - `value` Bot[] — Gets the list of bot service results and their properties.
    - `id` string — Specifies the resource ID.
    - `name` string — Specifies the name of the resource.
    - `location` string — Specifies the location of the resource.
    - `type` string — Specifies the type of the resource.
    - `tags` object — Contains resource tags defined as key/value pairs.
    - `sku` Sku — The SKU of the cognitive services account.
      - `name` 'F0' | 'S1', required — The name of SKU.
      - `tier` 'Free' | 'Standard' — Gets the sku tier. This is based on the SKU name.
    - `kind` 'sdk' | 'designer' | 'bot' | 'function' — Indicates the type of bot service
    - `etag` string — Entity Tag

## Other responses

- `default` — Error response describing why the operation failed

---

[API](https://skmtc.dev/azure/apis/azure-bot-service.md) · [All operations](https://skmtc.dev/azure/apis/azure-bot-service/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/azure-bot-service/revisions/e28acb77637d/schema)