Environment:

List Products

get /products

⚠ This functionality is only available to Providers.

Returns a list of your products that is offered to users on the Marketplace. The products are returned sorted by creation date, with the most recently created products appearing first.

Authentication

API Key ApiKey

order_sort

string

category

An enumeration.

name

string

page

integer

Default
0

size

integer

Default
50

Responses

Response: application/json

items

array[object (TppProduct)]

required

TppProduct

object (TppProduct)

Example
{ "description": "Unlimited usage, 66Mb average download speed*", "enabled": 1, "meta": { "affiliate_link": "https://www.awin1.com/cread.php?awinmid=4260&awinaffid=774713&clickref=John+Lewis+Broadband&ued=https%3A%2F%2Fwww.johnlewisbroadband.com%2F", "product_activation_fee": "£0", "product_av_download_speed": "66mb/s", "product_billing_freq": "monthly", "product_cashback_offer": "Free e-gift card worth up to £75 with John Lewis Broadband", "product_contract_length": "12 months", "product_description_long": "There’s no usage limit, so you can stream music and watch films while your other devices work away in the background. Fibre Extra is the next generation of internet connectivity, able to support your whole family as well as any Wi-Fi enabled devices at the same time, to make sure your connected home runs smoothly.", "product_price": "£29" }, "name": "Fibre Extra", "product_type": "utilities_broadband" }

created

string

date-time

required

description

string

enabled

boolean

expiration_date

string

date-time

external_key

string

id

string

required

meta

Any Of

object

TppProductBroadbandMeta

object (TppProductBroadbandMeta)

Example
{ "affiliate_link": "https://www.awin1.com/cread.php?awinmid=4260&awinaffid=774713&clickref=John+Lewis+Broadband&ued=https%3A%2F%2Fwww.johnlewisbroadband.com%2F", "product_activation_fee": "£0", "product_av_download_speed": "66mb/s", "product_billing_freq": "monthly", "product_cashback_offer": "Free e-gift card worth up to £75 with John Lewis Broadband", "product_contract_length": "12 months", "product_description_long": "There’s no usage limit, so you can stream music and watch films while your other devices work away in the background. Fibre Extra is the next generation of internet connectivity, able to support your whole family as well as any Wi-Fi enabled devices at the same time, to make sure your connected home runs smoothly.", "product_price": "£29", "thinkbroadband_key": "avail_retail_plusnet" }

affiliate_link

string

required

business

string

credit

string

download_limit

string

required

effective_first_year_cost

number

effective_full_contract_cost

number

effective_monthly_cost

number

external_short_name

string

extras_text

string

required

free_calls

string

required

full_contract_cost

number

has_broadband

boolean

landline

boolean

required

original_monthly_cost

number

original_monthly_cost_text

string

original_setup_fee

number

outlink

string

phone_number

string

phone_text

string

required

plus_vat

string

postage_cost

string

required

product_activation_fee

number

product_av_download_speed

string

product_av_upload_speed

string

product_billing_freq

string

product_cashback_offer

string

product_contract_length

int

product_cpa

string

product_cta

string

product_description_long

string

product_description_short

string

product_offer_expiry

string

product_offer_length

string

product_offer_start

string

product_offer_text

string

product_price

number

rating

number

student

int

supplier_image

string

switch_type

string

tv

boolean

required

tv_bundles

array[object (HomeboxTvBundle)]

required

HomeboxTvBundle

object (HomeboxTvBundle)

name

string

required

tv_channels

array[object (HomeboxTvChannel)]

required

HomeboxTvChannel

object (HomeboxTvChannel)

logo

string

required

name

string

required

tv_icon_text

string

required

tv_package_description

string

required

tv_package_image

string

required

tv_text

string

required

tv_total_channels

string

required

name

string

required

prices

array[object (TppProductPrice)]

TppProductPrice

object (TppProductPrice)

amount

int

required

currency

string

required

description

string

id

string

required

meta

object (meta)

name

string

required

prod_id

string

required

recurring_meta

object (recurring_meta)

tpp_id

string

required

type

An enumeration.

product_type

required

An enumeration.

tpp_id

string

required

updated

string

date-time

required

page

integer

required

size

int

required

total

integer

required

Response: application/json

detail

array[object (ValidationError)]

ValidationError

object (ValidationError)

loc

array[Any Of]

required

Any Of

string

int

msg

string

required

type

string

required

Create A New Product

post /products

Create a new product for your company

Authentication

API Key ApiKey

application/json

description

string

enabled

boolean

expiration_date

string

date-time

external_key

string

meta

Any Of

object

TppProductBroadbandMeta

object (TppProductBroadbandMeta)

