Contents

Read Section Information

Get information about the specified section, including its name, its channel, and whether it’s a default section.

URL

GET https://news-api.apple.com/sections/{sectionId}

Path Parameters

NameTypeDescription
sectionId Requiredstring

The UUID of the section with information to fetch.

Response Codes

StatusReasonTypeDescription
200OK
Content-Type: application/json
SectionResponse

The request was successful.

400Bad Request
Content-Type: application/json
Error

  • MISSING. You didn’t include the section UUID field in the request. Key path: sectionid.

  • INVALID_TYPE. The value you specified for the section is not of the correct type for that field. Key path: sectionid.

401Unauthorized
Content-Type: application/json
Error

You didn’t include the Authorization header. Key path: None.

403Forbidden
Content-Type: application/json
Error

You tried to access a channel your API key doesn’t have permission to access. Key path: None.

404Not Found
Content-Type: application/json
Error

  • The endpoint you tried to access doesn’t exist. Key path: None.

  • The section you tried to access doesn’t exist. Key path: sectionId.

Discussion

A Read Section Information request retrieves information about a single section. A section is a grouping of articles on a particular topic; for example, Sports, Silicon Valley, or Politics.

Every channel has a default section, even if no other sections are defined. See Add and manage sections in News Publisher User Guide.

Example

See Also

Sections