PUT /v2/locations/{location_id}

The ID of the location to update.

Default value: "application/json"

The merchant category code (MCC) of the location, as standardized by ISO 18245. The MCC describes the kind of goods or services sold at the location.

The description of the location.

The language associated with the location, in BCP 47 format. For more information, see Location language code.

The currency used for all transactions at this location, in ISO 4217 format. See Currency for possible values.

The URL of the logo image for the location. The Seller must choose this logo in the Seller dashboard (Receipts section) for the logo to appear on transactions (such as receipts, invoices) that Square generates on behalf of the Seller. This image should have an aspect ratio close to 1:1 and is recommended to be at least 200x200 pixels.

The Square-issued ID of the location.

The IANA Timezone identifier for the timezone of the location.

The business name of the location This is the name visible to the customers of the location. For example, this name appears on customer receipts.

Represents the hours of operation for a business location.

The list of time periods during which the business is open. There may be at most 10 periods per day.

The start time of a business hours period, specified in local time using partial-time RFC 3339 format.

The day of week for this time period.

The end time of a business hours period, specified in local time using partial-time RFC 3339 format.

The URL of the Point of Sale background image for the location.

The type of the location, either physical or mobile.

The country of the location, in ISO 3166-1-alpha-2 format.

See Country for possible values.

The URL of a full-format logo image for the location. The Seller must choose this logo in the Seller dashboard (Receipts section) for the logo to appear on transactions (such as receipts, invoices) that Square generates on behalf of the Seller. This image can have an aspect ratio of 2:1 or greater and is recommended to be at least 1280x648 pixels.

The ID of the merchant that owns the location.

Latitude and longitude coordinates.

The longitude of the coordinate expressed in degrees.

The latitude of the coordinate expressed in degrees.

The Instagram username of the location without the '@' symbol. For example, square.

The status of the location, either active or inactive.

The phone number of the location in human readable format. For example, +353 80 0 098 8099.

The name of the location. This information appears in the dashboard as the nickname. A location name must be unique within a seller account.

The email of the location. This email is visible to the customers of the location. For example, the email appears on customer receipts. For example, help@squareup.com.

The tax IDs that a Location is operating under.

The French government uses the NAF (Nomenclature des Activités Françaises) to display and track economic statistical data. This is also called the APE (Activite Principale de l’Entreprise) code. For example, 6910Z.

The EU VAT number for this location. For example, "IE3426675K". If the EU VAT number is present, it is well-formed and has been validated with VIES, the VAT Information Exchange System.

The SIRET (Système d'Identification du Répertoire des Entreprises et de leurs Etablissements) number is a 14 digits code issued by the French INSEE. For example, "39922799000021".

The time when the location was created, in RFC 3339 format. For more information, see Working with Dates.

The Facebook profile URL of the location. The URL should begin with 'facebook.com/'. For example, https://www.facebook.com/square.

The Twitter username of the location without the '@' symbol. For example, Square.

Represents a postal address in a country. The address format is based on an open-source library from Google. For more information, see AddressValidationMetadata. This format has dedicated fields for four address components: postal code, locality (city), administrative district (state, prefecture, or province), and sublocality (town or village). These components have dedicated fields in the Address object because software sometimes behaves differently based on them. For example, sales tax software may charge different amounts of sales tax based on the postal code, and some software is only available in certain states due to compliance reasons.

For the remaining address components, the Address type provides the address_line_1 and address_line_2 fields for free-form data entry. These fields are free-form because the remaining address components have too many variations around the world and typical software does not parse these components. These fields enable users to enter anything they want.

Note that, in the current implementation, all other Address type fields are blank. These include address_line_3, sublocality_2, sublocality_3, administrative_district_level_2, administrative_district_level_3, first_name, last_name, and organization.

When it comes to localization, the seller's language preferences (see Language preferences) are ignored for addresses. Even though Square products (such as Square Point of Sale and the Seller Dashboard) mostly use a seller's language preference in communication, when it comes to addresses, they will use English for a US address, Japanese for an address in Japan, and so on.

The third line of the address, if any.

Optional first name when it's representing recipient.

The address's postal code.

Optional organization name when it's representing recipient.

The second line of the address, if any.

The first line of the address.

Fields that start with address_line provide the address's most specific details, like street number, street name, and building name. They do not provide less specific details like city, state/province, or country (these details are provided in other fields).

A civil entity within the address's administrative_district_level_2, if any.

A civil region within the address's sublocality, if any.

A civil entity within the address's administrative_district_level_1. In the US, this is the county.

The city or town of the address.

A civil region within the address's locality, if any.

Optional last name when it's representing recipient.

A civil entity within the address's country. In the US, this is the state.

A civil region within the address's sublocality_2, if any.

The address's country, in ISO 3166-1-alpha-2 format.

The Square features that are enabled for the location. See LocationCapability for possible values.

The website URL of the location. For example, https://squareup.com.