Anon Concepts

Introduction to key API concepts and usage

Anon API

The Anon API lets you easily access extracted and processed data from migrations. This guide introduces the core concepts and API features you need to understand to effectively integrate with Anon.

This guide covers the fundamental concepts of the Anon API. For step-by-step implementation instructions, see the Quickstart guide.

Resource-Based API

Anon offers a REST API that follows resource-based principles. Each entity in the system (users, migrations, files) is a resource with a unique identifier that can be created, retrieved, and managed through standard HTTP methods.

Your organization can only access data that originates from migrations initiated through your embedded modal interface.

Anon UI

Migration Modal

The Migration Modal is the primary interface for users to initiate data transfers. The process follows these steps:

1. User Authentication

   • Your customers interact with the embeddable modal in your web application
   • They log in to their source system through this interface

2. Background Data Collection

   • After authentication, Anon’s intelligent AI agent works behind the scenes
   • Using AI-powered browser automation, it:
     • Downloads platform data (employee data, payroll records, etc.)
     • Transforms the data into structured formats

3. Data Access

   • Once the migration is complete, you can access the processed data through the Anon API
   • The data is organized in a medallion architecture (bronze, silver, and gold files)

Migrations are asynchronous operations. Always check the migration status endpoint to determine when a run is complete.

Admin Dashboard

Anon provides an admin dashboard to view and test migrations. You can also use it to access extracted and processed data from any past migration.

Environment	Dashboard URL
Production	dashboard.anon.com

Anon Resources

End Users

When integrating Anon, you’ll be working with end users (your customers) who initiate migrations. Anon’s API allows you to:

• Generate a link for an embeddable iframe of the migration modal tailored to a specific end user
• Retrieve migrations and extracted data for specific end users

End users initiate migrations via the embedded modal, and your system can subsequently retrieve these migrations through the API endpoints for additional processing and integration.

Migrations

Each attempt a user makes through the migration modal is called a migration.

The API allows you to:

• Track the status and progress of each migration
• Access files generated during the migration

Migrations are long-running asynchronous operations. Always check the migration’s status to determine when a run is complete.

Migration Artifacts / Files

Anon organizes data into a medallion architecture, which separates data into three distinct layers that progressively improve data quality and structure:

• Bronze Artifacts / Files: Raw, unprocessed data exports from the source system. These files maintain the original format and structure from the source platform.
• Silver Artifacts / Files: Cleaned and standardized data files that have been transformed into a consistent, machine-readable format (typically JSON). This layer may include data validation and quality checks.
• Gold Artifacts / Files: Business-ready, aggregated data that combines and enriches information from multiple silver files. These files are optimized for analytics and reporting.

Examples

• Employee Roster CSV (bronze)
• Federal Tax Form 941 PDF (bronze)
• Company information in JSON format (silver)
• Aggregated analytics (gold)