Amazon DevPay
Developer Guide (API Version 2007-12-01)

Usage Report

The purpose of the usage report is to help you understand the specific usage details that resulted in the revenue collected for each individual customer the previous month. You can use this report to understand the usage patterns of your product and the associated AWS costs.

Like the revenue report, this report is available in comma-separated value (CSV) format on or around the fifteenth day of each month. We don't generate a usage report if none of your customers used your product or generated any revenue for you during the previous month.

Each row of the report represents a single revenue item related to a customer's activity with a single DevPay product. For example, a row might represent the revenue from a sign-up charge, a monthly charge, or a specific AWS service usage dimension (such as data transfer in or data transfer out). Only dimensions related to a customer's use during the month are included in the report. For example, if your product uses Amazon EC2, but the customer didn't transfer any data in or out during the previous month, the report has no rows for data transfer in or out for that customer.

If a customer cancels and then resubscribes to your product in the same month, we present the revenue from each subscription period separately in that month's report. For example, if the customer cancels on January 10 and then resubscribes on January 20, the report you receive in February has one set of rows for the revenue for January 1 to January 10, and a separate set for the revenue for January 20 to January 31. The value in the Customer Since field for the second subscription period will be January 20.

To view the usage report

  1. Go to your DevPay Activity page at

  2. Click View Customer Reports in the table for any of your products.

    The DevPay Customer Reports page is displayed.

  3. In the Customer Revenue and Usage Reports section of the page, select the time period for the report, click Usage, and click Download Report.

    You're prompted to save the CSV report to the location of your choice.

The following table describes each of the columns presented in the report in the order they appear. All values in the report (except column names) are enclosed in quotation marks.

Column Name Description

Customer Email

The customer's e-mail address.

Type: String with 64 characters maximum length


Billing Period

The billing month the report covers.

Type: Date with format MMM-YYYY

Example: DEC-2007


The name of the DevPay product (important if you have multiple DevPay products).

Type: String with 80 characters maximum length

Example: My Application

Customer Since

The date the customer signed up for the product (and if the product has up-front fees at sign-up, this is the date the customer's sign-up payment succeeded). If the customer's status is Activation Pending, this field is empty.

Type: Date with format DD-MMM-YY

Example: 12-DEC-07

Amazon Web Service

The underlying AWS service. The field has a value only when Type is Usage; otherwise it is empty.

Type: String with 32 characters maximum

Example: AmazonEC2


The type of charge.

Type: String with 32 characters maximum

Valid values:

  • DevPayFeeThe DevPay fees related to this customer's use of your product

  • OneTimeFeeThe one-time sign-up charge

  • RefundA refund issued because of a cancellation or change to your product's price

  • SubscriptionThe monthly charge

  • UsageA charge for a usage dimension for the underlying AWS service

    See the following description for Usage Dimension.

Usage Dimension

If the Type column's value is Usage, then this field lists the specific usage dimension for the revenue reported in this row. For example, DataTransfer-In-Bytes.

The values shown in this field are the same values displayed when you generate an AWS Usage Report for your AWS developer account (creating an AWS Usage Report is one of the options you have when you log in to your AWS developer account).

Type: String with 256 characters maximum length

Example: DataTransfer-Out-Bytes

Usage Amount

The amount the customer used of the specified dimension.

Type: Number with 24 characters maximum length

Example: 0.032988

Usage Unit

The unit of measure for the specified dimension.

Type: String with 30 characters maximum length

Example: GB

Revenue Billed

The revenue we billed the customer for the specified dimension, regardless of whether the customer has actually paid the bill. If the Type column's value is Refund, then the value in this field is negative.

Type: Currency rounded to two decimal places

Example: 12345.99


If the Type is DevPayFee, this field lists the DevPay fee related to this customer's use of your product. If the Type is Usage, this field lists the cost to you of the underlying AWS service the customer used.

Note that data transfer out is a special case. Because it has a tiered cost structure, the value used to determine its cost is the cost-per-unit across the tiers.

For example, let's say that data transfer out costs $0.10 for the first gigabyte used by all your customers, and $0.20 for the remaining gigabytes used by all your customers. If you have three customers, and they each use 0.5 GB, then the total amount of data transfer out is 1.5 GB. Therefore, the cost-per-unit is: [(0.5 GB * $0.10/GB) + (0.5 GB * $0.10/GB) + (0.5 GB * $0.20/GB)] / 1.5 GB = $0.2 / 1.5 GB = $0.13 per GB.

Because it is a debit, this value is always negative.

Type: Currency rounded to two decimal places

Example: -12345.99

Example Usage Report

Customer Email,Customer Name,Billing Period,Application,Customer Status,Customer Since,Cancellation Date,Revenue Billed,AWS Costs,DevPay Fee,Refunds Issued,RevenueCollectedCurrBillPeriod,RevenueCollectedPrevBillPeriod
"","FEB-2008","My Product A","27-FEB-08","AmazonS3","Usage","DataTransfer-In-Bytes",".0049798339605331","GB",".01","0"
"","FEB-2008","My Product A","27-FEB-08","AmazonS3","Usage","DataTransfer-Out-Bytes",".0037920186296105","GB",".01","0"
"","FEB-2008","My Product A","27-FEB-08","AmazonS3","Usage","Requests-Tier1","12310","Requests",".25","-.12"
"","FEB-2008","My Product A","27-FEB-08","AmazonS3","Usage","Requests-Tier2","12737","Requests",".03","-.01"
"","FEB-2008","My Product A","27-FEB-08","AmazonS3","Usage","TimedStorage-ByteHrs",".00030796040363353","GB-Mo",".01","0"
"","FEB-2008","My Product A","27-FEB-08","","DevPayFee","","","","0","-.31"
"","FEB-2008","My Product B","21-FEB-08","AmazonS3","Usage","DataTransfer-In-Bytes",".00011754874140024","GB",".01","0"
"","FEB-2008","My Product B","21-FEB-08","AmazonS3","Usage","DataTransfer-Out-Bytes",".00035172142088413","GB",".01","0"
"","FEB-2008","My Product B","21-FEB-08","AmazonS3","Usage","Requests-Tier1","893","Requests",".02","-.01"
"","FEB-2008","My Product B","21-FEB-08","AmazonS3","Usage","Requests-Tier2","22178","Requests",".04","-.02"
"","FEB-2008","My Product B","21-FEB-08","AmazonS3","Usage","TimedStorage-ByteHrs",".000010993909733049","GB-Mo",".01","0"
"","FEB-2008","My Product B","21-FEB-08","","Subscription","","","","3.45","0"
"","FEB-2008","My Product B","21-FEB-08","","DevPayFee","","","","0","-.7"
"","FEB-2008","My Product C","24-FEB-08","","OneTimeFee","","","","1","0"
"","FEB-2008","My Product C","24-FEB-08","","Subscription","","","",".1","0"
"","FEB-2008","My Product C","24-FEB-08","","DevPayFee","","","","0","-.6"
"","FEB-2008","My Product D","27-DEC-07","AmazonEC2","Usage","BoxUsage","409","Hrs","57.26","-40.9"
"","FEB-2008","My Product D","27-DEC-07","AmazonEC2","Usage","DataTransfer-In-Bytes",".017763266339898","GB",".01","0"
"","FEB-2008","My Product D","27-DEC-07","AmazonEC2","Usage","DataTransfer-Out-Bytes",".03164594899863","GB",".01","-.01"
"","FEB-2008","My Product D","27-DEC-07","","Subscription","","","","5","0"
"","FEB-2008","My Product D","27-DEC-07","","DevPayFee","","","","0","-2.17"