Noun Project Icon Response Structure

{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/noun-project/refs/heads/main/json-structure/noun-project-icon-response-structure.json",
  "name": "IconResponse",
  "description": "Single icon response wrapper.",
  "type": "object",
  "properties": {
    "icon": {
      "type": "object",
      "description": "A single icon in the Noun Project library.",
      "properties": {
        "id": {
          "type": "int32",
          "description": "Numeric identifier of the icon.",
          "example": 1234567
        },
        "attribution": {
          "type": "string",
          "description": "Required attribution string when the icon is not public domain.",
          "example": "rocket by Jane Smith from Noun Project"
        },
        "attribution_preview_url": {
          "type": "uri",
          "description": "URL to a rendered attribution image suitable for design overlays.",
          "example": "https://static.thenounproject.com/png/1234567-attribution.png"
        },
        "creator": {
          "$ref": "#/components/schemas/IconCreator"
        },
        "date_uploaded": {
          "type": "datetime",
          "description": "ISO 8601 timestamp when the icon was uploaded.",
          "example": "2024-08-15T13:45:00Z"
        },
        "is_active": {
          "type": "boolean",
          "description": "Whether the icon is currently active and available for download.",
          "example": true
        },
        "is_public_domain": {
          "type": "boolean",
          "description": "Whether the icon has been released into the public domain.",
          "example": false
        },
        "license_description": {
          "type": "string",
          "description": "Human-readable license summary.",
          "example": "creative-commons-attribution"
        },
        "permalink": {
          "type": "uri",
          "description": "Canonical URL for the icon on thenounproject.com.",
          "example": "https://thenounproject.com/icon/1234567/"
        },
        "preview_url": {
          "type": "uri",
          "description": "URL for the default-size preview image.",
          "example": "https://static.thenounproject.com/png/1234567-200.png"
        },
        "preview_url_42": {
          "type": "uri",
          "description": "URL for the 42-pixel thumbnail.",
          "example": "https://static.thenounproject.com/png/1234567-42.png"
        },
        "preview_url_84": {
          "type": "uri",
          "description": "URL for the 84-pixel thumbnail.",
          "example": "https://static.thenounproject.com/png/1234567-84.png"
        },
        "preview_url_200": {
          "type": "uri",
          "description": "URL for the 200-pixel thumbnail.",
          "example": "https://static.thenounproject.com/png/1234567-200.png"
        },
        "icon_url": {
          "type": "uri",
          "description": "Direct URL to the SVG asset (when include_svg is not used).",
          "example": "https://static.thenounproject.com/svg/1234567.svg"
        },
        "svg": {
          "type": "string",
          "description": "Inline SVG markup when include_svg=true was requested.",
          "example": "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 512 512\"><path d=\"...\"/></svg>"
        },
        "style": {
          "type": "string",
          "description": "Visual style classification of the icon.",
          "enum": [
            "solid",
            "line"
          ],
          "example": "solid"
        },
        "line_weight": {
          "type": "int32",
          "description": "Line weight in pixels at 512px rendering (line-style icons only).",
          "minimum": 1,
          "maximum": 60,
          "example": 4
        },
        "tags": {
          "type": "array",
          "description": "Search tags applied to the icon.",
          "items": {
            "$ref": "#/components/schemas/Tag"
          }
        },
        "term": {
          "type": "string",
          "description": "Primary search term used to discover the icon.",
          "example": "rocket"
        },
        "term_slug": {
          "type": "string",
          "description": "URL-safe version of the term.",
          "example": "rocket"
        },
        "year_published": {
          "type": "int32",
          "description": "Year the icon was first published.",
          "example": 2024
        },
        "royalty_free_license": {
          "type": "boolean",
          "description": "Whether the icon is included under the royalty-free license.",
          "example": true
        },
        "nsfw": {
          "type": "boolean",
          "description": "Whether the icon has been flagged not-safe-for-work.",
          "example": false
        },
        "sponsor_id": {
          "type": [
            "integer",
            "null"
          ],
          "description": "Identifier of the sponsoring brand if any.",
          "example": null
        },
        "thumbnail_url": {
          "type": "uri",
          "description": "Thumbnail URL at the requested thumbnail_size.",
          "example": "https://static.thenounproject.com/png/1234567-200.png"
        }
      },
      "required": [
        "id",
        "permalink"
      ]
    },
    "generated_at": {
      "type": "datetime",
      "description": "ISO 8601 timestamp of when the response was generated.",
      "example": "2026-05-28T14:00:00Z"
    }
  },
  "required": [
    "icon"
  ]
}