• Example searches: “transaction”, “CreateOrder”, “/v2/locations”, “inventory”, “delete customer”

Object Index

You are viewing an old version of the API
Location

Represents one of a business's locations.

Properties

Name Description
id
string

Read only A short, generated string of letters and numbers that uniquely identifies this location instance.

name
string

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

address
Address

The physical address of the location.

timezone
string

The IANA Timezone identifier for the timezone of the location. For example, "America/Los_Angeles".

capabilities
string [ ]

Read only The Square features that are enabled for the location.

status
string

The status of the location.

created_at
string

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

merchant_id
string

Read only The ID of the merchant that owns the location.

country
string

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

language_code
string

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

currency
string

Read only The currency used for all transactions at this location, in ISO 4217 format. For example, the currency code for US dollars is USD.

phone_number
string

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

business_name
string

The business name of the location, visible to the location's customers.

type
string

The type of the location.

website_url
string

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

business_hours
BusinessHours

The hours of operation for the location.

business_email
string

The email address of the location, visible to the location's customers. This can be unique to the location, and is not always the email address for the business owner or admin.

description
string

The description of the location. For example, Main Street location.

twitter_username
string

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

instagram_username
string

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

facebook_url
string

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

coordinates
Coordinates

The physical coordinates (latitude and longitude) of the location.

logo_url
string

Read only The URL of the logo image for the location. When configured in the Seller dashboard (Receipts section), the logo appears on transactions (such as receipts and invoices) that Square generates on behalf of the Seller. This image should have a roughly square (1:1) aspect ratio and is recommended to be at least 200x200 pixels.

pos_background_url
string

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

mcc
string

Beta

A four-digit number that describes the kind of goods or services sold at the location. The merchant category code (MCC) of the location is standardized by ISO 18245. For example, 5045.

full_format_logo_url
string

Read only The URL of a full-format logo image for the location. When configured in the Seller dashboard (Receipts section), the logo appears on transactions (such as receipts and invoices) that Square generates on behalf of the Seller. This image can be wider than it is tall, and is recommended to be at least 1280x648 pixels.

tax_ids
TaxIds

Beta

The Tax IDs for this location.