Skip to content
Fragment
Get started
API Reference
Invoices

List History

invoices.list_history(strid) -> InvoiceListHistoryResponse
GET/invoices/{id}/history

Gets the version history of an invoice

ParametersExpand Collapse
id: str

Invoice ID

ReturnsExpand Collapse
class InvoiceListHistoryResponse: …

Version history of an invoice

data: List[Data]
id: str

Unique identifier for the invoice

created: datetime

ISO 8601 timestamp when the invoice was created

formatdate-time
status: Literal["active"]

The status of the invoice

version: float

Version number of this invoice snapshot

workspace_id: str

Workspace ID this invoice belongs to

diff: Optional[List[DataDiff]]

Cumulative diff of changes applied to the invoice

Accepts one of the following:
class DataDiffAddDiffEntry: …
item: DataDiffAddDiffEntryItem

Invoice line item object

id: str

Unique identifier for the line item

amount: str

Amount in smallest currency unit (represented as string for bigint)

currency_code: Literal["ADA", "BTC", "DAI", 176 more]

Currency code (ISO 4217 or crypto)

Accepts one of the following:
"ADA"
"BTC"
"DAI"
"ETH"
"SOL"
"USDC"
"USDT"
"USDG"
"EURC"
"CADC"
"CADT"
"XLM"
"UNI"
"BCH"
"LTC"
"AAVE"
"LINK"
"MATIC"
"PTS"
"AED"
"AFN"
"ALL"
"AMD"
"ANG"
"AOA"
"ARS"
"AUD"
"AWG"
"AZN"
"BAM"
"BBD"
"BDT"
"BGN"
"BHD"
"BIF"
"BMD"
"BND"
"BOB"
"BRL"
"BSD"
"BTN"
"BWP"
"BYR"
"BZD"
"CAD"
"CDF"
"CHF"
"CLP"
"CNY"
"COP"
"CRC"
"CUC"
"CUP"
"CVE"
"CZK"
"DJF"
"DKK"
"DOP"
"DZD"
"EGP"
"ERN"
"ETB"
"EUR"
"FJD"
"FKP"
"GBP"
"GEL"
"GGP"
"GHS"
"GIP"
"GMD"
"GNF"
"GTQ"
"GYD"
"HKD"
"HNL"
"HRK"
"HTG"
"HUF"
"IDR"
"ILS"
"IMP"
"INR"
"IQD"
"IRR"
"ISK"
"JMD"
"JOD"
"JPY"
"KES"
"KGS"
"KHR"
"KMF"
"KPW"
"KRW"
"KWD"
"KYD"
"KZT"
"LAK"
"LBP"
"LKR"
"LRD"
"LSL"
"LYD"
"MAD"
"MDL"
"MGA"
"MKD"
"MMK"
"MNT"
"MOP"
"MUR"
"MVR"
"MWK"
"MXN"
"MYR"
"MZN"
"NAD"
"NGN"
"NIO"
"NOK"
"NPR"
"NZD"
"OMR"
"PAB"
"PEN"
"PGK"
"PHP"
"PKR"
"PLN"
"PYG"
"QAR"
"RON"
"RSD"
"RUB"
"RWF"
"SAR"
"SBD"
"SCR"
"SDG"
"SEK"
"SGD"
"SHP"
"SLL"
"SOS"
"SPL"
"SRD"
"SVC"
"SYP"
"STN"
"SZL"
"THB"
"TJS"
"TMT"
"TND"
"TOP"
"TRY"
"TTD"
"TVD"
"TWD"
"TZS"
"UAH"
"UGX"
"USD"
"UYU"
"UZS"
"VEF"
"VND"
"VUV"
"WST"
"XAF"
"XCD"
"XOF"
"XPF"
"YER"
"ZAR"
"ZMW"
"LOGICAL"
"CUSTOM"
description: str

Description of the line item

product_id: str

ID of the product/catalog item

type: Literal["payin", "payout"]

The type of the line item

Accepts one of the following:
"payin"
"payout"
user_id: str

External ID of the user associated with this line item

op: Literal["add"]

A line item was added

class DataDiffUpdateDiffEntry: …
id: str

ID of the updated line item

new_amount: str

New amount after the update

old_amount: str

Amount before the update

op: Literal["update"]

A line item was updated

