Authenticate and make your first request

curl -sS https://api.businessradar.com/ext/v3/portfolios \
  -H "Authorization: Bearer $BUSINESSRADAR_API_KEY"

import os

from businessradar import BusinessRadar

client = BusinessRadar(api_key=os.environ["BUSINESSRADAR_API_KEY"])

page = client.portfolios.list()
for portfolio in page.results:
    print(portfolio.external_id, portfolio.name)

import BusinessRadar from '@businessradar/businessradar';

const client = new BusinessRadar({ apiKey: process.env['BUSINESSRADAR_API_KEY'] });

const page = await client.portfolios.list();
for (const portfolio of page.results) {
  console.log(portfolio.external_id, portfolio.name);
}

<?php

use Businessradar\Client;

$client = new Client(apiKey: getenv('BUSINESSRADAR_API_KEY'));

$page = $client->portfolios->list();
foreach ($page->getItems() as $portfolio) {
    echo $portfolio->external_id, ' ', $portfolio->name, PHP_EOL;
}

curl -sS "https://api.businessradar.com/ext/v3/portfolios?next_key=eyJvZmZzZXQiOjUwfQ" \
  -H "Authorization: Bearer $BUSINESSRADAR_API_KEY"

# Iterating the page fetches the next page automatically.
for portfolio in client.portfolios.list():
    print(portfolio.name)

for await (const portfolio of client.portfolios.list()) {
  console.log(portfolio.name);
}

<?php

foreach ($client->portfolios->list()->pagingEachItem() as $portfolio) {
    echo $portfolio->name, PHP_EOL;
}

client.with_options(max_retries=5).portfolios.list()

// Request options are the second argument, after the query.
await client.portfolios.list({}, { maxRetries: 5 });

<?php

$client->portfolios->list(requestOptions: ['maxRetries' => 5]);

# -f makes curl exit non-zero on 4xx/5xx; -i shows the status line and headers.
curl -fi -sS https://api.businessradar.com/ext/v3/portfolios \
  -H "Authorization: Bearer $BUSINESSRADAR_API_KEY" || echo "request failed"

import businessradar

try:
    page = client.portfolios.list()
except businessradar.AuthenticationError:
    print("The API key was rejected (401).")
except businessradar.RateLimitError:
    print("429 — back off and retry later.")
except businessradar.APIStatusError as error:
    print(error.status_code, error.response)
except businessradar.APIConnectionError as error:
    print("The server could not be reached:", error.__cause__)

const page = await client.portfolios.list().catch((error) => {
  if (error instanceof BusinessRadar.APIError) {
    console.log(error.status, error.name);
    return undefined;
  }
  throw error;
});

<?php

use Businessradar\Core\Exceptions\APIConnectionException;
use Businessradar\Core\Exceptions\APIStatusException;
use Businessradar\Core\Exceptions\RateLimitException;

try {
    $page = $client->portfolios->list();
} catch (RateLimitException $e) {
    echo '429 — back off and retry later.', PHP_EOL;
} catch (APIStatusException $e) {
    echo $e->getMessage(), PHP_EOL;
} catch (APIConnectionException $e) {
    echo 'The server could not be reached.', PHP_EOL;
}

#!/usr/bin/env bash
set -euo pipefail

: "${BUSINESSRADAR_API_KEY:?export your API key first}"
BASE=https://api.businessradar.com/ext/v3

next_key=""
while :; do
  url="$BASE/portfolios"
  [ -n "$next_key" ] && url="$url?next_key=$next_key"

  response=$(curl -fsS "$url" \
    -H "Authorization: Bearer $BUSINESSRADAR_API_KEY") || {
      echo "request failed — check the key and try again" >&2
      exit 1
    }

  echo "$response" | jq -r '.results[] | "\(.external_id)\t\(.name)"'

  next_key=$(echo "$response" | jq -r '.next_key // empty')
  [ -z "$next_key" ] && break
done

import os
import sys

import businessradar
from businessradar import BusinessRadar

client = BusinessRadar(api_key=os.environ["BUSINESSRADAR_API_KEY"])

try:
    # The client follows next_key on its own when you iterate the pager.
    for portfolio in client.portfolios.list():
        print(portfolio.external_id, portfolio.name)
except businessradar.AuthenticationError:
    sys.exit("The API key was rejected (401). Check BUSINESSRADAR_API_KEY.")
except businessradar.RateLimitError:
    sys.exit("429 — back off and retry later.")
except businessradar.APIStatusError as error:
    sys.exit(f"{error.status_code}: {error.response}")

import BusinessRadar from '@businessradar/businessradar';

const client = new BusinessRadar({ apiKey: process.env['BUSINESSRADAR_API_KEY'] });

try {
  // for await walks every page; no cursor bookkeeping needed.
  for await (const portfolio of client.portfolios.list()) {
    console.log(portfolio.external_id, portfolio.name);
  }
} catch (error) {
  if (error instanceof BusinessRadar.APIError) {
    console.error(error.status, error.name);
    process.exit(1);
  }
  throw error;
}

<?php

require 'vendor/autoload.php';

use Businessradar\Client;
use Businessradar\Core\Exceptions\APIStatusException;

$client = new Client(apiKey: getenv('BUSINESSRADAR_API_KEY'));

try {
    // pagingEachItem() requests the next page as you consume the current one.
    foreach ($client->portfolios->list()->pagingEachItem() as $portfolio) {
        echo $portfolio->external_id, ' ', $portfolio->name, PHP_EOL;
    }
} catch (APIStatusException $e) {
    fwrite(STDERR, $e->getMessage() . PHP_EOL);
    exit(1);
}