@adcp/sdk API Reference - v7.9.0
    Preparing search index...

    Interface RightsConstraint

    Rights metadata attached to a creative manifest. Each entry represents constraints from a single rights holder. A creative may combine multiple rights constraints (e.g., talent likeness + music license). For v1, rights constraints are informational metadata — the buyer/orchestrator manages creative lifecycle against these terms.

    interface RightsConstraint {
        rights_id: string;
        rights_agent: { url: string; id: string };
        valid_from?: string;
        valid_until?: string;
        uses: RightUse[];
        countries?: string[];
        excluded_countries?: string[];
        impression_cap?: number;
        right_type?: RightType;
        approval_status?: "rejected" | "approved" | "pending";
        verification_url?: string;
        ext?: ExtensionObject;
    }
    Index

    Properties

    rights_id rights_agent valid_from? valid_until? uses countries? excluded_countries? impression_cap? right_type? approval_status? verification_url? ext?

    Properties

    rights_id: string

    Rights grant identifier from the acquire_rights response

    rights_agent: { url: string; id: string }

    The agent that granted these rights

    Type Declaration

    • url: string

      MCP endpoint URL of the rights agent

    • id: string

      Agent identifier

    valid_from?: string

    Start of the rights validity period

    date-time

    valid_until?: string

    End of the rights validity period. Creative should not be served after this time.

    date-time

    uses: RightUse[]

    Rights uses covered by this constraint

    countries?: string[]

    Countries where this creative may be served under these rights (ISO 3166-1 alpha-2). If omitted, no country restriction. When both countries and excluded_countries are present, the effective set is countries minus excluded_countries.

    excluded_countries?: string[]

    Countries excluded from rights availability (ISO 3166-1 alpha-2). Use when the grant is worldwide except specific markets.

    impression_cap?: number

    Maximum total impressions allowed for the full validity period (valid_from to valid_until). This is the absolute cap across all creatives using this rights grant, not a per-creative or per-period limit.

    1

    right_type?: RightType
    approval_status?: "rejected" | "approved" | "pending"

    Approval status from the rights holder at manifest creation time (snapshot, not a live value)

    verification_url?: string

    URL where downstream supply chain participants can verify this rights grant is active. Returns HTTP 200 with the current grant status, or 404 if revoked. Enables SSPs and verification vendors to confirm rights before serving.

    ext?: ExtensionObject

    Settings

    Member Visibility

    On This Page

    Properties