Operations

Decide a Trust Model v3 manual-verification submission

Approves or rejects one current private entity/license submission. A human needs fresh AAL2 and complete_manual_verification; an external back-office agent needs that exact action on its active key. The submitter and current business owners cannot approve. Rejection should include a controlled owner_reason_code and always carries a separate private audited reason; for backward compatibility only, an omitted rejection code maps to the controlled generic other copy. Approval forbids owner_reason_code. Every official_source_manual decision requires the exact nonempty authority name and valid HTTPS source URL; document_review cannot carry an external source. official_record_not_found is additionally limited to a rejected official_source_manual review. Approval requires method-specific checks, reviewer-supplied validity within the factor/method ceiling, exact non-wildcard taxonomy scope for a licence, and exact type-to-confirm. The Loppee service writes the receipt and derives class; the caller cannot set either.

post/v1/admin/v3/manual-verification-submissions/{submission_id}/decision

Request

  • Base URL: https://loppee.com
  • URL: https://loppee.com/v1/admin/v3/manual-verification-submissions/{submission_id}/decision
  • Auth: one of:
    • HTTP bearer
    • API key in header X-LOPPEE-API-Key

Path parameters

submission_idstring required

submission id path identifier.

Request body

outcome'approved' | 'rejected' required
verification_method'official_source_manual' | 'document_review' required
source_authoritystring

Exact official authority name. Required for every official_source_manual decision; document_review cannot carry an external authority.

source_urlstring uri

Exact HTTPS official source URL. Required for every official_source_manual decision and forbidden for document_review.

reasonstring required
owner_reason_code'wrong_document_type' | 'identifier_mismatch' | 'holder_mismatch' | 'inactive_or_expired' | 'official_record_not_found' | 'qa_synthetic_fixture' | 'other'

Controlled owner-visible rejection reason. New clients should always send it for rejection; omission maps to other only for legacy compatibility. official_record_not_found requires outcome=rejected, verification_method=official_source_manual, and valid official source fields.

observed_atstring date-time
valid_untilstring date-time
credential_expires_atstring date

Expiration date printed on the license. Required for an approved license submission and kept separate from Loppee's internal recheck valid_until.

verified_service_scopestring[]
identifier_matchboolean
holder_name_matchboolean
active_or_good_standingboolean
confirmation'APPROVE VERIFICATION' | 'REJECT VERIFICATION' required

Response

Decide a Trust Model v3 manual-verification submission response

object required

Immutable audited manual-verification decision receipt.

Changes

No recorded changes to this operation across all 1 revision of this API.