action squareup_list_cards { label: "ListCards" description: "Retrieves a list of cards owned by the account making the request.\nA max of 25 cards will be returned." provider: squareup method: GET path: "/v2/cards" encoding: json input: { type: "object" properties: { cursor: { type: "string" } customer_id: { type: "string" } include_disabled: { type: "boolean" } reference_id: { type: "string" } sort_order: { type: "string" } } additionalProperties: false } output: { type: "object" description: "Defines the fields that are included in the response body of\na request to the [ListCards](#endpoint-cards-listcards) endpoint.\n\nNote: if there are errors processing the request, the card field will not be\npresent." properties: { cards: { type: "array" description: "The requested list of `Card`s." items: { 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." properties: { billing_address: { type: "object" description: "Represents a postal address in a country. The address format is based \non an [open-source library from Google](https://github.com/google/libaddressinput). For more information, \nsee [AddressValidationMetadata](https://github.com/google/libaddressinput/wiki/AddressValidationMetadata). \nThis format has dedicated fields for four address components: postal code, \nlocality (city), administrative district (state, prefecture, or province), and \nsublocality (town or village). These components have dedicated fields in the \n`Address` object because software sometimes behaves differently based on them. \nFor example, sales tax software may charge different amounts of sales tax \nbased on the postal code, and some software is only available in \ncertain states due to compliance reasons.\n\nFor the remaining address components, the `Address` type provides the \n`address_line_1` and `address_line_2` fields for free-form data entry. \nThese fields are free-form because the remaining address components have \ntoo many variations around the world and typical software does not parse \nthese components. These fields enable users to enter anything they want. \n\nNote that, in the current implementation, all other `Address` type fields are blank. \nThese include `address_line_3`, `sublocality_2`, `sublocality_3`, \n`administrative_district_level_2`, `administrative_district_level_3`, \n`first_name`, `last_name`, and `organization`. \n\nWhen it comes to localization, the seller's language preferences \n(see [Language preferences](https://developer.squareup.com/docs/locations-api#location-specific-and-seller-level-language-preferences)) \nare ignored for addresses. Even though Square products (such as Square Point of Sale \nand the Seller Dashboard) mostly use a seller's language preference in \ncommunication, when it comes to addresses, they will use English for a US address, \nJapanese for an address in Japan, and so on." properties: { address_line_1: { type: "string" 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" description: "The second line of the address, if any." } address_line_3: { type: "string" description: "The third line of the address, if any." } administrative_district_level_1: { type: "string" description: "A civil entity within the address's country. In the US, this\nis the state." } administrative_district_level_2: { type: "string" 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" description: "A civil entity within the address's `administrative_district_level_2`,\nif any." } country: { type: "string" description: "The address's country, in ISO 3166-1-alpha-2 format." } first_name: { type: "string" description: "Optional first name when it's representing recipient." } last_name: { type: "string" description: "Optional last name when it's representing recipient." } locality: { type: "string" description: "The city or town of the address." } organization: { type: "string" description: "Optional organization name when it's representing recipient." } postal_code: { type: "string" description: "The address's postal code." } sublocality: { type: "string" description: "A civil region within the address's `locality`, if any." } sublocality_2: { type: "string" description: "A civil region within the address's `sublocality`, if any." } sublocality_3: { type: "string" description: "A civil region within the address's `sublocality_2`, if any." } } } 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." } card_brand: { type: "string" description: "The card's brand." } card_type: { type: "string" description: "The type of the card.\nThe Card object includes this field only in response to Payments API calls." } cardholder_name: { type: "string" description: "The name of the cardholder." } customer_id: { type: "string" description: "The ID of a customer created using the Customers API to be associated with the card." } enabled: { type: "boolean" description: "Indicates whether or not a card can be used for payments." } exp_month: { type: "integer" format: "int64" description: "The expiration month of the associated card as an integer between 1 and 12." } exp_year: { type: "integer" format: "int64" description: "The four-digit year of the card's expiration date." } fingerprint: { type: "string" description: "__Not currently set.__ Intended as a Square-assigned identifier, based\non the card number, to identify the card across multiple locations within a\nsingle application." } id: { type: "string" description: "Unique ID for this card. Generated by Square." } last_4: { type: "string" description: "The last 4 digits of the card number." } prepaid_type: { type: "string" description: "Indicates whether the Card is prepaid or not.\nThe Card object includes this field only in response to Payments API calls." } reference_id: { type: "string" 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." } version: { type: "integer" format: "int64" 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." } } } } cursor: { type: "string" description: "The pagination cursor to be used in a subsequent request. If empty,\nthis is the final response.\n\nSee [Pagination](https://developer.squareup.com/docs/basics/api101/pagination) for more information." } 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." } } } } } } }