Set up your organization

Organizations are created in the dashboard, not through the API. There are no create, update, or delete org endpoints. Everything below is what you can do with the organization you’ve been provisioned.

You’ll need an access token for every call below — see Authentication.

Read your organization

Your org ID identifies your organization on every call.

get_direct_org_info — your own organization’s details.
organization_info/{org_id} — a specific organization by ID.
organization_list — for MSSP accounts, every organization you manage.

All three return the same shape:

{
  "id": 412,
  "name": "Acme Corp",
  "domain": "acme.com",
  "email": "security@acme.com",
  "industry_type": { "id": 7, "name": "Manufacturing" },
  "country": { "id": 14, "name": "Germany" },
  "size": "201-500",
  "is_direct_org": true,
  "main_org_id": null,
  "used_credits": 1840,
  "license": {
    "features": ["Ransomwatch", "SpoofGuard", "Credit Card Leaks"],
    "is_active": false,
    "creation_date": null,
    "expiration_date": null
  }
}

What you can derive from it:

Field	What it tells you
`id`	The org ID to pass on every org-scoped call.
`license.features`	Which capabilities your plan includes — gate your integration on these.
`used_credits`	How much of your credit quota you’ve consumed.
`is_direct_org`, `main_org_id`	Where the org sits in an MSSP hierarchy — your own org, or a managed sub-org and its parent.
`industry_type`, `country`, `size`	Org profile, used for benchmarking and context.

Gate on license.features, not license.is_active. These three read endpoints don’t populate the subscription-status fields: is_active returns false and creation_date / expiration_date return null regardless of your actual subscription. Use license.features to check entitlements; your active status and renewal date live in the dashboard.

MSSP accounts manage multiple client organizations. List them with organization_list, then target one by its org_id.

Risk and exposure

Your organization’s risk score, leak statistics, trends, and competitor benchmarks have their own page — see Risk and exposure.

Alert frequency

How often your organization is alerted.

alert_system_setting_get_organization_alert_frequency — read the current setting.
alert_system_setting_update_organization_alert_frequency — change it.

Get started

Search

Leaked credentials

Assess & report

Monitor

Downloads & exports

Changelog

Set up your organization

Read your organization

Risk and exposure

Alert frequency

​Read your organization

​Risk and exposure

​Alert frequency

Read your organization

Risk and exposure

Alert frequency