Accounts

Download schema

The DigitalOcean accounts connected to the team. Projects, resources, usage, invoices and alerts all belong to an account.

List accounts

GET

https://bill.do/api/v1

/accounts

OpenID Connect

Bearer (ctp_*)

Bearer (ctt_*)

List the DigitalOcean accounts connected to the team by name. Any Bill.DO read scope grants access.

List accounts › query Parameters

per_page

integer · min: 1 · max: 100

Number of results per page.

Default: 50

page

integer · min: 1

Page number to return.

Default: 1

List accounts › Responses

Paginated set of Account

Account[] · required

object · required

GET/accounts

curl https://bill.do/api/v1/accounts \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "data": [
    {
      "id": 42,
      "name": "Acme production",
      "digitalocean": {
        "team_id": "0f6c3a6e-6f3e-4d6c-9c0b-1f2e3d4c5b6a",
        "team_name": "Acme",
        "url": "url"
      },
      "connected": true,
      "imported_at": "imported_at",
      "invoiced_up_to": "invoiced_up_to",
      "stats": {
        "hourly": 0,
        "month_to_date": 0,
        "month_predicted": 0,
        "next_month_predicted": 0
      },
      "created_at": "created_at"
    }
  ],
  "links": {
    "first": "first",
    "last": "last",
    "prev": "prev",
    "next": "next"
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 1,
    "links": [
      {
        "url": "url",
        "label": "label",
        "active": true
      }
    ],
    "path": "path",
    "per_page": 0,
    "to": 1,
    "total": 0
  }
}

json

application/json

Get an account

GET

https://bill.do/api/v1

/accounts/{account}

OpenID Connect

Bearer (ctp_*)

Bearer (ctt_*)

Get one of the DigitalOcean accounts connected to the team. Any Bill.DO read scope grants access.

Get an account › path Parameters

account

integer · required

Get an account › Responses

Account

Account · required

Team Usage