# List channels > List channels: GET /v1/channels. One item per connected channel (several accounts on the same network give several items; default marks the one used when channel is omitted), plus a "not connected" item for each network without an account. Includes the status and the number of time slots. Source: https://praeko.app/docs/en/api/channels/list-channels `GET /v1/channels` · minimum scope: read One item per connected channel (several accounts on the same network give several items; `default` marks the one used when `channel` is omitted), plus a "not connected" item for each network without an account. Includes the status and the number of time slots. > **Headers** `Authorization: Bearer praeko_…` and `X-Praeko-Contract: en`. Always send both. Legacy Portuguese alias (still answered, marked as deprecated): `/v1/canais`. ## Example **curl** ```bash curl "https://praeko.app/v1/channels" \ -H "Authorization: Bearer $PRAEKO_KEY" \ -H "X-Praeko-Contract: en" ``` **JavaScript** ```js const res = await fetch("https://praeko.app/v1/channels", { method: "GET", headers: { "Authorization": `Bearer ${process.env.PRAEKO_KEY}`, "X-Praeko-Contract": "en", }, }); console.log(res.status, await res.json()); ``` **Node** ```js import { Praeko } from "@praeko/sdk"; const praeko = new Praeko({ url: "https://praeko.app", key: process.env.PRAEKO_KEY }); const resultado = await praeko.channels.list(); console.log(resultado); ``` **Python** ```python import os import requests resp = requests.get( "https://praeko.app/v1/channels", headers={ "Authorization": f"Bearer {os.environ['PRAEKO_KEY']}", "X-Praeko-Contract": "en", }, ) print(resp.status_code, resp.json()) ``` **PHP** ```php 'GET', CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => [ "Authorization: Bearer " . getenv("PRAEKO_KEY"), 'X-Praeko-Contract: en', ], ]); $resposta = curl_exec($ch); echo curl_getinfo($ch, CURLINFO_HTTP_CODE), " ", $resposta, PHP_EOL; curl_close($ch); ``` **Go** ```go package main import ( "fmt" "io" "net/http" "os" ) func main() { req, err := http.NewRequest("GET", "https://praeko.app/v1/channels", nil) if err != nil { panic(err) } req.Header.Set("Authorization", "Bearer "+os.Getenv("PRAEKO_KEY")) req.Header.Set("X-Praeko-Contract", "en") resp, err := http.DefaultClient.Do(req) if err != nil { panic(err) } defer resp.Body.Close() out, _ := io.ReadAll(resp.Body) fmt.Println(resp.Status, string(out)) } ``` **Ruby** ```ruby require "net/http" require "uri" uri = URI("https://praeko.app/v1/channels") request = Net::HTTP::Get.new(uri) request["Authorization"] = "Bearer #{ENV['PRAEKO_KEY']}" request["X-Praeko-Contract"] = "en" response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) } puts response.code, response.body ``` **C#** ```csharp using System.Net.Http; using System.Net.Http.Headers; using System.Text; using var client = new HttpClient(); using var request = new HttpRequestMessage(HttpMethod.Get, "https://praeko.app/v1/channels"); request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("PRAEKO_KEY")); request.Headers.Add("X-Praeko-Contract", "en"); using var response = await client.SendAsync(request); Console.WriteLine($"{(int)response.StatusCode} {await response.Content.ReadAsStringAsync()}"); ``` **Java** ```java import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; public class Main { public static void main(String[] args) throws Exception { HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://praeko.app/v1/channels")) .header("Authorization", "Bearer " + System.getenv("PRAEKO_KEY")) .header("X-Praeko-Contract", "en") .method("GET", HttpRequest.BodyPublishers.noBody()) .build(); HttpResponse response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.statusCode() + " " + response.body()); } } ``` **HTTPie** ```bash http GET "https://praeko.app/v1/channels" \ "Authorization: Bearer $PRAEKO_KEY" \ "X-Praeko-Contract: en" ``` > Official SDK for Node: Install it with `npm install @praeko/sdk` (see [SDK and CLI](https://praeko.app/docs/en/sdk)). ## Response | Success status | When | |---|---| | `200` | Success. | **Response 200** ```json { "channels": [ { "network": "youtube", "supported": true, "id": "01KA3V0R5D8M2WQ7X4HT9NZ1BF", "connected": true, "detail": "Marcone's Channel", "name": "Marcone's Channel", "timezone": "America/Sao_Paulo", "slots": 3, "avatar": "/v1/channels/youtube/avatar", "default": true }, { "network": "instagram", "supported": true, "id": "01KA3V1G4C7N9PXS2WQ6HM8TDZ", "connected": true, "detail": "via the Meta API", "timezone": "America/Sao_Paulo", "slots": 0, "meta": { "connected": true, "username": "dev.ocioso" }, "name": "dev.ocioso" }, { "network": "tiktok", "supported": true, "connected": false, "detail": "not connected (the TIKTOK_CLIENT_KEY and TIKTOK_CLIENT_SECRET secrets are missing)" } ] } ``` One item per connected account (several accounts on a network = several items) and a "not connected" item for each network without an account. `detail` is free text the server writes in Portuguese; the example shows it in English. ## Errors No errors specific to this route besides the common ones. ### Errors on any route | Status | code | When | |---|---|---| | 401 | `unauthorized` | The `Authorization: Bearer …` header is missing. | | 401 | `invalid_api_key` | The key does not exist. | | 401 | `revoked_api_key` | The key has been revoked. | | 401 | `expired_api_key` | The key has expired. | | 403 | `forbidden` | The key's scope is not enough for this route (see the scope badge). | | 429 | `rate_limited` | The per-minute request limit was exceeded. | The body of every error is `{ "error": { "code", "message", "details"? } }`. See [all error codes](https://praeko.app/docs/en/guides/errors-and-limits). ## Try it > **Try it**: the live test needs you to be signed in. It is switched off here.