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

# Read Article Information

Retrieve information about an article, such as the revision number and maturity rating.

## Discussion

Use the Read Article Information endpoint to retrieve information about the article ([`Article`](/documentation/AppleNewsAPI/Article)), article links (`ArticleLinks`), meta ([`Meta`](/documentation/AppleNewsAPI/Meta)), and optional metadata fields ([`Create Article Metadata Fields`](/documentation/AppleNewsAPI/Create-Article-Metadata-Fields)).

### Example

**Request:**

```
GET /articles/a3caeb08-b9db-4002-b379-cde305d74be7 HTTP/1.1
Host: news-api.apple.com
Accept: application/json
Authorization: HHMAC; key="1e3gfc5e-e9f8-4232-a6be-17bf40edad09"; signature="irqw07DCRQLtx/40Z2VhNc7sl3nB1PKII374R7AHjUQ="; date="2015-02-28T00:03:31Z"
```

**Response:**

```json
HTTP/1.1 200 OK
Date: Sat, 28 Feb 2015 00:51:41 GMT
Content-Type: application/json;charset=UTF-8
Transfer-Encoding: chunked
{
  "data": {
    "createdAt": "2015-02-28T00:49:36Z",
    "modifiedAt": "2015-02-28T00:49:36Z",
    "id": "a3caeb08-b9db-4002-b379-cde305d74be7",
    "type": "article",
    "shareUrl": "https://apple.news/ArRPpLPE9QXu3sehS0rvxvA",
    "links": {
      "channel": "https://news-api.apple.com/channels/63a75491-2c4d-3530-af91-819be8c3ace0",
      "self": "https://news-api.apple.com/articles/a3caeb08-b9db-4002-b379-cde305d74be7",
      "sections": [
        "https://news-api.apple.com/sections/0a468272-356f-3b61-afa3-c4f989954180",
        "https://news-api.apple.com/sections/0a664711-242f-6b13-1fa1-a6f081549989"
      ]
    },
  "document": {
  "version": "1.7",
  "identifier": "SampleArticle",
  "language": "en",
  "title": "Apple News App",
  "subtitle": "A look at the features of the News iOS app",
  "layout": {
    "columns": 7,
    "width": 1024,
    "margin": 75,
    "gutter": 20
  },
  "components": [
    {
      "role": "title",
      "text": "Apple News App",
      "textStyle": "title"
    },
    {
      "role": "body",
      "text": "The Apple News Format allows publishers to craft beautiful editorial layouts. Galleries, audio, video, and fun interactions like animation make stories spring to life."
    },
    {
      "role": "photo",
      "URL": "bundle://image.jpg"
    }
  ],
  "documentStyle": {
    "backgroundColor": "#F7F7F7"
  },
  "componentTextStyles": {
    "default": {
      "fontName": "Helvetica",
      "fontSize": 13,
      "linkStyle": {
        "textColor": "#428bca"
      }
    },
    "title": {
      "fontName": "Helvetica-Bold",
      "fontSize": 30,
      "hyphenation": false
    },
    "default-body": {
      "fontName": "Helvetica",
      "fontSize": 13
    }
  }
  },
"revision": "AAAAAAAAAAAAAAAAAAAAew==",
"state": "PROCESSING",
"title": "Tie Goes to the Runner",
"maturityRating": null,
"warnings": [],
"isCandidateToBeFeatured": false,
"isSponsored": false,
"isPreview": false,
"targetTerritoryCountryCodes": ["GB", "US"]
}
}
```

---

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)