Reference

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 Applications 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 Applications 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 Applications 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 Applications 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 Applications 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.