action square_retrieve_dispute_evidence {
  label: "RetrieveDisputeEvidence"
  description: "Returns the evidence metadata specified by the evidence ID in the request URL path\n\nYou must maintain a copy of the evidence you upload if you want to reference it later. You cannot\ndownload the evidence after you upload it."
  provider: square
  method: GET
  path: "/v2/disputes/{dispute_id}/evidence/{evidence_id}"
  encoding: json
  input: {
    type: "object"
    properties: {
      dispute_id: {
        type: "string"
      }
      evidence_id: {
        type: "string"
      }
    }
    required: ["dispute_id", "evidence_id"]
    additionalProperties: false
  }
  output: {
    type: "object"
    description: "Defines the fields in a `RetrieveDisputeEvidence` response."
    properties: {
      errors: {
        type: "array"
        description: "Any errors that occurred during the request."
        items: {
          type: "object"
          description: "Represents an error encountered during a request to the Connect API.\n\nSee [Handling errors](https://developer.squareup.com/docs/build-basics/handling-errors) for more information."
          required: ["category", "code"]
          properties: {
            category: {
              type: "string"
              description: "The high-level category for the error."
            }
            code: {
              type: "string"
              description: "The specific code of the error."
            }
            detail: {
              type: "string"
              description: "A human-readable description of the error for debugging purposes."
            }
            field: {
              type: "string"
              description: "The name of the field provided in the original request (if any) that\nthe error pertains to."
            }
          }
        }
      }
      evidence: {
        type: "object"
        properties: {
          dispute_id: {
            type: "string"
            description: "The ID of the dispute the evidence is associated with."
          }
          evidence_file: {
            type: "object"
            description: "A file to be uploaded as dispute evidence."
            properties: {
              filename: {
                type: "string"
                description: "The file name including the file extension. For example: \"receipt.tiff\"."
              }
              filetype: {
                type: "string"
                description: "Dispute evidence files must be application/pdf, image/heic, image/heif, image/jpeg, image/png, or image/tiff formats."
              }
            }
          }
          evidence_id: {
            type: "string"
            description: "The Square-generated ID of the evidence."
          }
          evidence_text: {
            type: "string"
            description: "Raw text"
          }
          evidence_type: {
            type: "string"
            description: "The type of the evidence."
          }
          id: {
            type: "string"
            description: "The Square-generated ID of the evidence."
          }
          uploaded_at: {
            type: "string"
            description: "The time when the next action is due, in RFC 3339 format."
          }
        }
      }
    }
  }
}