action squareup_retrieve_merchant {
  label: "RetrieveMerchant"
  description: "Retrieve a `Merchant` object for the given `merchant_id`."
  provider: squareup
  method: GET
  path: "/v2/merchants/{merchant_id}"
  encoding: json
  input: {
    type: "object"
    properties: {
      merchant_id: {
        type: "string"
      }
    }
    required: ["merchant_id"]
    additionalProperties: false
  }
  output: {
    type: "object"
    description: "The response object returned by the [RetrieveMerchant](https://developer.squareup.com/reference/square_2021-08-18/merchants-api/retrieve-merchant) endpoint."
    properties: {
      errors: {
        type: "array"
        description: "Information on errors encountered 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."
            }
          }
        }
      }
      merchant: {
        type: "object"
        description: "Represents a Square seller."
        required: ["country"]
        properties: {
          business_name: {
            type: "string"
            description: "The business name of the merchant."
          }
          country: {
            type: "string"
            description: "The country code associated with the merchant account, in ISO 3166 format."
          }
          currency: {
            type: "string"
            description: "The currency associated with the merchant account, in ISO 4217 format."
          }
          id: {
            type: "string"
            description: "The Square-issued ID of the merchant."
          }
          language_code: {
            type: "string"
            description: "The language code associated with the merchant account, in BCP 47 format."
          }
          main_location_id: {
            type: "string"
            description: "The ID of the main `Location` for this merchant."
          }
          status: {
            type: "string"
            description: "The merchant status, active or inactive."
          }
        }
      }
    }
  }
}