Properties
| Name | Type | Description |
|---|---|---|
| id | string | |
| statement_no | string | |
| payee | string | |
| payee_details | object | |
| contract | stringnull | |
| contract_details | object | |
| period_start | stringnull | |
| period_end | stringnull | |
| total_revenue_share | string | |
| statement_value | string | |
| previous_balance | string | |
| recoupment_applied | string | |
| statement_balance | string | |
| meets_payment_threshold | boolean | |
| payment_threshold | string | |
| currency | stringnull | |
| file | stringnull | |
| file_url | string | |
| created_by | string | |
| status | object | |
| created_at | string | |
| updated_at | string |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/track/json-schema/track-royalty-statement-schema.json",
"title": "RoyaltyStatement",
"x-generated": "2026-10-29",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/track-openapi.yml#/components/schemas/RoyaltyStatement",
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"readOnly": true
},
"statement_no": {
"type": "string",
"readOnly": true
},
"payee": {
"type": "string",
"format": "uuid",
"readOnly": true
},
"payee_details": {
"allOf": [
{
"$ref": "#/$defs/PayeeDetails"
}
],
"readOnly": true
},
"contract": {
"type": [
"string",
"null"
],
"format": "uuid",
"readOnly": true
},
"contract_details": {
"allOf": [
{
"$ref": "#/$defs/ContractDetails"
}
],
"readOnly": true,
"nullable": true
},
"period_start": {
"type": [
"string",
"null"
],
"format": "date",
"readOnly": true
},
"period_end": {
"type": [
"string",
"null"
],
"format": "date",
"readOnly": true
},
"total_revenue_share": {
"type": "string",
"format": "decimal",
"pattern": "^-?\\d{0,19}(?:\\.\\d{0,2})?$",
"readOnly": true
},
"statement_value": {
"type": "string",
"format": "decimal",
"pattern": "^-?\\d{0,19}(?:\\.\\d{0,2})?$",
"readOnly": true
},
"previous_balance": {
"type": "string",
"format": "decimal",
"pattern": "^-?\\d{0,19}(?:\\.\\d{0,2})?$",
"readOnly": true
},
"recoupment_applied": {
"type": "string",
"format": "decimal",
"pattern": "^-?\\d{0,19}(?:\\.\\d{0,2})?$",
"readOnly": true
},
"statement_balance": {
"type": "string",
"format": "decimal",
"pattern": "^-?\\d{0,19}(?:\\.\\d{0,2})?$",
"readOnly": true
},
"meets_payment_threshold": {
"type": "boolean",
"readOnly": true
},
"payment_threshold": {
"type": "string",
"format": "decimal",
"pattern": "^-?\\d{0,10}(?:\\.\\d{0,2})?$",
"readOnly": true
},
"currency": {
"type": [
"string",
"null"
],
"readOnly": true
},
"file": {
"type": [
"string",
"null"
],
"format": "uri",
"readOnly": true
},
"file_url": {
"type": "string",
"readOnly": true
},
"created_by": {
"type": "string",
"format": "uuid",
"readOnly": true
},
"status": {
"allOf": [
{
"$ref": "#/$defs/Status4deEnum"
}
],
"readOnly": true
},
"created_at": {
"type": "string",
"format": "date-time",
"readOnly": true
},
"updated_at": {
"type": "string",
"format": "date-time",
"readOnly": true
}
},
"required": [
"contract",
"contract_details",
"created_at",
"created_by",
"currency",
"file",
"file_url",
"id",
"meets_payment_threshold",
"payee",
"payee_details",
"payment_threshold",
"period_end",
"period_start",
"previous_balance",
"recoupment_applied",
"statement_balance",
"statement_no",
"statement_value",
"status",
"total_revenue_share",
"updated_at"
],
"$defs": {
"BlankEnum": {
"enum": [
""
]
},
"ContractDetails": {
"type": "object",
"description": "Shared helpers to serialize release and recording information.",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"readOnly": true
},
"created_at": {
"type": "string",
"format": "date-time",
"readOnly": true
},
"updated_at": {
"type": "string",
"format": "date-time",
"readOnly": true
},
"label": {
"type": "string",
"format": "uuid"
},
"label_name": {
"type": "string",
"readOnly": true
},
"payees": {
"type": "string"
},
"starting_balance": {
"type": [
"string",
"null"
],
"format": "decimal",
"pattern": "^-?\\d{0,10}(?:\\.\\d{0,2})?$",
"writeOnly": true
},
"name": {
"type": "string"
},
"contract_type": {
"$ref": "#/$defs/ContractTypeEnum"
},
"status": {
"$ref": "#/$defs/Status65cEnum"
},
"start_date": {
"type": [
"string",
"null"
],
"format": "date"
},
"end_date": {
"type": [
"string",
"null"
],
"format": "date"
},
"territory": {
"type": "string",
"maxLength": 128
},
"currency": {
"type": "string",
"maxLength": 3
},
"royalty_basis": {
"$ref": "#/$defs/RoyaltyBasisEnum"
},
"distribution_fee_percent": {
"type": [
"string",
"null"
],
"format": "decimal",
"pattern": "^-?\\d{0,3}(?:\\.\\d{0,2})?$"
},
"label_share_percent": {
"type": [
"string",
"null"
],
"format": "decimal",
"pattern": "^-?\\d{0,3}(?:\\.\\d{0,2})?$"
},
"label_share_overrides": {
"type": [
"object",
"null"
],
"description": "Per-category overrides of label_share_percent. Values are the label's share as decimal strings between 0.00 and 100.00; a missing key falls back to label_share_percent.",
"properties": {
"ad_revenue": {
"type": "string"
},
"cd": {
"type": "string"
},
"downloads": {
"type": "string"
},
"expenses": {
"type": "string"
},
"licensing": {
"type": "string"
},
"misc": {
"type": "string"
},
"physical": {
"type": "string"
},
"radio": {
"type": "string"
},
"streaming": {
"type": "string"
},
"video": {
"type": "string"
},
"vinyl": {
"type": "string"
}
},
"additionalProperties": false
},
"payment_threshold": {
"type": "string",
"format": "decimal",
"pattern": "^-?\\d{0,10}(?:\\.\\d{0,2})?$"
},
"advance_amount": {
"type": "string",
"format": "decimal",
"pattern": "^-?\\d{0,10}(?:\\.\\d{0,2})?$"
},
"cross_collateralized": {
"type": "boolean"
},
"file": {
"type": [
"string",
"null"
],
"format": "uri"
},
"notes": {
"type": "string"
},
"verified_at": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"extracting_status": {
"type": "string",
"readOnly": true
},
"statement_period": {
"nullable": true,
"oneOf": [
{
"$ref": "#/$defs/StatementPeriodEnum"
},
{
"$ref": "#/$defs/BlankEnum"
},
{
"$ref": "#/$defs/NullEnum"
}
]
},
"tracks_count": {
"type": "integer",
"readOnly": true,
"default": 0
},
"first_sound_recording_title": {
"type": [
"string",
"null"
],
"readOnly": true
},
"all_tracks_have_isrc": {
"type": "boolean",
"readOnly": true,
"default": true
},
"can_delete": {
"type": "boolean",
"readOnly": true
},
"can_activate": {
"type": "boolean",
"readOnly": true
},
"has_revenue": {
"type": "boolean",
"readOnly": true,
"default": false
},
"has_expenses": {
"type": "boolean",
"readOnly": true,
"default": false
},
"related_releases": {
"type": "string",
"readOnly": true
},
"related_recordings": {
"type": "string",
"readOnly": true
},
"rates_locked": {
"type": "boolean",
"readOnly": true
}
},
"required": [
"all_tracks_have_isrc",
"can_activate",
"can_delete",
"created_at",
"extracting_status",
"first_sound_recording_title",
"has_expenses",
"has_revenue",
"id",
"label",
"label_name",
"rates_locked",
"related_recordings",
"related_releases",
"tracks_count",
"updated_at"
]
},
"ContractTypeEnum": {
"enum": [
"recording",
"distribution",
"licensing",
"producer",
"featured_artist",
"exclusive_license",
"360"
],
"type": "string",
"description": "* `recording` - Recording\n* `distribution` - Distribution\n* `licensing` - Licensing\n* `producer` - Producer\n* `featured_artist` - Featured Artist\n* `exclusive_license` - Exclusive License\n* `360` - 360 Deal"
},
"CountryEnum": {
"enum": [
"AF",
"AX",
"AL",
"DZ",
"AS",
"AD",
"AO",
"AI",
"AQ",
"AG",
"AR",
"AM",
"AW",
"AU",
"AT",
"AZ",
"BS",
"BH",
"BD",
"BB",
"BY",
"BE",
"BZ",
"BJ",
"BM",
"BT",
"BO",
"BQ",
"BA",
"BW",
"BV",
"BR",
"IO",
"BN",
"BG",
"BF",
"BI",
"CV",
"KH",
"CM",
"CA",
"KY",
"CF",
"TD",
"CL",
"CN",
"CX",
"CC",
"CO",
"KM",
"CG",
"CD",
"CK",
"CR",
"CI",
"HR",
"CU",
"CW",
"CY",
"CZ",
"DK",
"DJ",
"DM",
"DO",
"EC",
"EG",
"SV",
"GQ",
"ER",
"EE",
"SZ",
"ET",
"FK",
"FO",
"FJ",
"FI",
"FR",
"GF",
"PF",
"TF",
"GA",
"GM",
"GE",
"DE",
"GH",
"GI",
"GR",
"GL",
"GD",
"GP",
"GU",
"GT",
"GG",
"GN",
"GW",
"GY",
"HT",
"HM",
"VA",
"HN",
"HK",
"HU",
"IS",
"IN",
"ID",
"IR",
"IQ",
"IE",
"IM",
"IL",
"IT",
"JM",
"JP",
"JE",
"JO",
"KZ",
"KE",
"KI",
"KW",
"KG",
"LA",
"LV",
"LB",
"LS",
"LR",
"LY",
"LI",
"LT",
"LU",
"MO",
"MG",
"MW",
"MY",
"MV",
"ML",
"MT",
"MH",
"MQ",
"MR",
"MU",
"YT",
"MX",
"FM",
"MD",
"MC",
"MN",
"ME",
"MS",
"MA",
"MZ",
"MM",
"NA",
"NR",
"NP",
"NL",
"NC",
"NZ",
"NI",
"NE",
"NG",
"NU",
"NF",
"KP",
"MK",
"MP",
"NO",
"OM",
"PK",
"PW",
"PS",
"PA",
"PG",
"PY",
"PE",
"PH",
"PN",
"PL",
"PT",
"PR",
"QA",
"RE",
"RO",
"RU",
"RW",
"BL",
"SH",
"KN",
"LC",
"MF",
"PM",
"VC",
"WS",
"SM",
"ST",
"SA",
"SN",
"RS",
"SC",
"SL",
"SG",
"SX",
"SK",
"SI",
"SB",
"SO",
"ZA",
"GS",
"KR",
"SS",
"ES",
"LK",
"SD",
"SR",
"SJ",
"SE",
"CH",
"SY",
"TW",
"TJ",
"TZ",
"TH",
"TL",
"TG",
"TK",
"TO",
"TT",
"TN",
"TR",
"TM",
"TC",
"TV",
"UG",
"UA",
"AE",
"GB",
"UM",
"US",
"UY",
"UZ",
"VU",
"VE",
"VN",
"VG",
"VI",
"WF",
"EH",
"YE",
"ZM",
"ZW"
],
"type": "string",
"description": "* `AF` - Afghanistan\n* `AX` - Åland Islands\n* `AL` - Albania\n* `DZ` - Algeria\n* `AS` - American Samoa\n* `AD` - Andorra\n* `AO` - Angola\n* `AI` - Anguilla\n* `AQ` - Antarctica\n* `AG` - Antigua and Barbuda\n* `AR` - Argentina\n* `AM` - Armenia\n* `AW` - Aruba\n* `AU` - Australia\n* `AT` - Austria\n* `AZ` - Azerbaijan\n* `BS` - Bahamas\n* `BH` - Bahrain\n* `BD` - Bangladesh\n* `BB` - Barbados\n* `BY` - Belarus\n* `BE` - Belgium\n* `BZ` - Belize\n* `BJ` - Benin\n* `BM` - Bermuda\n* `BT` - Bhutan\n* `BO` - Bolivia\n* `BQ` - Bonaire, Sint Eustatius and Saba\n* `BA` - Bosnia and Herzegovina\n* `BW` - Botswana\n* `BV` - Bouvet Island\n* `BR` - Brazil\n* `IO` - British Indian Ocean Territory\n* `BN` - Brunei\n* `BG` - Bulgaria\n* `BF` - Burkina Faso\n* `BI` - Burundi\n* `CV` - Cabo Verde\n* `KH` - Cambodia\n* `CM` - Cameroon\n* `CA` - Canada\n* `KY` - Cayman Islands\n* `CF` - Central African Republic\n* `TD` - Chad\n* `CL` - Chile\n* `CN` - China\n* `CX` - Christmas Island\n* `CC` - Cocos (Keeling) Islands\n* `CO` - Colombia\n* `KM` - Comoros\n* `CG` - Congo\n* `CD` - Congo (the Democratic Republic of the)\n* `CK` - Cook Islands\n* `CR` - Costa Rica\n* `CI` - Côte d'Ivoire\n* `HR` - Croatia\n* `CU` - Cuba\n* `CW` - Curaçao\n* `CY` - Cyprus\n* `CZ` - Czechia\n* `DK` - Denmark\n* `DJ` - Djibouti\n* `DM` - Dominica\n* `DO` - Dominican Republic\n* `EC` - Ecuador\n* `EG` - Egypt\n* `SV` - El Salvador\n* `GQ` - Equatorial Guinea\n* `ER` - Eritrea\n* `EE` - Estonia\n* `SZ` - Eswatini\n* `ET` - Ethiopia\n* `FK` - Falkland Islands (Malvinas)\n* `FO` - Faroe Islands\n* `FJ` - Fiji\n* `FI` - Finland\n* `FR` - France\n* `GF` - French Guiana\n* `PF` - French Polynesia\n* `TF` - French Southern Territories\n* `GA` - Gabon\n* `GM` - Gambia\n* `GE` - Georgia\n* `DE` - Germany\n* `GH` - Ghana\n* `GI` - Gibraltar\n* `GR` - Greece\n* `GL` - Greenland\n* `GD` - Grenada\n* `GP` - Guadeloupe\n* `GU` - Guam\n* `GT` - Guatemala\n* `GG` - Guernsey\n* `GN` - Guinea\n* `GW` - Guinea-Bissau\n* `GY` - Guyana\n* `HT` - Haiti\n* `HM` - Heard Island and McDonald Islands\n* `VA` - Holy See\n* `HN` - Honduras\n* `HK` - Hong Kong\n* `HU` - Hungary\n* `IS` - Iceland\n* `IN` - India\n* `ID` - Indonesia\n* `IR` - Iran\n* `IQ` - Iraq\n* `IE` - Ireland\n* `IM` - Isle of Man\n* `IL` - Israel\n* `IT` - Italy\n* `JM` - Jamaica\n* `JP` - Japan\n* `JE` - Jersey\n* `JO` - Jordan\n* `KZ` - Kazakhstan\n* `KE` - Kenya\n* `KI` - Kiribati\n* `KW` - Kuwait\n* `KG` - Kyrgyzstan\n* `LA` - Laos\n* `LV` - Latvia\n* `LB` - Lebanon\n* `LS` - Lesotho\n* `LR` - Liberia\n* `LY` - Libya\n* `LI` - Liechtenstein\n* `LT` - Lithuania\n* `LU` - Luxembourg\n* `MO` - Macao\n* `MG` - Madagascar\n* `MW` - Malawi\n* `MY` - Malaysia\n* `MV` - Maldives\n* `ML` - Mali\n* `MT` - Malta\n* `MH` - Marshall Islands\n* `MQ` - Martinique\n* `MR` - Mauritania\n* `MU` - Mauritius\n* `YT` - Mayotte\n* `MX` - Mexico\n* `FM` - Micronesia\n* `MD` - Moldova\n* `MC` - Monaco\n* `MN` - Mongolia\n* `ME` - Montenegro\n* `MS` - Montserrat\n* `MA` - Morocco\n* `MZ` - Mozambique\n* `MM` - Myanmar\n* `NA` - Namibia\n* `NR` - Nauru\n* `NP` - Nepal\n* `NL` - Netherlands\n* `NC` - New Caledonia\n* `NZ` - New Zealand\n* `NI` - Nicaragua\n* `NE` - Niger\n* `NG` - Nigeria\n* `NU` - Niue\n* `NF` - Norfolk Island\n* `KP` - North Korea\n* `MK` - North Macedonia\n* `MP` - Northern Mariana Islands\n* `NO` - Norway\n* `OM` - Oman\n* `PK` - Pakistan\n* `PW` - Palau\n* `PS` - Palestine, State of\n* `PA` - Panama\n* `PG` - Papua New Guinea\n* `PY` - Paraguay\n* `PE` - Peru\n* `PH` - Philippines\n* `PN` - Pitcairn\n* `PL` - Poland\n* `PT` - Portugal\n* `PR` - Puerto Rico\n* `QA` - Qatar\n* `RE` - Réunion\n* `RO` - Romania\n* `RU` - Russia\n* `RW` - Rwanda\n* `BL` - Saint Barthélemy\n* `SH` - Saint Helena, Ascension and Tristan da Cunha\n* `KN` - Saint Kitts and Nevis\n* `LC` - Saint Lucia\n* `MF` - Saint Martin (French part)\n* `PM` - Saint Pierre and Miquelon\n* `VC` - Saint Vincent and the Grenadines\n* `WS` - Samoa\n* `SM` - San Marino\n* `ST` - Sao Tome and Principe\n* `SA` - Saudi Arabia\n* `SN` - Senegal\n* `RS` - Serbia\n* `SC` - Seychelles\n* `SL` - Sierra Leone\n* `SG` - Singapore\n* `SX` - Sint Maarten (Dutch part)\n* `SK` - Slovakia\n* `SI` - Slovenia\n* `SB` - Solomon Islands\n* `SO` - Somalia\n* `ZA` - South Africa\n* `GS` - South Georgia and the South Sandwich Islands\n* `KR` - South Korea\n* `SS` - South Sudan\n* `ES` - Spain\n* `LK` - Sri Lanka\n* `SD` - Sudan\n* `SR` - Suriname\n* `SJ` - Svalbard and Jan Mayen\n* `SE` - Sweden\n* `CH` - Switzerland\n* `SY` - Syria\n* `TW` - Taiwan\n* `TJ` - Tajikistan\n* `TZ` - Tanzania\n* `TH` - Thailand\n* `TL` - Timor-Leste\n* `TG` - Togo\n* `TK` - Tokelau\n* `TO` - Tonga\n* `TT` - Trinidad and Tobago\n* `TN` - Tunisia\n* `TR` - Türkiye\n* `TM` - Turkmenistan\n* `TC` - Turks and Caicos Islands\n* `TV` - Tuvalu\n* `UG` - Uganda\n* `UA` - Ukraine\n* `AE` - United Arab Emirates\n* `GB` - United Kingdom\n* `UM` - United States Minor Outlying Islands\n* `US` - United States of America\n* `UY` - Uruguay\n* `UZ` - Uzbekistan\n* `VU` - Vanuatu\n* `VE` - Venezuela\n* `VN` - Vietnam\n* `VG` - Virgin Islands (British)\n* `VI` - Virgin Islands (U.S.)\n* `WF` - Wallis and Futuna\n* `EH` - Western Sahara\n* `YE` - Yemen\n* `ZM` - Zambia\n* `ZW` - Zimbabwe"
},
"NullEnum": {
"enum": [
null
]
},
"PayeeDetails": {
"type": "object",
"description": "Shared helpers to serialize release and recording information.",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"readOnly": true
},
"created_at": {
"type": "string",
"format": "date-time",
"readOnly": true
},
"updated_at": {
"type": "string",
"format": "date-time",
"readOnly": true
},
"label": {
"type": "string",
"format": "uuid"
},
"label_name": {
"type": "string",
"readOnly": true
},
"name": {
"type": "string",
"maxLength": 255
},
"legal_name": {
"type": [
"string",
"null"
],
"maxLength": 255
},
"tax_number": {
"type": [
"string",
"null"
],
"maxLength": 20
},
"preferred_currency": {
"type": "string",
"maxLength": 3
},
"country": {
"nullable": true,
"oneOf": [
{
"$ref": "#/$defs/CountryEnum"
},
{
"$ref": "#/$defs/NullEnum"
}
]
},
"city": {
"type": [
"string",
"null"
],
"maxLength": 100
},
"state": {
"type": [
"string",
"null"
],
"maxLength": 100
},
"zip_code": {
"type": [
"string",
"null"
],
"maxLength": 20
},
"address": {
"type": [
"string",
"null"
]
},
"address_line_2": {
"type": [
"string",
"null"
]
},
"website": {
"type": [
"string",
"null"
],
"maxLength": 255
},
"contact_email": {
"nullable": true,
"oneOf": [
{
"type": "string",
"format": "email",
"maxLength": 254
},
{
"type": "string",
"maxLength": 0
}
]
},
"phone": {
"type": [
"string",
"null"
],
"maxLength": 20
},
"is_active": {
"type": "boolean"
},
"can_delete": {
"type": "boolean",
"readOnly": true
},
"parties": {
"type": "array",
"items": {
"type": "string",
"format": "uuid"
}
},
"parties_details": {
"type": "string",
"readOnly": true
},
"contracts": {
"type": "string",
"readOnly": true
},
"releases": {
"type": "string",
"readOnly": true
},
"recordings": {
"type": "string",
"readOnly": true
}
},
"required": [
"can_delete",
"contracts",
"created_at",
"id",
"label",
"label_name",
"name",
"parties_details",
"recordings",
"releases",
"updated_at"
]
},
"RoyaltyBasisEnum": {
"enum": [
"net_receipts",
"gross"
],
"type": "string",
"description": "* `net_receipts` - Net Receipts\n* `gross` - Gross"
},
"StatementPeriodEnum": {
"enum": [
"monthly",
"quarterly",
"half_yearly",
"annually"
],
"type": "string",
"description": "* `monthly` - Monthly\n* `quarterly` - Quarterly\n* `half_yearly` - Half-Yearly\n* `annually` - Annually"
},
"Status4deEnum": {
"enum": [
"pending",
"generating",
"draft",
"sent",
"paid",
"failed"
],
"type": "string",
"description": "* `pending` - Pending\n* `generating` - Generating\n* `draft` - Draft\n* `sent` - Sent\n* `paid` - Paid\n* `failed` - Failed"
},
"Status65cEnum": {
"enum": [
"draft",
"active",
"ended"
],
"type": "string",
"description": "* `draft` - Draft\n* `active` - Active\n* `ended` - Ended"
}
}
}Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/track-royalty-statement"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.