Interface AcquireRightsAcquired

Type Declaration

• required: boolean

  Whether disclosure is required

• Optionaltext?: string

  Disclosure text to include with the creative

Type Declaration

• rights_id: string

  Rights grant identifier from the acquire_rights response

• rights_agent: { url: string; id: string }

  The agent that granted these rights

  • url: string

    MCP endpoint URL of the rights agent

  • id: string

    Agent identifier

• Optionalrights_holder?: BrandReference

• Optionalvalid_from?: string

  Start of the rights validity period

• Optionalvalid_until?: string

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

• uses: [RightUse, ...RightUse[]]

  Rights uses covered by this constraint

  Min Items

  1

• Optionalcountries?: 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.

• Optionalexcluded_countries?: string[]

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

• Optionalimpression_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.

• Optionalright_type?: RightType

• Optionalapproval_status?: "rejected" | "approved" | "pending"

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

• Optionalgrant_status?: "active" | "paused" | "revoked"

  Authoritative lifecycle state bound into the grant digest and credential status evidence. Only active can evaluate to verified. paused and revoked credentials are ineligible for serving; resumption issues a fresh active credential and reference.

• Optionalrestrictions?: [string, ...string[]]

  Normalized enforceable content and usage restrictions issued with the grant. When present these values are part of content_digest and cannot be omitted or changed without invalidating the attestation.

  Min Items

  1

• Optionaldisclosure?: {}

  Disclosure obligation issued with the grant and bound by content_digest.

• Optionalcreative_approval_required?: boolean

  Whether each creative produced under this grant requires holder approval before distribution. This enforceable term is bound by content_digest.

• Optionalverification_url?: string

  Deprecated

  DEPRECATED legacy informational locator. It is not proof of grant status, a revocation source, a credential locator, or permission to make a network request. Receivers MUST NOT fetch it during rights evaluation, and HTTP status codes have no AdCP authorization meaning. Rights authorization uses attestation_refs and a verifier-of-record evaluation under evaluator-owned policy.

• Optionalcontent_digest?: string

  SHA-256 of UTF8(JCS(rights_constraint minus content_digest, attestation_refs, and verification_url)), formatted as sha256:. This binds all serving-relevant grant fields, including future extension fields, while deliberately excluding the legacy non-authoritative URL.

• Optionalattestation_refs?: (
      {
          issuer: AttestationIssuer;
          claim_type: string;
          subject: AttestationSubject;
          locator?: | AttestationCredentialUriLocator
          | AttestationIssuerCredentialIdLocator;
          embedded_credential?: {
              format: string;
              value: string
              | {};
              ext?: ExtensionObject;
          };
          content_digest?: string;
          credential_version?: string;
          validity_hint?: { not_before?: string; expires_at?: string };
          verify_agent?: { agent_url: string };
          ext?: ExtensionObject;
      } & {
          issuer?: { type: "brand"; brand: BrandReference };
          claim_type?: "https://adcontextprotocol.org/claims/rights/grant";
          subject?: {
              type: "resource";
              resource_type: "https://adcontextprotocol.org/claims/subjects/rights-grant";
          };
      }
  )[]

  Alternative portable presentations of a holder-issued rights-grant credential signed by its authorized rights agent. The buyer carries references only; the serving party remains verifier-of-record. At least one reference must evaluate to verified and match rights_holder, rights_id, rights_agent, content_digest, validity, revocation state, and local policy before this constraint can contribute to serving eligibility.

  Min Items

  1

  Max Items

  4

• Optionalext?: ExtensionObject

• rights_id: string

  Rights grant identifier from the acquire_rights response

• rights_agent: { url: string; id: string }

  The agent that granted these rights

  • url: string

    MCP endpoint URL of the rights agent

  • id: string

    Agent identifier

• Optionalrights_holder?: BrandReference

• Optionalvalid_from?: string

  Start of the rights validity period

• Optionalvalid_until?: string

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

• uses: [RightUse, ...RightUse[]]

  Rights uses covered by this constraint

  Min Items

  1

• Optionalcountries?: 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.

• Optionalexcluded_countries?: string[]

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

• Optionalimpression_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.

• Optionalright_type?: RightType

• Optionalapproval_status?: "rejected" | "approved" | "pending"

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

• Optionalgrant_status?: "active" | "paused" | "revoked"

  Authoritative lifecycle state bound into the grant digest and credential status evidence. Only active can evaluate to verified. paused and revoked credentials are ineligible for serving; resumption issues a fresh active credential and reference.

• Optionalrestrictions?: [string, ...string[]]

  Normalized enforceable content and usage restrictions issued with the grant. When present these values are part of content_digest and cannot be omitted or changed without invalidating the attestation.

  Min Items

  1

• Optionaldisclosure?: {}

  Disclosure obligation issued with the grant and bound by content_digest.

• Optionalcreative_approval_required?: boolean

  Whether each creative produced under this grant requires holder approval before distribution. This enforceable term is bound by content_digest.

• Optionalverification_url?: string

  Deprecated

  DEPRECATED legacy informational locator. It is not proof of grant status, a revocation source, a credential locator, or permission to make a network request. Receivers MUST NOT fetch it during rights evaluation, and HTTP status codes have no AdCP authorization meaning. Rights authorization uses attestation_refs and a verifier-of-record evaluation under evaluator-owned policy.

• Optionalcontent_digest?: string

  SHA-256 of UTF8(JCS(rights_constraint minus content_digest, attestation_refs, and verification_url)), formatted as sha256:. This binds all serving-relevant grant fields, including future extension fields, while deliberately excluding the legacy non-authoritative URL.

• Optionalattestation_refs?: (
      {
          issuer: AttestationIssuer;
          claim_type: string;
          subject: AttestationSubject;
          locator?: | AttestationCredentialUriLocator
          | AttestationIssuerCredentialIdLocator;
          embedded_credential?: {
              format: string;
              value: string
              | {};
              ext?: ExtensionObject;
          };
          content_digest?: string;
          credential_version?: string;
          validity_hint?: { not_before?: string; expires_at?: string };
          verify_agent?: { agent_url: string };
          ext?: ExtensionObject;
      } & {
          issuer?: { type: "brand"; brand: BrandReference };
          claim_type?: "https://adcontextprotocol.org/claims/rights/grant";
          subject?: {
              type: "resource";
              resource_type: "https://adcontextprotocol.org/claims/subjects/rights-grant";
          };
      }
  )[]

  Alternative portable presentations of a holder-issued rights-grant credential signed by its authorized rights agent. The buyer carries references only; the serving party remains verifier-of-record. At least one reference must evaluate to verified and match rights_holder, rights_id, rights_agent, content_digest, validity, revocation state, and local policy before this constraint can contribute to serving eligibility.

  Min Items

  1

  Max Items

  4

• Optionalext?: ExtensionObject