HYBRID-CHAINDEVELOPERS
DOCUMENTATIONv2

TRUST & DATA · MODULE 26

Trust Center

Give an authenticated subject a consent-aware, policy-versioned trust workflow: discover requirements, start and monitor verification, inspect minimized attestation and credential commitments, and manage allowlisted self-asserted claims without exposing regulated evidence or collapsing issuer, reviewer, provider, subject, and relying-party authority.

BUSINESS CASES

Where this module fits

  • identity onboarding
  • policy, consent, and retention disclosure
  • KYC/AML posture review
  • age or eligibility commitment review
  • credential and attestation lifecycle reconciliation
  • subject claim management

PRIMARY CONSUMERS

Who integrates it

  • identity subjects
  • consent-aware onboarding applications
  • trust and verification agents
  • credential issuers and relying-party integrators

PREREQUISITES

What must exist first

  • subject-scoped trust authority for subject actions, with separate issuer or reviewer authority for their own future lifecycles
  • an applicable policy ID, immutable version, jurisdiction, evidence purpose, consent record, and retention basis
  • a relying-party rule for acceptable issuer, proof type, lifecycle, freshness, assurance, disclosure, and revocation checking

RECOMMENDED WORKFLOW

Compose the module safely.

  1. 01

    fetch current verification policy and sanctions-source posture

  2. 02

    select the least intrusive applicable policy and disclose checks, evidence classes, freshness, jurisdiction, and retention before consent

  3. 03

    start one idempotent subject-owned verification through the canonical trust lifecycle

  4. 04

    poll minimized verification state and distinguish capture, check completion, review, and final decision

  5. 05

    evaluate credential or attestation lifecycle, validity, issuer proof, assurance, and commitments under the relying-party policy

  6. 06

    manage private self-asserted claims separately from verification evidence and issuer-backed credentials

MODULE CONTRACTS

Every mapped endpoint

Each operation states whether its request shape is authoritative in OpenAPI, reviewed as a planning profile, or intentionally left as an outline pending an owner schema.

