action dodo_get_nh_photos {
  label: "All New Horizons photos and posters"
  description: "Get a list of all character photos+posters and their details in *Animal Crossing: New Horizons*."
  provider: dodo
  method: GET
  path: "/nh/photos"
  encoding: json
  input: {
    type: "object"
    properties: {
      "Accept-Version": {
        type: "string"
      }
      "X-API-KEY": {
        type: "string"
        format: "uuid"
      }
      excludedetails: {
        type: "string"
      }
    }
    required: ["Accept-Version", "X-API-KEY"]
    additionalProperties: false
  }
  output: {
    type: "array"
    items: {
      type: "object"
      properties: {
        availability: {
          type: "array"
          description: "Where the photo may be obtained from (could be multiple sources). `from` is a brief description of the source; `note`, when provided, provides additional details."
          items: {
            type: "object"
            properties: {
              from: {
                type: "string"
              }
              note: {
                type: "string"
              }
            }
          }
        }
        buy: {
          type: "array"
          description: "An array of prices, for when the item may be purchased with Bells, Nook Miles, etc.."
          items: {
            type: "object"
            properties: {
              currency: {
                type: "string"
              }
              price: {
                type: "integer"
              }
            }
          }
        }
        category: {
          type: "string"
          description: "The category of item as shown in the player's inventory."
          enum: ["Photos", "Posters"]
        }
        custom_body_part: {
          type: "string"
          description: "If the item has variations, this is the name of the furniture part that changes. For example, for many bamboo items, the custom body part is \"Bamboo\" as the bamboo color is able to be customized."
        }
        custom_kits: {
          type: "integer"
          description: "The number of `custom_kit_type`s (e.g. Customization Kits) that are needed to customize this item. Value is 0 if the item is not customizable."
        }
        customizable: {
          type: "boolean"
          description: "Whether or not the item is customizable via a crafting table."
        }
        grid_length: {
          type: "number"
          format: "float"
          description: "The number of lengthwise grid spaces this item takes up."
        }
        grid_width: {
          type: "number"
          format: "float"
          description: "The number of widthwise grid spaces this item takes up."
        }
        interactable: {
          type: "boolean"
          description: "Whether or not the item can be interacted with. This field is true for all photos and false for all posters."
        }
        name: {
          type: "string"
          description: "The name of the photo."
        }
        sell: {
          type: "integer"
          description: "The number of Bells the photo can be sold to the store for."
        }
        unlocked: {
          type: "boolean"
          description: "Whether the item is available through legitimate gameplay. Some items are added to the game files in an update, but aren't actually made available until a subsequent update unlocks them."
        }
        url: {
          type: "string"
          description: "Link to the respective Nookipedia article."
        }
        variations: {
          type: "array"
          description: "An array of objects, each object representing a variation of the photo or poster. Items that has no variations (only one version) will have a single variation object with the image URL and colors, but the `variation` field will be empty. Items with multiple variations will have the `variation` fields defined with the name of each variation."
          items: {
            type: "object"
            properties: {
              colors: {
                type: "array"
                items: {
                  type: "string"
                  enum: ["Aqua", "Beige", "Black", "Blue", "Brown", "Colorful", "Gray", "Green", "Orange", "Pink", "Purple", "Red", "White", "Yellow"]
                }
              }
              image_url: {
                type: "string"
              }
              variation: {
                type: "string"
              }
            }
          }
        }
        version_added: {
          type: "string"
          description: "The version of *New Horizons* that the item was added. Items that were included at the game's launch have version \"1.0.0\"."
        }
      }
    }
  }
}