List bundles

curl --request GET \
  --url https://api.getredo.com/v2.2/stores/{storeId}/bundles \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.getredo.com/v2.2/stores/{storeId}/bundles', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.getredo.com/v2.2/stores/{storeId}/bundles",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.getredo.com/v2.2/stores/{storeId}/bundles"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.getredo.com/v2.2/stores/{storeId}/bundles")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "bundles": [
    {
      "parent": {
        "variant_id": "55518673568035",
        "sku": "BUNDLE-STARTER-KIT",
        "name": "Starter Kit",
        "resolved": true
      },
      "children": [
        {
          "variant_id": "55518673404195",
          "sku": "SOCKS-BLK-L",
          "name": "Socks - Black / L",
          "returnable": true,
          "quantity": 1,
          "resolved": true
        },
        {
          "variant_id": "55518673600803",
          "sku": "TSHIRT-BLK-M",
          "name": "T-Shirt - Black / M",
          "returnable": true,
          "quantity": 2,
          "resolved": true
        }
      ],
      "return_types": [
        "return",
        "warranty"
      ]
    }
  ]
}

Bundles

List bundles

List the bundles stored for a store. Each product is looked up in your catalog, so you get SKUs and names rather than bare identifiers.

Finding one bundle

Pass parent_sku to return just that bundle. The lookup goes through your catalog, so a bundle created in the Redo UI is found too. sku_resolved tells you whether the SKU exists at all, as opposed to existing but having no bundle. If the SKU is on more than one variant, you get every matching bundle; use parent.variant_id to tell them apart. Filtered requests are not paged.

Quantities

Each child carries quantity, the number of units of that product in the bundle. This mirrors what you send on PUT.

Products that no longer exist

A product can be deleted after a bundle is built. When that happens the entry has resolved: false and sku and name are null. A resolved product with a null sku simply has no SKU set; such a bundle can only be managed from the Bundles page in Redo.

Paging

X-Page-Size sets the page size, up to 250 (default 50). When more bundles remain, the response includes an X-Page-Next header; send it back as X-Page-Continue for the next page. Treat the cursor as opaque.

Requires the returns_read scope.

GET

stores

{storeId}

bundles

List bundles

curl --request GET \
  --url https://api.getredo.com/v2.2/stores/{storeId}/bundles \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.getredo.com/v2.2/stores/{storeId}/bundles', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.getredo.com/v2.2/stores/{storeId}/bundles",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.getredo.com/v2.2/stores/{storeId}/bundles"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.getredo.com/v2.2/stores/{storeId}/bundles")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "bundles": [
    {
      "parent": {
        "variant_id": "55518673568035",
        "sku": "BUNDLE-STARTER-KIT",
        "name": "Starter Kit",
        "resolved": true
      },
      "children": [
        {
          "variant_id": "55518673404195",
          "sku": "SOCKS-BLK-L",
          "name": "Socks - Black / L",
          "returnable": true,
          "quantity": 1,
          "resolved": true
        },
        {
          "variant_id": "55518673600803",
          "sku": "TSHIRT-BLK-M",
          "name": "T-Shirt - Black / M",
          "returnable": true,
          "quantity": 2,
          "resolved": true
        }
      ],
      "return_types": [
        "return",
        "warranty"
      ]
    }
  ]
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

X-Page-Continue

string

Page marker, from the X-Page-Next header of the previous response

X-Page-Size

integer

Page size, defaults to 50

Required range: 1 <= x <= 250

Path Parameters

storeId

string

required

Store ID

Example:

"64e5a8a1af49a89df37e4ee7"

Query Parameters

parent_sku

string

Return only bundles whose parent product has this SKU. Case-sensitive. If the SKU is on more than one variant, every matching bundle is returned.

Response

Success

A page of stored bundles.

bundles

Bundle List Item · object[]

required

The bundles on this page.

Show child attributes

sku_resolved

boolean

Present only when parent_sku was supplied. false means no product in your catalog has that SKU, which is different from the SKU existing but having no bundle.

Getting Started

Endpoints

List bundles

Finding one bundle

Quantities

Products that no longer exist

Paging

Authorizations

Headers

Path Parameters

Query Parameters

Response