Descrição

The total number of verification cases created across all statuses. Includes active, completed, failed, and expired cases.

Impacto

Tracks overall verification volume and platform adoption. Spikes may indicate batch uploads or new client onboarding.

Exemplo

Displayed as a number, e.g. "247". Includes all cases regardless of status (active, completed, failed, expired).

Referência

Typical tenants process 50-500 cases/month depending on plan.

Descrição

Cases that have reached the COMPLETE terminal state — all required verification layers passed successfully.

Impacto

Directly measures successful verifications. A low completed count relative to total cases suggests drop-off in the verification funnel.

Exemplo

Displayed as a number, e.g. "189". Only counts cases with status = COMPLETE.

Referência

Healthy completion rates are 70-85% of total cases.

Fórmula

Count of cases where status = COMPLETE

Descrição

Cases where a postal letter has been dispatched but not yet delivered or verified. Status is POSTAL_DISPATCHED.

Impacto

High in-transit counts may indicate postal delays or delivery issues in certain regions.

Exemplo

Displayed as a number, e.g. "34". Counts cases with status = POSTAL_DISPATCHED.

Referência

UK letters: 1-3 business days. EU/US: 3-7 business days.

Descrição

Percentage of cases that reached COMPLETE status out of all cases that have reached a terminal state (COMPLETE, FAILED, or EXPIRED).

Impacto

The primary health metric for your verification process. Low success rates may indicate issues with subject engagement, postal delivery, or bundle configuration.

Exemplo

Displayed as a percentage, e.g. "82.5%". If 165 of 200 terminal cases completed, rate = 82.5%.

Referência

75-90% is healthy. Below 60% warrants investigation.

Fórmula

COMPLETE / (COMPLETE + FAILED + EXPIRED) x 100

Descrição

Initial state when a case is first created. No verification actions have been taken yet.

Impacto

Cases should move out of CREATED quickly. A backlog here means digital verification or letter dispatch is delayed.

Exemplo

Input: Subject name "Jane Smith", address "12 Baker Street, London, NW1 6XE, GB", email "jane@example.com". Output: Case created with status CREATED.

Descrição

Email and/or SMS OTP has been sent to the subject. Waiting for them to enter the code.

Impacto

Long dwell times suggest the subject did not receive the OTP or is not engaging.

Exemplo

Email OTP sent: "A3K9X2MF" (8 characters). SMS OTP sent: "482917" (6 digits). Subject enters the code on the verification page.

Referência

Most digital verifications complete within 5 minutes of sending.

Descrição

Subject has successfully entered the correct email/SMS OTP. Digital layer is complete.

Impacto

If the bundle includes postal verification, the case will transition to POSTAL_DISPATCHED next.

Exemplo

Subject entered "A3K9X2MF" correctly. Status transitions from DIGITAL_PENDING to DIGITAL_VERIFIED.

Descrição

A physical letter with a unique 10-character OTP and QR code has been printed and dispatched via the postal provider.

Impacto

Delivery tracking is available for UK and US/Canada (tracked delivery).

Exemplo

Letter dispatched with postal OTP "K7M2X9P4LR" (10 characters) and QR code linking to verification URL. Tracking reference: "TRK12345678".

Referência

UK: 1-3 days. EU/US: 3-7 days.

Descrição

Letter has been confirmed delivered (via tracking) but the subject has not yet entered the postal OTP.

Impacto

The subject has the letter but has not acted. A reminder may help.

Exemplo

Tracking shows "Delivered" on 2026-02-20. Subject has not yet entered OTP "K7M2X9P4LR". Reminder email scheduled.

Descrição

Subject has entered the correct postal OTP. Physical address possession is confirmed.

Impacto

The case will now transition to COMPLETE (assuming all required layers are verified).

Exemplo

Subject entered "K7M2X9P4LR" correctly via QR scan or manual entry. Address possession confirmed.

Descrição

All required verification layers have been successfully completed. Evidence pack is sealed with SHA-256 hash chain.

Impacto

Terminal state. The evidence pack is now available for download and webhook delivery.

Exemplo

Case completed with assurance level "Verified (Digital + Postal)". Evidence pack PDF available for download. Webhook "case.completed" fired.

Descrição

Case failed due to max OTP attempts exceeded, fraud detection, or manual rejection by a caseworker.

Impacto

Terminal state. Review the case timeline for the specific failure reason.

Exemplo

Reason: "Max OTP attempts exceeded (5/5 for postal layer)". Or: "Caseworker rejected — ghost address confirmed".

Descrição

Case exceeded its time-to-live (TTL) without completing all required verification layers.

Impacto

Terminal state. The subject did not complete verification within the allowed window.

Exemplo

Case created 2026-01-15 with 30-day TTL. Expired on 2026-02-14 with status stuck at POSTAL_PENDING.

Referência

Default TTL is 30 days. Adjust per bundle if needed.

Descrição

Shows exactly which verification layers were completed for a case. Each layer is listed individually: Email, SMS, Postal, and Geo. For example, "Email + SMS + Postal" means all three channels were verified.

Impacto

More layers = stronger assurance. Cases including Postal prove physical address possession. Cases including Geo prove physical presence at the address during verification.

Exemplo

"Email + Postal": email OTP + postal letter verified. "Email + SMS + Postal + Geo": all four layers verified — maximum assurance.

Referência

