Get Offering

Get offering

GET/v2/subscriptions/offerings/{offering_uuid}

Use it in a workflow

Add a step and choose the Elastic Path connector.
Pick the Get Offering action (under Subscriptions).
Fill in the fields below, then reference the result from later steps as {{getOffering.response.data}}.

Request

Path parameters

offering_uuidstring (uuid)required

The unique identifier of the offering.

Query parameters

includearray<string>

A comma-separated list of resources to include. See [Characteristics of Include Parameter](/guides/Getting-Started/includes#characteristics-of-include-parameter).

Response

Returns 200 with an object. Read it in later steps with {{getOffering.response.data.<field>}}.

dataobject

idstring (uuid)

The unique identifier.

typestringrequired

One ofsubscription_offering

attributesanyrequired

relationshipsany

Relationships are established between different subscription entities. For example, a plan and a pricing option are related to an offering, as both are attached to it.

metaobjectrequired3 fields

includedobject

featuresarray<object>5 fields

plansarray<object>5 fields

pricing_optionsarray<object>5 fields

json

{
  "data": {
    "type": "subscription_offering",
    "attributes": null,
    "meta": {
      "external_plan_refs": [
        "97dddc65-eabd-45d8-b45b-2ece5cfc8c50"
      ],
      "owner": "store",
      "timestamps": {
        "updated_at": "2017-01-10T11:41:19.244842Z",
        "created_at": "2017-01-10T11:41:19.244842Z"
      }
    },
    "id": "11111111-2222-3333-4444-555555555555",
    "relationships": {
      "pricing-options": {
        "links": {
          "related": "/offerings/:offering-id/pricing-options",
          "self": "/offerings/:offering-id"
        },
        "data": {
          "type": "offering-pricing-option",
          "id": "625fe958-7b4b-40a0-a2c0-dbb8f31eec0d"
        }
      }
    }
  },
  "included": {
    "features": [
      {
        "type": "subscription_offering_feature",
        "attributes": null,
        "meta": {
          "owner": "store",
          "timestamps": {
            "updated_at": "2017-01-10T11:41:19.244842Z",
            "created_at": "2017-01-10T11:41:19.244842Z"
          }
        },
        "id": "11111111-2222-3333-4444-555555555555",
        "relationships": {
          "pricing-options": {
            "links": {
              "related": "/offerings/:offering-id/pricing-options",
              "self": "/offerings/:offering-id"
            },
            "data": {
              "type": "offering-pricing-option",
              "id": "625fe958-7b4b-40a0-a2c0-dbb8f31eec0d"
            }
          }
        }
      }
    ],
    "plans": [
      {
        "type": "subscription_offering_plan",
        "attributes": null,
        "meta": {
          "owner": "store",
          "timestamps": {
            "updated_at": "2017-01-10T11:41:19.244842Z",
            "created_at": "2017-01-10T11:41:19.244842Z"
          },
          "prices": {},
          "display_price": {
            "without_tax": {
              "amount": 100,
              "currency": "USD",
              "formatted": "$1.00"
            },
            "with_tax": {
              "amount": 110,
              "currency": "USD",
              "formatted": "$1.10"
            },
            "tax": {
              "amount": 10,
              "currency": "USD",
              "formatted": "$0.10"
            }
          },
          "active_plan": true
        },
        "id": "11111111-2222-3333-4444-555555555555",
        "relationships": {
          "pricing-options": {
            "links": {
              "related": "/offerings/:offering-id/pricing-options",
              "self": "/offerings/:offering-id"
            },
            "data": {
              "type": "offering-pricing-option",
              "id": "625fe958-7b4b-40a0-a2c0-dbb8f31eec0d"
            }
          }
        }
      }
    ],
    "pricing_options": [
      {
        "type": "subscription_offering_pricing_option",
        "attributes": null,
        "meta": {
          "owner": "store",
          "timestamps": {
            "updated_at": "2017-01-10T11:41:19.244842Z",
            "created_at": "2017-01-10T11:41:19.244842Z"
          },
          "prices": {},
          "price": {
            "USD": {
              "type": "object",
              "description": "(schema truncated: exceeded maximum nesting depth)"
            },
            "GBP": {
              "type": "object",
              "description": "(schema truncated: exceeded maximum nesting depth)"
            }
          },
          "display_price": {
            "without_tax": {
              "amount": 100,
              "currency": "USD",
              "formatted": "$1.00"
            },
            "with_tax": {
              "amount": 110,
              "currency": "USD",
              "formatted": "$1.10"
            },
            "tax": {
              "amount": 10,
              "currency": "USD",
              "formatted": "$0.10"
            }
          },
          "active_pricing_option": true
        },
        "id": "11111111-2222-3333-4444-555555555555",
        "relationships": {
          "pricing-options": {
            "links": {
              "related": "/offerings/:offering-id/pricing-options",
              "self": "/offerings/:offering-id"
            },
            "data": {
              "type": "offering-pricing-option",
              "id": "625fe958-7b4b-40a0-a2c0-dbb8f31eec0d"
            }
          }
        }
      }
    ]
  }
}

Need more? See the Elastic Path guide for connection setup and behaviour shared by every action.

Was this page helpful?