Square · Schema

GetPaymentRefundResponse

Defines the response returned by [GetRefund](api-endpoint:Refunds-GetPaymentRefund). Note: If there are errors processing the request, the refund field might not be present or it might be present in a FAILED state.

BookingLocationSquareRestaurantCatalogCheckoutCustomersDisputesE-CommerceFinancial TechnologyGift CardsInventoryInvoicingLaborLoyaltyMerchantsOrderPaymentsPoint-of-SaleRefundsRetailSubscriptionTeamWebhookPayment ProcessingPayment Terminals

Properties

Name Type Description
errors array Information about errors encountered during the request.
refund object The requested `PaymentRefund`.
View JSON Schema on GitHub

JSON Schema

square-get-payment-refund-response-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/square/main/json-schema/square-get-payment-refund-response-schema.json",
  "title": "GetPaymentRefundResponse",
  "description": "Defines the response returned by [GetRefund](api-endpoint:Refunds-GetPaymentRefund).\n\nNote: If there are errors processing the request, the refund field might not be\npresent or it might be present in a FAILED state.",
  "x-generated": "2026-10-12",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/square-refunds-api-openapi.yml#/components/schemas/GetPaymentRefundResponse",
  "type": "object",
  "x-release-status": "PUBLIC",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/Error"
      },
      "description": "Information about errors encountered during the request."
    },
    "refund": {
      "$ref": "#/$defs/PaymentRefund",
      "description": "The requested `PaymentRefund`."
    }
  },
  "$defs": {
    "Address": {
      "type": "object",
      "description": "Represents a postal address in a country. \nFor more information, see [Working with Addresses](https://developer.squareup.com/docs/build-basics/working-with-addresses).",
      "x-release-status": "PUBLIC",
      "properties": {
        "address_line_1": {
          "type": [
            "string",
            "null"
          ],
          "description": "The first line of the address.\n\nFields that start with `address_line` provide the address's most specific\ndetails, like street number, street name, and building name. They do *not*\nprovide less specific details like city, state/province, or country (these\ndetails are provided in other fields)."
        },
        "address_line_2": {
          "type": [
            "string",
            "null"
          ],
          "description": "The second line of the address, if any."
        },
        "address_line_3": {
          "type": [
            "string",
            "null"
          ],
          "description": "The third line of the address, if any."
        },
        "locality": {
          "type": [
            "string",
            "null"
          ],
          "description": "The city or town of the address. For a full list of field meanings by country, see [Working with Addresses](https://developer.squareup.com/docs/build-basics/working-with-addresses)."
        },
        "sublocality": {
          "type": [
            "string",
            "null"
          ],
          "description": "A civil region within the address's `locality`, if any."
        },
        "sublocality_2": {
          "type": [
            "string",
            "null"
          ],
          "description": "A civil region within the address's `sublocality`, if any."
        },
        "sublocality_3": {
          "type": [
            "string",
            "null"
          ],
          "description": "A civil region within the address's `sublocality_2`, if any."
        },
        "administrative_district_level_1": {
          "type": [
            "string",
            "null"
          ],
          "description": "A civil entity within the address's country. In the US, this\nis the state. For a full list of field meanings by country, see [Working with Addresses](https://developer.squareup.com/docs/build-basics/working-with-addresses)."
        },
        "administrative_district_level_2": {
          "type": [
            "string",
            "null"
          ],
          "description": "A civil entity within the address's `administrative_district_level_1`.\nIn the US, this is the county."
        },
        "administrative_district_level_3": {
          "type": [
            "string",
            "null"
          ],
          "description": "A civil entity within the address's `administrative_district_level_2`,\nif any."
        },
        "postal_code": {
          "type": [
            "string",
            "null"
          ],
          "description": "The address's postal code. For a full list of field meanings by country, see [Working with Addresses](https://developer.squareup.com/docs/build-basics/working-with-addresses)."
        },
        "country": {
          "$ref": "#/$defs/Country",
          "description": "The address's country, in the two-letter format of ISO 3166. For example, `US` or `FR`.\nSee [Country](#type-country) for possible values"
        },
        "first_name": {
          "type": [
            "string",
            "null"
          ],
          "description": "Optional first name when it's representing recipient."
        },
        "last_name": {
          "type": [
            "string",
            "null"
          ],
          "description": "Optional last name when it's representing recipient."
        }
      }
    },
    "Card": {
      "type": "object",
      "description": "Represents the payment details of a card to be used for payments. These\ndetails are determined by the payment token generated by Web Payments SDK.",
      "x-release-status": "PUBLIC",
      "properties": {
        "id": {
          "type": "string",
          "description": "Unique ID for this card. Generated by Square.",
          "maxLength": 64,
          "readOnly": true
        },
        "card_brand": {
          "$ref": "#/$defs/CardBrand",
          "description": "The card's brand.\nSee [CardBrand](#type-cardbrand) for possible values",
          "readOnly": true
        },
        "last_4": {
          "type": "string",
          "description": "The last 4 digits of the card number.",
          "maxLength": 4,
          "readOnly": true
        },
        "exp_month": {
          "type": [
            "integer",
            "null"
          ],
          "description": "The expiration month of the associated card as an integer between 1 and 12.",
          "format": "int64"
        },
        "exp_year": {
          "type": [
            "integer",
            "null"
          ],
          "description": "The four-digit year of the card's expiration date.",
          "format": "int64"
        },
        "cardholder_name": {
          "type": [
            "string",
            "null"
          ],
          "description": "The name of the cardholder.",
          "maxLength": 96
        },
        "billing_address": {
          "$ref": "#/$defs/Address",
          "description": "The billing address for this card."
        },
        "fingerprint": {
          "type": "string",
          "description": "Intended as a Square-assigned identifier, based\non the card number, to identify the card across multiple locations within a\nsingle application.",
          "maxLength": 255,
          "readOnly": true
        },
        "customer_id": {
          "type": [
            "string",
            "null"
          ],
          "description": "**Required** The ID of a customer created using the Customers API to be associated with the card."
        },
        "merchant_id": {
          "type": "string",
          "description": "The ID of the merchant associated with the card.",
          "readOnly": true
        },
        "reference_id": {
          "type": [
            "string",
            "null"
          ],
          "description": "An optional user-defined reference ID that associates this card with\nanother entity in an external system. For example, a customer ID from an\nexternal customer management system.",
          "maxLength": 128
        },
        "enabled": {
          "type": "boolean",
          "description": "Indicates whether or not a card can be used for payments.",
          "readOnly": true
        },
        "card_type": {
          "$ref": "#/$defs/CardType",
          "description": "The type of the card.\nThe Card object includes this field only in response to Payments API calls.\nSee [CardType](#type-cardtype) for possible values",
          "readOnly": true
        },
        "prepaid_type": {
          "$ref": "#/$defs/CardPrepaidType",
          "description": "Indicates whether the Card is prepaid or not.\nThe Card object includes this field only in response to Payments API calls.\nSee [CardPrepaidType](#type-cardprepaidtype) for possible values",
          "readOnly": true
        },
        "bin": {
          "type": "string",
          "description": "The first six digits of the card number, known as the Bank Identification Number (BIN). Only the Payments API\nreturns this field.",
          "maxLength": 6,
          "readOnly": true
        },
        "version": {
          "type": "integer",
          "description": "Current version number of the card. Increments with each card update. Requests to update an\nexisting Card object will be rejected unless the version in the request matches the current\nversion for the Card.",
          "format": "int64"
        },
        "card_co_brand": {
          "$ref": "#/$defs/CardCoBrand",
          "description": "The card's co-brand if available. For example, an Afterpay virtual card would have a\nco-brand of AFTERPAY.\nSee [CardCoBrand](#type-cardcobrand) for possible values",
          "readOnly": true
        }
      }
    },
    "CardBrand": {
      "type": "string",
      "enum": [
        "OTHER_BRAND",
        "VISA",
        "MASTERCARD",
        "AMERICAN_EXPRESS",
        "DISCOVER",
        "DISCOVER_DINERS",
        "JCB",
        "CHINA_UNIONPAY",
        "SQUARE_GIFT_CARD",
        "SQUARE_CAPITAL_CARD",
        "INTERAC",
        "EFTPOS",
        "FELICA",
        "EBT"
      ],
      "x-enum-elements": [
        {
          "name": "OTHER_BRAND",
          "description": ""
        },
        {
          "name": "VISA",
          "description": ""
        },
        {
          "name": "MASTERCARD",
          "description": ""
        },
        {
          "name": "AMERICAN_EXPRESS",
          "description": ""
        },
        {
          "name": "DISCOVER",
          "description": ""
        },
        {
          "name": "DISCOVER_DINERS",
          "description": ""
        },
        {
          "name": "JCB",
          "description": ""
        },
        {
          "name": "CHINA_UNIONPAY",
          "description": ""
        },
        {
          "name": "SQUARE_GIFT_CARD",
          "description": ""
        },
        {
          "name": "SQUARE_CAPITAL_CARD",
          "description": ""
        },
        {
          "name": "INTERAC",
          "description": ""
        },
        {
          "name": "EFTPOS",
          "description": ""
        },
        {
          "name": "FELICA",
          "description": ""
        },
        {
          "name": "EBT",
          "description": ""
        }
      ],
      "description": "Indicates a card's brand, such as `VISA` or `MASTERCARD`.",
      "x-release-status": "PUBLIC"
    },
    "CardCoBrand": {
      "type": "string",
      "enum": [
        "UNKNOWN",
        "AFTERPAY",
        "CLEARPAY"
      ],
      "x-enum-elements": [
        {
          "name": "UNKNOWN",
          "description": ""
        },
        {
          "name": "AFTERPAY",
          "description": ""
        },
        {
          "name": "CLEARPAY",
          "description": ""
        }
      ],
      "description": "Indicates the brand for a co-branded card.",
      "x-release-status": "PUBLIC"
    },
    "CardPrepaidType": {
      "type": "string",
      "enum": [
        "UNKNOWN_PREPAID_TYPE",
        "NOT_PREPAID",
        "PREPAID"
      ],
      "x-enum-elements": [
        {
          "name": "UNKNOWN_PREPAID_TYPE",
          "description": ""
        },
        {
          "name": "NOT_PREPAID",
          "description": ""
        },
        {
          "name": "PREPAID",
          "description": ""
        }
      ],
      "description": "Indicates a card's prepaid type, such as `NOT_PREPAID` or `PREPAID`.",
      "x-release-status": "PUBLIC"
    },
    "CardType": {
      "type": "string",
      "enum": [
        "UNKNOWN_CARD_TYPE",
        "CREDIT",
        "DEBIT"
      ],
      "x-enum-elements": [
        {
          "name": "UNKNOWN_CARD_TYPE",
          "description": ""
        },
        {
          "name": "CREDIT",
          "description": ""
        },
        {
          "name": "DEBIT",
          "description": ""
        }
      ],
      "description": "Indicates a card's type, such as `CREDIT` or `DEBIT`.",
      "x-release-status": "PUBLIC"
    },
    "Country": {
      "type": "string",
      "enum": [
        "ZZ",
        "AD",
        "AE",
        "AF",
        "AG",
        "AI",
        "AL",
        "AM",
        "AO",
        "AQ",
        "AR",
        "AS",
        "AT",
        "AU",
        "AW",
        "AX",
        "AZ",
        "BA",
        "BB",
        "BD",
        "BE",
        "BF",
        "BG",
        "BH",
        "BI",
        "BJ",
        "BL",
        "BM",
        "BN",
        "BO",
        "BQ",
        "BR",
        "BS",
        "BT",
        "BV",
        "BW",
        "BY",
        "BZ",
        "CA",
        "CC",
        "CD",
        "CF",
        "CG",
        "CH",
        "CI",
        "CK",
        "CL",
        "CM",
        "CN",
        "CO",
        "CR",
        "CU",
        "CV",
        "CW",
        "CX",
        "CY",
        "CZ",
        "DE",
        "DJ",
        "DK",
        "DM",
        "DO",
        "DZ",
        "EC",
        "EE",
        "EG",
        "EH",
        "ER",
        "ES",
        "ET",
        "FI",
        "FJ",
        "FK",
        "FM",
        "FO",
        "FR",
        "GA",
        "GB",
        "GD",
        "GE",
        "GF",
        "GG",
        "GH",
        "GI",
        "GL",
        "GM",
        "GN",
        "GP",
        "GQ",
        "GR",
        "GS",
        "GT",
        "GU",
        "GW",
        "GY",
        "HK",
        "HM",
        "HN",
        "HR",
        "HT",
        "HU",
        "ID",
        "IE",
        "IL",
        "IM",
        "IN",
        "IO",
        "IQ",
        "IR",
        "IS",
        "IT",
        "JE",
        "JM",
        "JO",
        "JP",
        "KE",
        "KG",
        "KH",
        "KI",
        "KM",
        "KN",
        "KP",
        "KR",
        "KW",
        "KY",
        "KZ",
        "LA",
        "LB",
        "LC",
        "LI",
        "LK",
        "LR",
        "LS",
        "LT",
        "LU",
        "LV",
        "LY",
        "MA",
        "MC",
        "MD",
        "ME",
        "MF",
        "MG",
        "MH",
        "MK",
        "ML",
        "MM",
        "MN",
        "MO",
        "MP",
        "MQ",
        "MR",
        "MS",
        "MT",
        "MU",
        "MV",
        "MW",
        "MX",
        "MY",
        "MZ",
        "NA",
        "NC",
        "NE",
        "NF",
        "NG",
        "NI",
        "NL",
        "NO",
        "NP",
        "NR",
        "NU",
        "NZ",
        "OM",
        "PA",
        "PE",
        "PF",
        "PG",
        "PH",
        "PK",
        "PL",
        "PM",
        "PN",
        "PR",
        "PS",
        "PT",
        "PW",
        "PY",
        "QA",
        "RE",
        "RO",
        "RS",
        "RU",
        "RW",
        "SA",
        "SB",
        "SC",
        "SD",
        "SE",
        "SG",
        "SH",
        "SI",
        "SJ",
        "SK",
        "SL",
        "SM",
        "SN",
        "SO",
        "SR",
        "SS",
        "ST",
        "SV",
        "SX",
        "SY",
        "SZ",
        "TC",
        "TD",
        "TF",
        "TG",
        "TH",
        "TJ",
        "TK",
        "TL",
        "TM",
        "TN",
        "TO",
        "TR",
        "TT",
        "TV",
        "TW",
        "TZ",
        "UA",
        "UG",
        "UM",
        "US",
        "UY",
        "UZ",
        "VA",
        "VC",
        "VE",
        "VG",
        "VI",
        "VN",
        "VU",
        "WF",
        "WS",
        "YE",
        "YT",
        "ZA",
        "ZM",
        "ZW"
      ],
      "x-enum-elements": [
        {
          "name": "ZZ",
          "description": "Unknown"
        },
        {
          "name": "AD",
          "description": "Andorra"
        },
        {
          "name": "AE",
          "description": "United Arab Emirates"
        },
        {
          "name": "AF",
          "description": "Afghanistan"
        },
        {
          "name": "AG",
          "description": "Antigua and Barbuda"
        },
        {
          "name": "AI",
          "description": "Anguilla"
        },
        {
          "name": "AL",
          "description": "Albania"
        },
        {
          "name": "AM",
          "description": "Armenia"
        },
        {
          "name": "AO",
          "description": "Angola"
        },
        {
          "name": "AQ",
          "description": "Antartica"
        },
        {
          "name": "AR",
          "description": "Argentina"
        },
        {
          "name": "AS",
          "description": "American Samoa"
        },
        {
          "name": "AT",
          "description": "Austria"
        },
        {
          "name": "AU",
          "description": "Australia"
        },
        {
          "name": "AW",
          "description": "Aruba"
        },
        {
          "name": "AX",
          "description": "Åland Islands"
        },
        {
          "name": "AZ",
          "description": "Azerbaijan"
        },
        {
          "name": "BA",
          "description": "Bosnia and Herzegovina"
        },
        {
          "name": "BB",
          "description": "Barbados"
        },
        {
          "name": "BD",
          "description": "Bangladesh"
        },
        {
          "name": "BE",
          "description": "Belgium"
        },
        {
          "name": "BF",
          "description": "Burkina Faso"
        },
        {
          "name": "BG",
          "description": "Bulgaria"
        },
        {
          "name": "BH",
          "description": "Bahrain"
        },
        {
          "name": "BI",
          "description": "Burundi"
        },
        {
          "name": "BJ",
          "description": "Benin"
        },
        {
          "name": "BL",
          "description": "Saint Barthélemy"
        },
        {
          "name": "BM",
          "description": "Bermuda"
        },
        {
          "name": "BN",
          "description": "Brunei"
        },
        {
          "name": "BO",
          "description": "Bolivia"
        },
        {
          "name": "BQ",
          "description": "Bonaire"
        },
        {
          "name": "BR",
          "description": "Brazil"
        },
        {
          "name": "BS",
          "description": "Bahamas"
        },
        {
          "name": "BT",
          "description": "Bhutan"
        },
        {
          "name": "BV",
          "description": "Bouvet Island"
        },
        {
          "name": "BW",
          "description": "Botswana"
        },
        {
          "name": "BY",
          "description": "Belarus"
        },
        {
          "name": "BZ",
          "description": "Belize"
        },
        {
          "name": "CA",
          "description": "Canada"
        },
        {
          "name": "CC",
          "description": "Cocos Islands"
        },
        {
          "name": "CD",
          "description": "Democratic Republic of the Congo"
        },
        {
          "name": "CF",
          "description": "Central African Republic"
        },
        {
          "name": "CG",
          "description": "Congo"
        },
        {
          "name": "CH",
          "description": "Switzerland"
        },
        {
          "name": "CI",
          "description": "Ivory Coast"
        },
        {
          "name": "CK",
          "description": "Cook Islands"
        },
        {
          "name": "CL",
          "description": "Chile"
        },
        {
          "name": "CM",
          "description": "Cameroon"
        },
        {
          "name": "CN",
          "description": "China"
        },
        {
          "name": "CO",
          "description": "Colombia"
        },
        {
          "name": "CR",
          "description": "Costa Rica"
        },
        {
          "name": "CU",
          "description": "Cuba"
        },
        {
          "name": "CV",
          "description": "Cabo Verde"
        },
        {
          "name": "CW",
          "description": "Curaçao"
        },
        {
          "name": "CX",
          "description": "Christmas Island"
        },
        {
          "name": "CY",
          "description": "Cyprus"
        },
        {
          "name": "CZ",
          "description": "Czechia"
        },
        {
          "name": "DE",
          "description": "Germany"
        },
        {
          "name": "DJ",
          "description": "Djibouti"
        },
        {
          "name": "DK",
          "description": "Denmark"
        },
        {
          "name": "DM",
          "description": "Dominica"
        },
        {
          "name": "DO",
          "description": "Dominican Republic"
        },
        {
          "name": "DZ",
          "description": "Algeria"
        },
        {
          "name": "EC",
          "description": "Ecuador"
        },
        {
          "name": "EE",
          "description": "Estonia"
        },
        {
          "name": "EG",
          "description": "Egypt"
        },
        {
          "name": "EH",
          "description": "Western Sahara"
        },
        {
          "name": "ER",
          "description": "Eritrea"
        },
        {
          "name": "ES",
          "description": "Spain"
        },
        {
          "name": "ET",
          "description": "Ethiopia"
        },
        {
          "name": "FI",
          "description": "Finland"
        },
        {
          "name": "FJ",
          "description": "Fiji"
        },
        {
          "name": "FK",
          "description": "Falkland Islands"
        },
        {
          "name": "FM",
          "description": "Federated States of Micronesia"
        },
        {
          "name": "FO",
          "description": "Faroe Islands"
        },
        {
          "name": "FR",
          "description": "France"
        },
        {
          "name": "GA",
          "description": "Gabon"
        },
        {
          "name": "GB",
          "description": "United Kingdom"
        },
        {
          "name": "GD",
          "description": "Grenada"
        },
        {
          "name": "GE",
          "description": "Georgia"
        },
        {
          "name": "GF",
          "description": "French Guiana"
        },
        {
          "name": "GG",
          "description": "Guernsey"
        },
        {
          "name": "GH",
          "description": "Ghana"
        },
        {
          "name": "GI",
          "description": "Gibraltar"
        },
        {
          "name": "GL",
          "description": "Greenland"
        },
        {
          "name": "GM",
          "description": "Gambia"
        },
        {
          "name": "GN",
          "description": "Guinea"
        },
        {
          "name": "GP",
          "description": "Guadeloupe"
        },
        {
          "name": "GQ",
          "description": "Equatorial Guinea"
        },
        {
          "name": "GR",
          "description": "Greece"
        },
        {
          "name": "GS",
          "description": "South Georgia and the South Sandwich Islands"
        },
        {
          "name": "GT",
          "description": "Guatemala"
        },
        {
          "name": "GU",
          "description": "Guam"
        },
        {
          "name": "GW",
          "description": "Guinea-Bissau"
        },
        {
          "name": "GY",
          "description": "Guyana"
        },
        {
          "name": "HK",
          "description": "Hong Kong"
        },
        {
          "name": "HM",
          "description": "Heard Island and McDonald Islands"
        },
        {
          "name": "HN",
          "description": "Honduras"
        },
        {
          "name": "HR",
          "description": "Croatia"
        },
        {
          "name": "HT",
          "description": "Haiti"
        },
        {
          "name": "HU",
          "description": "Hungary"
        },
        {
          "name": "ID",
          "description": "Indonesia"
        },
        {
          "name": "IE",
          "description": "Ireland"
        },
        {
          "name": "IL",
          "description": "Israel"
        },
        {
          "name": "IM",
          "description": "Isle of Man"
        },
        {
          "name": "IN",
          "description": "India"
        },
        {
          "name": "IO",
          "description": "British Indian Ocean Territory"
        },
        {
          "name": "IQ",
          "description": "Iraq"
        },
        {
          "name": "IR",
          "description": "Iran"
        },
        {
          "name": "IS",
          "description": "Iceland"
        },
        {
          "name": "IT",
          "description": "Italy"
        },
        {
          "name": "JE",
          "description": "Jersey"
        },
        {
          "name": "JM",
          "description": "Jamaica"
        },
        {
          "name": "JO",
          "description": "Jordan"
        },
        {
          "name": "JP",
          "description": "Japan"
        },
        {
          "name": "KE",
          "description": "Kenya"
        },
        {
          "name": "KG",
          "description": "Kyrgyzstan"
        },
        {
          "name": "KH",
          "description": "Cambodia"
        },
        {
          "name": "KI",
          "description": "Kiribati"
        },
        {
          "name": "KM",
          "description": "Comoros"
        },
        {
          "name": "KN",
          "description": "Saint Kitts and Nevis"
        },
        {
          "name": "KP",
          "description": "Democratic People's Republic of Korea"
        },
        {
          "name": "KR",
          "description": "Republic of Korea"
        },
        {
          "name": "KW",
          "description": "Kuwait"
        },
        {
          "name": "KY",
          "description": "Cayman Islands"
        },
        {
          "name": "KZ",
          "description": "Kazakhstan"
        },
        {
          "name": "LA",
          "description": "Lao People's Democratic Republic"
        },
        {
          "name": "LB",
          "description": "Lebanon"
        },
        {
          "name": "LC",
          "description": "Saint Lucia"
        },
        {
          "name": "LI",
          "description": "Liechtenstein"
        },
        {
          "name": "LK",
          "description": "Sri Lanka"
        },
        {
          "name": "LR",
          "description": "Liberia"
        },
        {
          "name": "LS",
          "description": "Lesotho"
        },
        {
          "name": "LT",
          "description": "Lithuania"
        },
        {
          "name": "LU",
          "description": "Luxembourg"
        },
        {
          "name": "LV",
          "description": "Latvia"
        },
        {
          "name": "LY",
          "description": "Libya"
        },
        {
          "name": "MA",
          "description": "Morocco"
        },
        {
          "name": "MC",
          "description": "Monaco"
        },
        {
          "name": "MD",
          "description": "Moldova"
        },
        {
          "name": "ME",
          "description": "Montenegro"
        },
        {
          "name": "MF",
          "description": "Saint Martin"
        },
        {
          "name": "MG",
          "description": "Madagascar"
        },
        {
          "name": "MH",
          "description": "Marshall Islands"
        },
        {
          "name": "MK",
          "description": "North Macedonia"
        },
        {
          "name": "ML",
          "description": "Mali"
        },
        {
          "name": "MM",
          "description": "Myanmar"
        },
        {
          "name": "MN",
          "description": "Mongolia"
        },
        {
          "name": "MO",
          "description": "Macao"
        },
        {
          "name": "MP",
          "description": "Northern Mariana Islands"
        },
        {
          "name": "MQ",
          "description": "Martinique"
        },
        {
          "name": "MR",
          "description": "Mauritania"
        },
        {
          "name": "MS",
          "description": "Montserrat"
        },
        {
          "name": "MT",
          "description": "Malta"
        },
        {
          "name": "MU",
          "description": "Mauritius"
        },
        {
          "name": "MV",
          "description": "Maldives"
        },
        {
          "name": "MW",
          "description": "Malawi"
        },
        {
          "name": "MX",
          "description": "Mexico"
        },
        {
          "name": "MY",
          "description": "Malaysia"
        },
        {
          "name": "MZ",
          "description": "Mozambique"
        },
        {
          "name": "NA",
          "description": "Namibia"
        },
        {
          "name": "NC",
          "description": "New Caledonia"
        },
        {
          "name": "NE",
          "description": "Niger"
        },
        {
          "name": "NF",
          "description": "Norfolk Island"
        },
        {
          "name": "NG",
          "description": "Nigeria"
        },
        {
          "name": "NI",
          "description": "Nicaragua"
        },
        {
          "name": "NL",
          "description": "Netherlands"
        },
        {
          "name": "NO",
          "description": "Norway"
        },
        {
          "name": "NP",
          "description": "Nepal"
        },
        {
          "name": "NR",
          "description": "Nauru"
        },
        {
          "name": "NU",
          "description": "Niue"
        },
        {
          "name": "NZ",
          "description": "New Zealand"
        },
        {
          "name": "OM",
          "description": "Oman"
        },
        {
          "name": "PA",
          "description": "Panama"
        },
        {
          "name": "PE",
          "description": "Peru"
        },
        {
          "name": "PF",
          "description": "French Polynesia"
        },
        {
          "name": "PG",
          "description": "Papua New Guinea"
        },
        {
          "name": "PH",
          "description": "Philippines"
        },
        {
          "name": "PK",
          "description": "Pakistan"
        },
        {
          "name": "PL",
          "description": "Poland"
        },
        {
          "name": "PM",
          "description": "Saint Pierre and Miquelon"
        },
        {
          "name": "PN",
          "description": "Pitcairn"
        },
        {
          "name": "PR",
          "description": "Puerto Rico"
        },
        {
          "name": "PS",
          "description": "Palestine"
        },
        {
          "name": "PT",
          "description": "Portugal"
        },
        {
          "name": "PW",
          "description": "Palau"
        },
        {
          "name": "PY",
          "description": "Paraguay"
        },
        {
          "name": "QA",
          "description": "Qatar"
        },
        {
          "name": "RE",
          "description": "Réunion"
        },
        {
          "name": "RO",
          "description": "Romania"
        },
        {
          "name": "RS",
          "description": "Serbia"
        },
        {
          "name": "RU",
          "description": "Russia"
        },
        {
          "name": "RW",
          "description": "Rwanda"
        },
        {
          "name": "SA",
          "description": "Saudi Arabia"
        },
        {
          "name": "SB",
          "description": "Solomon Islands"
        },
        {
          "name": "SC",
          "description": "Seychelles"
        },
        {
          "name": "SD",
          "description": "Sudan"
        },
        {
          "name": "SE",
          "description": "Sweden"
        },
        {
          "name": "SG",
          "description": "Singapore"
        },
        {
          "name": "SH",
          "description": "Saint Helena, Ascension and Tristan da Cunha"
        },
        {
          "name": "SI",
          "description": "Slovenia"
        },
        {
          "name": "SJ",
  

# --- truncated at 32 KB (105 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/square/refs/heads/main/json-schema/square-get-payment-refund-response-schema.json

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/square-get-payment-refund-response"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.