Object Index / Definition

You are viewing an old version of the API
Location

Properties

Name Description
id
string

The Square-issued ID of the location.

name
string

The name of the location. This information appears in the dashboard as the nickname.

address
Address

The physical address of the location.

timezone
string

The IANA Timezone identifier for the timezone of the location.

capabilities
string [ ]

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

status
string

The status of the location, either active or inactive. See LocationStatus for possible values

created_at
string

The time when the location was created, in RFC 3339 format.

Examples for January 25th, 2020 6:27.34pm Pacific Standard Time:

UTC: 2020-01-26T02:25:34Z

Pacific Standard Time with UTC offset: 2020-01-25T18:25:34-08:00

merchant_id
string

The ID of the merchant that owns the location.

country
string

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

See Country for possible values. See Country for possible values

language_code
string

The language associated with the location, in BCP 47 format.

currency
string

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

phone_number
string

The phone number of the location in human readable format.

business_name
string

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.

type
string

The type of the location, either physical or mobile. See LocationType for possible values

website_url
string

The website URL of the location.

business_hours
BusinessHours

Represents the hours of operation for the location.

business_email
string

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

description
string

The description of the location.

twitter_username
string

The Twitter username of the location without the '@' symbol.

instagram_username
string

The Instagram username of the location without the '@' symbol.

facebook_url
string

The Facebook profile URL of the location. The URL should begin with 'facebook.com/'.

coordinates
Coordinates

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

logo_url
string

The URL of the logo image for the location.

pos_background_url
string

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

mcc
string

Beta

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.

Share Feedback

Thanks for visiting the Square API documentation. What's on your mind?