---
title: "Get domain usage counts"
method: GET
path: "/usage"
tags: ["Usage"]
---

# Get domain usage counts

`GET /usage`

## Request

- Base URL: `https://api.palisade.email`
- URL: `https://api.palisade.email/usage`
- Auth: one of:
  - HTTP bearer
  - HTTP basic

## Query parameters

- `date_from` string, date, required
- `date_to` string, date, required
- `expand` string[]

## Headers

- `Palisade-Version` '2025-04-30' | 'unstable', required

## Response `200`

Success

- Usage
  - `active_domains` number, required
  - `inactive_domains` number, required
  - `parked_domains` number, required
  - `deleted_domains` number, required
  - `domains` object[]
    - `id` string, uuid, required
    - `url` string, required
    - `is_active` boolean, required
    - `is_parked` boolean, required
    - `organization_id` string, uuid, required
  - `organizations` object[]
    - `id` string, uuid, required
    - `name` string, required
    - `active_domains` number, required
    - `inactive_domains` number, required
    - `parked_domains` number, required
    - `is_trialing` boolean, required
    - `line_items` LineItem[]
      - `sku` 'DOMAIN-ACTIVE-TRIAL' | 'DOMAIN-ACTIVE-FREE' | 'DOMAIN-ACTIVE-1TO10' | 'DOMAIN-ACTIVE-11TO100' | 'DOMAIN-ACTIVE-101TO1000' | 'DOMAIN-ACTIVE-1001PLUS' | 'DOMAIN-INACTIVE' | 'DOMAIN-PARKED' | 'AGENT-ADDON', required
      - `quantity` number, required
  - `line_items` LineItem[]
    - `sku` 'DOMAIN-ACTIVE-TRIAL' | 'DOMAIN-ACTIVE-FREE' | 'DOMAIN-ACTIVE-1TO10' | 'DOMAIN-ACTIVE-11TO100' | 'DOMAIN-ACTIVE-101TO1000' | 'DOMAIN-ACTIVE-1001PLUS' | 'DOMAIN-INACTIVE' | 'DOMAIN-PARKED' | 'AGENT-ADDON', required
    - `quantity` number, required
  - `aligned_messages` integer: How many messages authenticated as the organization's own mail (SPF- or DKIM-aligned) were reported over the requested range, across the organization and any active children. This is the volume an IT teams tier is sold against. Returned only when requested through expand, since it aggregates the DMARC report table.

---

[API](https://skmtc.dev/palisade/apis/palisade-api.md) · [All operations](https://skmtc.dev/palisade/apis/palisade-api/llms.txt) · [OpenAPI document](https://skmtc.dev/palisade/apis/palisade-api/revisions/37b4ae5a7766?raw)