Your site. Our catalogue.
One connected experience.

Read-only connection check

Check whether the endpoint responds. This check sends no API key and cannot place orders. It does not verify authenticated catalogue access or wallet eligibility. Your approved key and at least $5 USD (500 cents) are required for authenticated catalogue syncing.

Ready to check API availability. Authenticated catalogue syncing requires at least $5 USD in your wallet.

PHP · server only

<?php
// Server-side only. Set TOOLZPLANET_API_KEY in server configuration.
$key=getenv('TOOLZPLANET_API_KEY');
if(!$key)throw new RuntimeException('Configure an approved read-only API key.');
$page=1;
$ch=curl_init('https://toolzplanet.net/developer-api.php?action=catalogue&page='.$page);
curl_setopt_array($ch,[CURLOPT_RETURNTRANSFER=>true,CURLOPT_TIMEOUT=>20,CURLOPT_FOLLOWLOCATION=>false,CURLOPT_HTTPHEADER=>['Authorization: Bearer '.$key,'Accept: application/json']]);
$raw=curl_exec($ch);$http=(int)curl_getinfo($ch,CURLINFO_RESPONSE_CODE);curl_close($ch);
if($raw===false)throw new RuntimeException('Connection failed; retry this read-only request later.');
$data=json_decode($raw,true,512,JSON_THROW_ON_ERROR);
if(($data['error']['code']??'')==='minimum_wallet_balance_required'){
 throw new RuntimeException('Catalogue sync paused: maintain at least $5 USD (500 cents). Fund your wallet at '.$data['error']['funding_url'].' and retry after verified credit. No activation fee.');
}
if($http!==200||!($data['success']??false))throw new RuntimeException('API request rejected: '.($data['error']['code']??'http_'.$http));
foreach($data['data']['items'] as $item){
 echo json_encode(['id'=>$item['id'],'price_cents'=>$item['price_cents'],'currency'=>$item['currency'],'stock'=>$item['stock'],'live_quote_required'=>$item['live_quote_required']]).PHP_EOL;
}
// Request next_page with the same GET action when not null.
echo 'Next page: '.json_encode($data['data']['next_page']).PHP_EOL;

JavaScript · Node.js server only

// Node.js server only. Never embed an API key in browser JavaScript.
const key = process.env.TOOLZPLANET_API_KEY;
if (!key) throw new Error('Configure an approved read-only API key.');
const url = new URL('https://toolzplanet.net/developer-api.php');
url.searchParams.set('action', 'catalogue');
url.searchParams.set('page', '1');
const response = await fetch(url, {
  headers: {Authorization: `Bearer ${key}`, Accept: 'application/json'},
  redirect: 'error', signal: AbortSignal.timeout(20000)
});
const data = await response.json();
if (data.error?.code === 'minimum_wallet_balance_required') {
  throw new Error(`Catalogue sync paused: keep at least $5 USD (500 cents). Fund at ${data.error.funding_url} and retry after verified credit. No activation fee.`);
}
if (!response.ok || !data.success) throw new Error(`API request rejected: ${data.error?.code ?? response.status}`);
for (const item of data.data.items) {
  console.log({id: item.id, price_cents: item.price_cents, currency: item.currency,
    stock: item.stock, live_quote_required: item.live_quote_required});
}
console.log('Next page:', data.data.next_page);
// Follow next_page with GET catalogue only. A null price requires GET quote.

Set TOOLZPLANET_API_KEY in private server configuration. Never put it in browser code, a URL or logs. Use an approved read-only key. Supplier catalogue IDs are integer API item IDs. TextPlus IDs are strings such as textplus:123; preserve them exactly. TextPlus API purchasing is disabled. Prices are integer USD cents; a null price requires a fresh GET quote. Follow next_page until null. Stock can change before an order.

The launch pause is intentional and enforced server-side. Launch and individual account approval must both permit access before keys can be created.

Catalogue balance requirement · HTTP 403

minimum_wallet_balance_required means catalogue syncing is paused while your usable wallet is below 500 USD cents. Existing keys resume automatically after verified funding reaches at least 500 cents. No $5 fee, deduction or reservation is made.

{
  "success": false,
  "error": {
    "code": "minimum_wallet_balance_required",
    "currency": "USD",
    "required_balance_cents": 500,
    "balance_cents": 499,
    "funding_url": "https://toolzplanet.net/index.php?page=funding",
    "funding_instructions": "Top up your usable wallet to at least $5 USD, wait for verified credit, and retry the catalogue GET using the same key."
  },
  "request_id": "example"
}

Only catalogue access is subject to this minimum. Balance, account access, existing order history, delivery, refresh and eligible cancellation/refund actions remain available below it. Purchases and quotes use their existing rules. A purchase leaving less than $5 pauses subsequent catalogue requests.