PaginatedArticleList

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/spaceflight-news/refs/heads/main/json-schema/spaceflight-news-paginated-article-list-schema.json",
  "title": "PaginatedArticleList",
  "description": "Paginated envelope wrapping a page of articles.",
  "type": "object",
  "properties": {
    "count": {
      "type": "integer",
      "description": "Total number of articles matching the query.",
      "example": 34380
    },
    "next": {
      "type": "string",
      "nullable": true,
      "format": "uri",
      "description": "URL to fetch the next page of results, or null on the last page.",
      "example": "https://api.spaceflightnewsapi.net/v4/articles/?limit=10&offset=20"
    },
    "previous": {
      "type": "string",
      "nullable": true,
      "format": "uri",
      "description": "URL to fetch the previous page of results, or null on the first page.",
      "example": "https://api.spaceflightnewsapi.net/v4/articles/?limit=10&offset=0"
    },
    "results": {
      "type": "array",
      "description": "The current page of articles.",
      "items": {
        "type": "object",
        "description": "A spaceflight news article aggregated from a participating publisher.",
        "properties": {
          "id": {
            "type": "integer",
            "readOnly": true,
            "description": "Unique identifier of the article.",
            "example": 38168
          },
          "title": {
            "type": "string",
            "maxLength": 250,
            "description": "Title of the article.",
            "example": "Live coverage: SpaceX to launch 50th Starlink mission of 2026"
          },
          "authors": {
            "type": "array",
            "description": "List of authors who contributed to the article.",
            "items": {
              "type": "object",
              "description": "Author byline for an article, blog, or report.",
              "properties": {
                "name": {
                  "type": "string",
                  "maxLength": 250,
                  "description": "Display name of the author.",
                  "example": "Will Robinson-Smith"
                },
                "socials": {
                  "$ref": "#/components/schemas/Socials"
                }
              },
              "required": [
                "name"
              ]
            }
          },
          "url": {
            "type": "string",
            "format": "uri",
            "maxLength": 200,
            "description": "Canonical URL of the article on the source publisher.",
            "example": "https://spaceflightnow.com/2026/05/30/live-coverage-spacex-starlink/"
          },
          "image_url": {
            "type": "string",
            "format": "uri",
            "maxLength": 500,
            "description": "URL to a cover/header image for the article.",
            "example": "https://spaceflightnow.com/wp-content/uploads/2025/09/Starlink_Vertical.jpg"
          },
          "news_site": {
            "type": "string",
            "readOnly": true,
            "description": "Display name of the publisher that produced the article.",
            "example": "Spaceflight Now"
          },
          "summary": {
            "type": "string",
            "description": "Short summary of the article body.",
            "example": "The Starlink 17-41 mission is SpaceX's 10th and final launch of May."
          },
          "published_at": {
            "type": "string",
            "format": "date-time",
            "description": "ISO 8601 timestamp when the article was originally published.",
            "example": "2026-05-30T13:46:18Z"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "ISO 8601 timestamp when the article was last updated in SNAPI.",
            "example": "2026-05-30T13:50:17.306479Z"
          },
          "featured": {
            "type": "boolean",
            "description": "Whether the article is featured (curated by SNAPI editors).",
            "example": false
          },
          "launches": {
            "type": "array",
            "description": "Related Launch Library 2 launches.",
            "items": {
              "type": "object",
              "description": "Relationship to a Launch Library 2 launch.",
              "properties": {
                "launch_id": {
                  "type": "string",
                  "format": "uuid",
                  "description": "Launch Library 2 launch UUID.",
                  "example": "f33d5ece-e825-4cd8-809f-1d4c72a2e0d3"
                },
                "provider": {
                  "type": "string",
                  "readOnly": true,
                  "description": "Source provider of the related launch (typically Launch Library 2).",
                  "example": "Launch Library 2"
                }
              },
              "required": [
                "launch_id",
                "provider"
              ]
            }
          },
          "events": {
            "type": "array",
            "description": "Related Launch Library 2 events.",
            "items": {
              "type": "object",
              "description": "Relationship to a Launch Library 2 event (e.g. EVA, docking, milestone).",
              "properties": {
                "event_id": {
                  "type": "integer",
                  "maximum": 2147483647,
                  "minimum": -2147483648,
                  "description": "Launch Library 2 event identifier.",
                  "example": 851
                },
                "provider": {
                  "type": "string",
                  "readOnly": true,
                  "description": "Source provider of the related event (typically Launch Library 2).",
                  "example": "Launch Library 2"
                }
              },
              "required": [
                "event_id",
                "provider"
              ]
            }
          }
        },
        "required": [
          "authors",
          "events",
          "id",
          "image_url",
          "launches",
          "news_site",
          "published_at",
          "summary",
          "title",
          "updated_at",
          "url"
        ]
      }
    }
  },
  "required": [
    "count",
    "results"
  ]
}