Skip to content
ObraXRAY

Embedded risk widget

Show the risk of any Portuguese company directly on your site. Drop-in, one script, zero dependencies.

Quickstart#

Pick the install method that matches your stack — the snippet is identical, only the surrounding setup changes.

<div data-obx-nif="514566680" data-obx-key="obx_pk_..."></div>
<script src="https://embed.obraxray.com/v1/obx-embed.js" async></script>

Configuration#

  • data-obx-nifPortuguese company NIF (9 digits)
  • data-obx-keyYour public obx_pk_… key (visible in HTML, restricted by domain)
  • data-obx-variantWidget appearance. Values: summary (default), compact, detailed. Details in the section below.
  • data-obx-langLocale for the badge labels: "pt" (default) or "en". Falls back to the closest <html lang>.

Variants#

Three appearances available to fit the space you have on your page. The SDK reads the data-obx-variant attribute and sets an initial size; a postMessage adjusts the final height once the content loads.

summary(default) · 100% × 80 px

Inline card with score, verdict, company name and last-update date. Best for a dedicated section on a company profile page.

Pré-visualização
<div data-obx-nif="514566680"
     data-obx-key="obx_pk_..."
     data-obx-variant="summary"></div>

compact180 × 180 px

Square badge with a colored icon and short verdict. Ideal next to a company name in a list or table.

Pré-visualização
<div data-obx-nif="514566680"
     data-obx-key="obx_pk_..."
     data-obx-variant="compact"></div>

detailed100% × ~240 px

Full panel with score, verdict and the preliminary check pills (no insolvencies, no PER, no tax/SS debts, IMPIC license, director count). Use when dedicating a visible section to company risk.

Pré-visualização
<div data-obx-nif="514566680"
     data-obx-key="obx_pk_..."
     data-obx-variant="detailed"></div>

Domain allowlist#

Each key is bound to a domain allowlist. Requests from other domains are rejected in two layers: server-side validation (Origin/Referer) and frame-ancestors CSP in the browser. To add or change domains, contact us.

Per-key rate limits#

120 burst renders, refilled at 60/min by default. Higher limits available for partners — contact us.

Privacy#

We do not store visitor IPs or user-agents from your site. Per-render telemetry contains only: timestamp, key prefix, queried NIF, partner domain, status, and latency.

Get a key#

Keys are issued manually per partner. Drop us a line at partners@obraxray.com