List Invoices

GET

entities

{entity_id}

invoices

curl --request GET \
  --url https://api.prime.coinbase.com/v1/entities/{entity_id}/invoices

{
  "invoices": [
    {
      "id": "<string>",
      "billing_month": 123,
      "billing_year": 123,
      "due_date": "<string>",
      "invoice_number": "<string>",
      "state": "INVOICE_STATE_UNSPECIFIED",
      "usd_amount_paid": 123,
      "usd_amount_owed": 123,
      "invoice_items": [
        {
          "description": "<string>",
          "currency_symbol": "<string>",
          "invoice_type": "INVOICE_TYPE_UNSPECIFIED",
          "rate": 123,
          "quantity": 123,
          "price": 123,
          "average_auc": 123,
          "total": 123
        }
      ]
    }
  ]
}

Use the Prime SDK or CLI to test this endpoint by following the quickstart guide and running with the following examples

InvoiceService invoiceService = PrimeServiceFactory.createInvoiceService(client);

ListInvoicesRequest request = new ListInvoicesRequest.Builder("ENTITY_ID_HERE").build();

ListInvoicesResponse response = invoiceService.listInvoices(request);

For more information, please visit the Prime Java SDK.

InvoiceService invoiceService = PrimeServiceFactory.createInvoiceService(client);

ListInvoicesRequest request = new ListInvoicesRequest.Builder("ENTITY_ID_HERE").build();

ListInvoicesResponse response = invoiceService.listInvoices(request);

For more information, please visit the Prime Java SDK.

var invoiceService = new InvoiceService(client);

var request = new ListInvoicesRequest("ENTITY_ID_HERE");

var response = invoiceService.ListInvoices(request);

For more information, please visit the Prime .NET SDK.

invoiceService := invoice.NewInvoiceService(client)

request := &invoice.ListInvoicesRequest{
    EntityId: "ENTITY_ID_HERE",
}

response, err := invoiceService.ListInvoices(context.Background(), request)

For more information, please visit the Prime Go SDK.

prime_client = PrimeClient(credentials)

request = ListInvoicesRequest(
    entity_id="ENTITY_ID_HERE",
)

response = prime_client.list_invoices(request)

For more information, please visit the Prime Python SDK.

primectl list-invoices --help

For more information, please visit the Prime CLI.

const invoicesService = new InvoicesService(client);

invoicesService.listInvoices({
    entityId: 'ENTITY_ID_HERE'
}).then(async (response) => {
    console.log('Invoices: ', response);
})

For more information, please visit the Prime TS SDK.

Path Parameters

entity_id

string

required

The entity ID

Query Parameters

states

enum<string>[]

Invoice states to filter the response

billing_year

integer

Filter invoices by year

billing_month

integer

Integer representing the month to filter by, 1 for January, 12 for December

cursor

integer

Cursor used for pagination (last consumed record)

limit

integer

Number of items to retrieve

Response

200

application/json

A successful response.

The response is of type object.

Set Auto Sweep

Create Onchain Address Book Entry

curl --request GET \
  --url https://api.prime.coinbase.com/v1/entities/{entity_id}/invoices

{
  "invoices": [
    {
      "id": "<string>",
      "billing_month": 123,
      "billing_year": 123,
      "due_date": "<string>",
      "invoice_number": "<string>",
      "state": "INVOICE_STATE_UNSPECIFIED",
      "usd_amount_paid": 123,
      "usd_amount_owed": 123,
      "invoice_items": [
        {
          "description": "<string>",
          "currency_symbol": "<string>",
          "invoice_type": "INVOICE_TYPE_UNSPECIFIED",
          "rate": 123,
          "quantity": 123,
          "price": 123,
          "average_auc": 123,
          "total": 123
        }
      ]
    }
  ]
}

REST API

FIX API

Websocket Feed

Path Parameters

Query Parameters

Response