---
title: Get Account Billing History
---

[Skip to content](#%5Ftop) 

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

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

[History](https://developers.cloudflare.com/api/go/resources/billing/subresources/history)

Copy Markdown

Open in **Claude**

Open in **ChatGPT**

Open in **Cursor**

---

**Copy Markdown**

**View as Markdown**

# Get Account Billing History

client.Billing.History.List(ctx, params) (\*V4PagePaginationArray\[[HistoryListResponse](https://developers.cloudflare.com/api/go/resources/billing#%28resource%29%20billing.history%20%3E%20%28model%29%20HistoryListResponse%20%3E%20%28schema%29)\], error)

GET/accounts/{account\_id}/billing/history

Gets the billing history 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`

##### Accepted Permissions (at least one required)

`Billing Write` `Billing Read`

##### ParametersExpand Collapse 

params HistoryListParams

AccountID param.Field\[string\]

Path param: Identifier

maxLength32

Page param.Field\[int64\]Optional

Query param: Page number of paginated results.

minimum1

PerPage param.Field\[int64\]Optional

Query param: Number of items per page.

minimum1

Status param.Field\[string\]Optional

Query param: Filter billing history by status.

##### ReturnsExpand Collapse 

type HistoryListResponse struct{…}

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 Account Billing History

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"),
  )
  page, err := client.Billing.History.List(context.TODO(), billing.HistoryListParams{
    AccountID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"),
  })
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", page)
}

```

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": [
    {
      "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,
  "result_info": {
    "count": 1,
    "page": 1,
    "per_page": 20,
    "total_count": 2000
  }
}
```

##### 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": [
    {
      "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,
  "result_info": {
    "count": 1,
    "page": 1,
    "per_page": 20,
    "total_count": 2000
  }
}
```