Skip to main content

Welcome to Royalti API Documentation

Royalti.io is an online platform that assists artists and music companies in managing their catalog/splits, royalties, and accounting—an all-in-one workspace designed to streamline and simplify the process of handling the commercial aspects of music.
This documentation is designed for technical teams integrating the Royalti.io API into their applications. Our focus is on providing clear, actionable guidance for successful API integration.

What you can build

The Royalti.io API provides comprehensive functionality across four core areas:

Royalty Management

Track and calculate royalties for artists, publishers, and rights holders with automated distribution workflows.

Payment Processing

Handle payments, splits, and financial transactions with support for international payments and multiple currencies.

Artist & Content Management

Manage artists, releases, and digital assets with comprehensive metadata and catalog organization.

Accounting & Analytics

Comprehensive accounting and financial reporting with real-time analytics and revenue tracking.

Platform Features

Core Management

  • Artist Management: Complete artist profile and catalog management
  • Asset & Product Management: Track songs, albums, and digital content
  • User Management: Multi-user collaboration and access control
  • Split Management: Complex revenue sharing and royalty calculations

Financial Operations

  • Revenue Tracking: Monitor income from multiple sources
  • Expense Management: Track and categorize business expenses
  • Payment Processing: Automated and manual payment workflows
  • Accounting Integration: Complete financial reporting and reconciliation

Advanced Features

  • Bulk Operations: Efficient batch processing for large datasets
  • File Management: Upload and organize digital assets
  • VertoFx Integration: International payment processing
  • Data Validation: Built-in checklists and quality assurance tools

Environment

All API requests should be directed to: Production URL: https://server26-dot-royalti-project.uc.r.appspot.com

API Architecture

Our RESTful API is built with modern standards and best practices:
  • RESTful Design: Intuitive endpoints following REST conventions
  • JSON Format: All requests and responses use JSON
  • HTTPS Only: Secure communication with SSL encryption
  • Bearer Authentication: JWT-based authentication system
  • Rate Limiting: Fair usage policies and throttling
  • Comprehensive Documentation: Interactive API playground

Common Use Cases

Music Industry Workflows

  • Set up artist catalogs with complete metadata
  • Configure complex royalty split agreements
  • Process revenue from multiple streaming platforms
  • Generate comprehensive financial reports
  • Manage payment distributions to stakeholders

Integration Patterns

  • Automate royalty calculations and distributions
  • Sync data with external music platforms
  • Build custom dashboards and analytics
  • Implement payment workflow automation
  • Create bulk import/export systems

Security & Compliance

Royalti.io is built with enterprise-grade security:
  • SSL/TLS Encryption: All data transmitted over HTTPS
  • Access Token Security: Industry-standard cryptographic algorithms
  • Certificate Validation: Verisign-issued certificates
  • Data Protection: Secure storage and transmission protocols
  • Audit Trails: Comprehensive logging and monitoring
Always verify SSL certificates and never connect via unencrypted HTTP. Secure your access tokens and never share them with unauthorized parties.

Getting Started

Ready to integrate? Here’s how to get started:
  1. Quickstart Guide - Get up and running with your first API call in minutes
  2. Authentication - Learn about JWT tokens, API keys, and OAuth flows
  3. API Reference - Explore all available endpoints

Support & Resources

Need help or want to stay connected?

Languages & Methods

The API supports all platforms and languages capable of implementing HTTP RESTful methods, including:
  • cURL
  • JavaScript/Node.js
  • Python
  • Ruby
  • PHP
  • Java
  • Go
  • And any HTTP client library