Airlock as a Service Knowledge Base

Billing reporting

The Billing reporting page provides monthly consumption reports for the tenants in your organization. Each report lists the tenants, their monthly active users, and their service level. You can use these reports to reconcile your Airlock as a Service usage and import the data into your billing systems. Reports are available as charts for a quick overview and as downloadable CSV files for further processing.

To view and download billing reports, the AMC - Manage billing reporting permission is required. This permission is included in the SaaS Administrator role by default, but can also be assigned separately.


Accessing the Billig repeorting page

In the Airlock Console, go to:
Administration >> Billing reporting


Downloading billing reports

Billing reports are listed by month and grouped by year, with the most recent month first. To download a report, click Download CSV for the corresponding month. Each report covers one full calendar month. After it has been generated, the report is a fixed snapshot and no longer changes.

Notice

The report for the current month is not available yet and is displayed as a disabled row. Reports are generated automatically at the beginning of the following month.


CSV file contents

Each downloaded file is named billing-report-<year>-<month>.csv (e.g., billing-report-2026-05.csv). The file is UTF-8 encoded, uses a semicolon (;) as the field separator, and includes a header row.

The report contains one row per tenant that existed in your organization during the reporting month. The columns are:

Column

Description

Organization ID

The unique identifier of your organization in the Airlock Console.

External Organization ID

The identifier you configured for your organization to map it to your own billing systems. Empty if not configured.

Tenant ID

The unique identifier of the tenant in the Airlock Console.

External Tenant ID

The identifier you configured for the tenant to map it to your own billing systems. Empty if not configured.

PRCA ID

The Production Resource Catalog (PRCA) identifier associated with the tenant. Empty if not configured.

Report year

The year of the billing period.

Report month

The month of the billing period (1–12).

Tenant service level

The service level of the tenant during the period: prod for production or non-prod for non-production.

Tenant created date

The date the tenant was created, in UTC (YYYY-MM-DD).

Tenant deleted date

The date the tenant was deleted, in UTC (YYYY-MM-DD). Empty if the tenant was still active at the end of the period.

Monthly active users

The number of monthly active users counted for the tenant during the reporting month.


Configuring billing identifiers

The External Organization ID, External Tenant ID, and PRCA ID columns are populated with values that you define. These values are optional and let you map Airlock organizations and tenants to identifiers in your billing systems.

  • To set the External Organization ID, go to:
    Administration >> Organization >> Billing report configuration

  • To set the External Tenant ID and PRCA ID, go to:
    Configuration >> Tenant settings >> Billing reporting


Downloading reports via the API

You can also download billing reports programmatically using the Airlock as a Service public API — e.g., to integrate them into an automated billing pipeline.

  • Endpoint: GET /public/v1/organization/billing-reports/{year}/{month}/csv

  • Required permission: The OAuth 2.0 client used for the request must have the Download billing reports permission. For details, see OAuth 2.0
    clients
    and the API Reference.

  • Response: The response contains the same CSV file that can be downloaded from the Airlock Console.