<!--
{
  "availability" : [
    "Apple News API: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "AppleNewsAPI",
  "identifier" : "/documentation/AppleNewsAPI/GET-channels-_channelId_",
  "metadataVersion" : "0.1.0",
  "role" : "Web Service Endpoint",
  "symbol" : {
    "kind" : "Web Service Endpoint",
    "modules" : [
      "Apple News API"
    ],
    "preciseIdentifier" : "rest:news_api:get:channels-{}"
  },
  "title" : "Read Channel Information"
}
-->

# Read Channel Information

Get details about your channel, including the name, corresponding website, and default section.

## Discussion

Use the Read Channel Information endpoint to retrieve information about the channel, list of custom fonts used in the channel ([`Channel`](/documentation/AppleNewsAPI/Channel)), and link to the channel’s default section ([`ChannelLinks`](/documentation/AppleNewsAPI/ChannelLinks)). See <doc://com.apple.applenews/documentation/AppleNews/making-an-http-request-to-the-apple-news-api> and <doc://com.apple.applenews/documentation/AppleNews/signing-the-http-request> in <doc://com.apple.applenews/documentation/AppleNews/apple-news-api-tutorial>.

You create a channel in News Publisher, not the Apple News API. See [Add or share a channel](https://support.apple.com/guide/news-publisher/apd1c0277d3e) in News Publisher User Guide.

### Example

**Request:**

```
GET /channels/63a75491-2c4d-3530-af91-819be8c3ace0 HTTP/1.1
Host: news-api.apple.com
Accept: application/json
Authorization: HHMAC; key="1e3gfc5e-e9f8-4232-a6be-17bf40edad09"; signature="mLtpym3Lgl1300t8cze9wyWOaxkRBKL3j3ztalMjgWs="; date="2015-03-05T02:49:58Z"
```

**Response:**

```json
HTTP/1.1 200 OK
Date: Thu, 05 Mar 2015 02:53:54 GMT
Content-Type: application/json;charset=UTF-8
Transfer-Encoding: chunked	 
{
  "data": {
    "createdAt": "2015-02-19T04:57:23Z",
    "modifiedAt": "2015-02-23T23:25:53Z",
    "id": "63a75491-2c4d-3530-af91-819be8c3ace0",
    "type": "channel",
    "shareUrl": "https://apple.news/ArRPpLPE9QXu3sehS0rvxvA",
    "links": {
      "defaultSection": "https://news-api.apple.com/sections/4523e2f6-89fb-4842-b9f2-46514f7ebc6b",
      "self": "https://news-api.apple.com/channels/63a75491-2c4d-3530-af91-819be8c3ace0"
    },
    "name": "My Channel",
    "website": "http://example.com"
    "fonts": [
    ]
  }
}
```

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)