Example
{ "affiliate_link": "https://www.awin1.com/cread.php?awinmid=4260&awinaffid=774713&clickref=John+Lewis+Broadband&ued=https%3A%2F%2Fwww.johnlewisbroadband.com%2F", "product_activation_fee": "£0", "product_av_download_speed": "66mb/s", "product_billing_freq": "monthly", "product_cashback_offer": "Free e-gift card worth up to £75 with John Lewis Broadband", "product_contract_length": "12 months", "product_description_long": "There’s no usage limit, so you can stream music and watch films while your other devices work away in the background. Fibre Extra is the next generation of internet connectivity, able to support your whole family as well as any Wi-Fi enabled devices at the same time, to make sure your connected home runs smoothly.", "product_price": "£29", "thinkbroadband_key": "avail_retail_plusnet" }

affiliate_link

string

required

business

string

credit

string

download_limit

string

required

effective_first_year_cost

number

effective_full_contract_cost

number

effective_monthly_cost

number

external_short_name

string

extras_text

string

required

free_calls

string

required

full_contract_cost

number

has_broadband

boolean

landline

boolean

required

original_monthly_cost

number

original_monthly_cost_text

string

original_setup_fee

number

outlink

string

phone_number

string

phone_text

string

required

plus_vat

string

postage_cost

string

required

product_activation_fee

number

product_av_download_speed

string

product_av_upload_speed

string

product_billing_freq

string

product_cashback_offer

string

product_contract_length

int

product_cpa

string

product_cta

string

product_description_long

string

product_description_short

string

product_offer_expiry

string

product_offer_length

string

product_offer_start

string

product_offer_text

string

product_price

number

rating

number

student

int

supplier_image

string

switch_type

string

tv

boolean

required

tv_bundles

array[object (HomeboxTvBundle)]

required

HomeboxTvBundle

object (HomeboxTvBundle)

name

string

required

tv_channels

array[object (HomeboxTvChannel)]

required

HomeboxTvChannel

object (HomeboxTvChannel)

logo

string

required

name

string

required

tv_icon_text

string

required

tv_package_description

string

required

tv_package_image

string

required

tv_text

string

required

tv_total_channels

string

required

name

string

required

product_type

required

An enumeration.

Responses

Response: application/json

created

string

date-time

required

description

string

enabled

boolean

expiration_date

string

date-time

external_key

string

id

string

required

meta

Any Of

object

TppProductBroadbandMeta

object (TppProductBroadbandMeta)

Example
{ "affiliate_link": "https://www.awin1.com/cread.php?awinmid=4260&awinaffid=774713&clickref=John+Lewis+Broadband&ued=https%3A%2F%2Fwww.johnlewisbroadband.com%2F", "product_activation_fee": "£0", "product_av_download_speed": "66mb/s", "product_billing_freq": "monthly", "product_cashback_offer": "Free e-gift card worth up to £75 with John Lewis Broadband", "product_contract_length": "12 months", "product_description_long": "There’s no usage limit, so you can stream music and watch films while your other devices work away in the background. Fibre Extra is the next generation of internet connectivity, able to support your whole family as well as any Wi-Fi enabled devices at the same time, to make sure your connected home runs smoothly.", "product_price": "£29", "thinkbroadband_key": "avail_retail_plusnet" }

affiliate_link

string

required

business

string

credit

string

download_limit

string

required

effective_first_year_cost

number

effective_full_contract_cost

number

effective_monthly_cost

number

external_short_name

string

extras_text

string

required

free_calls

string

required

full_contract_cost

number

has_broadband

boolean

landline

boolean

required

original_monthly_cost

number

original_monthly_cost_text

string

original_setup_fee

number

outlink

string

phone_number

string

phone_text

string

required

plus_vat

string

postage_cost

string

required

product_activation_fee

number

product_av_download_speed

string

product_av_upload_speed

string

product_billing_freq

string

product_cashback_offer

string

product_contract_length

int

product_cpa

string

product_cta

string

product_description_long

string

product_description_short

string

product_offer_expiry

string

product_offer_length

string

product_offer_start

string

product_offer_text

string

product_price

number

rating

number

student

int

supplier_image

string

switch_type

string

tv

boolean

required

tv_bundles

array[object (HomeboxTvBundle)]

required

HomeboxTvBundle

object (HomeboxTvBundle)

name

string

required

tv_channels

array[object (HomeboxTvChannel)]

required

HomeboxTvChannel

object (HomeboxTvChannel)

logo

string

required

name

string

required

tv_icon_text

string

required

tv_package_description

string

required

tv_package_image

string

required

tv_text

string

required

tv_total_channels

string

required

name

string

required

prices

array[object (TppProductPrice)]

TppProductPrice

object (TppProductPrice)

amount

int

required

currency

string

required

description

string

id

string

required

