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.

API Key ApiKey

order_sort

string

category

An enumeration.

name

string

page

integer

Default
0

size

integer

Default
50

Response

Examples Schema

Successful Response

{
  "items": [
    {
      "name": "Fibre Extra",
      "description": "Unlimited usage, 66Mb average download speed*",
      "enabled": 1,
      "product_type": "utilities_broadband",
      "meta": {
        "product_price": "£29",
        "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_billing_freq": "monthly",
        "product_activation_fee": "£0",
        "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_av_download_speed": "66mb/s"
      }
    }
  ],
  "total": null,
  "page": null,
  "size": 123
}

Not found

Empty response

Validation Error

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

items

array[object (TppProduct)]

required

TppProduct

object (TppProduct)

Example
{ "name": "Fibre Extra", "description": "Unlimited usage, 66Mb average download speed*", "enabled": 1, "product_type": "utilities_broadband", "meta": { "product_price": "£29", "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_billing_freq": "monthly", "product_activation_fee": "£0", "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_av_download_speed": "66mb/s" } }

name

string

required

description

string

expiration_date

string

date-time

enabled

boolean

product_type

required

An enumeration.

meta

Any Of

object

TppProductBroadbandMeta

object (TppProductBroadbandMeta)

Example
{ "product_price": "£29", "affiliate_link": "https://www.awin1.com/cread.php?awinmid=4260&awinaffid=774713&clickref=John+Lewis+Broadband&ued=https%3A%2F%2Fwww.johnlewisbroadband.com%2F", "thinkbroadband_key": "avail_retail_plusnet", "product_billing_freq": "monthly", "product_activation_fee": "£0", "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_av_download_speed": "66mb/s" }

product_description_short

string

product_description_long

string

product_av_download_speed

string

product_av_upload_speed

string

product_price

number

product_billing_freq

string

product_contract_length

int

product_activation_fee

number

product_cashback_offer

string

product_offer_expiry

string

product_offer_start

string

product_offer_text

string

product_offer_length

string

product_cta

string

product_cpa

string

has_broadband

boolean

affiliate_link

string

required

external_short_name

string

student

int

business

string

rating

number

plus_vat

string

credit

string

original_monthly_cost

number

original_monthly_cost_text

string

original_setup_fee

number

full_contract_cost

number

effective_full_contract_cost

number

effective_monthly_cost

number

effective_first_year_cost

number

outlink

string

phone_number

string

switch_type

string

supplier_image

string

postage_cost

string

required

download_limit

string

required

landline

boolean

required

free_calls

string

required

phone_text

string

required

extras_text

string

required

tv

boolean

required

tv_text

string

required

tv_icon_text

string

required

tv_package_description

string

required

tv_package_image

string

required

tv_total_channels

string

required

tv_bundles

array[object (HomeboxTvBundle)]

required

HomeboxTvBundle

object (HomeboxTvBundle)

name

string

required

tv_channels

array[object (HomeboxTvChannel)]

required

HomeboxTvChannel

object (HomeboxTvChannel)

name

string

required

logo

string

required

external_key

string

id

string

required

tpp_id

string

required

created

string

date-time

required

updated

string

date-time

required

prices

array[object (TppProductPrice)]

TppProductPrice

object (TppProductPrice)

name

string

required

currency

string

required

amount

int

required

description

string

meta

object (meta)

type

An enumeration.

recurring_meta

object (recurring_meta)

id

string

required

tpp_id

string

required

prod_id

string

required

total

integer

required

page

integer

required

size

int

required

No schema

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

API Key ApiKey

name

string

required

description

string

expiration_date

string

date-time

enabled

boolean

product_type

required

An enumeration.

meta

Any Of

object

TppProductBroadbandMeta

object (TppProductBroadbandMeta)

Example
{ "product_price": "£29", "affiliate_link": "https://www.awin1.com/cread.php?awinmid=4260&awinaffid=774713&clickref=John+Lewis+Broadband&ued=https%3A%2F%2Fwww.johnlewisbroadband.com%2F", "thinkbroadband_key": "avail_retail_plusnet", "product_billing_freq": "monthly", "product_activation_fee": "£0", "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_av_download_speed": "66mb/s" }

product_description_short

string

product_description_long

string

product_av_download_speed

string

product_av_upload_speed

string

product_price

number

product_billing_freq

string

product_contract_length

int

product_activation_fee

number

product_cashback_offer

string

