Financial report fields
Financial reports show your monthly proceeds, as well as final unit sales by country or region and order type, for transactions on the App Store. Learn more.
All Countries or Regions (Single File, Multiple File) report fields:
|
Report Field |
Values |
Notes |
|---|---|---|
|
Start Date |
MM/DD/YYYY |
This is the period start date, based on Apple’s fiscal calendar. |
|
End Date |
MM/DD/YYYY |
This is the period end date, also based on Apple’s fiscal calendar. |
|
UPC |
Up to 20 characters |
This field is not applicable to developers. This will display as blank. |
|
ISRC / ISBN |
Up to 20 characters |
For apps, this is your SKU. For details, visit App information. For in-app purchases, this is the product ID. Visit In-app purchase information for details. |
|
Vendor Identifier |
Up to 20 characters |
This is the “SKU” that was provided for an app, or a “Product ID” provided for an in-app purchase. |
|
Quantity |
Number with no decimal places (positive or negative) |
Aggregated number of units sold. |
|
Partner Share |
Number with two decimal places (always positive) |
The proceeds you receive per unit. This is the Customer Price minus applicable taxes and Apple’s commission, per Schedule 2 of your Paid Apps Agreement. |
|
Extended Partner Share |
Number with two decimal places (positive or negative) |
Quantity multiplied by Partner Share. |
|
Partner Share Currency |
Three characters |
Three-character ISO code for the currency of the amounts earned. |
|
Sale or Return |
“S” or “R” |
S indicates a Sale, R indicates a Return |
|
Apple Identifier |
Up to 18 characters |
Apple ID, a unique identifier automatically generated for your app when you add the app to your account. You can view this property in the App information section in App Store Connect. This identifier is also used in the URL for the App Store on desktop computers. You can’t edit this property. Note: This identifier is not the same as your Apple ID that you use to sign in to App Store Connect and your developer account. |
|
Artist / Show / Developer / Author |
Up to 1000 characters |
Your legal entity name. |
|
Title |
Up to 5000 characters |
The name you entered for your app as described in App information. |
|
Label / Studio / Network / Developer / Publisher |
Up to 1000 characters |
This field is not applicable to developers. This will display as blank. |
|
Grid |
Up to 30 characters |
This field is not applicable to developers. This will display as blank. |
|
Product Type Identifier |
Up to five characters |
The type of product purchased. Visit Product type identifiers for more information. |
|
ISAN / Other Identifier |
Up to 50 characters |
This field is not applicable to developers. This will display as blank. |
|
Country of Sale |
Two characters |
Two-character ISO code (such as US for the United States) that indicates the country or region for the App Store where the purchase occurred. This is based on the customer Apple ID country or region. |
|
Pre-order Flag |
“P” or null |
|
|
Promo Code |
Up to 10 characters |
If the transaction was part of a promotion, a gift, or was downloaded through the Volume Purchase Program for Education, this field will contain a value. This field is empty for all non-promotional items. For more information, visit Promotional codes. |
|
Customer Price |
Number with two decimal places (positive or negative) |
The price per unit billed to the customer, which you set for your app or in-app purchase in App Store Connect. *Customer price is inclusive of any applicable taxes we collect and remit per Schedule 2 of the Paid Apps Agreement. |
|
Customer Currency |
Three characters |
Three-character ISO code for the currency type paid by the customer. For example, USD for the United States Dollar. |
An asterisk (*) indicates you provided this information to us. Sometimes we may change this information for consistency.
All Countries or Regions (Detailed) report fields:
|
Field Name |
Date Type |
Notes |
|---|---|---|
|
Vendor Name |
String |
Provided by you when signing your Paid Apps Agreement. |
|
Start Date |
MM/DD/YYYY |
This is the period start date, based on Apple’s fiscal calendar. |
|
End Date |
MM/DD/YYYY |
This is the period end date, also based on Apple’s fiscal calendar. |
|
Transaction Date |
MM/DD/YYYY |
Date the customer purchased the app or in-app purchase. The transaction date is only populated if it occurred within 30 days of the settlement date. Otherwise the field is blank. |
|
Settlement Date |
MM/DD/YYYY |
Date when the customer’s payment was processed and collected and an invoice was issued. |
|
Apple Identifier |
Int |
An app Apple ID is a unique identifier automatically generated for your app when you add a new app record in Apps and can't be edited. You can view this identifier in the App information section of the app record. It is also used in your app’s App Store link on desktop computers. |
|
SKU |
String |
“SKU” that was provided for an app, or the “Product ID” that was provided for an in-app purchase. |
|
Title |
String |
Name you entered for your app in App information. |
|
Developer Name |
String |
Your legal entity name. |
|
Product Type Identifier |
String |
Type of product purchased. Visit Product type identifiers. |
|
Country of Sale |
String |
Two-character ISO code (such as US for the United States) that indicates the country or region of the App Store where the purchase occurred. This is based on the customer’s Apple ID country or region. |
|
Quantity |
Int |
Aggregate number of units sold. |
|
Partner Share |
Decimal |
Proceeds you receive per unit. This is the Customer Price minus applicable taxes and Apple’s commission, per Schedule 2 of the Paid Apps Agreement. |
|
Extended Partner Share |
Decimal |
Quantity multiplied by Partner Share. |
|
Partner Share Currency |
String |
Three-character ISO code for the currency of the amounts earned. |
|
Customer Price |
Decimal |
Price per unit billed to the customer, which you set for your app or in-app purchase in App Store Connect. This includes any applicable taxes we collect and remit per Schedule 2 of the Paid Apps Agreement. |
|
Customer Currency |
String |
Three-character ISO code for the currency type paid by the customer. For example, USD for the United States Dollar. |
|
Sale or Return |
String |
S indicates a Sale. R indicates a Return. |
|
Promo Code |
String |
If the transaction was part of a promotion, a gift, or was downloaded through the Volume Purchase Program for Education, this field will contain a value. This field is empty for all non-promotional items. For more information, visit Promotional codes. |
|
Order Type |
String |
For introductory offers or promotional offers, indicates what type of transaction this line item is: Pay Up Front or Pay As You Go. For pre-orders, indicates whether a purchase originated from a Pre-Order. For promotional offers, the field will populate the Order ID. For offer codes, the field will populate the offer code reference name used in App Store Connect when setting up the subscription offer. |
|
Region |
String |
Shows a two-character state or province code for transactions in the United States and Canada. |