Exporting enterprise usage in FOCUS format by using the console

You can download a CSV file that contains usage data for the entire enterprise in FOCUS format directly from the IBM Cloud console. The export always includes all accounts in the enterprise and cannot be filtered by account group.

1. Log in to your enterprise account in the IBM Cloud console.
2. Go to Manage > Billing and usage > Usage.
3. Click Export > FOCUS. Then, from the Time frame menu, select the billing month for which you want to export data.
4. Click Export to download a CSV file that contains enterprise-level usage data in FOCUS format.

The downloaded file includes all mandatory FOCUS v1.2 fields plus IBM Cloud-specific fields. For a full description of the available fields, see Supported FOCUS fields.

Exporting enterprise usage in FOCUS format by using the API

You can automate enterprise FOCUS exports by using the Enterprise Usage Reports API.

1. Obtain an IAM access token for a user or service ID that has Usage Reports Viewer, Editor, or Administrator access on the Enterprise service. For more information, see Managing API keys.

2. Call the FOCUS export endpoint for your enterprise:

curl -X GET "https://enterprise.cloud.ibm.com/v1/focus-reports?enterprise_id={enterprise_id}&month={month}&format=csv" \
  -H "Authorization: Bearer {iam_token}"

Replace {enterprise_id} with your enterprise account ID, {month} with the reporting month in YYYY-MM format, {format} with the response format that you want, and {iam_token} with your IAM access token.

If you omit the page parameter, the full report is returned as a compressed file, which is the recommended approach for large enterprise exports.