# Revenue Schedules

A revenue schedule represents how revenue amounts from a single charge are distributed over time and recognized in accounting periods. Revenue schedules maintain consistency with the currency used.


## Create a revenue schedule for a credit memo item (manual distribution)

 - [POST /v1/revenue-schedules/credit-memo-items/{cmi-id}](https://developer.zuora.com/v1-api-reference/older-api/revenue-schedules/post_rsforcreditmemoitem_manualdistribution.md): Note: This operation is only available if you have Invoice Settlement enabled. The Invoice Settlement feature is generally available as of Zuora Billing Release 296 (March 2021). This feature includes Unapplied Payments, Credit and Debit Memo, and Invoice Item Settlement. If you want to enable Invoice Settlement, see Invoice Settlement Enablement and Checklist Guide for more information.

Creates a revenue schedule for a credit memo item, and manually distribute the revenue.

## Retrieve a revenue schedule by credit memo item ID

 - [GET /v1/revenue-schedules/credit-memo-items/{cmi-id}](https://developer.zuora.com/v1-api-reference/older-api/revenue-schedules/get_rsbycreditmemoitem.md): Note: This operation is only available if you have Invoice Settlement enabled. The Invoice Settlement feature is generally available as of Zuora Billing Release 296 (March 2021). This feature includes Unapplied Payments, Credit and Debit Memo, and Invoice Item Settlement. If you want to enable Invoice Settlement, see Invoice Settlement Enablement and Checklist Guide for more information.

Retrieves the details about a revenue schedule by specifying a valid credit memo item ID.

## Create a revenue schedule for a credit memo item (distribute by date range)

 - [POST /v1/revenue-schedules/credit-memo-items/{cmi-id}/distribute-revenue-with-date-range](https://developer.zuora.com/v1-api-reference/older-api/revenue-schedules/post_rsforcreditmemoitem_distributebydaterange.md): Note: This operation is only available if you have Invoice Settlement enabled. The Invoice Settlement feature is generally available as of Zuora Billing Release 296 (March 2021). This feature includes Unapplied Payments, Credit and Debit Memo, and Invoice Item Settlement. If you want to enable Invoice Settlement, see Invoice Settlement Enablement and Checklist Guide for more information.

Creates a revenue schedule for a credit memo item, and automatically distribute the revenue by specifying the recognition start and end dates.

## Create a revenue schedule for a debit memo item (manual distribution)

 - [POST /v1/revenue-schedules/debit-memo-items/{dmi-id}](https://developer.zuora.com/v1-api-reference/older-api/revenue-schedules/post_rsfordebitmemoitem_manualdistribution.md): Note: This operation is only available if you have Invoice Settlement enabled. The Invoice Settlement feature is generally available as of Zuora Billing Release 296 (March 2021). This feature includes Unapplied Payments, Credit and Debit Memo, and Invoice Item Settlement. If you want to enable Invoice Settlement, see Invoice Settlement Enablement and Checklist Guide for more information.

Creates a revenue schedule for a debit memo item, and manually distribute the revenue.

## Retrieve a revenue schedule by debit memo item ID

 - [GET /v1/revenue-schedules/debit-memo-items/{dmi-id}](https://developer.zuora.com/v1-api-reference/older-api/revenue-schedules/get_rsbydebitmemoitem.md): Note: This operation is only available if you have Invoice Settlement enabled. The Invoice Settlement feature is generally available as of Zuora Billing Release 296 (March 2021). This feature includes Unapplied Payments, Credit and Debit Memo, and Invoice Item Settlement. If you want to enable Invoice Settlement, see Invoice Settlement Enablement and Checklist Guide for more information.

Retrieves the details about a revenue schedule by specifying a valid debit memo item ID.

## Create a revenue schedule for a debit memo item (distribute by date range)

 - [POST /v1/revenue-schedules/debit-memo-items/{dmi-id}/distribute-revenue-with-date-range](https://developer.zuora.com/v1-api-reference/older-api/revenue-schedules/post_rsfordebitmemoitem_distributebydaterange.md): Note: This operation is only available if you have Invoice Settlement enabled. The Invoice Settlement feature is generally available as of Zuora Billing Release 296 (March 2021). This feature includes Unapplied Payments, Credit and Debit Memo, and Invoice Item Settlement. If you want to enable Invoice Settlement, see Invoice Settlement Enablement and Checklist Guide for more information.

Creates a revenue schedule for a debit memo item, and automatically distribute the revenue by specifying the recognition start and end dates.

## Retrieve a revenue schedule by invoice item adjustment key

 - [GET /v1/revenue-schedules/invoice-item-adjustments/{invoice-item-adj-key}](https://developer.zuora.com/v1-api-reference/older-api/revenue-schedules/get_rsbyinvoiceitemadjustment.md): Retrieves the details of a revenue schedule by specifying a valid invoice item adjustment identifier. Request and response field descriptions and sample code are provided.

## Create a revenue schedule for an invoice item adjustment (manual distribution)

 - [POST /v1/revenue-schedules/invoice-item-adjustments/{invoice-item-adj-key}](https://developer.zuora.com/v1-api-reference/older-api/revenue-schedules/post_rsforinvoiceitemadjustment_manualdistribution.md): Creates a revenue schedule for an Invoice Item Adjustment and manually distribute the revenue.

## Create a revenue schedule for an invoice item adjustment (distribute by date range)

 - [POST /v1/revenue-schedules/invoice-item-adjustments/{invoice-item-adj-key}/distribute-revenue-with-date-range](https://developer.zuora.com/v1-api-reference/older-api/revenue-schedules/post_rsforinvoiceitemadjustment_distributebydaterange.md): Creates a revenue schedule for an Invoice Item Adjustment and distribute the revenue by specifying the recognition start and end dates.

## Create a revenue schedule for an invoice item (manual distribution)

 - [POST /v1/revenue-schedules/invoice-items/{invoice-item-id}](https://developer.zuora.com/v1-api-reference/older-api/revenue-schedules/post_rsforinvoiceitem_manualdistribution.md): Creates a revenue schedule for an Invoice Item and manually distribute the revenue.

## Retrieve a revenue schedule by invoice item ID

 - [GET /v1/revenue-schedules/invoice-items/{invoice-item-id}](https://developer.zuora.com/v1-api-reference/older-api/revenue-schedules/get_rsbyinvoiceitem.md): Retrieves the details of a revenue schedule by specifying the invoice item ID.

## Create a revenue schedule for an invoice item (distribute by date range)

 - [POST /v1/revenue-schedules/invoice-items/{invoice-item-id}/distribute-revenue-with-date-range](https://developer.zuora.com/v1-api-reference/older-api/revenue-schedules/post_rsforinvoiceitem_distributebydaterange.md): Creates a revenue schedule for an Invoice Item and distribute the revenue by specifying the recognition start and end dates.

## List revenue schedules of a product charge by charge ID and account key

 - [GET /v1/revenue-schedules/product-charges/{charge-key}/{account-key}](https://developer.zuora.com/v1-api-reference/older-api/revenue-schedules/get_rsbyproductchargeandbillingaccount.md): Note: This operation is only available if you have Invoice Settlement enabled. The Invoice Settlement feature is generally available as of Zuora Billing Release 296 (March 2021). This feature includes Unapplied Payments, Credit and Debit Memo, and Invoice Item Settlement. If you want to enable Invoice Settlement, see Invoice Settlement Enablement and Checklist Guide for more information.

Retrieves the details about all revenue schedules of a product rate plan charge by specifying the charge ID and billing account ID.

## List all details of a revenue schedule

 - [GET /v1/revenue-schedules/{rs-number}](https://developer.zuora.com/v1-api-reference/older-api/revenue-schedules/get_rs.md): Retrieves the details of a revenue schedule by specifying the revenue schedule number. Request and response field descriptions and sample code are provided.

## Delete a revenue schedule

 - [DELETE /v1/revenue-schedules/{rs-number}](https://developer.zuora.com/v1-api-reference/older-api/revenue-schedules/delete_rs.md): Deletes a revenue schedule by specifying its revenue schedule number
### Prerequisites
You must have the Delete Custom Revenue Schedule permissions in Zuora Finance.

The revenue schedule must not be associated with any invoice item, invoice item adjustment, or credit/debit memo item in Zuora Billing.

## Update a revenue schedule

 - [PUT /v1/revenue-schedules/{rs-number}/basic-information](https://developer.zuora.com/v1-api-reference/older-api/revenue-schedules/put_rsbasicinfo.md): Retrieves basic information of a revenue schedule by specifying the revenue schedule number. Request and response field descriptions and sample code are provided.

## Distribute revenue across accounting periods

 - [PUT /v1/revenue-schedules/{rs-number}/distribute-revenue-across-accounting-periods](https://developer.zuora.com/v1-api-reference/older-api/revenue-schedules/put_revenueacrossap.md): Distributes revenue by specifying the revenue schedule number. Request and response field descriptions and sample code are provided.

## Distribute revenue on a specific date

 - [PUT /v1/revenue-schedules/{rs-number}/distribute-revenue-on-specific-date](https://developer.zuora.com/v1-api-reference/older-api/revenue-schedules/put_revenuespecificdate.md): Distributes revenue on a specific recognition date. Request and response field descriptions and sample code are provided.

## Distribute revenue in a recognition period

 - [PUT /v1/revenue-schedules/{rs-number}/distribute-revenue-with-date-range](https://developer.zuora.com/v1-api-reference/older-api/revenue-schedules/put_revenuebyrecognitionstartandenddates.md): Distributes revenue by specifying the recognition start and end dates. Request and response field descriptions and sample code are provided.

## Create a revenue schedule by subscription charge key

 - [POST /v1/revenue-schedules/subscription-charges/{charge-key}](https://developer.zuora.com/v1-api-reference/older-api/revenue-schedules/post_rsforsubsccharge.md): Creates a revenue schedule by specifying the subscription charge. This method is for custom unlimited revenue recognition only.

Note: You can create a maximum of 3,000 revenue schedules for a subscription charge.

## List revenue schedules by subscription charge key

 - [GET /v1/revenue-schedules/subscription-charges/{charge-key}](https://developer.zuora.com/v1-api-reference/older-api/revenue-schedules/get_rsforsubsccharge.md): Retrieves the revenue schedule details by specifying subscription charge ID. Request and response field descriptions and sample code are provided