class DataDiffDeleteDiffEntry: …
item: DataDiffDeleteDiffEntryItem

Invoice line item object

id: str

Unique identifier for the line item

amount: str

Amount in smallest currency unit (represented as string for bigint)

currency_code: Literal["ADA", "BTC", "DAI", 176 more]

Currency code (ISO 4217 or crypto)

Accepts one of the following:
"ADA"
"BTC"
"DAI"
"ETH"
"SOL"
"USDC"
"USDT"
"USDG"
"EURC"
"CADC"
"CADT"
"XLM"
"UNI"
"BCH"
"LTC"
"AAVE"
"LINK"
"MATIC"
"PTS"
"AED"
"AFN"
"ALL"
"AMD"
"ANG"
"AOA"
"ARS"
"AUD"
"AWG"
"AZN"
"BAM"
"BBD"
"BDT"
"BGN"
"BHD"
"BIF"
"BMD"
"BND"
"BOB"
"BRL"
"BSD"
"BTN"
"BWP"
"BYR"
"BZD"
"CAD"
"CDF"
"CHF"
"CLP"
"CNY"
"COP"
"CRC"
"CUC"
"CUP"
"CVE"
"CZK"
"DJF"
"DKK"
"DOP"
"DZD"
"EGP"
"ERN"
"ETB"
"EUR"
"FJD"
"FKP"
"GBP"
"GEL"
"GGP"
"GHS"
"GIP"
"GMD"
"GNF"
"GTQ"
"GYD"
"HKD"
"HNL"
"HRK"
"HTG"
"HUF"
"IDR"
"ILS"
"IMP"
"INR"
"IQD"
"IRR"
"ISK"
"JMD"
"JOD"
"JPY"
"KES"
"KGS"
"KHR"
"KMF"
"KPW"
"KRW"
"KWD"
"KYD"
"KZT"
"LAK"
"LBP"
"LKR"
"LRD"
"LSL"
"LYD"
"MAD"
"MDL"
"MGA"
"MKD"
"MMK"
"MNT"
"MOP"
"MUR"
"MVR"
"MWK"
"MXN"
"MYR"
"MZN"
"NAD"
"NGN"
"NIO"
"NOK"
"NPR"
"NZD"
"OMR"
"PAB"
"PEN"
"PGK"
"PHP"
"PKR"
"PLN"
"PYG"
"QAR"
"RON"
"RSD"
"RUB"
"RWF"
"SAR"
"SBD"
"SCR"
"SDG"
"SEK"
"SGD"
"SHP"
"SLL"
"SOS"
"SPL"
"SRD"
"SVC"
"SYP"
"STN"
"SZL"
"THB"
"TJS"
"TMT"
"TND"
"TOP"
"TRY"
"TTD"
"TVD"
"TWD"
"TZS"
"UAH"
"UGX"
"USD"
"UYU"
"UZS"
"VEF"
"VND"
"VUV"
"WST"
"XAF"
"XCD"
"XOF"
"XPF"
"YER"
"ZAR"
"ZMW"
"LOGICAL"
"CUSTOM"
description: str

Description of the line item

product_id: str

ID of the product/catalog item

type: Literal["payin", "payout"]

The type of the line item

Accepts one of the following:
"payin"
"payout"
user_id: str

External ID of the user associated with this line item

op: Literal["delete"]

A line item was deleted

line_items: Optional[List[DataLineItem]]

List of line items associated with this invoice

id: str

Unique identifier for the line item

amount: str

Amount in smallest currency unit (represented as string for bigint)

currency_code: Literal["ADA", "BTC", "DAI", 176 more]

Currency code (ISO 4217 or crypto)

