Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Tackle.io Subscriptions API

Operations for Subscriptions

Tackle.io Subscriptions API is one of 28 APIs that Tackle.io publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Subscriptions. The published artifact set on APIs.io includes an OpenAPI specification and an API reference.

This API exposes 2 operations across 2 paths, and defines 44 schemas. It is described by OpenAPI 3.0.3, at version 1.0.0.

Requests are made against a single base URL, https://contracts.tackle.io.

2 operations 2 paths 44 schemas 2 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
1.0.0
Base URL
https://api.tackle.io
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Tackle.io Subscriptions API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (JWT) (tackleJwt). By default, every request must be authenticated.

  • tackleJwt — Tackle-issued JWT (interactive user or MTM token).

Paths & Operations 2

Across 2 paths, the API surfaces 2 operations — 2 GET. Each is listed below with its method, path, parameters, and response codes.

Subscriptions 2

Operations for Subscriptions

GET
/v1/subscriptions
List Subscriptions
v1-list-subscriptions 5 params → 200401
GET
/v1/subscriptions/{tackle_subscription_id}
Get a Subscription
v1-get-subscription 1 param → 200401404

Schemas 44

The contract defines 44 schemas that model the data the API accepts and returns. The most detailed are GcpEntitlement (17 properties), Subscription (13 properties), RedHatEntitlement (9 properties), AzureEntitlement (5 properties). Each schema is shown below with its type and property counts.

AwsProductId
string
AWS Product Code
AzureCustomerId
string
Azure Subscription ID
AwsMarketplaceData
object
Marketplace data specific to AWS
1 property
Subscription
object
13 properties 4 required
AzureProductId
string
Azure Offer ID
ListSubscriptionsResponse
object
Response describing data containing a list of subscriptions and additional response metadata
2 properties 2 required
SubscriptionLink
string
A URL for a given subscription resource
Entitlement
object
A purchase entitlement for a given cloud marketplace
RedHatProductId
string
Red Hat Product Id
Metadata
object
Metadata for a given request
1 property 1 required
GcpCustomerId
string
GCP External Account ID
AzureEntitlement
object
A purchase entitlement from Azure Marketplace
5 properties 5 required
GcpEntitlement
object
A purchase entitlement from GCP Marketplace
17 properties 5 required
Error
object
4 properties 3 required
RedHatCustomerId
string
Red Hat Customer Id
SubscriptionExpanded
RedHatSubscriptionRenewType
string
Renew Type
OfferId
string
The AWS issued offer ID, Seller created Azure Plan ID, or the GCP issued Quote ID
TimestampZeroUtcOffset
string
ISO format timestamp with zero UTC offset
ProductId
Cloud Marketplace issued ID for a product
AwsCloud
string
AWS Cloud
RedHatEntitlement
object
A purchase entitlement from Red Hat Marketplace
9 properties 9 required
AwsEntitlement
object
A purchase entitlement from AWS Marketplace
4 properties 4 required
Entitlements
array
A list of Entitlement objects
TimestampZeroUtcOffsetOptional
string
Optional ISO format timestamp with zero UTC offset
AzureCloud
string
Azure Cloud
SubscriptionItem
object
1 property
SubscriptionContracted
RedHatCloud
string
Red Hat Cloud
IsFreeTrial
boolean
Designation for Free Trial
RedHatSubscriptionType
string
Type of the subscription
AwsCustomerId
string
AWS Account Reference ID
RedHatTermUnit
string
The unit for the term
GetSubscriptionResponse
object
Response describing data containing a single subscription and other metadata
2 properties 2 required
RegistrationDetails
object
Registration details of a purchaser that map to defined registration page fields for a given listing. The following fields are required at a minimum: - Company…
3 properties 3 required
Clouds
A string identifying a cloud marketplace
SubscriptionId
string
Subscription Id
SubscriptionDetails
object
3 properties
CustomerId
GcpCloud
string
GCP Cloud
OtherMarketplaceData
object
GCP, Azure, and Red Hat do not currently have marketplace specific data
GcpProductId
string
GCP Solution ID
MarketplaceData
The marketplace data object contains fields specific to the marketplaces
ProductLink
string
A URL for a given product resource

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

tackleio-subscriptions-api-openapi.yml Raw ↑

Other APIs Tackle.io publishes across the network.

Tackle.io Authentication API
Tackle.io Contracts API
Tackle.io Currencies API
Tackle.io Customers API
Tackle.io Disbursements API
Tackle.io Entitlements API
Tackle.io Groups API
Tackle.io Invitations API
Tackle.io Invoices API
Tackle.io Marketplace API
Tackle.io Metering API
Tackle.io Notifications API