SDKs & CLI

Official clients for TypeScript/JavaScript, PHP, and your terminal.

TypeScript / JavaScript

shell

npm install @brivio/sdk

TypeScript

import { BrivioClient } from "@brivio/sdk";

const brivio = new BrivioClient({ apiKey: process.env.BRIVIO_API_KEY! });

const invoices = await brivio.invoices.list({ status: "issued" });
for (const inv of invoices.data) console.log(inv.number, inv.total);

Typed end-to-end (types generated from the OpenAPI spec), automatic retries with backoff on 429/5xx, idempotency-key support on all mutations, and full coverage of the REST surface — invoices, contacts, e-Factura, inventory, trust signatures, DNS/domains, webhooks and more.

PHP

shell

composer require brivio/sdk

PHP

use Brivio\BrivioClient;

$brivio = new BrivioClient(apiKey: getenv('BRIVIO_API_KEY'));
$invoice = $brivio->invoices->create([
    'contact_id' => $contactId,
    'currency' => 'RON',
    'items' => [['description' => 'Servicii', 'quantity' => 1, 'unit_price' => '1000.00', 'vat_rate' => '21']],
]);

Includes drop-in compatibility shims for migrating from FGO, SmartBill and Oblio.

CLI

shell

npm install -g @brivio/cli

brivio login              # save your API key
brivio me                 # show current organization
brivio invoices list      # list invoices
brivio contacts create --name "Acme SRL" --type COMPANY
brivio trust sign ./contract.pdf   # request a digital signature
brivio api-keys rotate KEY_ID --grace 24

Every command supports --json for scripting. Configuration lives in ~/.config/brivio.