Introduction

Retrieves app-level resource usage statistics for the current organization on a specified date.

Plan Description

This is a paid advanced feature. For details, contact our Sales Team.

API Version

API Version	Updated On	Description
v1	2026-05-28	Initial release

API Call

Endpoint: https://api.jodoo.com/api/v1/corp_usage/app_metrics

Rate Limit: 1 request/second

Method: POST

Request Parameters:

Parameter	Type	Required	Description
`date`	String	No	The statistics date in `yyyy-MM-dd` format. If omitted or set to an empty string, the API queries statistics for the previous day, namely T-1.
`app_ids`	String[]	No	The list of app IDs. Up to 10 app IDs are supported. If omitted or set to an empty array, all apps are queried with pagination.
`skip`	Number	No	The pagination offset. Default: `0`.
`limit`	Number	No	The page size. Default: `20`. Maximum: `100`.

Notes:

When date is specified, it must not be later than the previous day, namely T-1. The API supports querying data from the last 180 days only.
This API does not return total. Use has_next to determine whether more pages are available.
date is based on UTC+8 by default.
1. For example, if the local date in the United States is 2026-05-28 and the date in China is 2026-05-27, passing 2026-05-28 as date will not return the corresponding data.
2. This is because date is interpreted in UTC+8. In this case, the UTC+8 date is 2026-05-27, and date must not be later than the previous day. Therefore, only data for 2026-05-26 or earlier can be queried.
Before using this API, make sure that the Admin Console > Management Tools > Usage Statistics feature has been enabled and used. Otherwise, the related data cannot be retrieved, and the metric fields will return 0.

Request Example:

{
  "date": "2026-05-08",
  "app_ids": [
    "65f000000000000000000001"
  ],
  "skip": 0,
  "limit": 20
}

Response Parameters:

Parameter	Description
`date`	The statistics date.
`has_next`	Indicates whether more pages are available.
`items`	The list of app usage statistics.
`items[].app_id`	The app ID.
`items[].app_name`	The app name.
`items[].creator`	Basic information about the creator.
`items[].created_at`	The creation time.
`items[].last_edit_at`	The last edited time.
`items[].last_visit_at`	The last visited time.
`items[].metrics`	App-level metrics. The metric fields are listed below. app: The number of apps. For app-level statistics, this is usually 1. form_coop:The number of standard forms. form_workflow:The number of workflow forms. dash:The number of dashboards. etl:The number of Data Factories. aggregate:The number of aggregate tables. public_link:The number of enabled public links. data_trigger:The number of Smart Assistants. automation:The number of Smart Assistant Pro automations. bpa: The number of Process Analyses data:The total data volume.

Response Example:

{
  "date": "2026-05-08",
  "has_next": false,
  "items": [
    {
      "app_id": "65f000000000000000000001",
      "app_name": "CRM",
      "creator": {
        "member_id": "65f000000000000000000011",
        "name": "Tom"
      },
      "created_at": "2026-01-01T00:00:00+08:00",
      "last_edit_at": "2026-05-06T12:00:00+08:00",
      "last_visit_at": "2026-05-06T18:00:00+08:00",
      "metrics": {
        "app": 1,
        "form_coop": 20,
        "form_workflow": 3,
        "dash": 2,
        "etl": 1,
        "aggregate": 1,
        "public_link": 5,
        "data_trigger": 2,
        "automation": 1,
        "bpa": 0,
        "data": 1200
      }
    }
  ]
}

User App Query API

Resource Usage API

Get Platform Resource Usage Statistics API

Get Member Resource Usage Statistics API

Get Audit Log Details API

Get App Resource Usage Statistics API

Introduction

Plan Description

API Version

API Call