---
title: "Inventory data model"
url: "https://docs.unified.to/ads/inventory/model"
description: "The Inventory data model object in Unified's Inventory API: 9 fields, including created_at, updated_at and name, with types and enum values."
date: "2026-11-12T01:35:01.124Z"
updated: "2026-11-12T01:35:01.124Z"
---
# Inventory data model

Updated: November 12, 2026

Publisher inventory: ad units, placements, sites, apps, zones or channels

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

| Field                    | Type               | Required | Description                                                                                                                       |
| ------------------------ | ------------------ | -------- | --------------------------------------------------------------------------------------------------------------------------------- |
| id                       | string             | No       |                                                                                                                                   |
| 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)                                                                                          |
| name                     | string             | No       |                                                                                                                                   |
| type                     | enum               | No       | Values: AD\_UNIT, PLACEMENT, SITE, APP, ZONE, CHANNEL, OTHER                                                                      |
| parent\_id               | string             | No       |                                                                                                                                   |
| status                   | enum               | No       | Values: UNSPECIFIED, ACTIVE, PAUSED, ARCHIVED, DRAFT, SCHEDULED\_FOR\_DELETION, PROCESSING, PROCESSING\_FAILED                    |
| sizes                    | AdsSize\[\]        | No       |                                                                                                                                   |
| sizes\[\].width          | number             | Yes      |                                                                                                                                   |
| sizes\[\].height         | number             | Yes      |                                                                                                                                   |
| metadata                 | AdsMetadata\[\]    | 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 AdsInventory = {
	id?: string;
	created_at?: string-time; // (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
	updated_at?: string-time; // (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
	name?: string;
	type?: 'AD_UNIT' | 'PLACEMENT' | 'SITE' | 'APP' | 'ZONE' | 'CHANNEL' | 'OTHER';
	parent_id?: string;
	status?: 'UNSPECIFIED' | 'ACTIVE' | 'PAUSED' | 'ARCHIVED' | 'DRAFT' | 'SCHEDULED_FOR_DELETION' | 'PROCESSING' | 'PROCESSING_FAILED';
	sizes?: [];
	metadata?: [];
	raw?: any;
} 
```

## Zod

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

export const ZodAdsInventory = z.object({
	id: z.string().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)"),
	name: z.string().optional(),
	type: z.enum("AD_UNIT", "PLACEMENT", "SITE", "APP", "ZONE", "CHANNEL", "OTHER").optional(),
	parent_id: z.string().optional(),
	status: z.enum("UNSPECIFIED", "ACTIVE", "PAUSED", "ARCHIVED", "DRAFT", "SCHEDULED_FOR_DELETION", "PROCESSING", "PROCESSING_FAILED").optional(),
	sizes: z.array().optional(),
	metadata: z.array().optional(),

});
```

## Python

```python
import dataclasses

@dataclasses.dataclass
class AdsInventoryType(str, Enum):
	AD_UNIT = 'AD_UNIT'
	PLACEMENT = 'PLACEMENT'
	SITE = 'SITE'
	APP = 'APP'
	ZONE = 'ZONE'
	CHANNEL = 'CHANNEL'
	OTHER = 'OTHER'

@dataclasses.dataclass
class AdsInventoryStatus(str, Enum):
	UNSPECIFIED = 'UNSPECIFIED'
	ACTIVE = 'ACTIVE'
	PAUSED = 'PAUSED'
	ARCHIVED = 'ARCHIVED'
	DRAFT = 'DRAFT'
	SCHEDULED_FOR_DELETION = 'SCHEDULED_FOR_DELETION'
	PROCESSING = 'PROCESSING'
	PROCESSING_FAILED = 'PROCESSING_FAILED'

@dataclasses.dataclass
class AdsInventory:
	id: Optional[str]
	"""(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)"""
	created_at: Optional[str]
	"""(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)"""
	updated_at: Optional[str]
	name: Optional[str]
	type: Optional[AdsInventoryType]
	parent_id: Optional[str]
	status: Optional[AdsInventoryStatus]
	sizes: Optional[PropertyAdsInventorySizes]
	metadata: Optional[PropertyAdsInventoryMetadata]

```