product_offer_expiry

string

product_offer_start

string

product_offer_text

string

product_offer_length

string

product_cta

string

product_cpa

string

has_broadband

boolean

affiliate_link

string

required

external_short_name

string

student

int

business

string

rating

number

plus_vat

string

credit

string

original_monthly_cost

number

original_monthly_cost_text

string

original_setup_fee

number

full_contract_cost

number

effective_full_contract_cost

number

effective_monthly_cost

number

effective_first_year_cost

number

outlink

string

phone_number

string

switch_type

string

supplier_image

string

postage_cost

string

required

download_limit

string

required

landline

boolean

required

free_calls

string

required

phone_text

string

required

extras_text

string

required

tv

boolean

required

tv_text

string

required

tv_icon_text

string

required

tv_package_description

string

required

tv_package_image

string

required

tv_total_channels

string

required

tv_bundles

array[object (HomeboxTvBundle)]

required

HomeboxTvBundle

object (HomeboxTvBundle)

name

string

required

tv_channels

array[object (HomeboxTvChannel)]

required

HomeboxTvChannel

object (HomeboxTvChannel)

name

string

required

logo

string

required

external_key

string

Request

{
  "name": "Fibre Extra",
  "description": "Unlimited usage, 66Mb average download speed*",
  "enabled": 1,
  "product_type": "utilities_broadband",
  "meta": {
    "product_price": "£29",
    "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_billing_freq": "monthly",
    "product_activation_fee": "£0",
    "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_av_download_speed": "66mb/s"
  }
}

Response

Examples Schema

Successful Response

{
  "name": "Fibre Extra",
  "description": "Unlimited usage, 66Mb average download speed*",
  "enabled": 1,
  "product_type": "utilities_broadband",
  "meta": {
    "product_price": "£29",
    "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_billing_freq": "monthly",
    "product_activation_fee": "£0",
    "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_av_download_speed": "66mb/s"
  }
}

Not found

Empty response

Validation Error

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

name

string

required

description

string

expiration_date

string

date-time

enabled

boolean

product_type

required

An enumeration.

meta

Any Of

object

TppProductBroadbandMeta

object (TppProductBroadbandMeta)

Example
{ "product_price": "£29", "affiliate_link": "https://www.awin1.com/cread.php?awinmid=4260&awinaffid=774713&clickref=John+Lewis+Broadband&ued=https%3A%2F%2Fwww.johnlewisbroadband.com%2F", "thinkbroadband_key": "avail_retail_plusnet", "product_billing_freq": "monthly", "product_activation_fee": "£0", "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_av_download_speed": "66mb/s" }

product_description_short

string

product_description_long

string

product_av_download_speed

string

product_av_upload_speed

string

product_price

number

product_billing_freq

string

product_contract_length

int

product_activation_fee

number

product_cashback_offer

string

product_offer_expiry

string

product_offer_start

string

product_offer_text

string

product_offer_length

string

product_cta

string

product_cpa

string

has_broadband

boolean

affiliate_link

string

required

external_short_name

string

student

int

business

string

rating

number

plus_vat

string

credit

string

original_monthly_cost

number

original_monthly_cost_text

string

original_setup_fee

number

full_contract_cost

number

effective_full_contract_cost

number

effective_monthly_cost

number

effective_first_year_cost

number

outlink

string

phone_number

string

switch_type

string

supplier_image

string

postage_cost

string

required

download_limit

string

required

landline

boolean

required

free_calls

string

required

phone_text

string

required

extras_text

string

required

tv

boolean

required

tv_text

string

required

tv_icon_text

string

required

tv_package_description

string

required

tv_package_image

string

required

tv_total_channels

string

required

tv_bundles

array[object (HomeboxTvBundle)]

required

HomeboxTvBundle

object (HomeboxTvBundle)

name

string

required

tv_channels

array[object (HomeboxTvChannel)]

required

HomeboxTvChannel

object (HomeboxTvChannel)

name

string

required

logo

string

required

external_key

string

id

string

required

tpp_id

string

required

created

string

date-time

required

updated

string

date-time

required

prices

array[object (TppProductPrice)]

TppProductPrice

object (TppProductPrice)

name

string

required

currency

string

required

amount

int

required

description

string

meta

object (meta)

type

An enumeration.

recurring_meta

object (recurring_meta)

id

string

required

tpp_id

string

required

prod_id

string

required

No schema

detail

