Get Tenant Source by RoyaltySource ID
Retrieves a tenant source association by the RoyaltySource ID.
Description
Required Permissions
sources:read
Important: ID Parameter
Theid parameter represents the RoyaltySource ID, not the TenantSource association ID.
This endpoint finds the tenant’s source association WHERE RoyaltySourceId = id AND TenantId = authenticated_tenant.
Since the composite key is (TenantId, RoyaltySourceId), this uniquely identifies the association.
Business Rules
- Returns only the authenticated tenant’s association
- Only shows active sources (
isActive=truein RoyaltySource)
- Required role:
useror higher
Code Examples
Authorizations
JWT Authorization header using the Bearer scheme. Format: "Bearer {token}"
Path Parameters
RoyaltySource ID (not TenantSource ID)
"src-1"
Response
Tenant source details
Association between a tenant and a royalty source. Note: The composite key is (TenantId, RoyaltySourceId).
Tenant ID (automatically set from authenticated user)
1
Royalty source ID
"src-1"
Whether this source association is active for the tenant
true
Tenant-specific settings for this source
Tenant-specific field replacements/mappings
Number of files processed for this tenant-source association
42
Timestamp of the most recently processed file
"2026-03-04T14:30:00.000Z"
ID of the most recently processed file
"a1b2c3d4-e5f6-7890-abcd-ef1234567890"
When tenant-specific settings were last modified
TenantUserId who last updated the settings