Assets

Get asset

Get a specific verified asset by ID.

get/api/v1/me/assets/{id}

Request

  • Base URL: https://api.proof.holdings
  • URL: https://api.proof.holdings/api/v1/me/assets/{id}
  • Auth: one of:
    • HTTP bearer
    • API key in cookie auth_token

Path parameters

idstring required

MongoDB ObjectId

Example:507f1f77bcf86cd799439011

Response

Asset details

idstring required

MongoDB ObjectId

type'phone' | 'email' | 'domain' | 'social' | 'wallet' | 'account' | 'telegram_bot' required

Type of asset being verified

channel'whatsapp' | 'telegram' | 'sms' | 'email' | 'dns' | 'http' | 'auto' | 'github' | 'google' | 'facebook' | 'x' | 'linkedin' | 'instagram' | 'youtube' | 'tiktok' | 'ethereum' | 'solana' | 'bitcoin' | 'coinbase' | 'kraken' | 'telegram_bot_token' | 'otp' | 'magic_link' required

How the asset was verified: a verification channel, or otp / magic_link for an email address confirmed from the dashboard

identifierstring required
status'active' | 'expired' | 'revoked' required

Status of a verified asset

proof_idstring nullable

Public handle of the proof backing this asset (ph_ctl_<32 hex>), or null when the asset predates the proof registry. This is the control_proof value POST /api/v1/delegations takes.

proof_status'active' | 'revoked' | 'expired' | 'suspended' | 'null' nullable

Registry status of that proof. Only an active proof can anchor a delegation.

proof_tokenstring nullable

The stored signed proof token. Returned by the point read (GET /me/assets/{id}) to a JWT owner session ONLY — an API-key caller and the list response carry has_proof alone.

has_proofboolean

Whether a proof token is stored for this asset. Sent by the point read (GET /me/assets/{id}) only.

verified_atstring date-time
proof_expires_atstring date-time required

When the proof backing this asset expires

metadataobject

Channel-specific details recorded at verification

created_atstring date-time required

Example response

{
  "id": "507f1f77bcf86cd799439011",
  "type": "phone",
  "channel": "whatsapp",
  "identifier": "+3706***9199",
  "status": "active",
  "proof_id": "ph_ctl_0123456789abcdef0123456789abcdef",
  "proof_status": "active"
}

Changes

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