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

# List All Sections

See a list of available sections in your channel.

## Discussion

A List All Sections request returns a list of all sections for a channel. A section is a grouping of articles on a particular topic; for example, Sports, Silicon Valley, or Politics.

You create sections in News Publisher. Sections aren’t created via the API; they are set up separately in News Publisher. See [Add and manage sections](https://support.apple.com/guide/news-publisher/apdfc6a051aa) in News Publisher User Guide. Every channel has a default section, even if no other sections are defined. The default section URL is included in the [`Read Channel Information`](/documentation/AppleNewsAPI/GET-channels-_channelId_) response.

### Example

**Request:**

```
GET /channels/63a75491-2c4d-3530-af91-819be8c3ace0/sections 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-03-07T00:00:56Z",
      "modifiedAt": "2015-03-07T00:11:52Z",
      "id": "0a468272-356f-3b61-afa3-c4f989954180",
      "type": "section",
      "shareUrl": "https://apple.news/ArRPpLPE9QXu3sehS0rvxvA",
      "links": {
        "channel": "https://news-api.apple.com/channels/63a75491-2c4d-3530-af91-819be8c3ace0",
        "self": "https://news-api.apple.com/sections/0a468272-356f-3b61-afa3-c4f989954180"
      },
      "name": "Main",
      "isDefault": true
    },
    {
      "createdAt": "2015-03-08T00:00:24Z",
      "modifiedAt": "2015-03-08T00:10:11Z",
      "id": "0a664711-242f-6b13-1fa1-a6f081549989",
      "type": "section",
      "shareUrl": "https://apple.news/ArRPpLPE9QXu3sehS0rvxvB",
      "links": {
        "channel": "https://news-api.apple.com/channels/63a75491-2c4d-3530-af91-819be8c3ace0",
        "self": "https://news-api.apple.com/sections/0a664711-242f-6b13-1fa1-a6f081549989"
      },
      "name": "Sports",
      "isDefault": false
    }
  ]
}
```

---

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)