Accepts one of the following:
"ADA"
"BTC"
"DAI"
"ETH"
"SOL"
"USDC"
"USDT"
"USDG"
"EURC"
"CADC"
"CADT"
"XLM"
"UNI"
"BCH"
"LTC"
"AAVE"
"LINK"
"MATIC"
"PTS"
"AED"
"AFN"
"ALL"
"AMD"
"ANG"
"AOA"
"ARS"
"AUD"
"AWG"
"AZN"
"BAM"
"BBD"
"BDT"
"BGN"
"BHD"
"BIF"
"BMD"
"BND"
"BOB"
"BRL"
"BSD"
"BTN"
"BWP"
"BYR"
"BZD"
"CAD"
"CDF"
"CHF"
"CLP"
"CNY"
"COP"
"CRC"
"CUC"
"CUP"
"CVE"
"CZK"
"DJF"
"DKK"
"DOP"
"DZD"
"EGP"
"ERN"
"ETB"
"EUR"
"FJD"
"FKP"
"GBP"
"GEL"
"GGP"
"GHS"
"GIP"
"GMD"
"GNF"
"GTQ"
"GYD"
"HKD"
"HNL"
"HRK"
"HTG"
"HUF"
"IDR"
"ILS"
"IMP"
"INR"
"IQD"
"IRR"
"ISK"
"JMD"
"JOD"
"JPY"
"KES"
"KGS"
"KHR"
"KMF"
"KPW"
"KRW"
"KWD"
"KYD"
"KZT"
"LAK"
"LBP"
"LKR"
"LRD"
"LSL"
"LYD"
"MAD"
"MDL"
"MGA"
"MKD"
"MMK"
"MNT"
"MOP"
"MUR"
"MVR"
"MWK"
"MXN"
"MYR"
"MZN"
"NAD"
"NGN"
"NIO"
"NOK"
"NPR"
"NZD"
"OMR"
"PAB"
"PEN"
"PGK"
"PHP"
"PKR"
"PLN"
"PYG"
"QAR"
"RON"
"RSD"
"RUB"
"RWF"
"SAR"
"SBD"
"SCR"
"SDG"
"SEK"
"SGD"
"SHP"
"SLL"
"SOS"
"SPL"
"SRD"
"SVC"
"SYP"
"STN"
"SZL"
"THB"
"TJS"
"TMT"
"TND"
"TOP"
"TRY"
"TTD"
"TVD"
"TWD"
"TZS"
"UAH"
"UGX"
"USD"
"UYU"
"UZS"
"VEF"
"VND"
"VUV"
"WST"
"XAF"
"XCD"
"XOF"
"XPF"
"YER"
"ZAR"
"ZMW"
"LOGICAL"
"CUSTOM"
description: str

Description of the line item

product_id: str

ID of the product/catalog item

type: Literal["payin", "payout"]

The type of the line item

Accepts one of the following:
"payin"
"payout"
user_id: str

External ID of the user associated with this line item

modified: Optional[datetime]

ISO 8601 timestamp when the invoice was last modified

formatdate-time

List History

from fragment import Fragment

client = Fragment()
response = client.invoices.list_history(
    "inv_1234567890",
)
print(response.data)
{
  "data": [
    {
      "id": "inv_1234567890",
      "created": "2024-01-13T00:00:00Z",
      "status": "active",
      "version": 1,
      "workspaceId": "ws_1234567890",
      "diff": [
        {
          "item": {
            "id": "item_1234567890",
            "amount": "1000",
            "currencyCode": "USD",
            "description": "Professional services for January 2026",
            "product_id": "prod_1234567890",
            "type": "payout",
            "user_id": "user_ext_456"
          },
          "op": "add"
        }
      ],
      "lineItems": [
        {
          "id": "item_1234567890",
          "amount": "1000",
          "currencyCode": "USD",
          "description": "Professional services for January 2026",
          "product_id": "prod_1234567890",
          "type": "payout",
          "user_id": "user_ext_456"
        }
      ],
      "modified": "2024-01-13T00:00:00Z"
    }
  ]
}
Returns Examples
{
  "data": [
    {
      "id": "inv_1234567890",
      "created": "2024-01-13T00:00:00Z",
      "status": "active",
      "version": 1,
      "workspaceId": "ws_1234567890",
      "diff": [
        {
          "item": {
            "id": "item_1234567890",
            "amount": "1000",
            "currencyCode": "USD",
            "description": "Professional services for January 2026",
            "product_id": "prod_1234567890",
            "type": "payout",
            "user_id": "user_ext_456"
          },
          "op": "add"
        }
      ],
      "lineItems": [
        {
          "id": "item_1234567890",
          "amount": "1000",
          "currencyCode": "USD",
          "description": "Professional services for January 2026",
          "product_id": "prod_1234567890",
          "type": "payout",
          "user_id": "user_ext_456"
        }
      ],
      "modified": "2024-01-13T00:00:00Z"
    }
  ]
}