Overview
The CUA API allows you to programmatically register copyrights, verify registrations, and manage certificates. All API requests use JSON and require authentication via API key.
Base URL: https://cua.herownsky.com/api/v1
Authentication
All API requests require an API key passed in the request header:
Authorization: Bearer YOUR_API_KEY
To obtain an API key, contact support@herownsky.com
Endpoints
Register a new copyright for an audio file
Request Body (multipart/form-data)
audio: [audio file] (required) title: "Song Title" (required) artist_name: "Artist Name" (required) artist_id: "uuid" (required) album: "Album Name" (optional) release_year: 2025 (optional)
Response
{
"success": true,
"registration_id": "db8fa3d7-0908-46a3-a1a7-d55bd8ce1b24",
"status": "processing",
"message": "Registration started"
}
Check the status of a registration
Response
{
"id": "db8fa3d7-0908-46a3-a1a7-d55bd8ce1b24",
"status": "completed",
"certificate_url": "https://cua.herownsky.com/certificates/...",
"verification_url": "https://cua.herownsky.com/verify/..."
}
Verify a copyright registration (returns JSON)
Response
{
"verified": true,
"registration": {
"id": "db8fa3d7-0908-46a3-a1a7-d55bd8ce1b24",
"title": "Stand By Me",
"artist_name": "Logan and Steph Vang",
"registered_at": "2025-12-25T00:00:00Z",
"fingerprint": "SHA256:abc123..."
}
}
Download the PDF certificate for a registration
Response
Returns the PDF file with appropriate Content-Type headers.
Rate Limits
API requests are rate limited based on your plan:
- Free Tier: 100 registrations/month
- Starter ($99/mo): 500 registrations/month
- Pro ($299/mo): 2,000 registrations/month
- Enterprise: Custom limits
Error Handling
All errors return JSON with an error code and message:
{
"error": "Invalid API key",
"code": "AUTH_ERROR",
"status": 401
}
Important: CUA provides supplemental copyright evidence, not official US Copyright Office registration. For full legal protection, register at copyright.gov.