Get your account

get https://api.linode.com/{apiVersion}/account

Returns the contact and billing information related to your account.

linode-cli account view


Learn more...

account:read_only


Learn more...

Responses

Response body

object

active_promotions

array of objects

active_promotions

object

credit_monthly_cap

string

The amount available to spend per month.

credit_remaining

string

The total amount of credit left for this promotion.

description

string

A detailed description of this promotion.

expire_dt

string

When this promotion's credits expire.

image_url

string

The location of an image for this promotion.

service_type

string

The service to which this promotion applies.

all backup blockstorage db_mysql ip_v4 linode linode_disk linode_memory longview managed nodebalancer objectstorage placement_group transfer_tx

summary

string

Short details of this promotion.

this_month_credit_remaining

string

The amount of credit left for this month for this promotion.

active_since

date-time

Read-only The date and time the account was activated.

address_1

string

length ≤ 64

The first line of this account's billing address.

address_2

string

length ≤ 64

The second line of this account's billing address.

balance

number

Read-only This account's balance, in US dollars.

balance_uninvoiced

number

Read-only This account's current estimated invoice in US dollars. This is not your final invoice balance. Transfer charges are not included in the estimate.

billing_source

string

Read-only The source of service charges for this account. Accounts that are associated with Akamai-specific customers return a value of akamai. All other accounts return a value of linode.

akamai linode

capabilities

array of strings

Read-only The Akamai Cloud Computing services your account supports.

capabilities

city

string

length ≤ 24

The city for this account's address.

company

string

length ≤ 128

The company name assigned to this account. This value can't include the characters, < > ( ) " =.

country

string

The two-letter ISO 3166 country code for this account's address.

credit_card

object

Read-only The credit card information assigned to this account.

expiry

string

The expiration month and year of the credit_card.

last_four

string

The last four digits of the credit_card assigned to this account.

string

length ≤ 128

The email address of the person assigned to this account.

euuid

string

Read-only An external unique identifier for this account.

first_name

string

length ≤ 50

The first name of the person assigned to this account. This value can't include the characters, < > ( ) " =.

last_name

string

length ≤ 50

The last name of the person assigned to this account. This value can't include the characters, < > ( ) " =.

phone

string

length ≤ 32

The phone number assigned to this account.

state

string

length ≤ 24

The state or province for the address set for your account, if applicable.

If the address is in the United States (US) or Canada (CA), this is the two-letter ISO 3166 code for the state or province.
If it's a US military address, this is the abbreviation for that territory. This includes AA for Armed Forces Americas (excluding Canada), AE for Armed Forces Africa, Europe, Middle East, and Canada, or AP for Armed Forces Pacific.
If outside the US or CA, this is the province associated with the account's address.

tax_id

string

length ≤ 25

The tax identification number (TIN) assigned to this account, used for tax calculations. A TIN is set by the national authorities in your country, based on your address_1, and it may be named differently between countries. Set to an empty string ("") if a TIN doesn't apply or for countries that don't collect tax.

📘
This value is externally validated. If the validation is successful, a tax_id_valid event is triggered. If unsuccessful, a tax_id_invalid event is triggered and an error response is issued for an operation that included it.

zip

string

The zip code for this account's address.

It can only contain ASCII letters, numbers, and dashes (-).
It can't contain more than nine letter or number characters.

Language

Credentials


xxxxxxxxxx
1
curl --request GET \
2
     --url https://api.linode.com/v4/account \
3
     --header 'accept: application/json'


xxxxxxxxxx
43
}
1
{
2
  "active_promotions": [
3
    {
4
      "credit_monthly_cap": "10.00",
5
      "credit_remaining": "50.00",
6
      "description": "Receive up to $10 off your services every month for 6 months! Unused credits will expire once this promotion period ends.",
7
      "expire_dt": "2018-01-31T23:59:59",
8
      "image_url": "https://linode.com/10_a_month_promotion.svg",
9
      "service_type": "all",
10
      "summary": "$10 off your Linode a month!",
11
      "this_month_credit_remaining": "10.00"
12
    }
13
  ],
14
  "active_since": "2018-01-01T00:01:01",
15
  "address_1": "123 Main Street",
16
  "address_2": "Suite A",
17
  "balance": 200,
18
  "balance_uninvoiced": 145,
19
  "billing_source": "akamai",
20
  "capabilities": [
21
    "Linodes",
22
    "NodeBalancers",
23
    "Block Storage",
24
    "Object Storage",
25
    "Placement Groups",

200Returns a single account object.

📘

defaultSee Errors for the range of possible error response codes.