> ## Documentation Index
> Fetch the complete documentation index at: https://wiki.darknetsearch.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Set up your organization

> Organizations are created in the dashboard — here's how to read and work with yours via the API.

<Info>
  **Organizations are created in the [dashboard](https://dashboard.darknetsearch.com), 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.
</Info>

You'll need an access token for every call below — see [Authentication](/api/guides/authentication).

### Read your organization

Your **org ID** identifies your organization on every call.

* [`get_direct_org_info`](https://client-api.leak.center/scalar-docs/#tag/organization-settings/GET/service/get_direct_org_info/) — your own organization's details.
* [`organization_info/{org_id}`](https://client-api.leak.center/scalar-docs/#tag/organization-settings/GET/service/organization_info/\{org_id}/) — a specific organization by ID.
* [`organization_list`](https://client-api.leak.center/scalar-docs/#tag/organization-settings/GET/service/organization_list/) — for MSSP accounts, every organization you manage.

All three return the same shape:

```json theme={"dark"}
{
  "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.                                              |

<Warning>
  **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](https://dashboard.darknetsearch.com).
</Warning>

<Info>
  **MSSP accounts** manage multiple client organizations. List them with `organization_list`, then target one by its `org_id`.
</Info>

### Risk and exposure

Your organization's risk score, leak statistics, trends, and competitor benchmarks have their own page — see **[Risk and exposure](/api/guides/risk-score)**.

### Alert frequency

How often your organization is alerted.

* [`alert_system_setting_get_organization_alert_frequency`](https://client-api.leak.center/scalar-docs/#tag/alert-system/GET/service/alert_system_setting_get_organization_alert_frequency/) — read the current setting.
* [`alert_system_setting_update_organization_alert_frequency`](https://client-api.leak.center/scalar-docs/#tag/alert-system/PUT/service/alert_system_setting_update_organization_alert_frequency/) — change it.