MentionListResponse

{
  "type": "object",
  "properties": {
    "mentions": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/Mention"
      },
      "description": "Newest first."
    },
    "has_more": {
      "type": "boolean",
      "description": "True when more results exist past this page."
    },
    "next_cursor": {
      "type": [
        "string",
        "null"
      ],
      "description": "Opaque cursor for the next page. Null on the last page."
    },
    "entity": {
      "allOf": [
        {
          "$ref": "#/components/schemas/Entity"
        },
        {
          "description": "The resolved entity the mentions belong to."
        }
      ]
    },
    "window": {
      "$ref": "#/components/schemas/PublicationWindow"
    },
    "note": {
      "type": "string",
      "description": "Present on a free preview page: where the list stops and the plan that lifts it. Say so rather than calling this every mention."
    },
    "unlock": {
      "type": "object",
      "properties": {
        "tier": {
          "type": "string",
          "description": "The plan that lifts the preview."
        },
        "url": {
          "type": "string",
          "description": "Where to start that plan."
        }
      },
      "required": [
        "tier",
        "url"
      ],
      "description": "Present with note on a free preview page."
    },
    "freshness": {
      "allOf": [
        {
          "$ref": "#/components/schemas/Freshness"
        },
        {
          "description": "Present when your plan's freshness gate cut the window: where results on this plan stop. unlock names the plan that reads past it."
        }
      ]
    }
  },
  "required": [
    "mentions",
    "has_more",
    "next_cursor",
    "entity",
    "window"
  ]
}