GuideDevelopers 22 min5 July 2026

VitalReturns Public API: an integration starter

A hands-on guide for building against the VitalReturns API — authentication, taxpayers, returns, submissions and webhooks.

This guide gets you from zero to a working integration against the VitalReturns Public API in under an hour.

Authentication

Provision an API key from workspace settings. Pass as Bearer token.

POST /api/v2/taxpayers with TIN. Verification runs automatically.

POST /api/v2/returns to prepare. POST /api/v2/returns/{id}/submit to file.

Configure a webhook endpoint. Receive signed events for every state change.