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 Marketplace API

AWS Marketplace context endpoints used to assemble offers and amendments.

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

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

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

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

4 operations 4 paths 9 schemas 4 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, HTTP Basic, API Key, OAuth 2.0
Resource Areas
1

Authentication & Security 4

Tackle Marketplace API declares 4 security schemes for authenticating requests. It accepts HTTP bearer tokens (JWT) (BearerAuth). It accepts HTTP basic authentication (BasicAuthCallback). An API key is passed in the header as subscription-key (HeaderApiKeyAuthCallback). It supports OAuth 2.0 (Oauth2AuthCallback) using the clientCredentials flow.

  • BearerAuth — The Tackle API requires a JWT for authentication. You can get this by [getting your API credentials](https://developers.tackle.io/docs/how-to-get-an-m2m-client…
  • BasicAuthCallback — Use basic for [basic HTTP authentication](https://en.wikipedia.org/wiki/Basicaccessauthentication); this is only used for callbacks
  • HeaderApiKeyAuthCallback — Use headerapikey to specify a custom HTTP request header for authentication. Requests from Tackle will use the specified HTTP header for outbound requests to y…
  • Oauth2AuthCallback — This auth-type is for oauth2 client credentials flow. We will use the clientid and clientsecret to call the tokenurl to get an access token; this is only used…

Paths & Operations 4

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

Marketplace 4

AWS Marketplace context endpoints used to assemble offers and amendments.

GET
/agreements
List AWS Marketplace Agreements
listAgreements 4 params → 200400401403
GET
/products
List Products
listProducts 3 params → 200401403
GET
/products/{productId}/pricing
Get Product Pricing
getProductPricing 1 param → 200401403404
GET
/allowed-currencies
List Allowed Currencies
listAllowedCurrencies → 200401403

Schemas 9

The contract defines 9 schemas that model the data the API accepts and returns. The most detailed are ProductPricing (19 properties), Product (10 properties), Agreement (9 properties), PricingDimension (6 properties). Each schema is shown below with its type and property counts.

PricingDimension
object
6 properties
UsageDimension
object
4 properties
ScheduledPayment
object
2 properties
AgreementList
object
Paginated list of agreements.
3 properties 1 required
Agreement
object
A marketplace agreement (entitlement) between a seller and a buyer for a product. For AWS this maps to an AWS Marketplace Agreement.
9 properties 8 required
PricingUnit
object
AMI-only pricing unit.
3 properties
ProductPricing
object
Pricing dimensions, billing term defaults, and payment model defaults for an AWS Marketplace product. Use the response to pre-populate a private-offer creation…
19 properties
Error
object
Error response. Endpoints in the Private Offers and Marketplace tags return the error in a message field. The Partners endpoint returns the error in an error f…
2 properties
Product
object
An AWS Marketplace product owned by the calling seller. The fields below are the most commonly consumed; additional listing-type-specific fields may also be pr…
10 properties 5 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

tackle-marketplace-api-openapi.yml Raw ↑

Other APIs Tackle publishes across the network.

Tackle Authentication API
Tackle Contracts API
Tackle Currencies API
Tackle Disbursements API
Tackle Entitlements API
Tackle Groups API
Tackle Invitations API
Tackle Invoices API
Tackle Metering API
Tackle Notifications API
Tackle Opportunities API
Tackle Partners API