array[object (ValidationError)]

ValidationError

object (ValidationError)

loc

array[Any Of]

required

Any Of

string

int

msg

string

required

type

string

required

Return A Specific Product

get /products/{product_id}

Returns the associated product by a given product_id.

API Key ApiKey

product_id

string

required

Response

Examples Schema

Successful Response

{
  "name": "Fibre Extra",
  "description": "Unlimited usage, 66Mb average download speed*",
  "enabled": 1,
  "product_type": "utilities_broadband",
  "meta": {
    "product_price": "£29",
    "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_billing_freq": "monthly",
    "product_activation_fee": "£0",
    "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_av_download_speed": "66mb/s"
  }
}

Not found

Empty response

Validation Error

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

name

string

required

description

string

expiration_date

string

date-time

enabled

boolean

product_type

required

An enumeration.

meta

Any Of

object

TppProductBroadbandMeta

object (TppProductBroadbandMeta)

Example
{ "product_price": "£29", "affiliate_link": "https://www.awin1.com/cread.php?awinmid=4260&awinaffid=774713&clickref=John+Lewis+Broadband&ued=https%3A%2F%2Fwww.johnlewisbroadband.com%2F", "thinkbroadband_key": "avail_retail_plusnet", "product_billing_freq": "monthly", "product_activation_fee": "£0", "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_av_download_speed": "66mb/s" }

product_description_short

string

product_description_long

string

product_av_download_speed

string

product_av_upload_speed

string

product_price

number

product_billing_freq

string

product_contract_length

int

product_activation_fee

number

product_cashback_offer

string

product_offer_expiry

string

product_offer_start

string

product_offer_text

string

product_offer_length

string

product_cta

string

product_cpa

string

has_broadband

boolean

affiliate_link

string

required

external_short_name

string

student

int

business

string

rating

number

plus_vat

string

credit

string

original_monthly_cost

number

original_monthly_cost_text

string

original_setup_fee

number

full_contract_cost

number

effective_full_contract_cost

number

effective_monthly_cost

number

effective_first_year_cost

number

outlink

string

phone_number

string

switch_type

string

supplier_image

string

postage_cost

string

required

download_limit

string

required

landline

boolean

required

free_calls

string

required

phone_text

string

required

extras_text

string

required

tv

boolean

required

tv_text

string

required

tv_icon_text

string

required

tv_package_description

string

required

tv_package_image

string

required

tv_total_channels

string

required

tv_bundles

array[object (HomeboxTvBundle)]

required

HomeboxTvBundle

object (HomeboxTvBundle)

name

string

required

tv_channels

array[object (HomeboxTvChannel)]

required

HomeboxTvChannel

object (HomeboxTvChannel)

name

string

required

logo

string

required

external_key

string

id

string

required

tpp_id

string

required

created

string

date-time

required

updated

string

date-time

required

prices

array[object (TppProductPrice)]

TppProductPrice

object (TppProductPrice)

name

string

required

currency

string

required

amount

int

required

description

string

meta

object (meta)

type

An enumeration.

recurring_meta

object (recurring_meta)

id

string

required

tpp_id

string

required

prod_id

string

required

No schema

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.

API Key ApiKey

product_id

string

required

name

string

required

description

string

expiration_date

string

date-time

enabled

boolean

product_type

required

An enumeration.

meta

Any Of

object

TppProductBroadbandMeta

object (TppProductBroadbandMeta)

Example
{ "product_price": "£29", "affiliate_link": "https://www.awin1.com/cread.php?awinmid=4260&awinaffid=774713&clickref=John+Lewis+Broadband&ued=https%3A%2F%2Fwww.johnlewisbroadband.com%2F", "thinkbroadband_key": "avail_retail_plusnet", "product_billing_freq": "monthly", "product_activation_fee": "£0", "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_av_download_speed": "66mb/s" }

product_description_short

string

product_description_long

string

product_av_download_speed

string

product_av_upload_speed

string

product_price

number

product_billing_freq

string

product_contract_length

int

product_activation_fee

number

product_cashback_offer

string

product_offer_expiry

string

product_offer_start

string

product_offer_text

string

product_offer_length

string

product_cta

string

product_cpa

string

has_broadband

boolean

affiliate_link

string

required

external_short_name

string

student

int

business

string

rating

number

plus_vat

string

credit

string

original_monthly_cost

number

original_monthly_cost_text

string

original_setup_fee

number

