Uber Developers

Uber

Developers

Ad Credits Report

The Ad Credits report provides ad credit usage and remaining balance at the ad account level, allowing you to track how many credits an account has used and when its remaining credits expire.

Account types supported:

Account type	Supported
`OFD`	✅
`USER_STORES_GROUP`	❌ (use Ad Credits by Location report)
`CPG`	❌
`NON_ENDEMIC_ADVERTISER`	❌
`AGENCY`	❌
`INTERNAL`	❌
`UNKNOWN`	❌

¶ Report Details

Report Type ID: AD_CREDITS

Use Cases:

Ad credit consumption tracking
Credit balance monitoring
Credit expiration planning

Dimensions:

ad_account_id: Ad account identifier
currency_code: Currency for monetary values

Supported Time Units:

Time Unit	Async	Sync
`HOURLY`	❌	❌
`DAILY`	✅	✅
`WEEKLY`	✅	❌
`MONTHLY`	✅	❌
`SUMMARY`	❌	❌

¶ Available Metrics

credits_utilized
credits_available
expiry_date

credits_available and expiry_date are current values and do not vary by time period. They reflect the account’s balance at the time the report is generated, regardless of the time_range requested.

¶ Time Range Configuration

When configuring time ranges, follow these guidelines for proper aggregation:

Daily Reports

Start Date: Any valid date
End Date: Any valid date after start date
Example: "start_time": "2025-07-15T00:00:00Z", "end_time": "2025-07-20T00:00:00Z"

Weekly Reports

Start Date: Must be a Monday
End Date: Must be the next Monday
Example: "start_time": "2025-07-21T00:00:00Z", "end_time": "2025-07-28T00:00:00Z"

Monthly Reports

Start Date: Must be the first day of a month
End Date: Must be the first day of the next month
Example: "start_time": "2025-07-01T00:00:00Z", "end_time": "2025-08-01T00:00:00Z"

¶ Filter Operators

Supported operators: EQUAL, NOT_EQUAL, IN

¶ Sync Reporting Limitations

When using sync reporting for this report type, only the DAILY time unit is supported.

¶ Example Request (Async)

curl -X POST "https://api.uber.com/v1/ads/{account_id}/reporting/report" \
  -H "Authorization: Bearer {ACCESS_TOKEN}" \
  -H "Accept: application/json" \
  -d '{
    "report_type": "AD_CREDITS",
    "time_range": {
      "start_time": "2025-07-21T00:00:00Z",
      "end_time": "2025-07-28T00:00:00Z"
    },
    "columns": [
      "ad_account_id",
      "currency_code",
      "credits_utilized",
      "credits_available",
      "expiry_date"
    ],
    "time_unit": "WEEKLY",
    "file_format": "CSV"
  }'

¶ Example Response

{
  "report_id": "7c4e9f2a-1d3b-5a8e-b6c0-2f7d4e9a3b15"
}

¶ Example Request (Sync)

curl -X POST "https://api.uber.com/v1/ads/{account_id}/reporting/sync" \
  -H "Authorization: Bearer {ACCESS_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "report_type": "AD_CREDITS",
    "time_range": {
      "start_time": "2025-11-03T00:00:00Z",
      "end_time": "2025-11-05T00:00:00Z"
    },
    "columns": [
      "currency_code",
      "credits_utilized",
      "credits_available",
      "expiry_date"
    ],
    "time_unit": "DAILY"
  }'