List runtime bundle candidates
Streams the authenticated member’s active, not-disabled subscriptions, including those without a billing date, newest created first with a stable internal tie breaker. Each page is only a fragment: clients must drain every page before constructing complete groups, counts or saved gross totals, and hydrate subscription UUIDs for display details. No complete bundle or persistent bundle ID is returned. Concurrent edits can change membership or keys; refresh the stream before relying on a complete grouping. Grouping follows the existing snapshot/address/customer fallback policy; a native profile without a legacy Customer does not introduce a new address fallback. Saved line amounts are not renewal quotes. Company bundling must be enabled; unsafe related references refuse the page. Only page[cursor] and page[limit] are accepted. Responses are private and require revalidation.
curl --request GET \
--url https://api.fluid.app/api/member/v2026-10/subscriptions/bundle-candidates \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.fluid.app/api/member/v2026-10/subscriptions/bundle-candidates"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.fluid.app/api/member/v2026-10/subscriptions/bundle-candidates', 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.fluid.app/api/member/v2026-10/subscriptions/bundle-candidates",
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.fluid.app/api/member/v2026-10/subscriptions/bundle-candidates"
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))
}HttpResponse<String> response = Unirest.get("https://api.fluid.app/api/member/v2026-10/subscriptions/bundle-candidates")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluid.app/api/member/v2026-10/subscriptions/bundle-candidates")
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{
"status": 200,
"data": [
{
"id": "01983a21-7b23-7123-8123-123456789abc",
"grouping_key": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"next_billing_date": "2026-11-01",
"currency": "USD",
"quantity": 2,
"unit_price": "40.0",
"line_total": "80.0"
}
],
"meta": {
"request_uuid": "01983a21-7b23-7123-8123-123456789abd",
"timestamp": "2026-10-01T12:00:00Z",
"pagination": {
"next_cursor": null
}
}
}{
"status": 123,
"error": {
"message": "<string>",
"details": {}
},
"meta": {
"request_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"timestamp": "2023-11-07T05:31:56Z",
"subscription_schedule": {
"next_bill_date": "2023-12-25",
"latest_skip_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"pending_skip_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"pending_skip_date": "2023-12-25",
"can_skip": true,
"applied": true
},
"code": "next_bill_date_blackout",
"blocked_date": "2026-11-30",
"blocked_day": 30,
"allowed_date": "2026-11-28",
"scheduled_date": "2026-12-10",
"last_bill_date": "2026-11-10",
"requested_date": "2026-11-30"
}
}{
"status": 123,
"error": {
"message": "<string>",
"details": {}
},
"meta": {
"request_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"timestamp": "2023-11-07T05:31:56Z",
"subscription_schedule": {
"next_bill_date": "2023-12-25",
"latest_skip_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"pending_skip_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"pending_skip_date": "2023-12-25",
"can_skip": true,
"applied": true
},
"code": "next_bill_date_blackout",
"blocked_date": "2026-11-30",
"blocked_day": 30,
"allowed_date": "2026-11-28",
"scheduled_date": "2026-12-10",
"last_bill_date": "2026-11-10",
"requested_date": "2026-11-30"
}
}{
"status": 123,
"error": {
"message": "<string>",
"details": {}
},
"meta": {
"request_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"timestamp": "2023-11-07T05:31:56Z",
"subscription_schedule": {
"next_bill_date": "2023-12-25",
"latest_skip_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"pending_skip_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"pending_skip_date": "2023-12-25",
"can_skip": true,
"applied": true
},
"code": "next_bill_date_blackout",
"blocked_date": "2026-11-30",
"blocked_day": 30,
"allowed_date": "2026-11-28",
"scheduled_date": "2026-12-10",
"last_bill_date": "2026-11-10",
"requested_date": "2026-11-30"
}
}{
"status": 123,
"error": {
"message": "<string>",
"details": {}
},
"meta": {
"request_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"timestamp": "2023-11-07T05:31:56Z",
"subscription_schedule": {
"next_bill_date": "2023-12-25",
"latest_skip_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"pending_skip_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"pending_skip_date": "2023-12-25",
"can_skip": true,
"applied": true
},
"code": "next_bill_date_blackout",
"blocked_date": "2026-11-30",
"blocked_day": 30,
"allowed_date": "2026-11-28",
"scheduled_date": "2026-12-10",
"last_bill_date": "2026-11-10",
"requested_date": "2026-11-30"
}
}Authorizations
Query Parameters
Response
One fragment of the owned candidate stream, or an empty page.
One bounded fragment of candidate subscriptions; groups can span any number of pages.
curl --request GET \
--url https://api.fluid.app/api/member/v2026-10/subscriptions/bundle-candidates \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.fluid.app/api/member/v2026-10/subscriptions/bundle-candidates"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.fluid.app/api/member/v2026-10/subscriptions/bundle-candidates', 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.fluid.app/api/member/v2026-10/subscriptions/bundle-candidates",
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.fluid.app/api/member/v2026-10/subscriptions/bundle-candidates"
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))
}HttpResponse<String> response = Unirest.get("https://api.fluid.app/api/member/v2026-10/subscriptions/bundle-candidates")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluid.app/api/member/v2026-10/subscriptions/bundle-candidates")
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{
"status": 200,
"data": [
{
"id": "01983a21-7b23-7123-8123-123456789abc",
"grouping_key": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"next_billing_date": "2026-11-01",
"currency": "USD",
"quantity": 2,
"unit_price": "40.0",
"line_total": "80.0"
}
],
"meta": {
"request_uuid": "01983a21-7b23-7123-8123-123456789abd",
"timestamp": "2026-10-01T12:00:00Z",
"pagination": {
"next_cursor": null
}
}
}{
"status": 123,
"error": {
"message": "<string>",
"details": {}
},
"meta": {
"request_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"timestamp": "2023-11-07T05:31:56Z",
"subscription_schedule": {
"next_bill_date": "2023-12-25",
"latest_skip_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"pending_skip_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"pending_skip_date": "2023-12-25",
"can_skip": true,
"applied": true
},
"code": "next_bill_date_blackout",
"blocked_date": "2026-11-30",
"blocked_day": 30,
"allowed_date": "2026-11-28",
"scheduled_date": "2026-12-10",
"last_bill_date": "2026-11-10",
"requested_date": "2026-11-30"
}
}{
"status": 123,
"error": {
"message": "<string>",
"details": {}
},
"meta": {
"request_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"timestamp": "2023-11-07T05:31:56Z",
"subscription_schedule": {
"next_bill_date": "2023-12-25",
"latest_skip_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"pending_skip_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"pending_skip_date": "2023-12-25",
"can_skip": true,
"applied": true
},
"code": "next_bill_date_blackout",
"blocked_date": "2026-11-30",
"blocked_day": 30,
"allowed_date": "2026-11-28",
"scheduled_date": "2026-12-10",
"last_bill_date": "2026-11-10",
"requested_date": "2026-11-30"
}
}{
"status": 123,
"error": {
"message": "<string>",
"details": {}
},
"meta": {
"request_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"timestamp": "2023-11-07T05:31:56Z",
"subscription_schedule": {
"next_bill_date": "2023-12-25",
"latest_skip_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"pending_skip_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"pending_skip_date": "2023-12-25",
"can_skip": true,
"applied": true
},
"code": "next_bill_date_blackout",
"blocked_date": "2026-11-30",
"blocked_day": 30,
"allowed_date": "2026-11-28",
"scheduled_date": "2026-12-10",
"last_bill_date": "2026-11-10",
"requested_date": "2026-11-30"
}
}{
"status": 123,
"error": {
"message": "<string>",
"details": {}
},
"meta": {
"request_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"timestamp": "2023-11-07T05:31:56Z",
"subscription_schedule": {
"next_bill_date": "2023-12-25",
"latest_skip_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"pending_skip_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"pending_skip_date": "2023-12-25",
"can_skip": true,
"applied": true
},
"code": "next_bill_date_blackout",
"blocked_date": "2026-11-30",
"blocked_day": 30,
"allowed_date": "2026-11-28",
"scheduled_date": "2026-12-10",
"last_bill_date": "2026-11-10",
"requested_date": "2026-11-30"
}
}