# Varmo

> Card delivery intelligence API — bridge the gap between card issuance and delivery.

## Docs

- [Varmo API error codes and troubleshooting](https://docs.varmo.fi/api-reference/errors.md): HTTP error codes returned by the Varmo API, what each code means, and how to resolve common authentication, permission, and rate limit issues.
- [GET /v1/status — retrieve card delivery status](https://docs.varmo.fi/api-reference/get-status.md): GET /v1/status/{id} — fetch delivery status, predicted delivery window, confidence level, and UI suggestion for a dispatched card.
- [Authenticate with the Varmo API](https://docs.varmo.fi/authentication.md): Varmo authenticates requests with API key Bearer tokens. Learn how to obtain your key, include it in every request, and keep it secure.
- [GDPR compliance and data handling in Varmo](https://docs.varmo.fi/compliance/gdpr.md): Learn what data Varmo processes, the legal basis for that processing, your data subject rights obligations, and how to request a DPA.
- [Security and compliance overview for Varmo](https://docs.varmo.fi/compliance/overview.md): Understand Varmo's PCI-DSS out-of-scope architecture, SOC 2 Type I certification status, and GDPR compliance before you integrate.
- [Card delivery lifecycle in Varmo](https://docs.varmo.fi/concepts/delivery-lifecycle.md): Understand the stages a card moves through from dispatch to delivery and how Varmo tracks each stage using regional postal intelligence.
- [Delivery window predictions and confidence](https://docs.varmo.fi/concepts/predictions.md): Learn how Varmo calculates delivery windows from regional latency data, and what High, Medium, and Low confidence levels mean for your UI.
- [UI suggestions for cardholder messaging](https://docs.varmo.fi/concepts/ui-suggestions.md): Use Varmo's ui_suggestion field to display locale-aware delivery messages and prompt cardholders to act at the right moment in their delivery journey.
- [Drive card activation with delivery intelligence](https://docs.varmo.fi/guides/customer-activation.md): Use Varmo's delivery predictions and UI suggestions to build anticipation during the dispatch window and convert cardholders at the moment of arrival.
- [Track card delivery status with Varmo](https://docs.varmo.fi/guides/track-card-delivery.md): Poll the Varmo Status API to surface real-time card delivery progress to cardholders, from dispatch through to arrival at their door.
- [Receive delivery status updates via webhooks](https://docs.varmo.fi/guides/webhooks.md): Register a webhook endpoint with Varmo to receive instant push notifications whenever a card's delivery status changes, eliminating the need to poll.
- [Varmo: card delivery intelligence API](https://docs.varmo.fi/introduction.md): Varmo gives card issuers real-time delivery status and predictive arrival windows so cardholders always know when their card will arrive.
- [Quickstart: make your first Varmo API call](https://docs.varmo.fi/quickstart.md): Make your first call to the Varmo Status API in minutes — from getting your API key to reading a delivery prediction and displaying it in your app.

## Optional

- [Home](https://varmo.fi/)