---
title: "Bomline data model"
url: "https://docs.unified.to/plm/bomline/model"
description: "The Bomline data model object in Unified's Bomline API: 13 fields, including created_at, updated_at and parent_part_id, with types and enum values."
date: "2026-11-02T06:50:20.035Z"
updated: "2026-11-02T06:50:20.035Z"
---
# Bomline data model

Updated: November 2, 2026

One parent to child usage in a bill of materials

 View field support, webhooks, and list parameters for each integration on the [Supported Integrations](https://docs.unified.to/plm/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)      |
| parent\_part\_id       | string             | No       | The assembly                                  |
| child\_part\_id        | string             | No       | The component's PlmPart ID (a revision ID)    |
| child\_revision        | string             | No       | Pinned child revision, when the line pins one |
| quantity               | number             | No       |                                               |
| unit\_of\_measure      | string             | No       |                                               |
| line\_number           | string             | No       | Find or item number on the BOM                |
| reference\_designators | string\[\]         | No       |                                               |
| effective\_at          | string (date-time) | No       | (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)      |
| expires\_at            | string (date-time) | No       | (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)      |
| notes                  | string             | No       |                                               |

## TypeScript

```typescript
export type PlmBomline = {
	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)
	parent_part_id?: string; // The assembly
	child_part_id?: string; // The component's PlmPart ID (a revision ID)
	child_revision?: string; // Pinned child revision, when the line pins one
	quantity?: number;
	unit_of_measure?: string;
	line_number?: string; // Find or item number on the BOM
	reference_designators?: string[];
	effective_at?: string-time; // (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
	expires_at?: string-time; // (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
	notes?: string;
	raw?: any; // Raw data from integration
} 
```

## Zod

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

export const ZodPlmBomline = 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)"),
	parent_part_id: z.string().optional().describe("The assembly"),
	child_part_id: z.string().optional().describe("The component's PlmPart ID (a revision ID)"),
	child_revision: z.string().optional().describe("Pinned child revision, when the line pins one"),
	quantity: z.number().optional(),
	unit_of_measure: z.string().optional(),
	line_number: z.string().optional().describe("Find or item number on the BOM"),
	reference_designators: z.array().optional(),
	effective_at: z.string-time().optional().describe("(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)"),
	expires_at: z.string-time().optional().describe("(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)"),
	notes: z.string().optional(),

});
```

## Python

```python
import dataclasses

@dataclasses.dataclass
class PlmBomline:
	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]
	"""The assembly"""
	parent_part_id: Optional[str]
	"""The component's PlmPart ID (a revision ID)"""
	child_part_id: Optional[str]
	"""Pinned child revision, when the line pins one"""
	child_revision: Optional[str]
	quantity: Optional[int]
	unit_of_measure: Optional[str]
	"""Find or item number on the BOM"""
	line_number: Optional[str]
	reference_designators: Optional[List[List[str]]]
	"""(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)"""
	effective_at: Optional[str]
	"""(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)"""
	expires_at: Optional[str]
	notes: Optional[str]

```