---
title: "Update a bill"
method: PATCH
path: "/bills/{bill_id}"
tags: ["Bills"]
---

# Update a bill

`PATCH /bills/{bill_id}`

Update an existing digital bill. Can update customer details, line items, receipt summary, and other fields.

## Path parameters

- `bill_id` string, required

## Request body

- Bill — A Razorpay Billme digital receipt/bill. Used for retail, food & beverage, events, ecommerce, and other use cases.
  - `id` string — Bill ID with prefix bill_
  - `business_type` 'ecommerce' | 'retail' | 'food_and_beverage' | 'events'
  - `business_category` string
  - `customer` object
    - `contact` string
    - `name` string
    - `email` string
    - `customer_id` string
    - `addresses` object[]
  - `employee` object
    - `id` string
    - `name` string
  - `loyalty` object
    - `points` integer
    - `redeemed_points` integer
  - `store_code` string
  - `receipt_timestamp` integer — Unix timestamp of the transaction
  - `receipt_number` string
  - `receipt_type` 'tax_invoice' | 'sales_invoice' | 'bill_of_supply' | 'credit_note' | 'debit_note'
  - `receipt_delivery` 'digital' | 'print' | 'digital_and_print'
  - `tags` object
  - `bar_code_number` string
  - `qr_code_number` string
  - `billing_pos_number` string
  - `pos_category` string
  - `order_number` string
  - `order_service_type` 'dine_in' | 'takeaway' | 'delivery'
  - `delivery_status_url` string
  - `line_items` object[]
    - `name` string
    - `quantity` number
    - `unit_amount` integer
    - `unit` string
    - `hsn_code` string
    - `product_code` string
    - `total_amount` integer
    - `taxes` object[]
    - `sub_items` object[]
    - `tags` object
  - `receipt_summary` object
    - `total_quantity` number
    - `sub_total_amount` integer
    - `currency` string
    - `net_payable_amount` integer
    - `payment_status` string
    - `discounts` object[]
    - `taxes` object[]
  - `taxes` object[]
  - `payments` object[]
    - `method` string
    - `currency` string
    - `amount` integer
    - `payment_reference_id` string
    - `financier_data` object
  - `event` object — Event details for events business type
  - `irn` string — Invoice Reference Number for GST e-invoicing
  - `receipt_url` string
  - `created_at` integer

## Response `200`

Bill updated successfully

- Bill — A Razorpay Billme digital receipt/bill. Used for retail, food & beverage, events, ecommerce, and other use cases.
  - `id` string — Bill ID with prefix bill_
  - `business_type` 'ecommerce' | 'retail' | 'food_and_beverage' | 'events'
  - `business_category` string
  - `customer` object
    - `contact` string
    - `name` string
    - `email` string
    - `customer_id` string
    - `addresses` object[]
  - `employee` object
    - `id` string
    - `name` string
  - `loyalty` object
    - `points` integer
    - `redeemed_points` integer
  - `store_code` string
  - `receipt_timestamp` integer — Unix timestamp of the transaction
  - `receipt_number` string
  - `receipt_type` 'tax_invoice' | 'sales_invoice' | 'bill_of_supply' | 'credit_note' | 'debit_note'
  - `receipt_delivery` 'digital' | 'print' | 'digital_and_print'
  - `tags` object
  - `bar_code_number` string
  - `qr_code_number` string
  - `billing_pos_number` string
  - `pos_category` string
  - `order_number` string
  - `order_service_type` 'dine_in' | 'takeaway' | 'delivery'
  - `delivery_status_url` string
  - `line_items` object[]
    - `name` string
    - `quantity` number
    - `unit_amount` integer
    - `unit` string
    - `hsn_code` string
    - `product_code` string
    - `total_amount` integer
    - `taxes` object[]
    - `sub_items` object[]
    - `tags` object
  - `receipt_summary` object
    - `total_quantity` number
    - `sub_total_amount` integer
    - `currency` string
    - `net_payable_amount` integer
    - `payment_status` string
    - `discounts` object[]
    - `taxes` object[]
  - `taxes` object[]
  - `payments` object[]
    - `method` string
    - `currency` string
    - `amount` integer
    - `payment_reference_id` string
    - `financier_data` object
  - `event` object — Event details for events business type
  - `irn` string — Invoice Reference Number for GST e-invoicing
  - `receipt_url` string
  - `created_at` integer

## Other responses

- `400` — Bad request. Invalid parameters or missing required fields.
- `401` — Authentication failed. Invalid or missing API key credentials.
- `429` — Rate limit exceeded. Implement exponential backoff with jitter before retrying.
- `500` — Internal server error.

---

[API](https://skmtc.net/curlec/apis/razorpay-api.md) · [All operations](https://skmtc.net/curlec/apis/razorpay-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/curlec/razorpay-api/versions/824ca9e6faef/schema)