> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tako.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a notification channel

> Read one notification channel's destination and delivery status

export const MonitorsExperimental = () => <Warning>
    <strong>Monitors is experimental.</strong> Request and payload shapes can change without a deprecation window. Monitors isn't recommended for production workflows.
  </Warning>;

<MonitorsExperimental />

## Notes

* To authenticate, you'll need a [Tako API key](https://tako.com/console/api-keys). It's best practice to store it as an environment variable to avoid hardcoding sensitive credentials in your code.
* An `id` that names no channel of yours answers `404`.
* This response doesn't carry `secret`, and no request other than [create](/api-reference/notification-channels-create) does. Use this endpoint to check where a channel points and whether it's still delivering — not to recover a secret.
* `status_reason` is `delivery_failures` when Tako paused the channel after two consecutive failed deliveries, and `null` when the channel is active or when you paused it yourself.


## OpenAPI

````yaml GET /v1/notification_channels/{id}
openapi: 3.1.0
info:
  title: Knowledge Search API
  version: 1.0.0
servers:
  - url: https://tako.com/api/
    description: Tako Production API Server
security: []
paths:
  /v1/notification_channels/{id}:
    parameters:
      - description: Resource id
        required: true
        schema:
          type: string
          format: uuid
        name: id
        in: path
    get:
      tags:
        - monitors
      summary: Get a notification channel
      description: >-
        One channel, without its secret.


        **Experimental.** Request and payload shapes can change without a
        deprecation window. Monitors isn't recommended for production workflows.
      operationId: getNotificationChannel
      responses:
        '200':
          description: One channel, without its secret
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotificationChannelResponse'
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BaseAPIError'
        '404':
          description: No resource with this id belongs to the caller.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BaseAPIError'
      security:
        - apiKey: []
components:
  schemas:
    NotificationChannelResponse:
      properties:
        id:
          type: string
          format: uuid
          title: Id
        name:
          type: string
          title: Name
        kind:
          $ref: '#/components/schemas/ChannelKind'
        url:
          type: string
          title: Url
        status:
          $ref: '#/components/schemas/ChannelStatus'
        status_reason:
          anyOf:
            - $ref: '#/components/schemas/ChannelStatusReason'
            - type: 'null'
          description: >-
            Why Tako paused the channel. Null while the channel is active, and
            null when you paused it yourself.
        created_at:
          type: string
          format: date-time
          title: Created At
        updated_at:
          type: string
          format: date-time
          title: Updated At
      type: object
      required:
        - id
        - name
        - kind
        - url
        - status
        - status_reason
        - created_at
        - updated_at
      title: NotificationChannelResponse
    BaseAPIError:
      properties:
        error_message:
          type: string
          title: Error Message
        error_type:
          $ref: '#/components/schemas/APIErrorType'
      type: object
      required:
        - error_message
        - error_type
      title: BaseAPIError
    ChannelKind:
      type: string
      enum:
        - webhook
        - slack_workflow
      title: ChannelKind
      description: >-
        How Tako shapes the request body it posts to a channel: `webhook` sends
        nested JSON that namespaces the monitor, the firing, and the payload,
        and `slack_workflow` sends a flat body of strings for a Slack Workflow
        Builder trigger, which rejects any nested value.
    ChannelStatus:
      type: string
      enum:
        - active
        - paused
      title: ChannelStatus
    ChannelStatusReason:
      type: string
      enum:
        - delivery_failures
      title: ChannelStatusReason
    APIErrorType:
      type: string
      enum:
        - BAD_REQUEST
        - AUTHENTICATION_ERROR
        - INTERNAL_SERVER_ERROR
        - RELEVANT_RESULTS_NOT_FOUND
        - RATE_LIMIT_EXCEEDED
        - PAYMENT_REQUIRED
        - REQUEST_TIMEOUT
        - FORBIDDEN
        - NOT_FOUND
        - SERVICE_UNAVAILABLE
        - SERVICE_OVERLOADED
        - UNSUPPORTED_CONTENT_FORMAT
      title: APIErrorType
  securitySchemes:
    apiKey:
      type: apiKey
      name: X-API-Key
      in: header

````