Account

Payments List

get
https://api.linode.com/v4/account/payments

Returns a paginated list of Payments made on this Account.

Query Parameters

page
integer > = 1
Default: 1

The page of a collection to return.

page_size
integer [25 .. 500]
Default: 100

The number of items to return per page.

Request Samples

curl -H "Authorization: Bearer $TOKEN" \
    https://api.linode.com/v4/account/payments

Response Samples

{
  "data": [
    {
      "id": "",
      "date": "2018-01-15T00:01:01",
      "usd": "120.50"
    }
  ],
  "page": 1,
  "pages": 1,
  "results": 1
}

Responses

200: Returns a paginated list of Payment objects.

data
array of objects
id
integer

The unique ID of the Payment.

date
string

When the Payment was made.

usd
integer

The amount, in US dollars, of the Payment.

page
integer

The current page.

pages
integer

The total number of pages.

results
integer

The total number of results.

default: Error

errors
array of objects
reason
string

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.

field
string

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.

Payment Make

post
https://api.linode.com/v4/account/payments

Makes a Payment to your Account.

  • The requested amount is charged to the default Payment Method if no payment_method_id is specified.

  • A payment_submitted event is generated when a payment is successfully submitted.

Request Body Schema

usd
Required
string ^\$?\d+\.\d{2}$

The amount in US Dollars of the Payment.

  • Can begin with or without $.
  • Commas (,) are not accepted.
  • Must end with a decimal expression, such as .00 or .99.
  • Minimum: $5.00 or the Account balance, whichever is lower.
  • Maximum: $2000.00 or the Account balance up to $50000.00, whichever is greater.
cvv
string

CVV (Card Verification Value) of the credit card to be used for the Payment. Required if paying by credit card.

payment_method_id
integer

The ID of the Payment Method to apply to the Payment.

Request Samples

curl -H "Content-Type: application/json" \
    -H "Authorization: Bearer $TOKEN" \
    -X POST -d '{
        "cvv": "123",
        "usd": "120.50",
        "payment_method_id": 123
    }' \
    https://api.linode.com/v4/account/payments

Response Samples

{
  "id": 1234,
  "date": "2018-01-15T00:01:01",
  "usd": 120.5
}

Responses

200: Payment submitted successfully.

id
integer

The unique ID of the Payment.

date
string <date-time>

When the Payment was made.

usd
integer

The amount, in US dollars, of the Payment.

default: Error

errors
array of objects
reason
string

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.

field
string

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.