meta

object (meta)

name

string

required

prod_id

string

required

recurring_meta

object (recurring_meta)

tpp_id

string

required

type

An enumeration.

product_type

required

An enumeration.

tpp_id

string

required

updated

string

date-time

required

Response: application/json

detail

array[object (ValidationError)]

ValidationError

object (ValidationError)

loc

array[Any Of]

required

Any Of

string

int

msg

string

required

type

string

required

Request Examples

Return A Specific Product

get /products/{product_id}

Returns the associated product by a given product_id.

Authentication

API Key ApiKey

product_id

string

required

Responses

Response: application/json

created

string

date-time

required

description

string

enabled

boolean

expiration_date

string

date-time

external_key

string

id

string

required

meta

Any Of

object

TppProductBroadbandMeta

object (TppProductBroadbandMeta)

Example
{ "affiliate_link": "https://www.awin1.com/cread.php?awinmid=4260&awinaffid=774713&clickref=John+Lewis+Broadband&ued=https%3A%2F%2Fwww.johnlewisbroadband.com%2F", "product_activation_fee": "£0", "product_av_download_speed": "66mb/s", "product_billing_freq": "monthly", "product_cashback_offer": "Free e-gift card worth up to £75 with John Lewis Broadband", "product_contract_length": "12 months", "product_description_long": "There’s no usage limit, so you can stream music and watch films while your other devices work away in the background. Fibre Extra is the next generation of internet connectivity, able to support your whole family as well as any Wi-Fi enabled devices at the same time, to make sure your connected home runs smoothly.", "product_price": "£29", "thinkbroadband_key": "avail_retail_plusnet" }

affiliate_link

string

required

business

string

credit

string

download_limit

string

required

effective_first_year_cost

number

effective_full_contract_cost

number

effective_monthly_cost

number

external_short_name

string

extras_text

string

required

free_calls

string

required

full_contract_cost

number

has_broadband

boolean

landline

boolean

required

original_monthly_cost

number

original_monthly_cost_text

string

original_setup_fee

number

outlink

string

phone_number

string

phone_text

string

required

plus_vat

string

postage_cost

string

required

product_activation_fee

number

product_av_download_speed

string

product_av_upload_speed

string

product_billing_freq

string

product_cashback_offer

string

product_contract_length

int

product_cpa

string

product_cta

string

product_description_long

string

product_description_short

string

product_offer_expiry

string

product_offer_length

string

product_offer_start

string

product_offer_text

string

product_price

number

rating

number

student

int

supplier_image

string

switch_type

string

tv

boolean

required

tv_bundles

array[object (HomeboxTvBundle)]

required

HomeboxTvBundle

object (HomeboxTvBundle)

name

string

required

tv_channels

array[object (HomeboxTvChannel)]

required

HomeboxTvChannel

object (HomeboxTvChannel)

logo

string

required

name

string

required

tv_icon_text

string

required

tv_package_description

string

required

tv_package_image

string

required

tv_text

string

required

tv_total_channels

string

required

name

string

required

prices

array[object (TppProductPrice)]

TppProductPrice

object (TppProductPrice)

amount

int

required

currency

string

required

description

string

id

string

required

meta

object (meta)

name

string

required

prod_id

string

required

recurring_meta

object (recurring_meta)

tpp_id

string

required

type

An enumeration.

product_type

required

An enumeration.

tpp_id

string

required

updated

string

date-time

required

Response: application/json

detail

array[object (ValidationError)]

ValidationError

object (ValidationError)

loc

array[Any Of]

required

Any Of

string

int

msg

string

required

type

string

required

Update Product Details

post /products/{product_id}

Update product information given a product_id.

Authentication

API Key ApiKey

product_id

string

required

application/json

description

string

enabled

boolean

expiration_date

string

date-time

external_key

string

meta

Any Of

object

TppProductBroadbandMeta

object (TppProductBroadbandMeta)

Example
{ "affiliate_link": "https://www.awin1.com/cread.php?awinmid=4260&awinaffid=774713&clickref=John+Lewis+Broadband&ued=https%3A%2F%2Fwww.johnlewisbroadband.com%2F", "product_activation_fee": "£0", "product_av_download_speed": "66mb/s", "product_billing_freq": "monthly", "product_cashback_offer": "Free e-gift card worth up to £75 with John Lewis Broadband", "product_contract_length": "12 months", "product_description_long": "There’s no usage limit, so you can stream music and watch films while your other devices work away in the background. Fibre Extra is the next generation of internet connectivity, able to support your whole family as well as any Wi-Fi enabled devices at the same time, to make sure your connected home runs smoothly.", "product_price": "£29", "thinkbroadband_key": "avail_retail_plusnet" }

affiliate_link

string

required

