---
title: Load capture
description: Capture an anonymized profile of write requests, query requests, or both on a query-capable node.
url: https://docs.influxdata.com/influxdb3/enterprise/api/load-capture/
estimated_tokens: 616
product: InfluxDB 3 Enterprise
version: enterprise
publisher: InfluxData
canonical: https://docs.influxdata.com/influxdb3/enterprise/api/load-capture/
---

[Download InfluxDB 3 Enterprise API Spec](/openapi/influxdb3-enterprise-openapi.yml)

Capture an anonymized profile of write requests, query requests, or both on a query-capable node.

GET`/api/v3/loadcap/profiles`

### List load capture profiles

Returns load capture profiles stored by a query-capable Enterprise node that has the performance upgrade preview enabled and an explicit `--mode` setting that includes `query`.

This endpoint requires an admin token.

Example request[Ask AI about this](#)

```sh
curl --request GET \
  "https://localhost:8181/api/v3/loadcap/profiles" \
  --header "Authorization: Bearer INFLUX_TOKEN"
```

#### Responses

200Load capture profiles.

401Unauthorized access.

`data`object

`error`string

403Forbidden. An admin token is required.

404Load capture is unavailable because this node does not use the performance upgrade preview with an explicit `--mode` setting that includes `query`.

POST`/api/v3/loadcap/start`

### Start a load capture

Starts a timed capture of write requests, query requests, or both on a query-capable Enterprise node that has the performance upgrade preview enabled and an explicit `--mode` setting that includes `query`.

Only one capture can run at a time on a node. This endpoint requires an admin token.

#### Request bodyrequired

Content-Type:`application/json`

`duration`requiredstring

Capture duration using seconds, minutes, or hours. The maximum duration is one hour.

Example:`"5m"`

`type`requiredstring

The request types to capture.

Allowed:`write`, `query`, `both`

Example request[Ask AI about this](#)

```sh
curl --request POST \
  "https://localhost:8181/api/v3/loadcap/start" \
  --header "Authorization: Bearer INFLUX_TOKEN" \
  --header "Content-Type: application/json" \
  --data-raw '{
  "duration": "5m",
  "type": "write"
}'
```

#### Responses

200Load capture started.

`profile_id`requiredstring \<uuid\>

Identifier of the new load capture profile.

400Invalid capture type or duration.

401Unauthorized access.

`data`object

`error`string

403Forbidden. An admin token is required.

404Load capture is unavailable because this node does not use the performance upgrade preview with an explicit `--mode` setting that includes `query`.

409A load capture is already running on this node.

#### Related

* [Capture workload data](/influxdb3/enterprise/admin/load-capture/)
* [InfluxDB 3 API client libraries](/influxdb3/enterprise/reference/client-libraries/v3/)