full_contract_cost

number

effective_full_contract_cost

number

effective_monthly_cost

number

effective_first_year_cost

number

outlink

string

phone_number

string

switch_type

string

supplier_image

string

postage_cost

string

required

download_limit

string

required

landline

boolean

required

free_calls

string

required

phone_text

string

required

extras_text

string

required

tv

boolean

required

tv_text

string

required

tv_icon_text

string

required

tv_package_description

string

required

tv_package_image

string

required

tv_total_channels

string

required

tv_bundles

array[object (HomeboxTvBundle)]

required

HomeboxTvBundle

object (HomeboxTvBundle)

name

string

required

tv_channels

array[object (HomeboxTvChannel)]

required

HomeboxTvChannel

object (HomeboxTvChannel)

name

string

required

logo

string

required

external_key

string

Request

{
  "name": "Fibre Extra",
  "description": "Unlimited usage, 66Mb average download speed*",
  "enabled": 1,
  "product_type": "utilities_broadband",
  "meta": {
    "product_price": "£29",
    "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_billing_freq": "monthly",
    "product_activation_fee": "£0",
    "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_av_download_speed": "66mb/s"
  }
}

Response

Examples Schema

Successful Response

{
  "name": "Fibre Extra",
  "description": "Unlimited usage, 66Mb average download speed*",
  "enabled": 1,
  "product_type": "utilities_broadband",
  "meta": {
    "product_price": "£29",
    "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_billing_freq": "monthly",
    "product_activation_fee": "£0",
    "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_av_download_speed": "66mb/s"
  }
}

Not found

Empty response

Validation Error

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

name

string

required

description

string

expiration_date

string

date-time

enabled

boolean

product_type

required

An enumeration.

meta

Any Of

object

TppProductBroadbandMeta

object (TppProductBroadbandMeta)

Example
{ "product_price": "£29", "affiliate_link": "https://www.awin1.com/cread.php?awinmid=4260&awinaffid=774713&clickref=John+Lewis+Broadband&ued=https%3A%2F%2Fwww.johnlewisbroadband.com%2F", "thinkbroadband_key": "avail_retail_plusnet", "product_billing_freq": "monthly", "product_activation_fee": "£0", "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_av_download_speed": "66mb/s" }

product_description_short

string

product_description_long

string

product_av_download_speed

string

product_av_upload_speed

string

product_price

number

product_billing_freq

string

product_contract_length

int

product_activation_fee

number

product_cashback_offer

string

product_offer_expiry

string

product_offer_start

string

product_offer_text

string

product_offer_length

string

product_cta

string

product_cpa

string

has_broadband

boolean

affiliate_link

string

required

external_short_name

string

student

int

business

string

rating

number

plus_vat

string

credit

string

original_monthly_cost

number

original_monthly_cost_text

string

original_setup_fee

number

full_contract_cost

number

effective_full_contract_cost

number

effective_monthly_cost

number

effective_first_year_cost

number

outlink

string

phone_number

string

switch_type

string

supplier_image

string

postage_cost

string

required

download_limit

string

required

landline

boolean

required

free_calls

string

required

phone_text

string

required

extras_text

string

required

tv

boolean

required

tv_text

string

required

tv_icon_text

string

required

tv_package_description

string

required

tv_package_image

string

required

tv_total_channels

string

required

tv_bundles

array[object (HomeboxTvBundle)]

required

HomeboxTvBundle

object (HomeboxTvBundle)

name

string

required

tv_channels

array[object (HomeboxTvChannel)]

required

HomeboxTvChannel

object (HomeboxTvChannel)

name

string

required

logo

string

required

external_key

string

id

string

required

tpp_id

string

required

created

string

date-time

required

updated

string

date-time

required

prices

array[object (TppProductPrice)]

TppProductPrice

object (TppProductPrice)

name

string

required

currency

string

required

amount

int

required

description

string

meta

object (meta)

type

An enumeration.

recurring_meta

object (recurring_meta)

id

string

required

tpp_id

string

required

prod_id

string

required

No schema

detail

array[object (ValidationError)]

ValidationError

object (ValidationError)

loc

array[Any Of]

required

Any Of

string

int

msg

string

required

type

string

required

Delete Product

delete /products/{product_id}

Delete a product.

API Key ApiKey

product_id

string

required

Response

Examples Schema

Successful Response

Empty response

Not found

Empty response

Validation Error

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

No schema

No schema

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?