business

string

credit

string

download_limit

string

required

effective_first_year_cost

number

effective_full_contract_cost

number

effective_monthly_cost

number

external_short_name

string

extras_text

string

required

free_calls

string

required

full_contract_cost

number

has_broadband

boolean

landline

boolean

required

original_monthly_cost

number

original_monthly_cost_text

string

original_setup_fee

number

outlink

string

phone_number

string

phone_text

string

required

plus_vat

string

postage_cost

string

required

product_activation_fee

number

product_av_download_speed

string

product_av_upload_speed

string

product_billing_freq

string

product_cashback_offer

string

product_contract_length

int

product_cpa

string

product_cta

string

product_description_long

string

product_description_short

string

product_offer_expiry

string

product_offer_length

string

product_offer_start

string

product_offer_text

string

product_price

number

rating

number

student

int

supplier_image

string

switch_type

string

tv

boolean

required

tv_bundles

array[object (HomeboxTvBundle)]

required

HomeboxTvBundle

object (HomeboxTvBundle)

name

string

required

tv_channels

array[object (HomeboxTvChannel)]

required

HomeboxTvChannel

object (HomeboxTvChannel)

logo

string

required

name

string

required

tv_icon_text

string

required

tv_package_description

string

required

tv_package_image

string

required

tv_text

string

required

tv_total_channels

string

required

name

string

required

product_type

required

An enumeration.

Responses

Response: application/json

created

string

date-time

required

description

string

enabled

boolean

expiration_date

string

date-time

external_key

string

id

string

required

meta

Any Of

object

TppProductBroadbandMeta

object (TppProductBroadbandMeta)

Example
{ "affiliate_link": "https://www.awin1.com/cread.php?awinmid=4260&awinaffid=774713&clickref=John+Lewis+Broadband&ued=https%3A%2F%2Fwww.johnlewisbroadband.com%2F", "product_activation_fee": "£0", "product_av_download_speed": "66mb/s", "product_billing_freq": "monthly", "product_cashback_offer": "Free e-gift card worth up to £75 with John Lewis Broadband", "product_contract_length": "12 months", "product_description_long": "There’s no usage limit, so you can stream music and watch films while your other devices work away in the background. Fibre Extra is the next generation of internet connectivity, able to support your whole family as well as any Wi-Fi enabled devices at the same time, to make sure your connected home runs smoothly.", "product_price": "£29", "thinkbroadband_key": "avail_retail_plusnet" }

affiliate_link

string

required

business

string

credit

string

download_limit

string

required

effective_first_year_cost

number

effective_full_contract_cost

number

effective_monthly_cost

number

external_short_name

string

extras_text

string

required

free_calls

string

required

full_contract_cost

number

has_broadband

boolean

landline

boolean

required

original_monthly_cost

number

original_monthly_cost_text

string

original_setup_fee

number

outlink

string

phone_number

string

phone_text

string

required

plus_vat

string

postage_cost

string

required

product_activation_fee

number

product_av_download_speed

string

product_av_upload_speed

string

product_billing_freq

string

product_cashback_offer

string

product_contract_length

int

product_cpa

string

product_cta

string

product_description_long

string

product_description_short

string

product_offer_expiry

string

product_offer_length

string

product_offer_start

string

product_offer_text

string

product_price

number

rating

number

student

int

supplier_image

string

switch_type

string

tv

boolean

required

tv_bundles

array[object (HomeboxTvBundle)]

required

HomeboxTvBundle

object (HomeboxTvBundle)

name

string

required

tv_channels

array[object (HomeboxTvChannel)]

required

HomeboxTvChannel

object (HomeboxTvChannel)

logo

string

required

name

string

required

tv_icon_text

string

required

tv_package_description

string

required

tv_package_image

string

required

tv_text

string

required

tv_total_channels

string

required

name

string

required

prices

array[object (TppProductPrice)]

TppProductPrice

object (TppProductPrice)

amount

int

required

currency

string

required

description

string

id

string

required

meta

object (meta)

name

string

required

prod_id

string

required

recurring_meta

object (recurring_meta)

tpp_id

string

required

type

An enumeration.

product_type

required

An enumeration.

tpp_id

string

required

updated

string

date-time

required

Response: application/json

detail

array[object (ValidationError)]

ValidationError

object (ValidationError)

loc

array[Any Of]

required

Any Of

string

int

msg

string

required

type

string

required

Request Examples

Delete Product

delete /products/{product_id}

Delete a product.

Authentication

API Key ApiKey

product_id

string

required

Responses

Response: application/json

detail

array[object (ValidationError)]

ValidationError

object (ValidationError)

loc

array[Any Of]

required

Any Of

string

int

msg

string

required

type

string

required

Was this page helpful?