---
title: Get Unpaid Invoices
---

[Skip to content](#%5Ftop) 

[API Reference](https://developers.cloudflare.com/api/go)

[Billing](https://developers.cloudflare.com/api/go/resources/billing)

[Unpaid Invoice](https://developers.cloudflare.com/api/go/resources/billing/subresources/unpaid%5Finvoice)

Copy Markdown

Open in **Claude**

Open in **ChatGPT**

Open in **Cursor**

---

**Copy Markdown**

**View as Markdown**

# Get Unpaid Invoices

client.Billing.UnpaidInvoice.Get(ctx, query) (\*[UnpaidInvoiceGetResponse](https://developers.cloudflare.com/api/go/resources/billing#%28resource%29%20billing.unpaid%5Finvoice%20%3E%20%28model%29%20UnpaidInvoiceGetResponse%20%3E%20%28schema%29), error)

GET/accounts/{account\_id}/billing/unpaid-invoice

Gets unpaid invoice information for an account.

##### Security

API Token

The preferred authorization scheme for interacting with the Cloudflare API. [Create a token](https://developers.cloudflare.com/fundamentals/api/get-started/create-token/).

**Example:**`Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY`

API Email + API Key

The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key.

**Example:**`X-Auth-Email: user@example.com`

The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys.

**Example:**`X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194`

##### ParametersExpand Collapse 

query UnpaidInvoiceGetParams

AccountID param.Field\[string\]

Identifier

maxLength32

##### ReturnsExpand Collapse 

type UnpaidInvoiceGetResponse struct{…}

Invoices \[\]UnpaidInvoiceGetResponseInvoiceOptional

List of unpaid invoices.

ID stringOptional

Billing history item identifier.

Action stringOptional

The billing item action.

Amount float64Optional

The amount associated with this billing item.

AmountToPay float64Optional

The amount remaining to pay.

Currency stringOptional

The currency of the billing item.

Description stringOptional

The billing item description.

ExternalInvoiceID stringOptional

The external invoice identifier.

HostedInvoiceURL stringOptional

URL to the hosted invoice.

InvoiceID stringOptional

The associated invoice identifier.

OccurredAt TimeOptional

When the billing event occurred.

formatdate-time

ReceiptID stringOptional

The associated receipt identifier.

Source stringOptional

The source of the billing item.

SourceInvoiceID stringOptional

The source invoice identifier.

Status stringOptional

The status of the billing item.

Type stringOptional

The billing item type.

### Get Unpaid Invoices

Go

HTTPHTTP

TypeScriptTypeScript

PythonPython

GoGo

TerraformTerraform

```
package main

import (
  "context"
  "fmt"

  "github.com/cloudflare/cloudflare-go"
  "github.com/cloudflare/cloudflare-go/billing"
  "github.com/cloudflare/cloudflare-go/option"
)

func main() {
  client := cloudflare.NewClient(
    option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"),
  )
  unpaidInvoice, err := client.Billing.UnpaidInvoice.Get(context.TODO(), billing.UnpaidInvoiceGetParams{
    AccountID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"),
  })
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", unpaidInvoice.Invoices)
}

```

200 example

```
{
  "errors": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "messages": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "result": {
    "invoices": [
      {
        "id": "b69a9f3492637782896352daae219e7d",
        "action": "subscription",
        "amount": 20.99,
        "amount_to_pay": 0,
        "currency": "USD",
        "description": "The billing item description",
        "external_invoice_id": "external_invoice_id",
        "hosted_invoice_url": "hosted_invoice_url",
        "invoice_id": "invoice_id",
        "occurred_at": "2014-03-01T12:21:59.3456Z",
        "receipt_id": "receipt_id",
        "source": "source",
        "source_invoice_id": "source_invoice_id",
        "status": "status",
        "type": "charge"
      }
    ]
  },
  "success": true
}
```

##### Returns Examples

200 example

```
{
  "errors": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "messages": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "result": {
    "invoices": [
      {
        "id": "b69a9f3492637782896352daae219e7d",
        "action": "subscription",
        "amount": 20.99,
        "amount_to_pay": 0,
        "currency": "USD",
        "description": "The billing item description",
        "external_invoice_id": "external_invoice_id",
        "hosted_invoice_url": "hosted_invoice_url",
        "invoice_id": "invoice_id",
        "occurred_at": "2014-03-01T12:21:59.3456Z",
        "receipt_id": "receipt_id",
        "source": "source",
        "source_invoice_id": "source_invoice_id",
        "status": "status",
        "type": "charge"
      }
    ]
  },
  "success": true
}
```