POSTValidate identity/api/v2/identity/validatePlanned capability: apply the requested transition to validate identity through the authoritative trust service boundary.GETGet account closure request/api/v2/account-closure-requests/{request_uuid}Return the authenticated subject's authoritative account-closure lifecycle state.POSTCancel account closure request/api/v2/account-closure-requests/{request_uuid}/cancellationsCancel an eligible closure request after fresh authenticator verification when required.GETGet login policy/api/v2/admin/identity/login-policyRead provider readiness and tenant login-method policy with administrator authority.PUTUpdate login policy/api/v2/admin/identity/login-policyPublish tenant login-method policy with administrator authority and purpose-bound step-up authorization.POSTBegin federated authorization/api/v2/auth/federation/{provider}/authorizationsCreate a one-time server-owned OAuth authorization-code and PKCE transaction for Google, Apple, or GitHub.POSTExchange federated authorization/api/v2/auth/federation/{provider}/exchangesVerify and consume a provider authorization response once, then issue a Hybrid session or complete an explicit account link.POSTRefresh session/api/v2/auth/session-refreshesRotate a single-use refresh credential and issue the next V2 credential pair.POSTExchange workload assertion/api/v2/auth/workload-token-exchangesVerify a one-time Ed25519 private-key JWT assertion and issue a refreshless, network-bound scoped workload bearer with a 15-minute default and network-specific lifetime cap.GETGet contact projection/api/v2/me/contactReturn the authenticated subject's email and phone verification projection.POSTRequest email change/api/v2/me/contact/email-change-requestsAuthenticate a proposed email replacement and deliver a 15-minute one-time token to the new address.POSTConfirm email change/api/v2/me/contact/email-change-requests/confirmConsume the one-time email token, atomically replace the address, and revoke active sessions.POSTRequest phone change/api/v2/me/contact/phone-change-requestsAuthenticate a proposed E.164 phone replacement and deliver a 15-minute one-time SMS token.POSTConfirm phone change/api/v2/me/contact/phone-change-requests/confirmConsume the one-time SMS token, atomically replace the phone, and revoke active sessions.GETGet preferences/api/v2/me/preferencesReturn locale, timezone, language, base currency, theme, developer experience, Business Network mode, and workspace ordering preferences.PUTUpdate preferences/api/v2/me/preferencesUpdate the complete submitted account preference subset through a signed mutation.GETGet privacy settings/api/v2/me/privacyReturn visibility controls without embedding the full user record.PUTUpdate privacy settings/api/v2/me/privacyUpdate visibility controls through a signed mutation.GETGet core profile/api/v2/me/profileReturn identity, account type, display name, and names without contact, preference, privacy, or verification data.PATCHUpdate core profile/api/v2/me/profileUpdate only the authenticated subject's personal or company names through a signed mutation.GETGet verification summary/api/v2/me/verification-summaryReturn current assurance, decision, completion, and retention posture without evidence payloads.GETGet workspace preferences/api/v2/me/workspaces/{workspace_uuid}/preferencesReturn the authenticated member's experience preferences for one workspace, including its default wallet environment.PUTUpdate workspace preferences/api/v2/me/workspaces/{workspace_uuid}/preferencesSet or clear the authenticated member's default wallet environment for one workspace through a signed mutation.POSTCreate identity/api/v2/identitiesPlanned capability: apply the requested transition to identity through the authoritative trust service boundary.GETGet identity details/api/v2/identities/{identity_uuid}Planned capability: return identity details through the authoritative trust service boundary.GETGet subject transfer credentials/api/v2/identity/transfer-credentials/subject/profile/{profile_uuid}Planned capability: return manage subject transfer credentials through the authoritative trust service boundary.POSTUpdate subject transfer credentials/api/v2/identity/transfer-credentials/subject/profile/{profile_uuid}Planned capability: apply the requested transition to manage subject transfer credentials through the authoritative trust service boundary.POSTActivate account/api/v2/account-activationsConsume a one-time activation credential, activate the account, and return the canonical activation receipt.GETList linked bank accounts/api/v2/funding/bank-accountsReturn the authenticated profile's linked bank accounts with opaque identifiers, masked IBANs, currencies, and verification state; full account numbers and legacy database identifiers are excluded.GETGet referral summary/api/v2/growth/referralsReturn referral codes and aggregate usage for the authenticated profile without exposing referred-user identities, contact details, commission data, downline graphs, or the legacy user JSON.GETGet wallet balances/api/v2/ledger/accounts/{account_id}/balancesList wallet balances through the authoritative custody service boundary.GETGet current profile/api/v2/meReturn the authenticated identity's current purpose-limited profile projection.PATCHUpdate current profile/api/v2/meUpdate allowlisted current-profile fields through the authoritative Identity profile service.GETList authentication events/api/v2/me/authentication-eventsList successful password and federated sign-ins with redacted device context and integrity-protected cursor pagination.GETGet profile avatar image/api/v2/me/avatarPlanned capability: list profile avatar image through the authoritative trust service boundary.POSTUpload profile avatar image/api/v2/me/avatarPlanned capability: apply the requested transition to upload profile avatar image through the authoritative trust service boundary.GETGet effective capabilities/api/v2/me/capabilitiesReturn effective profile scopes and security features for the authenticated identity.PUTChange password/api/v2/me/passwordRequire bearer authorization, current-password proof, conditional authenticator step-up, and revoke active sessions.GETGet symbol watchlist/api/v2/me/watchlistList symbol watchlist through the authoritative trust service boundary.DELETERemove symbol from watchlist/api/v2/me/watchlist/{market_id}Apply the requested transition to symbol from watchlist through the authoritative trust service boundary.PUTAdd symbol to watchlist/api/v2/me/watchlist/{market_id}Apply the requested transition to add symbol to watchlist through the authoritative trust service boundary.POSTRequest reset link/api/v2/password-reset-requestsApply the requested transition to reset link through the authoritative trust service boundary.POSTReset password/api/v2/password-resetsApply the requested transition to reset password through the authoritative trust service boundary.GETGet tenant brand/api/v2/tenant-brandReturn the authenticated tenant's presentation-safe names, theme, assets, links, and labels without exposing policy, credential, banking, registration, or infrastructure configuration.GETIntrospect mobile identity session/api/v2/identity/mobile/introspectPlanned capability: list introspect mobile identity session through the authoritative trust service boundary.POSTRefresh mobile identity session/api/v2/identity/mobile/refreshPlanned capability: apply the requested transition to refresh mobile identity session through the authoritative trust service boundary.POSTRevoke mobile identity session/api/v2/identity/mobile/revokePlanned capability: apply the requested transition to mobile identity session through the authoritative trust service boundary.GETGet mobile identity security/api/v2/identity/mobile/securityPlanned capability: list manage mobile identity security through the authoritative trust service boundary.POSTUpdate mobile identity security/api/v2/identity/mobile/securityPlanned capability: apply the requested transition to manage mobile identity security through the authoritative trust service boundary.POSTCreate mobile identity session/api/v2/identity/mobile/sessionPlanned capability: apply the requested transition to mobile identity session through the authoritative trust service boundary.GETGet all affiliate programs for whitelabeling/api/v2/identity/whitelabelsPlanned capability: list all affiliate programs for whitelabeling through the authoritative trust service boundary.GETGet whitelabel meta for whitelabel hash/api/v2/identity/whitelabels/hash/{whitelabel_hash}Planned capability: return whitelabel meta for whitelabel hash through the authoritative trust service boundary.GETGet whitelabel hash for profile uuid/api/v2/identity/whitelabels/profile/{profile_uuid}/hashPlanned capability: list whitelabel hash for profile uuid through the authoritative trust service boundary.GETGet whitelabel symbol for profile uuid/api/v2/identity/whitelabels/profile/{profile_uuid}/symbolPlanned capability: list whitelabel symbol for profile uuid through the authoritative trust service boundary.GETGet status/api/v2/identity/statusReturn the current posture for status through the authoritative trust service boundary.GETNews publications/api/v2/newsList published newsroom entries through a stable public contract with bounded pagination plus optional category and featured-content filters.GETNews publication/api/v2/news/{identifier}Return one published newsroom entry by its canonical public identifier for article, feed, or developer-portal presentation.GETNews publication verification/api/v2/news/{identifier}/verifyReturn the publication's integrity and provenance verification projection separately from its editorial content.GETMobile messaging device status/api/v2/identity/messaging/device-status/{session_id}Return mobile messaging device status through the authoritative trust service boundary.POSTRegister messaging device keys/api/v2/identity/mobile/messaging/deviceBind one authenticated application installation to independently generated Ed25519 signing and X25519 encryption public keys after proof of possession, then return a signed device credential.GETIssue messaging ticket/api/v2/identity/mobile/messaging/ticketIssue a short-lived device- and session-bound messaging ticket for an installation with an active signed device credential.GETList attestations/api/v2/identity/attestationsPlanned capability: return the assurance state for attestations through the authoritative trust service boundary.GETGet attestation/api/v2/identity/attestations/{credential_uuid}Planned capability: return the assurance state for attestation through the authoritative trust service boundary.POSTCreate attestation challenge/api/v2/identity/attestations/{credential_uuid}/challengePlanned capability: apply the requested transition to attestation challenge through the authoritative trust service boundary.POSTCreate attestation presentation/api/v2/identity/attestations/{credential_uuid}/presentationPlanned capability: apply the requested transition to attestation presentation through the authoritative trust service boundary.POSTUpdate attestation status/api/v2/identity/attestations/{credential_uuid}/statusPlanned capability: apply the requested transition to attestation status through the authoritative trust service boundary.POSTVerify attestation presentation/api/v2/identity/attestations/{credential_uuid}/verifyPlanned capability: apply the requested transition to attestation presentation through the authoritative trust service boundary.POSTIssue attestation/api/v2/identity/attestations/issue/{identity_uuid}Planned capability: apply the requested transition to issue attestation through the authoritative trust service boundary.GETGet attestation issuer/api/v2/identity/attestations/issuerPlanned capability: return the assurance state for attestation issuer through the authoritative trust service boundary.GETGet subject attestations/api/v2/identity/attestations/subject/profile/{profile_uuid}Planned capability: return the assurance state for subject attestations through the authoritative trust service boundary.POSTUpdate subject attestation status/api/v2/identity/attestations/subject/profile/{profile_uuid}/{credential_uuid}/statusPlanned capability: apply the requested transition to subject attestation status through the authoritative trust service boundary.GETGet subject claims/api/v2/identity/attestations/subject/profile/{profile_uuid}/claimsPlanned capability: return the assurance state for manage subject claims through the authoritative trust service boundary.POSTUpdate subject claims/api/v2/identity/attestations/subject/profile/{profile_uuid}/claimsPlanned capability: apply the requested transition to manage subject claims through the authoritative trust service boundary.POSTIssue subject attestation/api/v2/identity/attestations/subject/profile/{profile_uuid}/issuePlanned capability: apply the requested transition to issue subject attestation through the authoritative trust service boundary.GETList verification policies/api/v2/identity/verification/policiesList the versioned identity-verification policies available to the authenticated subject, including assurance levels, retention periods, required checks, and freshness windows so a person or agent can select a policy before starting verification.GETGet verification review queue/api/v2/identity/verification/reviewPlanned capability: return the assurance state for manage verification review queue through the authoritative trust service boundary.POSTUpdate verification review queue/api/v2/identity/verification/reviewPlanned capability: apply the requested transition to manage verification review queue through the authoritative trust service boundary.POSTAssign verification reviewer/api/v2/identity/verification/review/assignPlanned capability: apply the requested transition to assign verification reviewer through the authoritative trust service boundary.GETVerification evidence/api/v2/identity/verification/review/evidence/{evidence_uuid}Planned capability: return the assurance state for verification evidence through the authoritative trust service boundary.POSTFinalize verification case/api/v2/identity/verification/review/finalizePlanned capability: apply the requested transition to finalize verification case through the authoritative trust service boundary.POSTRequest verification screening/api/v2/identity/verification/review/screenPlanned capability: apply the requested transition to verification screening through the authoritative trust service boundary.GETList sanctions source posture/api/v2/identity/verification/sanctions/sourcesList the purpose-limited coverage and freshness posture of first-party sanctions sources without exposing source URLs, downloaded-content hashes, error messages, or screening evidence.GETGet subject verification/api/v2/identity/verification/subject/profile/{profile_uuid}Planned capability: return the assurance state for manage subject verification through the authoritative trust service boundary.POSTUpdate subject verification/api/v2/identity/verification/subject/profile/{profile_uuid}Planned capability: apply the requested transition to manage subject verification through the authoritative trust service boundary.POSTCapture subject verification evidence/api/v2/identity/verification/subject/profile/{profile_uuid}/{session_uuid}/evidencePlanned capability: apply the requested transition to capture subject verification evidence through the authoritative trust service boundary.POSTLoad aristaflow widget/api/v2/kyc/aristaflow/widgetPlanned capability: apply the requested transition to load aristaflow widget through the authoritative trust service boundary.POST2. submit address kyc data/api/v2/kycaml/addressdataPlanned capability: apply the requested transition to 2. submit address kyc data through the authoritative trust service boundary.POST3. submit kyc identification data/api/v2/kycaml/identificationdataPlanned capability: apply the requested transition to 3. submit kyc identification data through the authoritative trust service boundary.POST1. submit profile kyc data/api/v2/kycaml/personaldataPlanned capability: apply the requested transition to 1. submit profile kyc data through the authoritative trust service boundary.POST4. submit kyc selfie data/api/v2/kycaml/selfiedataPlanned capability: apply the requested transition to 4. submit kyc selfie data through the authoritative trust service boundary.GETGet all approved kyc submissions/api/v2/admin/approved_kycsPlanned capability: list all approved kyc submissions through the authoritative trust service boundary.POSTSet kyc stage status/api/v2/admin/kyc_status_updatePlanned capability: apply the requested transition to set kyc stage status through the authoritative trust service boundary.GETGet all pending kyc submissions/api/v2/admin/pending_kycsPlanned capability: list all pending kyc submissions through the authoritative trust service boundary.GETGet identity readiness overview/api/v2/admin/overviewReturn aggregate-only account growth, activation, onboarding, and wallet-readiness posture across 52 weekly cohorts.GETList workload clients/api/v2/admin/identity/workload-clientsList tenant-scoped machine identities, public keys, delegated scopes, and lifecycle state.POSTRegister workload client/api/v2/admin/identity/workload-clientsRegister an Ed25519 workload identity using proof of possession and purpose-bound administrator step-up.POSTRevoke workload client/api/v2/admin/identity/workload-clients/{client_id}/revocationsRevoke a workload client and immediately invalidate all of its outstanding access tokens.POSTRotate workload client/api/v2/admin/identity/workload-clients/{client_id}/rotationsRotate a workload client's public request-signing key using old-key authorization and new-key proof of possession.GETGet identity control record/api/v2/admin/users/{profile_uuid}Return one identity's lifecycle, capability controls, alerts, evidence signals, sessions, and audit events.POSTApply identity intervention/api/v2/admin/users/{profile_uuid}/interventionsApply a version-bound lifecycle, capability, reviewer-rating, or alert decision with an attributed reason.GETList credentials/api/v2/transfer-compliance/credentialsList transfer credentials and selective-disclosure manifests.POSTIssue credential/api/v2/transfer-compliance/credentialsPlanned capability: issue a scoped transfer credential from an authorized trust boundary.POSTRequest vasp credential/api/v2/transfer-compliance/vasp-credentialsCreate a pending institutional credential commitment for issuer review.GETList attestations/api/v2/trust/attestationsList attestations issued to or visible by the caller.GETList claims/api/v2/trust/claimsList subject claims and disclosure posture.POSTSave claim/api/v2/trust/claimsCreate or update a subject-owned identity claim.DELETEDelete claim/api/v2/trust/claims/{claim_uuid}Delete an eligible subject-owned identity claim.GETList credentials/api/v2/trust/credentialsList identity and verification credentials visible to the subject.POSTIssue credential/api/v2/trust/credentialsPlanned capability: issue an authorized identity credential.POSTRevoke credential/api/v2/trust/credentials/{credential_uuid}/revocationsPlanned capability: revoke a credential with a retained reason and authority.POSTStart verification/api/v2/trust/verificationsStart an identity verification workflow.GETGet verification/api/v2/trust/verifications/{verification_uuid}Return verification state and evidence visible to the caller.GETGet identity/api/v2/explorer/identities/{credential_uuid}Return identity from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.GETGet identity issuer/api/v2/explorer/identities/issuerList identity issuer from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.GETList mPC beneficial claims/api/v2/explorer/mpc-wallets/beneficial-claims/{domain_uuid}Return mpc beneficial claims from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.GETList mPC wallet devnet faucet claims/api/v2/explorer/mpc-wallets/devnet-faucet/claimsList mpc wallet devnet faucet claims from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.GETGet mPC wallet devnet faucet claim/api/v2/explorer/mpc-wallets/devnet-faucet/claims/{claim_identifier}Return mpc wallet devnet faucet claim from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.GETGet mPC wallet devnet faucet attestation/api/v2/explorer/mpc-wallets/devnet-faucet/independent-attestations/latestReturn the verification projection for mpc wallet devnet faucet attestation from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.GETGet mPC synthetic faucet claim/api/v2/explorer/mpc-wallets/synthetic-faucet-claims/{claim_uuid}Return mpc synthetic faucet claim from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.GETList mPC wallet testnet faucet claims/api/v2/explorer/mpc-wallets/testnet-faucet/claimsList mpc wallet testnet faucet claims from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.GETGet mPC wallet testnet faucet claim/api/v2/explorer/mpc-wallets/testnet-faucet/claims/{claim_identifier}Return mpc wallet testnet faucet claim from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.GETGet mPC wallet testnet faucet attestation/api/v2/explorer/mpc-wallets/testnet-faucet/independent-attestations/latestReturn the verification projection for mpc wallet testnet faucet attestation from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.GETResolve a network scoped faucet claim/api/v2/explorer/settlements/faucet-claims/{identifier}Planned capability: planning marker for a website helper that guesses whether an identifier belongs to the devnet or testnet faucet. Canonical integrations must choose the network explicitly and call either the implemented devnet-faucet or testnet-faucet claim read.GETList supply gate attestations/api/v2/explorer/settlements/supply-gate/attestationsReturn the verification projection for settlements supply gate attestations from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.GETGet supply gate attestation/api/v2/explorer/settlements/supply-gate/attestations/{commitment}Return the verification projection for settlements supply gate attestations commitment from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.GETList testnet supply gate attestations/api/v2/explorer/testnet/supply-gate/attestationsReturn the verification projection for testnet supply gate attestations from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.GETGet testnet supply gate attestation/api/v2/explorer/testnet/supply-gate/attestations/{commitment}Return the verification projection for testnet supply gate attestation from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.GETGet testnet supply gate latest/api/v2/explorer/testnet/supply-gate/attestations/latestReturn the verification projection for testnet supply gate latest from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.