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.

order_sort

string

category

An enumeration.

name

string

page

integer

Default
0

size

integer

Default
50

Response

ExamplesSchema

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
}

Create A New Product

post /products

Create a new product for your company

name

string

required

description

string

expiration_date

string

date-time

enabled

boolean

product_type

required

An enumeration.

meta

Any Of

external_key

string

Response

ExamplesSchema

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"
  }
}

Return A Specific Product

get /products/{product_id}

Returns the associated product by a given product_id.

product_id

string

required

Response

ExamplesSchema

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"
  }
}

Update Product Details

post /products/{product_id}

Update product information given a product_id.

name

string

required

description

string

expiration_date

string

date-time

enabled

boolean

product_type

required

An enumeration.

meta

Any Of

external_key

string

Response

ExamplesSchema

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"
  }
}

Delete Product

delete /products/{product_id}

Delete a product.

product_id

string

required

Response

ExamplesSchema

Successful Response

Empty response

Was this page helpful?