---
title: "Subscription data model"
url: "https://docs.unified.to/payment/subscription/model"
description: "API reference for Subscription data model. Launch multiple pre-built Subscription integrations today with zero maintenance — all through a single API."
generated_at: "2026-06-12T16:19:05.465Z"
---
# Subscription data model

 View field support, webhooks, and list parameters for each integration on the [Supported Integrations](/payment/integrations) page. 

### 

* Data Model
* Typescript Type
* Zod Shape
* Python Class

Data Model

**id**string 

**created\_at**date 

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

**updated\_at**date 

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

**description**string 

**contact\_id**string 

a reference to an Accounting Contact (reference to AccountingContact)

**invoice\_id**string 

a reference to an Accounting Invoice (reference to AccountingInvoice)

**current\_period\_end\_at**date 

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

**current\_period\_start\_at**date 

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

**canceled\_at**date 

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

**currency**string 

**start\_at**date 

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

**end\_at**date 

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

**status** enum

Valid values:

 "ACTIVE" 

 "INACTIVE" 

 "CANCELED" 

 "PAUSED" 

**month**number 

the month on which to charge a customer (1-12). Only applies when the interval\_unit is YEAR.

**interval\_unit** enum

Valid values:

 "YEAR" 

 "MONTH" 

 "WEEK" 

 "DAY" 

**day\_of\_month**number 

The day of the month to charge customers on. 1-28 or -1 to indicate the last day of the month. Only applies when the interval\_unit is MONTH.

**day\_of\_week**number 

The day of the week to charge customers on. 1-7 or -1 to indicate the last day of the week. Only applies when the interval\_unit is WEEK.

**interval**number 

The number of intervals between charges within the interval\_unit. Defaults to 1.

**lineitems** array 

**raw**any