---
title: "GET /kanaal/{uuid}"
method: GET
path: "/kanaal/{uuid}"
tags: ["kanaal"]
---

# GET /kanaal/{uuid}

`GET /kanaal/{uuid}`

## Request

- Base URL: `/api/v1` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/v1/kanaal/{uuid}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/vng-realisatie/apis/notificaties-api/docs/kanaal/:uuid/get.ts> (a function with typed inputs; its response is checked against the schema)

Een specifiek KANAAL opvragen.

## Response `200`

OK

- Kanaal
  - `url` string, uri: URL-referentie naar dit object. Dit is de unieke identificatie en locatie van dit object.
  - `naam` string, required: Naam van het KANAAL (ook wel "Exchange" genoemd) dat de bron vertegenwoordigd.
  - `documentatieLink` string, uri: URL naar documentatie.
  - `filters` string[]: Lijst van mogelijke filter kenmerken van een KANAAL. Deze filter kenmerken kunnen worden gebruikt bij het aanmaken van een ABONNEMENT.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `406`: Not acceptable
- `409`: Conflict
- `410`: Gone
- `415`: Unsupported media type
- `429`: Too many requests
- `500`: Internal server error

## Changes

- **2019-05-16** `0175e7c33f58`: 2 info
  - the security scope `(notificaties.publiceren | notificaties.consumeren)` was added to the endpoint's security scheme `JWT-Claims`
  - the security scope `(notificaties.scopes.publiceren | notificaties.scopes.consumeren)` was removed from the endpoint's security scheme `JWT-Claims`

[Operation history](https://skmtc.dev/vng-realisatie/apis/notificaties-api/changes/kanaal/:uuid/get.md)

---

[API](https://skmtc.dev/vng-realisatie/apis/notificaties-api.md) - [All operations](https://skmtc.dev/vng-realisatie/apis/notificaties-api/llms.txt) - [OpenAPI document](https://skmtc.dev/vng-realisatie/apis/notificaties-api/revisions/ff27778ddd2f?raw)