Regulated industries (law, finance, accountancy) typically require at least Email + Postal.

Descrição

Composite fraud risk score from 0-100 calculated at case creation. Higher scores indicate greater risk.

Impacto

Determines whether risk-based step-up is triggered. Cases above the threshold are automatically escalated from digital to postal verification.

Exemplo

Score 15: Low risk (no signals). Score 45: Medium (disposable email detected). Score 75: High (ghost address + velocity + disposable email).

Referência

0-30: Low risk. 30-60: Medium risk. 60+: High risk (step-up likely).

Fórmula

Weighted sum of individual risk signals (disposable email, ghost address, address velocity, etc.)

Descrição

The overall verification confidence score (0-100%) assigned when a case completes. Combines results from all verification layers: email OTP, SMS OTP, geolocation proximity, postal letter redemption, and address quality checks.

Impacto

Higher scores indicate stronger proof of address. This score decays over time (see Reverification). Cases with low strength may warrant additional verification.

Exemplo

Score 83%: Strong (postal + digital + geo all passed). Score 68%: Good (postal + digital passed, no geo). Score 35%: Weak (digital only, partial checks).

Referência

70-100%: Strong verification. 40-69%: Moderate. Below 40%: Weak — consider re-verification.

Fórmula

Sum of layer scores: Email (10), SMS (10), Geo proximity (up to 20), Postal (25), Address quality (up to 15), minus penalties for risk signals.

Descrição

Detected when the subject email address belongs to a known disposable/temporary email provider (e.g. Guerrilla Mail, Tempail).

Impacto

Strong fraud indicator. Disposable emails cannot receive follow-up communications and suggest intent to avoid accountability.

Exemplo

Input email: "user@guerrillamail.com" or "temp@throwaway.email". Signal triggers: Disposable Email = true, +25 risk points.

Descrição

Address matches a known mail forwarding service, virtual office, PO box farm, or serviced office address.

Impacto

The subject may not physically reside or operate at this address. Letters will be received but do not prove actual occupancy.

Exemplo

Input address: "71-75 Shelton Street, London, WC2H 9JQ" (known virtual office). Signal triggers: Ghost Address = true.

Descrição

Address is associated with a mail forwarding or redirection service (e.g. postal redirection service, PO Box).

Impacto

Mail forwarding means the letter could be received at a different physical location than the claimed address.

Exemplo

Input address: "PO Box 4521, Manchester, M60 3AT" or an address with an active postal redirect. Signal: Mail Forwarding = true.

Descrição

Multiple cases for different subjects have been submitted with the same address within a rolling time window.

Impacto

Could indicate a legitimate shared address (e.g. office building) or a fraud pattern where one address is used for multiple fake identities.

Exemplo

5 different subjects verified at "42 High Street, Bristol, BS1 2AW" in the past 7 days. Velocity signal triggered.

Referência

1-2 cases per address per month is normal. 5+ within a week is suspicious.

Descrição

The same address has appeared in verification cases across different tenants on the platform.

Impacto

May indicate an address being used to fraudulently verify across multiple regulated firms simultaneously.

Exemplo

"10 Downing Street, London" verified by 3 different tenants in the past 30 days. Cross-tenant signal raised (tenant names anonymised).

Descrição

The IP address used during digital verification geolocates to a region significantly different from the claimed postal address.

Impacto

May indicate the subject is not near the claimed address. However, VPN usage can produce false positives.

Exemplo

Claimed address: London, UK. Verification IP: 203.0.113.45 (geolocated to Lagos, Nigeria). Mismatch distance: 4,900 km.

Descrição

Automatic escalation from a digital-only verification bundle to include postal verification, triggered when the risk score exceeds the configured threshold.

Impacto

Ensures high-risk cases get physical address verification even when the original bundle was digital-only.

Exemplo

Case created with "Basic" bundle (email only). Risk score = 72 (above threshold 60). Postal layer automatically added. Step-Up badge shown.

Referência

Default step-up threshold is 60 (configurable per tenant).

Descrição

Sends an 8-character OTP code to the subject's email address for verification.

Impacto

Fast digital verification — most subjects complete within minutes. Validates email ownership but not physical address.

Exemplo

Input: subject email "jane.smith@lawfirm.co.uk". Output: OTP "A3K9X2MF" sent via configured email template.

Referência

Delivery rate: 98%+ for legitimate email addresses. Completion rate: 85-95%.

Descrição

Sends a 6-digit OTP code via SMS to the subject's mobile number.

Impacto

Validates phone number ownership. Higher engagement than email due to push notification.

Exemplo

Input: subject phone "+44 7700 900123". Output: SMS with OTP "482917" sent. Subject enters code on verification page.

Referência

Delivery rate: 95-99% depending on carrier. Completion rate: 90%+.

Descrição

Dispatches a physical letter with a unique 10-character OTP and QR code to the subject's claimed address.

Impacto

The core Postal.id verification — proves physical possession of the address. Unfakeable by digital means.

Exemplo

Input: "12 Baker Street, London, NW1 6XE". Letter printed with OTP "K7M2X9P4LR" + QR code. Dispatched via tracked post.

Referência

UK delivery: 1-3 days. Completion rate: 70-85% (dependent on subject engagement).

Descrição

Captures GPS coordinates from the subject's device at the time of OTP entry. Compares with the claimed address location.

Impacto

