> For the complete documentation index, see [llms.txt](https://docs.txn.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.txn.io/invoices/listing-invoices.md).

# Listing invoices

<mark style="color:green;">`GET`</mark> `/api/public/v1/invoices`

Returns your invoices, newest first, with pagination. Filter by `reference` to find the invoice for one of your orders, or by `created_at_from` and `created_at_to` for a period. Each entry carries the same attributes as [Reading invoice](https://docs.txn.io/invoices/reading-invoice.md), including `status`, `paymentStatus` and `statusContext`.

**Headers**

| Name          | Value                      |
| ------------- | -------------------------- |
| Content-Type  | `application/vnd.api+json` |
| Authorization | `Bearer <api_key>`         |

**URL Parameters**

<table><thead><tr><th width="164.692626953125">Name</th><th width="142.010009765625">Type</th><th>Description</th></tr></thead><tbody><tr><td>order</td><td>string</td><td>Field to order the list of invoices by. Currently the only supported value is <code>created_at</code>.</td></tr><tr><td>order_type</td><td>string</td><td>Order type. Can be either <code>asc</code> or <code>desc</code>.</td></tr><tr><td>page</td><td>number</td><td>Page for which you want to return invoices.</td></tr><tr><td>per_page</td><td>number</td><td>Number of invoices per page to return.</td></tr><tr><td>reference</td><td>string</td><td>Invoice <code>reference</code>.</td></tr><tr><td>created_at_from</td><td>string</td><td>Return invoices created at or after this ISO 8601 timestamp, e.g. <code>2024-06-18T15:49:02.031Z</code>.</td></tr><tr><td>created_at_to</td><td>string</td><td>Return invoices created at or before this ISO 8601 timestamp, e.g. <code>2024-06-18T15:49:02.031Z</code>.</td></tr></tbody></table>

**cURL**

```bash
curl -G "https://api.sandbox.txn.io/api/public/v1/invoices" \
     -H 'Content-Type: application/vnd.api+json' \
     -H 'Authorization: Bearer <api_key>' \
     --data-urlencode 'created_at_from=2026-10-01T00:00:00Z' \
     --data-urlencode 'created_at_to=2026-11-01T00:00:00Z' \
     --data-urlencode 'per_page=100' \
     --data-urlencode 'page=1'
```

**Response Body**

<table><thead><tr><th>Name</th><th width="97">Type</th><th>Description</th></tr></thead><tbody><tr><td>data[].id</td><td>string</td><td>Invoice ID.</td></tr><tr><td>data[].type</td><td>string</td><td>Entity type returned. Always <code>invoices</code>.</td></tr><tr><td>data[].attributes</td><td>object</td><td>Set of invoice attributes.</td></tr><tr><td>data[].attributes.amountBilled</td><td>string</td><td>Invoice amount to display to end users. Determines the amount due after conversion.</td></tr><tr><td>data[].attributes.amountCharged</td><td>string</td><td>Amount due. Determines the amount of cryptocurrency the end-user is required to pay.</td></tr><tr><td>data[].attributes.targetAmount</td><td>string</td><td>Amount you will receive into your target currency account.</td></tr><tr><td>data[].attributes.billedCurrency</td><td>string</td><td>Invoice currency to display to end users. Determines the currency due after conversion. Refer to <a href="https://docs.txn.io/api-basics/supported-currencies.md">supported</a> currencies.</td></tr><tr><td>data[].attributes.chargedCurrency</td><td>string</td><td>Cryptocurrency that the customer must pay in. Refer to <a href="https://docs.txn.io/api-basics/supported-currencies.md">supported</a> currencies.</td></tr><tr><td>data[].attributes.targetCurrency</td><td>string</td><td>Settlement currency. This is the currency you will receive in your account after the payment is processed.</td></tr><tr><td>data[].attributes.chargedTargetRate</td><td>string</td><td>Charged currency to target currency exchange rate.</td></tr><tr><td>data[].attributes.chargedTargetRateCurrency</td><td>string</td><td>Currency in which <code>chargedTargetRate</code> is quoted.</td></tr><tr><td>data[].attributes.reference</td><td>string</td><td>The custom reference ID to tie the invoice to end-user who pays. This can be anything you choose.</td></tr><tr><td>data[].attributes.statusContext</td><td>string</td><td>Indicates whether the end-user paid in <code>full</code>, <code>underpaid</code>, <code>overpaid</code>, or has not paid (<code>unpaid</code>) the invoice. Refer to <a href="https://docs.txn.io/invoices/invoice-status-flow.md">Invoice status flow</a>.</td></tr><tr><td>data[].attributes.network</td><td>string</td><td>Network code. Refer to <a href="https://docs.txn.io/api-basics/supported-currencies.md">Supported currencies</a>.</td></tr><tr><td>data[].attributes.networkName</td><td>string</td><td>Network name to display.</td></tr><tr><td>data[].attributes.paymentMethods</td><td>array</td><td>Invoice payment methods.</td></tr><tr><td>data[].attributes.status</td><td>string</td><td>Invoice status. Refer to <a href="https://docs.txn.io/invoices/invoice-status-flow.md">Invoice status flow</a>.</td></tr><tr><td>data[].attributes.successRedirectUrl</td><td>string</td><td>URL your customer will be redirected from our hosted page to if the invoice completes.</td></tr><tr><td>data[].attributes.unsuccessRedirectUrl</td><td>string</td><td>URL your customer will be redirected from our hosted page to if the invoice gets expired, cancelled or rejected.</td></tr><tr><td>data[].attributes.paymentStatus</td><td>string</td><td>Invoice payment status. Refer to <a href="https://docs.txn.io/invoices/invoice-status-flow.md">Invoice status flow</a>.</td></tr><tr><td>data[].attributes.exchangeRate</td><td>string</td><td>Invoice exchange rate valid for 20 minutes.</td></tr><tr><td>data[].attributes.expiresAt</td><td>string</td><td>Invoice expiry date and time.</td></tr><tr><td>data[].attributes.createdAt</td><td>string</td><td>Date and time invoice was created at.</td></tr><tr><td>data[].attributes.hostedPageUrl</td><td>string</td><td>Invoice hosted page.</td></tr><tr><td>data[].attributes.scAddress</td><td>string</td><td>Smart contract address for the NFT payment feature. <code>null</code> when not enabled.</td></tr><tr><td>data[].relationships.targetAccount</td><td>object</td><td>The settlement account the invoice is credited to. <code>data.type</code> is <code>accounts</code>; the account entity is returned in <code>included[]</code>.</td></tr><tr><td>data[].relationships.address</td><td>object</td><td>The invoice receiving address. <code>data.type</code> is <code>addresses</code>; the entity is returned in <code>included[]</code>.</td></tr><tr><td>data[].relationships.binanceOrder</td><td>object</td><td>Binance Pay order for the invoice. <code>data.type</code> is <code>binanceOrders</code>; the entity is returned in <code>included[]</code>. <code>data</code> is <code>null</code> unless <code>paymentMethods</code> includes <code>binance_pay</code>.</td></tr><tr><td>data[].relationships.invoiceTransactions</td><td>array</td><td>The settlement record of the invoice. One entry, created with the invoice; <code>data[].type</code> is <code>invoiceTransactions</code>. The entity is returned in <code>included[]</code>.</td></tr><tr><td>data[].relationships.coinDeposits</td><td>array</td><td>On-chain payments received at the invoice address; <code>data[].type</code> is <code>coinDeposits</code>. Empty until a payment is detected, more than one entry when the end user paid in several transfers. The entities are returned in <code>included[]</code>.</td></tr><tr><td>data[].relationships.refundLinks</td><td>array</td><td>Refund links created for this invoice; <code>data[].type</code> is <code>paymentLinks</code>. Empty unless a payment was refunded. The entities are returned in <code>included[]</code>; see <a href="https://docs.txn.io/invoices/invoice-refunds.md">Invoice refunds</a> for their fields.</td></tr><tr><td>included[].type(addresses)</td><td>object</td><td>The receiving address of the invoice (<code>data[].relationships.address</code>).</td></tr><tr><td>included[].type(addresses).attributes.value</td><td>string</td><td>The address the end user must send the payment to. For XRP the destination tag is appended as <code>?dt=&#x3C;tag></code>; display both parts, see the <a href="https://docs.txn.io/invoices/invoice-integration-guide.md">invoice integration guide</a>.</td></tr><tr><td>included[].type(addresses).attributes.label</td><td>string</td><td>Address label. For invoice addresses this is the network name, e.g. <code>Tron (TRC20)</code>.</td></tr><tr><td>included[].type(addresses).attributes.createdAt</td><td>string</td><td>When the address was created. Invoice addresses are allocated from a pool, so this can predate the invoice.</td></tr><tr><td>included[].type(addresses).relationships</td><td>object</td><td><code>account</code> and <code>network</code>: not expanded (<code>meta.included</code> is <code>false</code>); use <code>data[].attributes.network</code> and <code>data[].attributes.networkName</code>.</td></tr><tr><td>included[].type(binanceOrders)</td><td>object</td><td>Binance Pay payment instructions. Present only when <code>paymentMethods</code> includes <code>binance_pay</code>.</td></tr><tr><td>included[].type(binanceOrders).attributes.deeplink</td><td>string</td><td>Link that opens the Binance app directly on a mobile device.</td></tr><tr><td>included[].type(binanceOrders).attributes.universalUrl</td><td>string</td><td>Link that works in both web and mobile browsers. Use it when you cannot tell the device type.</td></tr><tr><td>included[].type(binanceOrders).attributes.qrcodeLink</td><td>string</td><td>URL of a hosted QR code image to display.</td></tr><tr><td>included[].type(binanceOrders).attributes.qrContent</td><td>string</td><td>The content encoded in the QR code. Use it to render your own QR code.</td></tr><tr><td>included[].type(accounts)</td><td>object</td><td>The target account (<code>data[].relationships.targetAccount</code>). Same fields as <a href="https://docs.txn.io/accounts/reading-account.md">Reading account</a>; the ones most relevant here are listed below.</td></tr><tr><td>included[].type(accounts).attributes.currencyCode</td><td>string</td><td>Account currency. Equals <code>data[].attributes.targetCurrency</code>.</td></tr><tr><td>included[].type(accounts).attributes.label</td><td>string</td><td>Account label.</td></tr><tr><td>included[].type(accounts).attributes.master</td><td>boolean</td><td><code>true</code> for the master account, <code>false</code> for a subaccount.</td></tr><tr><td>included[].type(accounts).attributes.balance</td><td>string</td><td>Account balance at the time of the request.</td></tr><tr><td>included[].type(accounts).attributes.currencyType</td><td>string</td><td><code>fiat</code> or <code>crypto</code>.</td></tr><tr><td>included[].type(accounts).relationships</td><td>object</td><td><code>company</code>, <code>networks</code> and <code>txnBankCredentials</code>: not expanded (<code>meta.included</code> is <code>false</code>).</td></tr><tr><td>included[].type(coinDeposits)</td><td>object</td><td>An on-chain payment received at the invoice address. One entry per transfer.</td></tr><tr><td>included[].type(coinDeposits).attributes.txHash</td><td>string</td><td>Transaction hash on the network.</td></tr><tr><td>included[].type(coinDeposits).attributes.amount</td><td>string</td><td>Amount received, in <code>currencyCode</code>.</td></tr><tr><td>included[].type(coinDeposits).attributes.currencyCode</td><td>string</td><td>Equals <code>data[].attributes.chargedCurrency</code>.</td></tr><tr><td>included[].type(coinDeposits).attributes.createdAt</td><td>string</td><td>When Txn detected the transfer.</td></tr><tr><td>included[].type(coinDeposits).attributes.simplifiedState</td><td>string</td><td>Deposit status; <code>processed</code> once the payment has been applied to the invoice. A payment to an invoice address does not move an account balance by itself: the credit is the <code>transactions</code> entity. See <a href="https://docs.txn.io/transactions/listing-transactions.md#transaction-statuses">Transaction statuses</a>.</td></tr><tr><td>included[].type(coinDeposits).attributes.state</td><td>string</td><td>Internal Txn state. Ignore this field and use <code>simplifiedState</code>.</td></tr><tr><td>included[].type(coinDeposits).attributes.reference</td><td>string</td><td>The invoice <code>reference</code>.</td></tr><tr><td>included[].type(coinDeposits).attributes.accountId</td><td>string</td><td>ID of the crypto account (in <code>chargedCurrency</code>) that holds the invoice address. Not the target account.</td></tr><tr><td>included[].type(coinDeposits).attributes.sourceAddresses</td><td>array</td><td>Wallet address(es) the funds were sent from. Typically a single address; may contain multiple entries when the deposit arrived via a UTXO-based network (BTC, LTC, BCH, DOGE, etc.) and the sender's wallet combined several inputs.</td></tr><tr><td>included[].type(coinDeposits).attributes.riskScore</td><td>string</td><td>Risk score for the deposit's source address from on-chain analytics screening, when available. <code>null</code> if no score was returned.</td></tr><tr><td>included[].type(coinDeposits).attributes.clusterCategory</td><td>string</td><td>Category of the entity the source address is attributed to by on-chain analytics, e.g. <code>Exchange</code>. <code>null</code> until screening completes.</td></tr><tr><td>included[].type(coinDeposits).attributes.clusterName</td><td>string</td><td>Name of the entity the source address is attributed to. <code>null</code> until screening completes.</td></tr><tr><td>included[].type(coinDeposits).relationships</td><td>object</td><td><code>network</code>, <code>address</code> and <code>author</code>: not expanded (<code>meta.included</code> is <code>false</code>).</td></tr><tr><td>included[].type(invoiceTransactions)</td><td>object</td><td>The settlement record of the invoice: the amounts settled and the fees charged. Created with the invoice and updated when the payment is applied. Its <code>id</code> equals the <code>id</code> of the related <code>transactions</code> entity.</td></tr><tr><td>included[].type(invoiceTransactions).attributes.amountBilled</td><td>string</td><td>The actual payment amount in <code>billedCurrency</code>, reflecting what the end-user's crypto payment converted to. Use this field to credit the end-user's balance on your platform. In a full payment it equals the original invoice amount; for underpayments and overpayments, Txn applies the spot exchange rate to the crypto actually received, so this value will differ. Pre-fee — see <code>transactionFee</code> and <code>targetTransactionFee</code> for the fee breakdown.</td></tr><tr><td>included[].type(invoiceTransactions).attributes.billedChargedRate</td><td>string</td><td>Rate used to convert <code>billedCurrency</code> into <code>chargedCurrency</code>, including your spread. Same value as <code>data[].attributes.exchangeRate</code>.</td></tr><tr><td>included[].type(invoiceTransactions).attributes.billedChargedRateCurrency</td><td>string</td><td>Currency the rate is quoted in. Equals <code>billedCurrency</code>.</td></tr><tr><td>included[].type(invoiceTransactions).attributes.transactionFee</td><td>string</td><td>Txn processing fee in <code>transactionFeeCurrency</code>: <code>amountBilled</code> multiplied by your invoice fee percentage, subject to the minimum fee configured for your account.</td></tr><tr><td>included[].type(invoiceTransactions).attributes.transactionFeeCurrency</td><td>string</td><td>Equals <code>billedCurrency</code>.</td></tr><tr><td>included[].type(invoiceTransactions).attributes.consolidationFee</td><td>string</td><td>Network fee for consolidating the received funds from the invoice address, quoted in <code>billedCurrency</code>. <code>0.00</code> when your account is not charged consolidation fees.</td></tr><tr><td>included[].type(invoiceTransactions).attributes.targetTransactionFee</td><td>string</td><td><code>transactionFee</code> converted into <code>targetCurrency</code>. This is the amount deducted from what is credited to the target account.</td></tr><tr><td>included[].type(invoiceTransactions).attributes.targetTransactionFeeCurrency</td><td>string</td><td>Equals <code>targetCurrency</code>.</td></tr><tr><td>included[].type(invoiceTransactions).attributes.simplifiedState</td><td>string</td><td>Status of the settlement on the target account: <code>pending</code> until a payment is applied (it stays <code>pending</code> for invoices that expire or are cancelled unpaid), <code>on_hold</code> while a received payment is under review, <code>completed</code> once credited, <code>cancelled</code> when a received payment was rejected. Same value as the related <code>transactions</code> entity. See <a href="https://docs.txn.io/transactions/listing-transactions.md#transaction-statuses">Transaction statuses</a>.</td></tr><tr><td>included[].type(invoiceTransactions).relationships.txn</td><td>object</td><td>The account transaction crediting the target account. <code>data.type</code> is <code>transactions</code>; the entity is returned in <code>included[]</code>.</td></tr><tr><td>included[].type(invoiceTransactions).relationships.exchangeQuote</td><td>object</td><td>The conversion of the received crypto into <code>targetCurrency</code>. <code>data.type</code> is <code>exchangeQuotes</code>; the entity is returned in <code>included[]</code>. <code>data</code> is <code>null</code> until the invoice completes, and stays <code>null</code> when <code>chargedCurrency</code> equals <code>targetCurrency</code>.</td></tr><tr><td>included[].type(invoiceTransactions).relationships.author</td><td>object</td><td>The API key that created the invoice. <code>data.type</code> is <code>apiKeys</code>; the entity is returned in <code>included[]</code>. <code>data</code> is <code>null</code> for invoices created in the dashboard. Not expanded in webhook payloads.</td></tr><tr><td>included[].type(invoiceTransactions).relationships</td><td>object</td><td><code>account</code> and <code>invoice</code>: not expanded (<code>meta.included</code> is <code>false</code>).</td></tr><tr><td>included[].type(transactions)</td><td>object</td><td>The balance movement on the target account for this invoice, in the shape returned by <a href="https://docs.txn.io/transactions/listing-transactions.md">Listing transactions</a>. Its <code>id</code> equals the <code>invoiceTransactions</code> id.</td></tr><tr><td>included[].type(transactions).attributes.amount</td><td>string</td><td>Amount credited to the target account in <code>currency</code>, net of fees. Equals <code>data[].attributes.targetAmount</code> until a payment is applied and is then set to the settled amount, so it differs from <code>targetAmount</code> on underpayment and overpayment.</td></tr><tr><td>included[].type(transactions).attributes.currency</td><td>string</td><td>Equals <code>data[].attributes.targetCurrency</code>.</td></tr><tr><td>included[].type(transactions).attributes.simplifiedState</td><td>string</td><td>Same value as <code>included[].type(invoiceTransactions).attributes.simplifiedState</code>.</td></tr><tr><td>included[].type(transactions).attributes.transactionType</td><td>string</td><td>Always <code>InvoiceTransaction</code>.</td></tr><tr><td>included[].type(transactions).attributes.balance</td><td>string</td><td>Always <code>null</code> here. The running balance is only computed by the transaction listings.</td></tr><tr><td>included[].type(transactions).attributes.reference</td><td>string</td><td>The invoice <code>reference</code>.</td></tr><tr><td>included[].type(transactions).attributes.accountId</td><td>string</td><td>ID of the target account.</td></tr><tr><td>included[].type(transactions).attributes.createdAt</td><td>string</td><td>When the invoice was created.</td></tr><tr><td>included[].type(transactions).relationships</td><td>object</td><td><code>account</code>, <code>transactionDetails</code> and <code>author</code>: not expanded (<code>meta.included</code> is <code>false</code>).</td></tr><tr><td>included[].type(exchangeQuotes)</td><td>object</td><td>The conversion of the received crypto into <code>targetCurrency</code>, in the shape returned by <a href="https://docs.txn.io/exchange/reading-quote.md">Reading quote</a>. Created when the invoice completes; absent when <code>chargedCurrency</code> equals <code>targetCurrency</code>.</td></tr><tr><td>included[].type(exchangeQuotes).attributes.amountCharged</td><td>string</td><td>Crypto amount converted, in <code>amountChargedCurrency</code>: the received payment.</td></tr><tr><td>included[].type(exchangeQuotes).attributes.amountChargedCurrency</td><td>string</td><td>Equals <code>chargedCurrency</code>.</td></tr><tr><td>included[].type(exchangeQuotes).attributes.amountReceived</td><td>string</td><td>Resulting amount in <code>amountReceivedCurrency</code>, before the Txn processing fee. The <code>transactions</code> amount is this value minus <code>targetTransactionFee</code>.</td></tr><tr><td>included[].type(exchangeQuotes).attributes.amountReceivedCurrency</td><td>string</td><td>Equals <code>targetCurrency</code>.</td></tr><tr><td>included[].type(exchangeQuotes).attributes.rate</td><td>string</td><td>Rate applied, including your spread, quoted in <code>rateCurrency</code>.</td></tr><tr><td>included[].type(exchangeQuotes).attributes.rateCurrency</td><td>string</td><td>Currency the rate is quoted in.</td></tr><tr><td>included[].type(exchangeQuotes).attributes.exchangeFee</td><td>string</td><td>Always <code>0.00</code> for invoice conversions; the invoice fee is charged as <code>transactionFee</code> instead.</td></tr><tr><td>included[].type(exchangeQuotes).attributes.exchangeFeeCurrency</td><td>string</td><td>Currency of <code>exchangeFee</code>.</td></tr><tr><td>included[].type(exchangeQuotes).attributes.status</td><td>string</td><td>Always <code>completed</code> here.</td></tr><tr><td>included[].type(exchangeQuotes).attributes.accountChargedId</td><td>string</td><td>ID of the crypto account the payment was received on. Same as <code>included[].type(coinDeposits).attributes.accountId</code>.</td></tr><tr><td>included[].type(exchangeQuotes).attributes.accountReceivedId</td><td>string</td><td>ID of the target account.</td></tr><tr><td>included[].type(exchangeQuotes).attributes.expiresAt</td><td>string</td><td>Quote expiry. Informational only: the quote is executed as soon as it is created.</td></tr><tr><td>included[].type(exchangeQuotes).relationships</td><td>object</td><td><code>exchangeOrder</code>, <code>transactions</code>, <code>author</code>, <code>accountCharged</code> and <code>accountReceived</code>: not expanded (<code>meta.included</code> is <code>false</code>).</td></tr><tr><td>included[].type(apiKeys)</td><td>object</td><td>The API key that created the invoice (<code>included[].type(invoiceTransactions).relationships.author</code>). Not present in webhook payloads.</td></tr><tr><td>included[].type(apiKeys).attributes.name</td><td>string</td><td>Name of the API key, as set when it was created.</td></tr><tr><td>included[].type(apiKeys).attributes.createdAt</td><td>string</td><td>When the API key was created.</td></tr><tr><td>meta.page</td><td>number</td><td>Current page number.</td></tr><tr><td>meta.per_page</td><td>number</td><td>Page size used for the response.</td></tr><tr><td>meta.total</td><td>number</td><td>Total number of invoices matching the query.</td></tr></tbody></table>

**Response**

{% tabs %}
{% tab title="HTTP 200" %}

```json
{
  "data": [
    {
      "id": "806f822f-7e7c-440e-bb2d-cba36e4ad6f2",
      "type": "invoices",
      "attributes": {
        "amountBilled": "33.00",
        "amountCharged": "33.365698",
        "targetAmount": "27.76",
        "billedCurrency": "USD",
        "chargedCurrency": "USDT",
        "targetCurrency": "EUR",
        "chargedTargetRate": "0.85512683728197",
        "chargedTargetRateCurrency": "EUR",
        "reference": "dd171c10-f246-4888-9759-ee39009745bf",
        "statusContext": "unpaid",
        "network": "ttrx:usdt",
        "networkName": "Tron (TRC20)",
        "paymentMethods": [
          "on_chain"
        ],
        "status": "cancelled",
        "successRedirectUrl": null,
        "unsuccessRedirectUrl": null,
        "paymentStatus": "expecting",
        "exchangeRate": "0.9890397",
        "expiresAt": "2026-01-19T10:07:54.355Z",
        "createdAt": "2026-01-19T07:07:54.483Z",
        "hostedPageUrl": "https://sandbox.txn.io/redirect?item_id=806f822f-7e7c-440e-bb2d-cba36e4ad6f2&request_type=item_hosted_page",
        "scAddress": null
      },
      "relationships": {
        "targetAccount": {
          "data": {
            "type": "accounts",
            "id": "adb0f9c4-c7fd-4989-a273-1bd11ad5847b"
          }
        },
        "binanceOrder": {
          "data": null
        },
        "address": {
          "data": {
            "type": "addresses",
            "id": "525d85d7-a0c5-47ad-a775-eb2a6375b706"
          }
        },
        "refundLinks": {
          "data": []
        },
        "invoiceTransactions": {
          "data": [
            {
              "type": "invoiceTransactions",
              "id": "307f4dc9-5395-4a7b-b78d-7484985f7166"
            }
          ]
        },
        "coinDeposits": {
          "data": []
        }
      }
    },
    {
      "id": "9506769e-295d-4d9e-b371-9995dc91fba0",
      "type": "invoices",
      "attributes": {
        "amountBilled": "1000.00",
        "amountCharged": "23.123807",
        "targetAmount": "22.33",
        "billedCurrency": "TRY",
        "chargedCurrency": "USDT",
        "targetCurrency": "USD",
        "chargedTargetRate": "0.99926",
        "chargedTargetRateCurrency": "USD",
        "reference": "edeaa162-3b95-4aa1-b800-b1efa24fbcb6",
        "statusContext": "unpaid",
        "network": "ttrx:usdt",
        "networkName": "Tron (TRC20)",
        "paymentMethods": [
          "on_chain"
        ],
        "status": "cancelled",
        "successRedirectUrl": null,
        "unsuccessRedirectUrl": null,
        "paymentStatus": "expecting",
        "exchangeRate": "43.24547465",
        "expiresAt": "2026-01-17T15:58:58.652Z",
        "createdAt": "2026-01-17T12:58:59.186Z",
        "hostedPageUrl": "https://sandbox.txn.io/redirect?item_id=9506769e-295d-4d9e-b371-9995dc91fba0&request_type=item_hosted_page",
        "scAddress": null
      },
      "relationships": {
        "targetAccount": {
          "data": {
            "type": "accounts",
            "id": "80b8dd61-35bc-49cc-9e04-f2c0f741a096"
          }
        },
        "binanceOrder": {
          "data": null
        },
        "address": {
          "data": {
            "type": "addresses",
            "id": "f83db4c7-b86c-4b45-8009-2c9d042eac1d"
          }
        },
        "refundLinks": {
          "data": []
        },
        "invoiceTransactions": {
          "data": [
            {
              "type": "invoiceTransactions",
              "id": "7f044fef-f685-4a11-9fac-da5d962ade97"
            }
          ]
        },
        "coinDeposits": {
          "data": []
        }
      }
    }
  ],
  "included": [
    {
      "id": "adb0f9c4-c7fd-4989-a273-1bd11ad5847b",
      "type": "accounts",
      "attributes": {
        "master": false,
        "currencyCode": "EUR",
        "label": "EUR_4",
        "bankReference": "BDR0154632342411086",
        "balance": "31.63",
        "totalBalance": "31.63",
        "bankWithdrawalAvailable": true,
        "bankDepositAvailable": true,
        "transferAvailable": true,
        "currencyType": "fiat"
      },
      "relationships": {
        "company": {
          "meta": {
            "included": false
          }
        },
        "networks": {
          "meta": {
            "included": false
          }
        }
      }
    },
    {
      "id": "525d85d7-a0c5-47ad-a775-eb2a6375b706",
      "type": "addresses",
      "attributes": {
        "label": "Tron (TRC20)",
        "value": "TDa95SveS24fbYATjn59jYdXNAxgpHdvbZ",
        "createdAt": "2026-01-13T07:13:30.951Z"
      },
      "relationships": {
        "account": {
          "meta": {
            "included": false
          }
        },
        "network": {
          "meta": {
            "included": false
          }
        }
      }
    },
    {
      "id": "307f4dc9-5395-4a7b-b78d-7484985f7166",
      "type": "invoiceTransactions",
      "attributes": {
        "amountBilled": "33.00",
        "billedChargedRate": "0.9890397",
        "billedChargedRateCurrency": "USD",
        "consolidationFee": "0.56",
        "transactionFee": "0.33",
        "transactionFeeCurrency": "USD",
        "targetTransactionFee": "0.29",
        "targetTransactionFeeCurrency": "EUR",
        "simplifiedState": "pending"
      },
      "relationships": {
        "txn": {
          "data": {
            "type": "transactions",
            "id": "307f4dc9-5395-4a7b-b78d-7484985f7166"
          }
        },
        "exchangeQuote": {
          "data": null
        },
        "account": {
          "meta": {
            "included": false
          }
        },
        "invoice": {
          "meta": {
            "included": false
          }
        },
        "author": {
          "data": {
            "type": "apiKeys",
            "id": "9c4b8ebd-ae0b-4812-a97b-92d8359fd1e0"
          }
        }
      }
    },
    {
      "id": "80b8dd61-35bc-49cc-9e04-f2c0f741a096",
      "type": "accounts",
      "attributes": {
        "master": true,
        "currencyCode": "USD",
        "label": "master",
        "bankReference": "BDR3455470827278341",
        "balance": "3614.05",
        "totalBalance": "3839.43",
        "bankWithdrawalAvailable": false,
        "bankDepositAvailable": true,
        "transferAvailable": true,
        "currencyType": "fiat"
      },
      "relationships": {
        "company": {
          "meta": {
            "included": false
          }
        },
        "networks": {
          "meta": {
            "included": false
          }
        }
      }
    },
    {
      "id": "f83db4c7-b86c-4b45-8009-2c9d042eac1d",
      "type": "addresses",
      "attributes": {
        "label": "Tron (TRC20)",
        "value": "TXXnCyP46NcyH5aiM9LDx9him1kbWYJJmQ",
        "createdAt": "2026-01-12T18:04:40.953Z"
      },
      "relationships": {
        "account": {
          "meta": {
            "included": false
          }
        },
        "network": {
          "meta": {
            "included": false
          }
        }
      }
    },
    {
      "id": "7f044fef-f685-4a11-9fac-da5d962ade97",
      "type": "invoiceTransactions",
      "attributes": {
        "amountBilled": "1000.00",
        "billedChargedRate": "43.24547465",
        "billedChargedRateCurrency": "TRY",
        "consolidationFee": "23.73",
        "transactionFee": "10.00",
        "transactionFeeCurrency": "TRY",
        "targetTransactionFee": "0.23",
        "targetTransactionFeeCurrency": "USD",
        "simplifiedState": "pending"
      },
      "relationships": {
        "txn": {
          "data": {
            "type": "transactions",
            "id": "7f044fef-f685-4a11-9fac-da5d962ade97"
          }
        },
        "exchangeQuote": {
          "data": null
        },
        "account": {
          "meta": {
            "included": false
          }
        },
        "invoice": {
          "meta": {
            "included": false
          }
        },
        "author": {
          "data": {
            "type": "apiKeys",
            "id": "b56961f4-46cf-4e60-bb32-b36addb09f66"
          }
        }
      }
    },
    {
      "id": "307f4dc9-5395-4a7b-b78d-7484985f7166",
      "type": "transactions",
      "attributes": {
        "createdAt": "2026-01-19T07:07:54.527Z",
        "simplifiedState": "pending",
        "transactionType": "InvoiceTransaction",
        "amount": "27.76",
        "currency": "EUR",
        "balance": null,
        "reference": "dd171c10-f246-4888-9759-ee39009745bf",
        "accountId": "adb0f9c4-c7fd-4989-a273-1bd11ad5847b"
      },
      "relationships": {
        "account": {
          "meta": {
            "included": false
          }
        },
        "transactionDetails": {
          "meta": {
            "included": false
          }
        },
        "author": {
          "meta": {
            "included": false
          }
        }
      }
    },
    {
      "id": "9c4b8ebd-ae0b-4812-a97b-92d8359fd1e0",
      "type": "apiKeys",
      "attributes": {
        "name": "My API Key",
        "createdAt": "2025-07-04T08:07:13.549Z"
      }
    },
    {
      "id": "7f044fef-f685-4a11-9fac-da5d962ade97",
      "type": "transactions",
      "attributes": {
        "createdAt": "2026-01-17T12:58:59.293Z",
        "simplifiedState": "pending",
        "transactionType": "InvoiceTransaction",
        "amount": "22.33",
        "currency": "USD",
        "balance": null,
        "reference": "edeaa162-3b95-4aa1-b800-b1efa24fbcb6",
        "accountId": "80b8dd61-35bc-49cc-9e04-f2c0f741a096"
      },
      "relationships": {
        "account": {
          "meta": {
            "included": false
          }
        },
        "transactionDetails": {
          "meta": {
            "included": false
          }
        },
        "author": {
          "meta": {
            "included": false
          }
        }
      }
    },
    {
      "id": "9c4b8ebd-ae0b-4812-a97b-92d8359fd1e0",
      "type": "apiKeys",
      "attributes": {
        "name": "My API Key",
        "createdAt": "2025-07-04T08:07:13.549Z"
      }
    },
    {
      "id": "b56961f4-46cf-4e60-bb32-b36addb09f66",
      "type": "apiKeys",
      "attributes": {
        "name": "Test API key",
        "createdAt": "2024-06-17T19:41:33.398Z"
      }
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 2,
    "total": 4637
  },
  "jsonapi": {
    "version": "1.0"
  }
}
```

{% endtab %}
{% endtabs %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.txn.io/invoices/listing-invoices.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
