---
title: "List organization seals"
method: GET
path: "/seals"
tags: ["Organization Seals"]
---

# List organization seals

`GET /seals`

List organization seal heads for the company. Returns active (non-revoked, non-deleted) seal heads by default. Pass include_revoked=true to include revoked heads.

## Query parameters

- `include_revoked` boolean
- `workspace_id` string, uuid

## Response `200`

Seal list retrieved successfully

- object
  - `seals` OrganizationSeal[], required
    - `id` string, uuid
    - `lineage_id` string, uuid — Shared across versions of the same seal
    - `version` integer
    - `companies_id` string, uuid
    - `companies_workspaces_id` string, uuid, nullable — Null for company-scope seals
    - `authority_name` string, nullable — The name the seal was attested for: the company for company scope or the protected workspace, otherwise the workspace. Null for seals whose lineage was created before pinning; they certify in the company's current name.
    - `name` string
    - `display_name` string
    - `signatory_title` string, nullable
    - `kind` 'uploaded' | 'typed' | 'drawn'
    - `is_default` 0 | 1 — 1 if this is the default seal for its scope
    - `statement_language` string
    - `statement_version` integer
    - `signatory_name` string
    - `signatory_title_attested` string, nullable
    - `attested_at` string, date-time
    - `revoked_on` string, date-time, nullable
    - `created_at` string, date-time
    - `deleted` 0 | 1

## Other responses

- `401` — Unauthorized - Invalid or missing API key
- `403` — Forbidden - Insufficient permissions
- `429` — Too Many Requests - Rate limit exceeded

## Changes

- **2026-09-17** `369590c8c416` — 1 info
  - added the optional property `seals/items/authority_name` to the response with the `200` status
- **2026-09-15** `f179958c3bee` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/firma/apis/firma-partner-api/changes/seals/get.md)

---

[API](https://skmtc.dev/firma/apis/firma-partner-api.md) · [All operations](https://skmtc.dev/firma/apis/firma-partner-api/llms.txt) · [OpenAPI document](https://skmtc.dev/firma/apis/firma-partner-api/revisions/12d1aae71d9a?raw)