---
title: "Invoices"
description: "An invoice is money owed, and its history is append-only — which is why there are three different ways to end one and they are not alternatives."
canonical_url: "https://twominutebilling.com/help/developers/api-reference/invoices"
---
# Invoices

> An invoice is money owed, and its history is append-only — which is why there are three different ways to end one and they are not alternatives.

An invoice is money owed, and its history is append-only — which is why there are three different ways to end one and they are not alternatives. **Void** reverses an invoice raised in error, undoing its postings and refunding anything applied. **Write off** accepts that a real debt will not be paid and books it as bad debt. A **credit note** reduces what is owed, or returns money, while the invoice itself stands.

A pending invoice is still being assembled; `close` finalizes it, applying discounts, tax and available credit, and that is the point it becomes payable. Collection can be triggered by hand and dunning can be paused or stopped per invoice when you are negotiating.

Refunds are grouped here because a refund follows a credit note: issue one against the invoice, then return the money to the card, or record that you returned it some other way.

## Endpoints

<table>
<thead>
  <tr>
    <th>
      Method
    </th>
    
    <th>
      Endpoint
    </th>
    
    <th>
      Description
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        GET
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/invoices/list-credit-notes">
        <code>
          /v1/businesses/{biz}/credit_notes
        </code>
      </a>
    </td>
    
    <td>
      List credit notes
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        POST
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/invoices/issue-a-credit-note-against-an-invoice">
        <code>
          /v1/businesses/{biz}/credit_notes
        </code>
      </a>
    </td>
    
    <td>
      Issue a credit note against an invoice
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        GET
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/invoices/get-a-credit-note-with-its-refunds-allocations-t">
        <code>
          /v1/businesses/{biz}/credit_notes/{cn}
        </code>
      </a>
    </td>
    
    <td>
      Get a credit note with its refunds & allocations timeline
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        GET
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/invoices/download-the-credit-note-as-a-pdf">
        <code>
          /v1/businesses/{biz}/credit_notes/{cn}/pdf
        </code>
      </a>
    </td>
    
    <td>
      Download the credit note as a PDF
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        POST
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/invoices/record-an-offline-refund">
        <code>
          /v1/businesses/{biz}/credit_notes/{cn}/record_refund
        </code>
      </a>
    </td>
    
    <td>
      Record an offline refund (cash/check/bank transfer) of a refundable credit note
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        POST
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/invoices/refund">
        <code>
          /v1/businesses/{biz}/credit_notes/{cn}/refund
        </code>
      </a>
    </td>
    
    <td>
      Refund (part of) a refundable credit note to the card/cash
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        POST
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/invoices/resolve-a-payout-refund-the-gateway-could-not-co">
        <code>
          /v1/businesses/{biz}/credit_notes/{cn}/resolve_payout
        </code>
      </a>
    </td>
    
    <td>
      Resolve a payout refund the gateway could not confirm
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        POST
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/invoices/void-a-credit-note">
        <code>
          /v1/businesses/{biz}/credit_notes/{cn}/void
        </code>
      </a>
    </td>
    
    <td>
      Void a credit note
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        GET
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/invoices/list-invoices">
        <code>
          /v1/businesses/{biz}/invoices
        </code>
      </a>
    </td>
    
    <td>
      List invoices
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        POST
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/invoices/create-a-manual-one-off-invoice">
        <code>
          /v1/businesses/{biz}/invoices
        </code>
      </a>
    </td>
    
    <td>
      Create a manual / one-off invoice
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        GET
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/invoices/get-an-invoice-with-line-items">
        <code>
          /v1/businesses/{biz}/invoices/{inv}
        </code>
      </a>
    </td>
    
    <td>
      Get an invoice with line items
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        PATCH
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/invoices/update-operator-editable-invoice-fields">
        <code>
          /v1/businesses/{biz}/invoices/{inv}
        </code>
      </a>
    </td>
    
    <td>
      Update operator-editable invoice fields
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        POST
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/invoices/apply-the-customer-s-refundable-excess-credit-to">
        <code>
          /v1/businesses/{biz}/invoices/{inv}/apply_credits
        </code>
      </a>
    </td>
    
    <td>
      Apply the customer's refundable / excess credit to this invoice on purpose
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        POST
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/invoices/close">
        <code>
          /v1/businesses/{biz}/invoices/{inv}/close
        </code>
      </a>
    </td>
    
    <td>
      Close (finalize) a pending invoice
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        POST
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/invoices/attempt-collection-on-an-open-invoice-now">
        <code>
          /v1/businesses/{biz}/invoices/{inv}/collect
        </code>
      </a>
    </td>
    
    <td>
      Attempt collection on an open invoice now
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        GET
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/invoices/an-invoice-s-dunning-journey">
        <code>
          /v1/businesses/{biz}/invoices/{inv}/dunning_journey
        </code>
      </a>
    </td>
    
    <td>
      An invoice's dunning journey
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        GET
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/invoices/explain-an-invoice">
        <code>
          /v1/businesses/{biz}/invoices/{inv}/explanation
        </code>
      </a>
    </td>
    
    <td>
      Explain an invoice
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        GET
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/invoices/rich-print-friendly-html-invoice">
        <code>
          /v1/businesses/{biz}/invoices/{inv}/html
        </code>
      </a>
    </td>
    
    <td>
      Rich print-friendly HTML invoice
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        POST
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/invoices/pause-dunning-until-a-given-time">
        <code>
          /v1/businesses/{biz}/invoices/{inv}/pause_dunning
        </code>
      </a>
    </td>
    
    <td>
      Pause dunning until a given time
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        POST
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/invoices/record-an-offline-manual-payment">
        <code>
          /v1/businesses/{biz}/invoices/{inv}/pay
        </code>
      </a>
    </td>
    
    <td>
      Record an offline/manual payment
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        GET
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/invoices/download-the-invoice-as-a-pdf">
        <code>
          /v1/businesses/{biz}/invoices/{inv}/pdf
        </code>
      </a>
    </td>
    
    <td>
      Download the invoice as a PDF
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        GET
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/invoices/get-the-gateway-account-a-refund-of-this-invoice">
        <code>
          /v1/businesses/{biz}/invoices/{inv}/refund_gateway_account
        </code>
      </a>
    </td>
    
    <td>
      Get the gateway account a refund of this invoice goes through
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        POST
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/invoices/regenerate-a-voided-invoice-into-a-fresh-invoice">
        <code>
          /v1/businesses/{biz}/invoices/{inv}/regenerate
        </code>
      </a>
    </td>
    
    <td>
      Regenerate a voided invoice into a fresh invoice for the same period
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        POST
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/invoices/resume-a-paused-dunning-run">
        <code>
          /v1/businesses/{biz}/invoices/{inv}/resume_dunning
        </code>
      </a>
    </td>
    
    <td>
      Resume a paused dunning run
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        POST
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/invoices/dunning-retry-now">
        <code>
          /v1/businesses/{biz}/invoices/{inv}/retry
        </code>
      </a>
    </td>
    
    <td>
      Dunning "retry now"
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        POST
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/invoices/stop-dunning-for-an-invoice">
        <code>
          /v1/businesses/{biz}/invoices/{inv}/stop_dunning
        </code>
      </a>
    </td>
    
    <td>
      Stop dunning for an invoice
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        POST
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/invoices/void-an-open-invoice">
        <code>
          /v1/businesses/{biz}/invoices/{inv}/void
        </code>
      </a>
    </td>
    
    <td>
      Void an open invoice
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        POST
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/invoices/write-off-an-unpaid-invoice-as-bad-debt">
        <code>
          /v1/businesses/{biz}/invoices/{inv}/write_off
        </code>
      </a>
    </td>
    
    <td>
      Write off an unpaid invoice as bad debt
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        POST
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/invoices/cancel-a-debit-the-gateway-has-not-collected-yet">
        <code>
          /v1/businesses/{biz}/payments/{pay}/cancel_pending_debit
        </code>
      </a>
    </td>
    
    <td>
      Cancel a debit the gateway has not collected yet
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        POST
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/invoices/refund-a-payment">
        <code>
          /v1/businesses/{biz}/payments/{pay}/refund
        </code>
      </a>
    </td>
    
    <td>
      Refund a payment
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        GET
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/invoices/list-invoices-under-retry">
        <code>
          /v1/businesses/{biz}/retries
        </code>
      </a>
    </td>
    
    <td>
      List invoices under retry (dunning)
    </td>
  </tr>
</tbody>
</table>


## Sitemap

See the full [sitemap](https://twominutebilling.com/sitemap.md) for all pages.