---
title: "List all SNIs"
url: "https://nov18-dev.movespot.fyi/apis/konnect-runtime-groups-configuration-0/versions/af18902c-58f1-49d7-8ec2-9987b4e0d1bd/operations/list-snis"
---

> Full API specification: https://nov18-dev.movespot.fyi/apis/konnect-runtime-groups-configuration-0/versions/af18902c-58f1-49d7-8ec2-9987b4e0d1bd.md

# List all SNIs

`GET` `/runtime-groups/{runtimeGroupId}/core-entities/snis`

Operation ID: `list-snis`

List all SNIs

## Path parameters

- `runtimeGroupId` (string, required) - The ID of your runtime group. This variable is available in the Konnect manager

## Query parameters

- `size` (integer, optional) - Number of resources to be returned.
- `offset` (string, optional) - Offset from which to return the next set of resources. Use the value of the 'offset' field from the response of a list operation as input here to paginate through all the resources
- `tags` (string, optional) - A list of tags to filter the list of resources on. Multiple tags can be concatenated using ',' to mean AND or using '/' to mean OR.

## Responses

- `200` - SNI response object

## OpenAPI definition

```yaml
openapi: 3.0.0
info:
  title: Konnect Runtime Groups Configuration
  version: 0.0.1
servers:
  - url: https://us.api.konghq.com/v2
    description: United-States Production region
  - url: https://eu.api.konghq.com/v2
    description: Europe Production region
  - url: https://au.api.konghq.com/v2
    description: Australia Production region
  - url: https://me.api.konghq.com/v2
    description: Middle-East Production region
  - url: https://in.api.konghq.com/v2
    description: India Production region
  - url: https://sg.api.konghq.com/v2
    description: Singapore Production region
paths:
  /runtime-groups/{runtimeGroupId}/core-entities/snis:
    parameters:
      - $ref: "#/components/parameters/runtimeGroupId"
    get:
      operationId: list-snis
      summary: List all SNIs
      description: List all SNIs
      parameters:
        - $ref: "#/components/parameters/pagination-size"
        - $ref: "#/components/parameters/pagination-offset"
        - $ref: "#/components/parameters/pagination-tags-filter"
      responses:
        "200":
          $ref: "#/components/responses/sni-response"
      tags:
        - SNIs
security:
  - konnectAccessToken: []
  - personalAccessToken: []
components:
  parameters:
    runtimeGroupId:
      name: runtimeGroupId
      in: path
      required: true
      schema:
        type: string
        example: 9524ec7d-36d9-465d-a8c5-83a3c9390458
      description: The ID of your runtime group. This variable is available in the
        Konnect manager
    pagination-size:
      description: Number of resources to be returned.
      in: query
      name: size
      schema:
        type: integer
        default: 100
        maximum: 1000
        minimum: 1
    pagination-offset:
      description: Offset from which to return the next set of resources. Use the
        value of the 'offset' field from the response of a list operation as
        input here to paginate through all the resources
      in: query
      name: offset
      schema:
        type: string
    pagination-tags-filter:
      description: A list of tags to filter the list of resources on. Multiple tags
        can be concatenated using ',' to mean AND or using '/' to mean OR.
      example: tag1,tag2
      in: query
      name: tags
      schema:
        type: string
  responses:
    sni-response:
      description: SNI response object
      content:
        application/json:
          schema:
            type: object
            properties:
              data:
                description: Array of SNIs
                type: array
                items:
                  type: object
                  properties:
                    id:
                      description: The unique identifier or the name attribute of the Certificate
                        whose SNIs are to be retrieved. When using this
                        endpoint, only SNIs associated to the specified
                        Certificate will be listed.
                      type: string
                      example: 147f5ef0-1ed6-4711-b77f-489262f8bff7
                    name:
                      description: |
                        The SNI name to associate with the given certificate.
                      type: string
                      example: my-sni
                    created_at:
                      description: |
                        Unix epoch when the resource was created.
                      type: integer
                      example: 1422386534
                    tags:
                      description: >
                        An optional set of strings associated with the SNIs for
                        grouping and filtering.
                      type: array
                      items:
                        type: string
                    certificate:
                      description: >
                        The id (a UUID) of the certificate with which to
                        associate the SNI hostname. The Certificate must have a
                        valid private key associated with it to be used by the
                        SNI object.
                      type: object
                      properties:
                        id:
                          description: The unique identifier or the name attribute of the Certificate
                            whose SNIs
                          type: string
                          example: 2e013e8-7623-4494-a347-6d29108ff68b
              next:
                description: Offset is used to paginate through the API. Provide this value to
                  the next list operation to fetch the next page
                type: string
                example: http://localhost:8001/snis?offset=6378122c-a0a1-438d-a5c6-efabae9fb969
            x-examples:
              Example 1:
                data:
                  - id: 147f5ef0-1ed6-4711-b77f-489262f8bff7
                    name: my-sni
                    created_at: 1422386534
                    tags:
                      - user-level
                      - low-priority
                    certificate:
                      id: a3ad71a8-6685-4b03-a101-980a953544f6
                  - id: b87eb55d-69a1-41d2-8653-8d706eecefc0
                    name: my-sni
                    created_at: 1422386534
                    tags:
                      - admin
                      - high-priority
                      - critical
                    certificate:
                      id: 4e8d95d4-40f2-4818-adcb-30e00c349618
                next: http://localhost:8001/snis?offset=6378122c-a0a1-438d-a5c6-efabae9fb969
          examples:
            Example SNI response:
              value:
                certificate:
                  id: e94215b0-9198-42ce-bf0b-98afff31b2a7
                created_at: 1685646239
                id: cf3b640e-100e-4fa4-aef6-2dc0488d7a58
                name: my-sni
                updated_at: 1685646239
  securitySchemes:
    konnectAccessToken:
      type: http
      scheme: bearer
      description: >-
        The Konnect access token is meant to be used by the Konnect dashboard
        and the decK CLI to

        authenticate with.
    personalAccessToken:
      type: http
      scheme: bearer
      description: The personal access token is meant to be used as an alternative to
        basic-auth when accessing Konnect via APIs. You can generate a Personal
        Access Token (PAT) from the personal access token page in the Konnect
        dashboard.
```
