---
title: Read Channel Information
framework: applenewsapi
role: symbol
role_heading: Web Service Endpoint
path: applenewsapi/get-channels-_channelid_
---

# Read Channel Information

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

## URL

GET https://news-api.apple.com/channels/{channelId}

## Path Parameters

channelId: The UUID of the channel to get. You can get your channel ID from News Publisher. See Use your CMS with News Publisher in News Publisher User Guide.

## Response Codes

200 OK: The request was successful. 400 Bad Request:  MISSING. You didn’t include the Channel UUID field in the request. Key path: * INVALID_JSON. The server can’t parse the JSON specified in the request as JSON. Key path: None. INVALID_TYPE. The value you specified for channelId is not of the correct type for that field. Key path: channelId. 401 Unauthorized: You didn’t include the Authorization header. Key path: None. 403 Forbidden: You tried to access a channel your API key doesn’t have permission to access. Key path: None. 404 Not Found:  The endpoint you tried to access doesn’t exist. Key path: None. The channel you tried to access doesn’t exist. Key path: channel_id.

## Mentioned in

Making an HTTP Request to the Apple News API Signing the HTTP Request

## Discussion

Discussion Use the Read Channel Information endpoint to retrieve information about the channel, list of custom fonts used in the channel (Channel), and link to the channel’s default section (ChannelLinks). See Making an HTTP Request to the Apple News API and Signing the HTTP Request in Apple News API Tutorial. You create a channel in News Publisher, not the Apple News API. See Add or share a channel in News Publisher User Guide. Example

## See Also

### Channel

- [Read Channel Quota Information](applenewsapi/get-channels-_channelid_-quota.md)
- [Channel](applenewsapi/channel.md)
- [ChannelLinks](applenewsapi/channellinks.md)
- [ChannelResponse](applenewsapi/channelresponse.md)