---
title: "Location data model"
url: "https://docs.unified.to/calendar/location/model"
description: "The Location data model object in Unified's Location API: 9 fields, including name, parent_id and type, with types and enum values."
date: "2026-10-25T22:23:43.518Z"
updated: "2026-10-25T22:23:43.518Z"
---
# Location data model

Updated: October 25, 2026

 View field support, webhooks, and list parameters for each integration on the [Supported Integrations](https://docs.unified.to/calendar/integrations.md) page. 

| Field                    | Type                                                                                        | Required | Description                                                                                                                       |
| ------------------------ | ------------------------------------------------------------------------------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------- |
| id                       | string                                                                                      | No       |                                                                                                                                   |
| name                     | string                                                                                      | No       |                                                                                                                                   |
| parent\_id               | string                                                                                      | No       |                                                                                                                                   |
| type                     | enum                                                                                        | No       | Values: BUILDING, FLOOR, CAMPUS, CITY, REGION, COUNTRY, OTHER                                                                     |
| address                  | object                                                                                      | No       |                                                                                                                                   |
| address.address1         | string                                                                                      | No       |                                                                                                                                   |
| address.address2         | string                                                                                      | No       |                                                                                                                                   |
| address.city             | string                                                                                      | No       |                                                                                                                                   |
| address.region           | string                                                                                      | No       |                                                                                                                                   |
| address.region\_code     | string                                                                                      | No       |                                                                                                                                   |
| address.postal\_code     | string                                                                                      | No       |                                                                                                                                   |
| address.country          | string                                                                                      | No       |                                                                                                                                   |
| address.country\_code    | string                                                                                      | No       | ISO 2-digit country code                                                                                                          |
| created\_at              | string (date-time)                                                                          | No       | (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)                                                                                          |
| updated\_at              | string (date-time)                                                                          | No       | (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)                                                                                          |
| timezone                 | string                                                                                      | No       |                                                                                                                                   |
| metadata                 | [CalendarMetadata](https://docs.unified.to/calendar/location/model.md#CalendarMetadata)\[\] | No       |                                                                                                                                   |
| metadata\[\].id          | string                                                                                      | No       |                                                                                                                                   |
| metadata\[\].slug        | string                                                                                      | No       |                                                                                                                                   |
| metadata\[\].value       | object                                                                                      | No       |                                                                                                                                   |
| metadata\[\].namespace   | string                                                                                      | No       |                                                                                                                                   |
| metadata\[\].format      | enum                                                                                        | No       | Values: TEXT, NUMBER, DATE, BOOLEAN, FILE, TEXTAREA, SINGLE\_SELECT, MULTIPLE\_SELECT, MEASUREMENT, PRICE, YES\_NO, CURRENCY, URL |
| metadata\[\].extra\_data | object                                                                                      | No       |                                                                                                                                   |

## TypeScript

```typescript
export type CalendarLocation = {
	id?: string;
	name?: string;
	parent_id?: string;
	type?: 'BUILDING' | 'FLOOR' | 'CAMPUS' | 'CITY' | 'REGION' | 'COUNTRY' | 'OTHER';
	address?: {
		address1?: string; 
		address2?: string; 
		city?: string; 
		region?: string; 
		region_code?: string; 
		postal_code?: string; 
		country?: string; 
		country_code?: string; // ISO 2-digit country code 
	};
	raw?: any;
	created_at?: string-time; // (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
	updated_at?: string-time; // (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
	timezone?: string;
	metadata?: [];
} 
```

## Zod

```typescript
import { z } from 'zod';

export const ZodCalendarLocation = z.object({
	id: z.string().optional(),
	name: z.string().optional(),
	parent_id: z.string().optional(),
	type: z.enum("BUILDING", "FLOOR", "CAMPUS", "CITY", "REGION", "COUNTRY", "OTHER").optional(),
	address: z.object({
			address1: z.string().optional(),
			address2: z.string().optional(),
			city: z.string().optional(),
			region: z.string().optional(),
			region_code: z.string().optional(),
			postal_code: z.string().optional(),
			country: z.string().optional(),
			country_code: z.string().optional().describe("ISO 2-digit country code")
}).optional(),
,
	created_at: z.string-time().optional().describe("(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)"),
	updated_at: z.string-time().optional().describe("(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)"),
	timezone: z.string().optional(),
	metadata: z.array().optional()
});
```

## Python

```python
import dataclasses

@dataclasses.dataclass
class CalendarLocationType(str, Enum):
	BUILDING = 'BUILDING'
	FLOOR = 'FLOOR'
	CAMPUS = 'CAMPUS'
	CITY = 'CITY'
	REGION = 'REGION'
	COUNTRY = 'COUNTRY'
	OTHER = 'OTHER'

@dataclasses.dataclass
class PropertyCalendarLocationAddress:
	address1: Optional[str]
	address2: Optional[str]
	city: Optional[str]
	region: Optional[str]
	region_code: Optional[str]
	postal_code: Optional[str]
	country: Optional[str]
	"""ISO 2-digit country code"""
	country_code: Optional[str]

@dataclasses.dataclass
class CalendarLocation:
	id: Optional[str]
	name: Optional[str]
	parent_id: Optional[str]
	type: Optional[CalendarLocationType]
	address: Optional[PropertyCalendarLocationAddress]

	"""(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)"""
	created_at: Optional[str]
	"""(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)"""
	updated_at: Optional[str]
	timezone: Optional[str]
	metadata: Optional[PropertyCalendarLocationMetadata]
```