Locations

A location is a physical or logical business unit (dealership, service center, franchise location) within your partner hierarchy. Every order and payment is anchored to a location.

List locations

GET /pos/v1/locations

Required scopes: tilt/locations:read

Query parameters

Parameter	Type	Description
limit	integer	Default 50, max 200
offset	integer	Default 0
search	string	Fuzzy search on location name

Response

{
  "items": [
    {
      "location_id": "uuid",
      "name": "Acme Motors — Main St",
      "address": {
        "line1": "123 Main St",
        "city": "Springfield",
        "state": "IL",
        "zip": "62701",
        "country": "US"
      },
      "timezone": "America/Chicago",
      "currency": "USD",
      "active": true
    }
  ],
  "total": 3,
  "limit": 50,
  "offset": 0
}

Get a location

GET /pos/v1/locations/{location_id}

Required scopes: tilt/locations:read

Returns a single location. All locations returned by this endpoint are within your partner scope — you cannot read locations belonging to other partners.

Response

Same shape as a single item from the list endpoint, with the addition of:

{
  "location_id": "uuid",
  "organization_id": "uuid",
  "name": "Acme Motors — Main St",
  "address": { ... },
  "timezone": "America/Chicago",
  "currency": "USD",
  "active": true,
  "features": ["pos", "payments", "inventory"],
  "created_at": "2024-01-01T00:00:00Z"
}

features lists the applications and capabilities enabled at this location. A location must have payments in its feature set to accept payments.