Report

A spaceflight report (mission report, program update, or agency briefing) from a participating publisher.

NewsSpaceSpaceflightAerospaceOpen SourceLaunchesPublic APIs

Properties

Name	Type	Description
id	integer	Unique identifier of the report.
title	string	Title of the report.
authors	array	List of authors who contributed to the report.
url	string	Canonical URL of the report on the source publisher.
image_url	string	URL to a cover/header image for the report.
news_site	string	Display name of the publisher that produced the report.
summary	string	Short summary of the report.
published_at	string	ISO 8601 timestamp when the report was originally published.
updated_at	string	ISO 8601 timestamp when the report was last updated in SNAPI.

View JSON Schema on GitHub

JSON Schema

{
  "$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-report-schema.json",
  "title": "Report",
  "description": "A spaceflight report (mission report, program update, or agency briefing) from a participating publisher.",
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "readOnly": true,
      "description": "Unique identifier of the report.",
      "example": 1662
    },
    "title": {
      "type": "string",
      "maxLength": 250,
      "description": "Title of the report.",
      "example": "Starliner arrives safely back on Earth"
    },
    "authors": {
      "type": "array",
      "description": "List of authors who contributed to the report.",
      "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": {
            "type": "object",
            "description": "Social media handles for an author.",
            "properties": {
              "x": {
                "type": "string",
                "format": "uri",
                "maxLength": 200,
                "description": "URL of the author's X (Twitter) profile.",
                "example": "https://x.com/willrobinsons"
              },
              "youtube": {
                "type": "string",
                "format": "uri",
                "maxLength": 200,
                "description": "URL of the author's YouTube channel.",
                "example": "https://youtube.com/@author"
              },
              "instagram": {
                "type": "string",
                "format": "uri",
                "maxLength": 200,
                "description": "URL of the author's Instagram profile.",
                "example": "https://instagram.com/author"
              },
              "linkedin": {
                "type": "string",
                "format": "uri",
                "maxLength": 200,
                "description": "URL of the author's LinkedIn profile.",
                "example": "https://linkedin.com/in/author"
              },
              "mastodon": {
                "type": "string",
                "format": "uri",
                "maxLength": 200,
                "description": "URL of the author's Mastodon profile.",
                "example": "https://mastodon.social/@author"
              },
              "bluesky": {
                "type": "string",
                "format": "uri",
                "maxLength": 200,
                "description": "URL of the author's Bluesky profile.",
                "example": "https://bsky.app/profile/author.bsky.social"
              }
            }
          }
        },
        "required": [
          "name"
        ]
      }
    },
    "url": {
      "type": "string",
      "format": "uri",
      "maxLength": 200,
      "description": "Canonical URL of the report on the source publisher.",
      "example": "https://starlinerupdates.com/starliner-arrives-safely-back-on-earth/"
    },
    "image_url": {
      "type": "string",
      "format": "uri",
      "maxLength": 200,
      "description": "URL to a cover/header image for the report.",
      "example": "https://boeing-jtti.s3.amazonaws.com/wp-content/uploads/2023/02/docking.png"
    },
    "news_site": {
      "type": "string",
      "readOnly": true,
      "description": "Display name of the publisher that produced the report.",
      "example": "Boeing"
    },
    "summary": {
      "type": "string",
      "description": "Short summary of the report.",
      "example": "Boeing's Starliner landed safely at 12:01 a.m. Eastern time on Saturday."
    },
    "published_at": {
      "type": "string",
      "format": "date-time",
      "description": "ISO 8601 timestamp when the report was originally published.",
      "example": "2024-09-07T04:14:32Z"
    },
    "updated_at": {
      "type": "string",
      "format": "date-time",
      "readOnly": true,
      "description": "ISO 8601 timestamp when the report was last updated in SNAPI.",
      "example": "2024-09-07T04:18:06.656360Z"
    }
  },
  "required": [
    "authors",
    "id",
    "image_url",
    "news_site",
    "published_at",
    "title",
    "updated_at",
    "url"
  ]
}