List Subscriptions

client.Accounts.Subscriptions.Get(ctx, query) (*SinglePage[Subscription], error)

GET/accounts/{account_id}/subscriptions

Lists all of an account's subscriptions.

Security

API Token

The preferred authorization scheme for interacting with the Cloudflare API. Create a token.

Example:Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY

API Email + API Key

The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key.

Example:X-Auth-Email: user@example.com

The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys.

Example:X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194

Accepted Permissions (at least one required)

Billing WriteBilling Read

ParametersExpand Collapse

query SubscriptionGetParams

AccountID param.Field[string]

Identifier

maxLength32

ReturnsExpand Collapse

type Subscription struct{…}

ID stringoptional

Subscription identifier tag.

maxLength32

Currency stringoptional

The monetary unit in which pricing information is displayed.

CurrentPeriodEnd Timeoptional

The end of the current period and also when the next billing is due.

formatdate-time

CurrentPeriodStart Timeoptional

When the current billing period started. May match initial_period_start if this is the first period.

formatdate-time

Frequency SubscriptionFrequencyoptional

How often the subscription is renewed automatically.

One of the following:

const SubscriptionFrequencyWeekly SubscriptionFrequency = "weekly"

const SubscriptionFrequencyMonthly SubscriptionFrequency = "monthly"

const SubscriptionFrequencyQuarterly SubscriptionFrequency = "quarterly"

const SubscriptionFrequencyYearly SubscriptionFrequency = "yearly"

Price float64optional

The price of the subscription that will be billed, in US dollars.

RatePlan RatePlanoptional

The rate plan applied to the subscription.

ID RatePlanIDoptional

The ID of the rate plan.

One of the following:

const RatePlanIDFree RatePlanID = "free"

const RatePlanIDLite RatePlanID = "lite"

const RatePlanIDPro RatePlanID = "pro"

const RatePlanIDProPlus RatePlanID = "pro_plus"

const RatePlanIDBusiness RatePlanID = "business"

const RatePlanIDEnterprise RatePlanID = "enterprise"

const RatePlanIDPartnersFree RatePlanID = "partners_free"

const RatePlanIDPartnersPro RatePlanID = "partners_pro"

const RatePlanIDPartnersBusiness RatePlanID = "partners_business"

const RatePlanIDPartnersEnterprise RatePlanID = "partners_enterprise"

Currency stringoptional

The currency applied to the rate plan subscription.

ExternallyManaged booloptional

Whether this rate plan is managed externally from Cloudflare.

IsContract booloptional

Whether a rate plan is enterprise-based (or newly adopted term contract).

PublicName stringoptional

The full name of the rate plan.

Scope stringoptional

The scope that this rate plan applies to.

Sets []stringoptional

The list of sets this rate plan applies to. Returns array of strings.

State SubscriptionStateoptional

The state that the subscription is in.

One of the following:

const SubscriptionStateTrial SubscriptionState = "Trial"

const SubscriptionStateProvisioned SubscriptionState = "Provisioned"

const SubscriptionStatePaid SubscriptionState = "Paid"

const SubscriptionStateAwaitingPayment SubscriptionState = "AwaitingPayment"

const SubscriptionStateCancelled SubscriptionState = "Cancelled"

const SubscriptionStateFailed SubscriptionState = "Failed"

const SubscriptionStateExpired SubscriptionState = "Expired"

List Subscriptions

package main

import (
  "context"
  "fmt"

  "github.com/cloudflare/cloudflare-go"
  "github.com/cloudflare/cloudflare-go/accounts"
  "github.com/cloudflare/cloudflare-go/option"
)

func main() {
  client := cloudflare.NewClient(
    option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"),
  )
  page, err := client.Accounts.Subscriptions.Get(context.TODO(), accounts.SubscriptionGetParams{
    AccountID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"),
  })
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", page)
}

{
  "errors": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "messages": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "result": [
    {
      "id": "506e3185e9c882d175a2d0cb0093d9f2",
      "currency": "USD",
      "current_period_end": "2014-03-31T12:20:00Z",
      "current_period_start": "2014-05-11T12:20:00Z",
      "frequency": "monthly",
      "price": 20,
      "rate_plan": {
        "id": "free",
        "currency": "USD",
        "externally_managed": false,
        "is_contract": false,
        "public_name": "Business Plan",
        "scope": "zone",
        "sets": [
          "string"
        ]
      },
      "state": "Paid"
    }
  ],
  "success": true,
  "result_info": {
    "count": 1,
    "page": 1,
    "per_page": 20,
    "total_count": 2000
  }
}

Returns Examples

{
  "errors": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "messages": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "result": [
    {
      "id": "506e3185e9c882d175a2d0cb0093d9f2",
      "currency": "USD",
      "current_period_end": "2014-03-31T12:20:00Z",
      "current_period_start": "2014-05-11T12:20:00Z",
      "frequency": "monthly",
      "price": 20,
      "rate_plan": {
        "id": "free",
        "currency": "USD",
        "externally_managed": false,
        "is_contract": false,
        "public_name": "Business Plan",
        "scope": "zone",
        "sets": [
          "string"
        ]
      },
      "state": "Paid"
    }
  ],
  "success": true,
  "result_info": {
    "count": 1,
    "page": 1,
    "per_page": 20,
    "total_count": 2000
  }
}