Square · Schema
CreateCheckoutRequest
Defines the parameters that can be included in the body of a request to the `CreateCheckout` endpoint.
BookingLocationSquareRestaurantCatalogCheckoutCustomersDisputesE-CommerceFinancial TechnologyGift CardsInventoryInvoicingLaborLoyaltyMerchantsOrderPaymentsPoint-of-SaleRefundsRetailSubscriptionTeamWebhookPayment ProcessingPayment Terminals
Properties
| Name | Type | Description |
|---|---|---|
| idempotency_key | string | A unique string that identifies this checkout among others you have created. It can be any valid string but must be unique for every order sent to Square Checkout for a given location ID. The idempote |
| order | object | The order including line items to be checked out. |
| ask_for_shipping_address | boolean | If `true`, Square Checkout collects shipping information on your behalf and stores that information with the transaction information in the Square Seller Dashboard. Default: `false`. |
| merchant_support_email | string | The email address to display on the Square Checkout confirmation page and confirmation email that the buyer can use to contact the seller. If this value is not set, the confirmation page and email dis |
| pre_populate_buyer_email | string | If provided, the buyer's email is prepopulated on the checkout page as an editable text field. Default: none; only exists if explicitly set. |
| pre_populate_shipping_address | object | If provided, the buyer's shipping information is prepopulated on the checkout page as editable text fields. Default: none; only exists if explicitly set. |
| redirect_url | string | The URL to redirect to after the checkout is completed with `checkoutId`, `transactionId`, and `referenceId` appended as URL parameters. For example, if the provided redirect URL is `http://www.exampl |
| additional_recipients | array | The basic primitive of a multi-party transaction. The value is optional. The transaction facilitated by you can be split from here. If you provide this value, the `amount_money` value in your `additio |
| note | string | An optional note to associate with the `checkout` object. This value cannot exceed 60 characters. |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://raw.githubusercontent.com/api-evangelist/square/main/json-schema/square-create-checkout-request-schema.json",
"title": "CreateCheckoutRequest",
"description": "Defines the parameters that can be included in the body of\na request to the `CreateCheckout` endpoint.",
"x-generated": "2026-10-12",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/square-checkout-api-openapi.yml#/components/schemas/CreateCheckoutRequest",
"type": "object",
"x-release-status": "PUBLIC",
"required": [
"idempotency_key",
"order"
],
"properties": {
"idempotency_key": {
"type": "string",
"description": "A unique string that identifies this checkout among others you have created. It can be\nany valid string but must be unique for every order sent to Square Checkout for a given location ID.\n\nThe idempotency key is used to avoid processing the same order more than once. If you are \nunsure whether a particular checkout was created successfully, you can attempt it again with\nthe same idempotency key and all the same other parameters without worrying about creating duplicates.\n\nYou should use a random number/string generator native to the language\nyou are working in to generate strings for your idempotency keys.\n\nFor more information, see [Idempotency](https://developer.squareup.com/docs/working-with-apis/idempotency).",
"minLength": 1,
"maxLength": 192
},
"order": {
"$ref": "#/$defs/CreateOrderRequest",
"description": "The order including line items to be checked out."
},
"ask_for_shipping_address": {
"type": "boolean",
"description": "If `true`, Square Checkout collects shipping information on your behalf and stores \nthat information with the transaction information in the Square Seller Dashboard.\n\nDefault: `false`."
},
"merchant_support_email": {
"type": "string",
"description": "The email address to display on the Square Checkout confirmation page\nand confirmation email that the buyer can use to contact the seller.\n\nIf this value is not set, the confirmation page and email display the\nprimary email address associated with the seller's Square account.\n\nDefault: none; only exists if explicitly set.",
"maxLength": 254
},
"pre_populate_buyer_email": {
"type": "string",
"description": "If provided, the buyer's email is prepopulated on the checkout page\nas an editable text field.\n\nDefault: none; only exists if explicitly set.",
"maxLength": 254
},
"pre_populate_shipping_address": {
"$ref": "#/$defs/Address",
"description": "If provided, the buyer's shipping information is prepopulated on the\ncheckout page as editable text fields.\n\nDefault: none; only exists if explicitly set."
},
"redirect_url": {
"type": "string",
"description": "The URL to redirect to after the checkout is completed with `checkoutId`,\n`transactionId`, and `referenceId` appended as URL parameters. For example,\nif the provided redirect URL is `http://www.example.com/order-complete`, a\nsuccessful transaction redirects the customer to:\n\n`http://www.example.com/order-complete?checkoutId=xxxxxx&referenceId=xxxxxx&transactionId=xxxxxx`\n\nIf you do not provide a redirect URL, Square Checkout displays an order\nconfirmation page on your behalf; however, it is strongly recommended that\nyou provide a redirect URL so you can verify the transaction results and\nfinalize the order through your existing/normal confirmation workflow.\n\nDefault: none; only exists if explicitly set.",
"maxLength": 800
},
"additional_recipients": {
"type": "array",
"items": {
"$ref": "#/$defs/ChargeRequestAdditionalRecipient"
},
"description": "The basic primitive of a multi-party transaction. The value is optional.\nThe transaction facilitated by you can be split from here.\n\nIf you provide this value, the `amount_money` value in your `additional_recipients` field\ncannot be more than 90% of the `total_money` calculated by Square for your order.\nThe `location_id` must be a valid seller location where the checkout is occurring.\n\nThis field requires `PAYMENTS_WRITE_ADDITIONAL_RECIPIENTS` OAuth permission.\n\nThis field is currently not supported in the Square Sandbox."
},
"note": {
"type": "string",
"description": "An optional note to associate with the `checkout` object.\n\nThis value cannot exceed 60 characters.",
"maxLength": 60
}
},
"x-sq-sdk-sample-code": {
"csharp": "/sdk_samples/CreateCheckout/CreateCheckoutRequest.csharp",
"java": "/sdk_samples/CreateCheckout/CreateCheckoutRequest.java",
"javascript": "/sdk_samples/CreateCheckout/CreateCheckoutRequest.javascript",
"php": "/sdk_samples/CreateCheckout/CreateCheckoutRequest.php",
"python": "/sdk_samples/CreateCheckout/CreateCheckoutRequest.python",
"ruby": "/sdk_samples/CreateCheckout/CreateCheckoutRequest.ruby"
},
"$defs": {
"AdditionalRecipient": {
"type": "object",
"description": "Represents an additional recipient (other than the merchant) receiving a portion of this tender.",
"x-release-status": "DEPRECATED",
"required": [
"location_id",
"amount_money"
],
"properties": {
"location_id": {
"type": "string",
"description": "The location ID for a recipient (other than the merchant) receiving a portion of this tender.",
"minLength": 1,
"maxLength": 50
},
"description": {
"type": [
"string",
"null"
],
"description": "The description of the additional recipient.",
"maxLength": 100
},
"amount_money": {
"$ref": "#/$defs/Money",
"description": "The amount of money distributed to the recipient."
},
"receivable_id": {
"type": [
"string",
"null"
],
"description": "The unique ID for the RETIRED `AdditionalRecipientReceivable` object. This field should be empty for any `AdditionalRecipient` objects created after the retirement.",
"maxLength": 192
}
}
},
"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"
},
"ChargeRequestAdditionalRecipient": {
"type": "object",
"description": "Represents an additional recipient (other than the merchant) entitled to a portion of the tender.\nSupport is currently limited to USD, CAD and GBP currencies",
"x-release-status": "DEPRECATED",
"required": [
"location_id",
"description",
"amount_money"
],
"properties": {
"location_id": {
"type": "string",
"description": "The location ID for a recipient (other than the merchant) receiving a portion of the tender.",
"minLength": 1,
"maxLength": 50
},
"description": {
"type": "string",
"description": "The description of the additional recipient.",
"minLength": 1,
"maxLength": 100
},
"amount_money": {
"$ref": "#/$defs/Money",
"description": "The amount of money distributed to the recipient."
}
}
},
"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"
# --- truncated at 32 KB (209 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/square/refs/heads/main/json-schema/square-create-checkout-request-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.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/square-create-checkout-request"
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.