Adds a physical presence confirmation. The subject must be near the claimed address when entering the postal OTP.

Exemplo

Claimed address: 51.5074, -0.1278 (London). Subject GPS: 51.5081, -0.1290 (0.15 km away). Within 1 km radius: PASS.

Descrição

Maximum number of days allowed for the subject to complete all required verification layers before the case expires.

Impacto

Shorter TTLs create urgency but increase expiry rates. Longer TTLs are more lenient but delay case resolution.

Exemplo

Input: 30 (days). Case created 2026-02-01 will expire 2026-03-03 if not completed. Enter 7-60 depending on use case.

Referência

Default: 30 days. For urgent verifications, 7-14 days. For international postal, 45-60 days.

Descrição

Maximum number of OTP entry attempts allowed per verification layer before the case is marked as failed.

Impacto

Prevents brute-force OTP guessing. Too few attempts frustrate legitimate subjects; too many weaken security.

Exemplo

Input: 5. Subject enters wrong OTP 5 times → case fails. Enter 3-10 (recommended: 5 for standard, 3 for high security).

Referência

Default: 5 attempts. Security-sensitive: 3 attempts.

Fórmula

After max attempts exhausted → case status transitions to FAILED.

Descrição

The postal format used for dispatching verification letters. Options depend on the provider and destination country.

Impacto

Different formats have different costs, delivery speeds, and tracking capabilities.

Exemplo

Options: "standard" (cheapest, no tracking), "tracked" (mid-range, delivery confirmation), "certified" (signature required).

Descrição

Each verification layer in a bundle can be marked as required or optional. Required layers must be completed; optional layers enhance assurance if completed.

Impacto

Required layers determine the minimum assurance level. Optional layers provide additional confidence without blocking completion.

Exemplo

Bundle config: Email = Required, SMS = Optional, Postal = Required, Geo = Optional. Subject must complete email + postal; SMS and geo are bonus.

Descrição

Percentage of dispatched letters that were successfully delivered to the destination address.

Impacto

Low delivery rates may indicate address quality issues, incorrect postcodes, or regional postal problems.

Exemplo

96 of 100 letters delivered = 96% delivery rate. Displayed as a percentage on the postal metrics card.

Referência

UK: 98%+. EU: 95-98%. US: 97%+.

Fórmula

Delivered / Dispatched x 100

Descrição

Percentage of dispatched letters returned to sender (RTS) by the postal service.

Impacto

High return rates indicate invalid addresses, subjects who have moved, or incorrect address formatting.

Exemplo

3 of 100 letters returned = 3% return rate. Common reasons: "addressee gone away", "insufficient address".

Referência

Healthy: below 3%. Above 5% warrants address validation review.

Fórmula

Returned / Dispatched x 100

Descrição

Average number of business days between letter dispatch and confirmed delivery (where tracking is available).

Impacto

Helps set realistic TTL values and subject expectations.

Exemplo

Displayed as "1.8 days" for UK, "4.2 days" for EU. Based on tracked deliveries in your recent cases.

Referência

UK: 1.5 days. EU: 4-5 days. US: 3-4 days.

Descrição

Percentage of postal verifications completed by scanning the QR code on the letter versus manually typing the OTP.

Impacto

Higher QR scan rates indicate good subject experience — scanning is faster and less error-prone.

Exemplo

55 of 100 postal verifications used QR scan = 55%. Remaining 45% typed the 10-character OTP manually.

Referência

Typical: 40-60% use QR scanning.

Descrição

Alert triggered when an address receives more verification cases than the configured threshold within a time window.

Impacto

May indicate legitimate shared occupancy or potential fraud via address reuse.

Exemplo

Alert: "42 High Street, Bristol" — 5 cases in 7 days (threshold: 3 per 30 days). Investigate shared office or fraud.

Referência

Default threshold: 3 cases per address per 30 days.

Descrição

Alert triggered when the same address is being verified across multiple different tenants on the platform.

Impacto

Could indicate a professional fraud attempt spanning multiple regulated firms.

Exemplo

Alert: "10 Downing Street, London" appears in 3 different tenants within 30 days. Other tenant names are anonymised.

Descrição

Numerical severity score assigned to each address alert based on the type and frequency of signals detected.

Impacto

Higher scores warrant more urgent investigation. Used for prioritising the alert queue.

Exemplo

Score 15 (low): single velocity signal. Score 45 (medium): velocity + ghost address. Score 80 (high): cross-tenant + velocity + forwarding.

Referência

1-30: Low priority. 30-60: Medium. 60+: High priority — investigate immediately.

Descrição

Mark an alert as reviewed after investigation. Acknowledged alerts are moved out of the active queue.

Impacto

Helps team members track which alerts have been investigated versus which need attention.

Exemplo

Click "Acknowledge" on an alert → add a note like "Confirmed shared office building, legitimate usage". Alert moves to resolved queue.

Descrição

Real-time HTTP POST notifications sent to your configured endpoint when case status changes occur.

Impacto

Enables automated workflows — update your CRM, trigger follow-up actions, or sync verification status with your systems.

Exemplo

Events: case.created, case.digital_verified, case.postal_dispatched, case.postal_verified, case.completed, case.failed, case.expired, letter.dispatched, letter.delivered

Descrição

Every webhook request includes an X-Postal-Id-Signature header containing an HMAC-SHA256 hash of the request body using your webhook secret.

