Account
Account View
https://api.linode.com/v4/account
Returns the contact and billing information related to your Account.
Request Samples
- Shell
- CLI
curl -H "Authorization: Bearer $TOKEN" \
https://api.linode.com/v4/account
Response Samples
- 200
- default
{
"active_promotions": [
{
"credit_monthly_cap": "10.00",
"credit_remaining": "50.00",
"description": "Receive up to $10 off your services every month for 6 months! Unused credits will expire once this promotion period ends.",
"expire_dt": "2018-01-31T23:59:59",
"image_url": "https://linode.com/10_a_month_promotion.svg",
"summary": "$10 off your Linode a month!",
"this_month_credit_remaining": "10.00",
"service_type": "all"
}
],
"active_since": "2018-01-01T00:01:01",
"address_1": "123 Main Street",
"address_2": "Suite A",
"balance": 200,
"balance_uninvoiced": 145,
"billing_source": "akamai",
"capabilities": [],
"city": "Philadelphia",
"credit_card": {
"last_four": 1111,
"expiry": "11/2022"
},
"company": "Linode LLC",
"country": "US",
"email": "john.smith@linode.com",
"first_name": "John",
"last_name": "Smith",
"phone": "215-555-1212",
"state": "PA",
"tax_id": "ATU99999999",
"euuid": "E1AF5EEC-526F-487D-B317EBEB34C87D71",
"zip": "19102-1234"
}Responses
200: Returns a single Account object.
The amount available to spend per month.
The total amount of credit left for this promotion.
A detailed description of this promotion.
When this promotion's credits expire.
The location of an image for this promotion.
Short details of this promotion.
The amount of credit left for this month for this promotion.
The service to which this promotion applies.
The datetime of when the account was activated.
First line of this Account's billing address.
Second line of this Account's billing address.
This Account's balance, in US dollars.
This Account's current estimated invoice in US dollars. This is not your final invoice balance. Transfer charges are not included in the estimate.
The source of service charges for this Account, as determined by its relationship with Akamai.
Accounts that are associated with Akamai-specific customers return a value of akamai.
All other Accounts return a value of linode.
A list of capabilities your account supports.
The city for this Account's billing address.
Credit Card information associated with this Account.
The last four digits of the credit card associated with this Account.
The expiration month and year of the credit card.
The company name associated with this Account.
Must not include any of the following characters: < > ( ) " =
The two-letter ISO 3166 country code of this Account's billing address.
The email address of the person associated with this Account.
The first name of the person associated with this Account.
Must not include any of the following characters: < > ( ) " =
The last name of the person associated with this Account.
Must not include any of the following characters: < > ( ) " =
The phone number associated with this Account.
If billing address is in the United States (US) or Canada (CA), only the two-letter ISO 3166 State or Province code are accepted. If entering a US military address, state abbreviations (AA, AE, AP) should be entered. If the address is outside the US or CA, this is the Province associated with the Account's billing address.
The tax identification number associated with this Account, for tax calculations in some countries. If you do not live in a country that collects tax, this should be an empty string ("").
An external unique identifier for this account.
The zip code of this Account's billing address. The following restrictions apply:
- May only consist of letters, numbers, spaces, and hyphens.
- Must not contain more than 9 letter or number characters.
default: Error
What happened to cause this error. In most cases, this can be fixed immediately by changing the data you sent in the request, but in some cases you will be instructed to open a Support Ticket or perform some other action before you can complete the request successfully.
The field in the request that caused this error. This may be a path, separated by periods in the case of nested fields. In some cases this may come back as "null" if the error is not specific to any single element of the request.
Account Update
https://api.linode.com/v4/account
Updates contact and billing information related to your Account.
Request Body Schema
First line of this Account's billing address.
Second line of this Account's billing address.
The city for this Account's billing address.
The company name associated with this Account.
Must not include any of the following characters: < > ( ) " =
The two-letter ISO 3166 country code of this Account's billing address.
The email address of the person associated with this Account.
The first name of the person associated with this Account.
Must not include any of the following characters: < > ( ) " =
The last name of the person associated with this Account.
Must not include any of the following characters: < > ( ) " =
The phone number associated with this Account.
If billing address is in the United States (US) or Canada (CA), only the two-letter ISO 3166 State or Province code are accepted. If entering a US military address, state abbreviations (AA, AE, AP) should be entered. If the address is outside the US or CA, this is the Province associated with the Account's billing address.
The tax identification number associated with this Account, for tax calculations in some countries. If you do not live in a country that collects tax, this should be an empty string ("").
The zip code of this Account's billing address. The following restrictions apply:
- May only consist of letters, numbers, spaces, and hyphens.
- Must not contain more than 9 letter or number characters.
Request Samples
- Shell
- CLI
curl -H "Content-Type: application/json" \
-H "Authorization: Bearer $TOKEN" \
-X PUT -d '{
"address_1": "123 Main St.",
"address_2": "Suite 101",
"city": "Philadelphia",
"company": "My Company, LLC",
"country": "US",
"email": "jsmith@mycompany.com",
"first_name": "John",
"last_name": "Smith",
"phone": "555-555-1212",
"state": "PA",
"tax_id": "ATU99999999",
"zip": "19102"
}' \
https://api.linode.com/v4/account
Response Samples
- 200
- default
{
"active_promotions": [
{
"credit_monthly_cap": "10.00",
"credit_remaining": "50.00",
"description": "Receive up to $10 off your services every month for 6 months! Unused credits will expire once this promotion period ends.",
"expire_dt": "2018-01-31T23:59:59",
"image_url": "https://linode.com/10_a_month_promotion.svg",
"summary": "$10 off your Linode a month!",
"this_month_credit_remaining": "10.00",
"service_type": "all"
}
],
"active_since": "2018-01-01T00:01:01",
"address_1": "123 Main Street",
"address_2": "Suite A",
"balance": 200,
"balance_uninvoiced": 145,
"billing_source": "akamai",
"capabilities": [],
"city": "Philadelphia",
"credit_card": {
"last_four": 1111,
"expiry": "11/2022"
},
"company": "Linode LLC",
"country": "US",
"email": "john.smith@linode.com",
"first_name": "John",
"last_name": "Smith",
"phone": "215-555-1212",
"state": "PA",
"tax_id": "ATU99999999",
"euuid": "E1AF5EEC-526F-487D-B317EBEB34C87D71",
"zip": "19102-1234"
}Responses
200: The updated Account.
The amount available to spend per month.
The total amount of credit left for this promotion.
A detailed description of this promotion.
When this promotion's credits expire.
The location of an image for this promotion.
Short details of this promotion.
The amount of credit left for this month for this promotion.
The service to which this promotion applies.
The datetime of when the account was activated.
First line of this Account's billing address.
Second line of this Account's billing address.
This Account's balance, in US dollars.
This Account's current estimated invoice in US dollars. This is not your final invoice balance. Transfer charges are not included in the estimate.
The source of service charges for this Account, as determined by its relationship with Akamai.
Accounts that are associated with Akamai-specific customers return a value of akamai.
All other Accounts return a value of linode.
A list of capabilities your account supports.
The city for this Account's billing address.
Credit Card information associated with this Account.
The last four digits of the credit card associated with this Account.
The expiration month and year of the credit card.
The company name associated with this Account.
Must not include any of the following characters: < > ( ) " =
The two-letter ISO 3166 country code of this Account's billing address.
The email address of the person associated with this Account.
The first name of the person associated with this Account.
Must not include any of the following characters: < > ( ) " =
The last name of the person associated with this Account.
Must not include any of the following characters: < > ( ) " =
The phone number associated with this Account.
If billing address is in the United States (US) or Canada (CA), only the two-letter ISO 3166 State or Province code are accepted. If entering a US military address, state abbreviations (AA, AE, AP) should be entered. If the address is outside the US or CA, this is the Province associated with the Account's billing address.
The tax identification number associated with this Account, for tax calculations in some countries. If you do not live in a country that collects tax, this should be an empty string ("").
An external unique identifier for this account.
The zip code of this Account's billing address. The following restrictions apply:
- May only consist of letters, numbers, spaces, and hyphens.
- Must not contain more than 9 letter or number characters.
default: Error
What happened to cause this error. In most cases, this can be fixed immediately by changing the data you sent in the request, but in some cases you will be instructed to open a Support Ticket or perform some other action before you can complete the request successfully.
The field in the request that caused this error. This may be a path, separated by periods in the case of nested fields. In some cases this may come back as "null" if the error is not specific to any single element of the request.