Impacto

Verify this signature before processing to ensure the webhook came from Postal.id and was not tampered with.

Exemplo

Header: "X-Postal-Id-Signature: sha256=a1b2c3d4e5...". Verify by computing HMAC-SHA256(your_secret, raw_body) and comparing.

Fórmula

HMAC-SHA256(webhook_secret, request_body)

Descrição

Failed webhook deliveries (non-2xx response or timeout) are retried with exponential backoff up to 5 attempts.

Impacto

Ensures temporary outages on your side do not cause missed events.

Exemplo

Retry delays: ~30s, ~2min, ~8min, ~30min, ~2hr (exponential backoff with jitter)

Descrição

Maximum number of verification cases included in your current subscription plan per billing period.

Impacto

Cases beyond the plan limit may incur overage charges or be blocked depending on your plan settings.

Exemplo

Performance plan: "87 / 100 cases used this period". At 100, new case creation may be blocked until next period.

Referência

Essential: 25/month. Performance: 100/month. Enterprise: unlimited.

Descrição

The current billing cycle during which verification cases are counted against your plan limit.

Impacto

Case counts reset at the start of each billing period.

Exemplo

Displayed as "1 Feb 2026 — 28 Feb 2026". Cases created within this window count toward the limit.

Descrição

Current state of your subscription: active, past_due, cancelled, or trialing.

Impacto

Verification capabilities may be restricted for past_due or cancelled plans.

Exemplo

Values: "active" (normal), "trialing" (free trial), "past_due" (payment failed), "cancelled" (subscription ended).

Descrição

Visual breakdown of cases at each stage of the verification lifecycle, showing where subjects progress and where they drop off.

Impacto

Identify bottlenecks — if many cases stall at POSTAL_PENDING, subjects are receiving letters but not entering codes.

Exemplo

Created: 100 → Digital Verified: 85 → Postal Dispatched: 80 → Postal Verified: 65 → Complete: 62 → Failed: 8 → Expired: 15.

Descrição

Cases escalated from the automated flow for human review. Typically due to risk signals, edge cases, or caseworker discretion.

Impacto

Manual review cases require a caseworker to approve or reject. They do not auto-complete.

Exemplo

Case escalated due to risk score 85 + ghost address. Caseworker reviews evidence, clicks "Approve" (→ COMPLETE) or "Reject" (→ FAILED).

Descrição

Create multiple verification cases at once by uploading a CSV file. The system validates every row, flags errors, checks for duplicates, and processes valid rows in parallel.

Impacto

Enables bulk onboarding — process hundreds of verification cases from a single file upload instead of creating them one by one.

Exemplo

Upload "clients_q1.csv" with 50 rows → Validate → 47 valid, 2 invalid, 1 duplicate → Upload 47 cases → Cases created and digital OTPs sent.

Descrição

Your CSV must include these required columns: name (subject's full name), email (for notifications and digital OTP), line1 (street address), city, postalCode, countryCode (2-letter ISO code e.g. GB, US, DE). Optional columns: phone (with country prefix e.g. +44), line2, region, reference (your internal ID), bundleId (1 = Basic, 2 = Standard, 3 = Enhanced, 4 = Maximum).

Impacto

Correct CSV formatting ensures maximum validation success. Missing required columns will cause row-level errors.

Exemplo

Header row: name,email,phone,line1,line2,city,region,postalCode,countryCode,reference,bundleId Data row: Jane Smith,jane@example.com,+447700900123,12 Baker Street,,London,,NW1 6XE,GB,MATTER-001,3

Descrição

Before uploading, click "Preview & Validate" to check your file. The system checks: required fields present, valid email format, valid country codes, address completeness, and duplicate detection against existing cases.

Impacto

Validation catches errors before cases are created, saving time and avoiding wasted postal costs on invalid addresses.

Exemplo

Validation results: Total Rows: 50, Valid: 47 (green), Invalid: 2 (red), Duplicates: 1 (amber). Country breakdown: GB: 30, US: 15, DE: 5.

Descrição

Common errors: "Missing required field" (name/line1/city/postalCode/countryCode is blank), "Invalid country code" (not a recognised 2-letter ISO code), "Invalid email format" (malformed email), "Duplicate" (same name+address already exists as an active case).

Impacto

Each error shows the row number, field name, and error message so you can fix the exact issue in your CSV.

Exemplo

Row 15: postalCode — "Missing required field". Row 23: countryCode — "Invalid country code 'UK' (expected 'GB')". Row 31: name — "Duplicate of row 12 (Jane Smith, 12 Baker Street)".

Descrição

After validation, you'll see: Total Rows (all rows in CSV), Valid (ready to upload), Invalid (have errors — fix and re-upload), Duplicates (match existing active cases — skipped). Only valid rows are processed when you click Upload.

Impacto

Invalid and duplicate rows are skipped. You can download a report of failed rows to fix and re-upload separately.

Exemplo

Click "Upload 47 Cases" → system creates 47 verification cases in parallel. Each case gets digital OTPs sent immediately. Postal letters dispatched based on bundle config.

Descrição

After upload, each batch job shows a status: Processing (still creating cases), Complete (all rows processed), Failed (system error during processing). The progress bar shows Succeeded/Failed/Remaining counts.

Impacto

Monitor batch progress in real-time. Most batches complete within minutes.

Exemplo

Batch "clients_q1.csv": 47/47 processed, 45 succeeded, 2 failed. Click "View Errors" to see which rows failed.

Descrição

Click "View Errors" on a completed batch to see which rows failed and why. Click "Download Report" to get a CSV of failed rows with error details — fix the errors and re-upload just those rows. "Retry Failed" re-processes failed rows without re-uploading.

Impacto

Efficiently handle partial failures without re-processing the entire batch.

Exemplo

Error report: Row 12 — "Address validation failed: undeliverable address". Row 38 — "Plan limit exceeded". Fix address in row 12, upgrade plan, then retry.

Descrição

Opens the case creation form where you enter the subject's details, address, and select a verification bundle. Once submitted, digital OTPs are sent immediately and a postal letter is dispatched (if the bundle includes postal verification).

Impacto

The primary way to start a single address verification. For bulk verifications, use Batch Upload instead.

Exemplo

Click "New Case" → fill in name, email, address → select "Enhanced" bundle → click "Create Case" → email OTP sent within seconds, letter dispatched within 1 hour.

Descrição

View all subjects (people being verified) across all your cases. Search by name, email, phone, or address. Click any recipient to see their full verification history, risk signals, and address changes over time.

Impacto

Central directory of all people you've ever verified. Useful for re-verification, fraud investigation, and compliance audits.

Exemplo

Search "Jane Smith" → see all cases for that person → click through to view detailed profile with verification history, risk signals, and address timeline.

Descrição

Create multiple verification cases at once by uploading a CSV file. The system validates every row, flags errors, checks for duplicates against existing cases, and processes valid rows in parallel.

Impacto

Essential for high-volume onboarding. Process hundreds of verifications from a single file instead of creating cases one by one.

Exemplo

Prepare CSV with columns: name, line1, city, postalCode, countryCode (required) + email, phone, reference (optional) → Upload → Validate → Process.

Descrição

Digital-only verification using email OTP. An 8-character OTP code is sent to the subject's email address. The subject enters the code to verify email ownership. Fastest completion time (~5 minutes). TTL (Time To Live) defines how long each OTP code remains valid before expiring — e.g. "30m TTL" means the code expires after 30 minutes.

Impacto

Assurance level: Verified (Digital). Suitable for low-risk onboarding where email confirmation is sufficient and postal proof is not required by regulation.

Exemplo

Layers enabled: Email (required). Subject receives email with OTP "A3K9X2MF" → enters code → case completes with "Verified (Digital)" assurance.

Referência

Completion time: 2-5 minutes. Success rate: 85-95%. Cost: lowest (no postal dispatch).

Descrição

Two-factor digital verification using both email OTP (8-character code) and SMS OTP (6-digit code). Both channels must be verified for the case to complete.

Impacto

Assurance level: Verified (Digital). Provides dual-channel digital confirmation. Stronger than Basic but still does not prove physical address possession.

Exemplo

Layers enabled: Email (required), SMS (required). Subject receives email OTP "A3K9X2MF" + SMS OTP "482917" → enters both → case completes.

Referência

Completion time: 3-10 minutes. Success rate: 80-90%. Cost: low (email + SMS, no postal).

Descrição

Full postal + digital verification. Sends email OTP and dispatches a tracked physical letter with a unique 10-character postal OTP and QR code. SMS is optional. The postal letter proves physical possession of the address.

Impacto

Assurance level: Verified (Digital + Postal). Meets the strictest FCA, SRA, and HMRC requirements for proof of address. The gold standard for regulated industries.

Exemplo

Layers enabled: Email (required), SMS (optional), Postal (required). Subject verifies email → letter arrives in 1-7 days → subject enters postal OTP → case completes.

Referência

Completion time: 3-10 days (depends on postal delivery). Success rate: 70-85%. Cost: medium (includes postal dispatch).

Descrição

Highest assurance. All four verification layers: email OTP (8-char), SMS OTP (6-digit), postal letter (10-char OTP + QR code), AND GPS geo-location capture when entering the postal code. Proves both mail receipt AND physical presence at the address.

Impacto

Assurance level: Verified (Digital + Postal) with geo confirmation. The strongest possible proof that the subject physically resides at the claimed address.

Exemplo

Layers: Email (required), SMS (required), Postal (required), Geo (required, 200m radius). Subject verifies email + SMS → receives letter → enters postal OTP while GPS confirms they're at the address.

Referência

Completion time: 3-10 days. Success rate: 60-75% (geo may fail if subject declines location). Cost: highest.

Descrição

The bundle marked as "Default" is automatically used when cases are created via the API without specifying a bundleId. Only one bundle can be the default at any time.

Impacto

Controls the verification flow for API-created cases and any cases where the caseworker doesn't explicitly select a bundle.

Exemplo

Set "Enhanced" as default → all API-created cases automatically use email + postal verification. Change to "Basic" → API cases only use email.

Descrição

Pre-configured verification packages provided by Postal.id: Basic, Standard, Enhanced, and Maximum. These cannot be edited or deleted but can be set as the default.

Impacto

Platform packages cover the most common verification scenarios. Create custom packages only if you need non-standard layer combinations.

Exemplo

Platform packages: Basic (email only), Standard (email + SMS), Enhanced (email + SMS + postal), Maximum (all 4 layers). All are always available.

Descrição

A "recipient" (also called "subject") is the person whose address is being verified. Each recipient may have multiple verification cases if they've been verified at different addresses or re-verified over time.

Impacto

Click any recipient to view their full profile including verification history, risk signals, address changes, and verification method success rates.

Exemplo

Recipient "Jane Smith" has 3 cases: 1 completed (London address), 1 active (Manchester address), 1 failed (disposable email detected).

Descrição

Shows the status of the most recent verification case for this recipient. Reflects where they are in the verification flow right now.

Impacto

Quick indicator of whether the recipient's most recent verification is complete, in progress, or has issues.

Exemplo

COMPLETE (green): latest case fully verified. POSTAL_DISPATCHED (amber): letter sent, awaiting delivery. FAILED (red): latest case failed.

Descrição

Total number of verification cases ever created for this recipient across all addresses and time periods. Includes active, completed, failed, and expired cases.

Impacto

Multiple cases may exist if the recipient moved, if a previous case expired, or if periodic re-verification is required.

Exemplo

3 cases: means this person has been through the verification process 3 separate times (possibly at different addresses).

Descrição

Aggregated risk percentage based on all risk signals detected for this recipient across all their cases. Combines ghost address, mail forwarding, address velocity, disposable email, and cross-tenant signals.

Impacto

Red (>70%): High risk — investigate immediately. Amber (40-70%): Moderate risk — review recommended. Green (<40%): Low risk — no immediate action needed.

Exemplo

15%: Low risk (no signals). 52%: Medium (disposable email detected). 85%: High (ghost address + cross-tenant + velocity).

Fórmula

Weighted average of all risk signals across all cases for this recipient.

Descrição

Search across name, email, phone number, and address fields. Filter by case status to find recipients at a specific verification stage. Sort by newest, oldest, name alphabetically, or most cases.

Impacto

Quickly find specific recipients or identify groups of recipients in a particular state.

Exemplo

Search "Manchester" → shows all recipients with Manchester addresses. Filter "FAILED" → shows recipients whose latest case failed.

Descrição

All verification cases ever created for this person, regardless of outcome. Includes active cases in progress, successfully completed cases, failed cases, and expired cases.

Impacto

A high case count may indicate re-verifications (normal) or repeated failed attempts (investigate).

Exemplo

5 total cases: 3 completed, 1 active, 1 expired.

Descrição

Cases currently in progress — not yet reached a terminal state (COMPLETE, FAILED, or EXPIRED). These are cases where the subject still needs to complete one or more verification steps.

Impacto

Active cases require monitoring. If a case stays active for too long, the subject may need a reminder.

Exemplo

2 active cases: one at DIGITAL_PENDING (email OTP sent, awaiting entry), one at POSTAL_DISPATCHED (letter sent, awaiting delivery).

Descrição

The subject's name, email address, and phone number as provided when the case was created. "First Seen" shows when this person was first added to the system. "Latest Status" shows their most recent case state.

Impacto

Contact information is used for email OTP delivery (email) and SMS OTP delivery (phone). Tags help categorise recipients.

Exemplo

Name: Jane Smith. Email: jane@example.com. Phone: +44 7700 900123. First Seen: 15 Jan 2026. Tags: VIP, Priority.

Descrição

The most recent address provided for verification. "Verified" with a date means postal verification was successfully completed for this address. Ghost Address and Forwarding badges indicate risk flags detected during address validation.

Impacto

The current address is the one used for the latest or active verification case. Previous addresses appear in Address History.

Exemplo

12 Baker Street, London, NW1 6XE, GB. Verified: 20 Feb 2026. Badges: none (clean address).

Descrição

Breakdown of how many email, SMS, and postal OTPs were sent to this recipient and how many were successfully verified. The progress bar shows the success rate for each channel.

Impacto

Identifies which verification channels work best for this recipient. Low success on a channel may indicate delivery issues.

Exemplo

Email: 3 sent, 3 verified (100%). SMS: 2 sent, 2 verified (100%). Postal: 2 sent, 1 verified (50%). Green bar (≥80%), Amber (50-79%), Red (<50%).

Descrição

Chronological list of all addresses this person has been verified at across all their cases. Each entry shows the full address, country flag, and whether verification was completed.

Impacto

Useful for detecting frequent movers, address fraud patterns, or confirming legitimate address changes over time.

Exemplo

1. 12 Baker Street, London — Verified 20 Feb 2026. 2. 45 Oxford Road, Manchester — Verified 15 Nov 2025. 3. PO Box 123, Bristol (Ghost badge) — Not verified.

Descrição

All verification cases for this recipient in reverse chronological order. Click any Case ID to view the full case details including timeline, risk assessment, and evidence pack.

Impacto

Complete audit trail of every verification attempt for this person. Useful for compliance reviews and dispute resolution.

Exemplo

Case a1b2c3d4: COMPLETE, Verified (Digital + Postal), 12 Baker Street, 20 Feb 2026. Case e5f6g7h8: FAILED, --, 45 Oxford Road, 15 Nov 2025.

Descrição

The person whose address is being verified. "Subject" is Postal.id terminology for the end-person — not your employee or team member. Provide their full legal name as it would appear at the address.

Impacto

The subject's name is printed on the postal letter and included in the evidence pack. Use the correct legal name for compliance purposes.

Exemplo

Input: "Jane Elizabeth Smith" (full legal name). Avoid nicknames or abbreviations unless that's the name at the address.

Descrição

Email is used for email OTP delivery (8-character code). Phone (with country prefix like +44 for UK, +1 for US) is used for SMS OTP delivery (6-digit code). Both are optional but required if the selected verification bundle includes email/SMS layers.

Impacto

Without email, the email OTP layer cannot function. Without phone, the SMS OTP layer cannot function. Postal verification does not require either.

Exemplo

Email: jane.smith@example.com. Phone: +447700900123 (UK mobile) or +12125551234 (US). Note: phone must include country prefix.

Descrição

Legal requirement (GDPR/data protection): you must confirm the subject has given consent for address verification before creating a case. This checkbox is mandatory — the case cannot be created without it.

Impacto

Ensures compliance with data protection regulations. The consent status is recorded in the audit trail and included in the evidence pack.

Exemplo

Check the box to confirm: "Subject has given consent for address verification". Unchecked = "Create Case" button is disabled.

Descrição

After entering an address, the system automatically validates it for deliverability. Checks include: valid postal code format, known ghost/virtual office addresses, active mail forwarding/redirection services, and address standardisation.

Impacto

Pre-dispatch validation prevents wasted postal costs on undeliverable addresses and flags risk signals early.

Exemplo

Enter "12 Baker St, London" → validation returns: Deliverable (green tick), standardised to "12 Baker Street, London, NW1 6XE". Or: "71-75 Shelton Street" → Ghost Address warning (orange).

Descrição

Choose which verification bundle to use for this case. Each package defines which layers (email, SMS, postal, geo) are enabled and whether they're required or optional. "Default" badge means this is the bundle used for API-created cases. "Platform" badge means it's provided by Postal.id.

Impacto

The selected package determines the verification flow, timeline, cost, and resulting assurance level.

Exemplo

Select "Enhanced" → email OTP sent immediately, postal letter dispatched within 1 hour. Estimated postal cost shown below (e.g. £1.20 for UK letter).

Descrição

Optional internal reference for your own records. Use your matter ID, client number, file reference, or any identifier that helps you match this verification case to your internal systems.

Impacto

Searchable in the case list and included in webhook payloads and evidence packs. Makes it easy to cross-reference with your practice management software.

Exemplo

Examples: "MATTER-2024-001", "CLT-4521", "AML-REF-789", "Property-Sale-42-High-St". Any format up to 100 characters.

Descrição

Verification scores decay logarithmically over time using a half-life of ~180 days. The decay rate is 0.15, meaning scores erode quickly at first then slow down. A score never drops below 10% of its original value.

Impacto

Decay reflects that proof of address becomes less reliable over time — people move, addresses change. Monitoring decay helps you plan re-verifications before scores become unreliable.

Exemplo

A score of 85 at completion decays to ~72 after 180 days, ~63 after 360 days.

Fórmula

currentScore = originalScore × (1 − 0.15 × ln(1 + daysSince / 180))

Descrição

The anticipated date when the verification score will decay below the 30-point acceptance threshold. This is computed from the original score and the completion date using the logarithmic decay formula.

Impacto

Plan re-verification before this date to maintain continuous, uninterrupted proof of address for your client. After this date, the Postal ID may no longer be accepted by other tenants.

Exemplo

A case completed on 1 Jan 2026 with a score of 85 would have a reverification date around mid-2027.

Descrição

The number of days remaining before the verification score drops below the acceptance threshold (30 points). Colour coded: green (>90 days), amber (30–90 days), red (<30 days), or "Overdue" if already past due.

Impacto

Gives you an at-a-glance view of which cases need attention soon. Prioritise cases in red or amber for re-verification.

Descrição

Creating a new verification case for the same person and address. This resets the decay clock, updates the Postal ID score to the new verification result, and increments the re-verification count.

Impacto

Essential for maintaining long-term proof of address for ongoing client relationships. Each re-verification strengthens the Postal ID credential.

Descrição

The total number of tenant organisations registered on the platform, including both active and disabled accounts.

Impacto

Tracks platform adoption. Growth in tenant count indicates market traction.

Referência

Healthy platforms see steady month-over-month growth. A disabled tenant count above 20% may indicate onboarding or retention issues.

Descrição

The total number of individual user accounts across all tenants, excluding soft-deleted users.

Impacto

Indicates platform engagement depth. Multiple users per tenant suggests healthy adoption.

Referência

Average 2-5 users per tenant is typical for professional services firms.

Descrição

The all-time count of verification cases created across all tenants. Includes cases in all states: active, completed, failed, and expired.

Impacto

The primary volume metric for the platform. Drives revenue and capacity planning.

Fórmula

Total Cases = sum of all cases across all tenants, regardless of status.

Descrição

The percentage of all cases that reached COMPLETE status, calculated as Completed Cases / Total Cases.

Impacto

The key quality metric. A low success rate may indicate issues with postal delivery, subject engagement, or verification flow usability.

Referência

Target 60-80% for a healthy platform. Below 50% warrants investigation into failure causes.

Fórmula

Success Rate = (COMPLETE cases / Total Cases) × 100

Descrição

The number of cases created in the current calendar month. Compared against last month to show growth trend.

Impacto

Tracks current platform activity and billing volume. A declining trend may indicate tenant churn.

Descrição

Cases currently in progress — not yet completed, failed, or expired. Includes states: CREATED, DIGITAL_PENDING, DIGITAL_VERIFIED, POSTAL_DISPATCHED, POSTAL_PENDING, POSTAL_VERIFIED, and MANUAL_REVIEW.

Impacto

Indicates current platform workload. A high number of active cases relative to completions may indicate bottlenecks.

Descrição

Cases that have been escalated to MANUAL_REVIEW status, requiring a human caseworker to make a verification decision.

Impacto

Cases awaiting human decision. A growing queue indicates either increased risk signals or insufficient caseworker capacity.

Descrição

The percentage of cases that ended in FAILED or EXPIRED status, calculated as (Failed + Expired) / Total Cases.

Impacto

Indicates verification friction. High failure rates reduce platform value and tenant satisfaction.

Referência

Target below 30%. Above 40% requires investigation. Expired cases often indicate subject disengagement rather than system failure.

Fórmula

Failure Rate = (FAILED + EXPIRED cases / Total Cases) × 100

Descrição

A breakdown of all cases grouped by their current status, showing count and percentage for each state in the verification pipeline.

Impacto

Provides a snapshot of where cases are in the funnel. Useful for identifying bottlenecks and throughput issues.

Descrição

The top 10 tenants ranked by total case volume. Shows tenant name, billing plan, active/disabled status, and case count.

Impacto

Identifies your highest-volume clients. These tenants drive most of the platform revenue and should receive priority support.

Descrição

A tenant is a corporate client organisation registered on Postal.id. Each tenant has their own users, cases, verification bundles, branding, and billing.

Impacto

Tenants are the primary unit of multi-tenancy. All data is strictly isolated between tenants — a user in one tenant can never see another tenant's data.

Descrição

The subscription tier assigned to a tenant: Trial (limited free cases), Starter, Professional, or Enterprise. Each plan defines case limits, feature access, and pricing.

Impacto

Determines how many cases a tenant can create per period and which features are available.

Referência

Trial: 1-3 cases. Starter: 50/month. Professional: 500/month. Enterprise: unlimited.

Descrição

Whether a tenant account is Active or Disabled. Disabled tenants cannot log in or create new cases, but their existing data is preserved.

Impacto

Disabling a tenant is a reversible action — it blocks access without deleting data. Used for non-payment, policy violations, or at tenant request.

Descrição

The number of user accounts within a tenant. Includes Tenant Admins (full access), Caseworkers (create/manage cases), and Auditors (read-only).

Impacto

User count indicates how deeply a tenant has adopted the platform. More users generally means higher engagement.

Descrição

The total number of verification cases created by a tenant, broken down by status.

Impacto

Case volume drives billing and indicates tenant engagement level.

Descrição

Enable or disable a tenant account. Only available to Platform Admins (not Support Agents).

Impacto

Disabling blocks all login and case creation for that tenant. Enabling restores full access.

Descrição

The tenant's platform configuration including verification policy, branding (logo, colours), webhook settings, and API key management.

Impacto

Configuration determines how the tenant's verification flow behaves — which channels are required, OTP expiry times, and assurance levels.

Descrição

Global platform configuration including rate limits (OTP attempts, API requests), default values (bundle, OTP expiry, evidence retention), feature flags, and maintenance mode.

Impacto

Changes affect all tenants platform-wide. Rate limits protect against abuse. Feature flags control which capabilities are available.

Descrição

Real-time health status of external service providers: postal (Lob, Stannp), email (Resend), SMS (Infobip/Twilio), and storage (S3). Each provider shows Healthy, Degraded, or Down status.

Impacto

Provider health directly affects verification capability. A Down postal provider means letters cannot be dispatched in that region.

Referência

All providers should be Healthy. Degraded indicates elevated error rates. Down means the circuit breaker has tripped.

Descrição

Monitoring for webhook event deliveries to tenant endpoints. Shows success rate, average response time, retry queue depth, and per-tenant health.

Impacto

Failed webhooks mean tenants miss real-time notifications about case status changes. A growing retry queue indicates endpoint issues.

Referência

Target >95% webhook delivery success rate. Average response time should be under 2 seconds.

Descrição

Immutable, append-only record of all significant platform events: case creation, status changes, user logins, settings modifications, evidence downloads, and security events.

Impacto

The audit log is the compliance backbone. Regulators and auditors rely on it to verify that verification processes were followed correctly.

Descrição

Cross-tenant search across all verified subjects (recipients). Supports search by name, email, or case number, plus bulk search for multiple values at once.

Impacto

Enables support agents to quickly find any recipient across the entire platform when handling queries.

Descrição

Detailed health monitoring for each external API provider. Shows latency, success rate, circuit breaker state, endpoint documentation, and last error.

Impacto

Provides visibility into third-party dependencies. Useful for diagnosing delivery failures or slow verification times.

Descrição

A read-only platform role for postal.id employees who handle customer support. Support Agents can view all admin data (tenants, cases, recipients, audit logs) but cannot modify settings, toggle tenants, or change configurations.

Impacto

Enables customer support without the risk of accidental configuration changes.

Descrição

When enabled, all tenant portals display a maintenance message instead of normal content. Only Platform Admins can enable/disable maintenance mode from Platform Settings.

Impacto

Use during planned deployments or infrastructure changes. Prevents tenants from encountering errors during updates.