# List node types

> operationId: `listNodeTypes`


## Request

Lists node types. The q value is trimmed and Unicode casefolded (with no additional NFC/NFKC normalization), then matched as a substring against any of id, action, title, or description. An empty value does not filter. An action of null is treated as an empty string. The category value is trimmed and matched exactly, case-sensitively. An empty value does not filter, and an unknown value returns 400. The current static categories are browser (actions) and structure (structure nodes). On an actual instance, you can first query without filters to discover the categories. The two filters are combined with AND, and results are sorted by id in ascending order. The catalog covers 52 actions and six structure types: start, end, group, case, caseDefault, and exceptionBlock. Structure types have action=null, which does not mean that the executor is missing. Evaluate authorable, runtimeSupported, externalRunnable, and documentationComplete separately. A node type being in the catalog does not mean that it is allowed to run.

- **Prerequisites**: You have read the capabilities. For category, use a value actually returned by the node catalog.
- **Authentication**: Same as the rest of the Local API; see [Authentication](/api-reference/getting-started/authentication). Resources belong to the current account/team data scope.
- **Side effects**: None. This call doesn't write business data.
- **Completion signal**: A 200 returns node type summaries and pagination information.
- **Retries**: Read-only calls can be retried. On 429 or 503, back off as indicated by Retry-After.


### Endpoint

```http
GET /api/rpa/browser/v1/node-types
```

Local API: `http://127.0.0.1:<port>/api/rpa/browser/v1/node-types`. Use the port configured in the client.

### Headers

| Parameter | Type | Required | Description and constraints |
|  --- | --- | --- | --- |
| `Authorization` | string | When Local API authentication is enabled | See [Authentication](/api-reference/getting-started/authentication). |


### Path parameters

None.

### Query parameters

| Parameter | Type | Required | Description and constraints |
|  --- | --- | --- | --- |
| `page` | integer | No | Page number, starting at 1. Minimum 1; default 1. |
| `pageSize` | integer | No | Items per page. Default 20, maximum 100. Minimum 1; maximum 100; default 20. |
| `q` | string | No | Trimmed and Unicode casefolded (no NFC/NFKC normalization), then matched as a substring against id, action (null is treated as empty), title, or description; a match in any of them counts. An empty value matches all. Combined with category using AND. Results are sorted by id in ascending order. Max length 100. |
| `category` | string | No | Category, trimmed and matched exactly (case-sensitive). An empty value means no filter. An unknown nonempty category returns 400. Max length 100. |


### Request body

No request body.

### Request example

This is a documentation example; it was not sent to a live client. Set `RPA_BASE_URL` as described in [API conventions](/browser-rpa/api/common). Resource variables, the catalog revision, and ETags come from actual responses.

```bash
curl -i -X GET "${RPA_BASE_URL}/node-types?page=1&pageSize=20"
```

## Response

### 200

A 200 returns node type summaries and pagination information.

Body: `application/json`. The top-level `data` uses the model below. For `meta`, see [Metadata](/browser-rpa/api/data-types#metadata).

| Field | Type | Required | Description and constraints |
|  --- | --- | --- | --- |
| `items` | array<[NodeTypeSummary](/browser-rpa/api/data-types#nodetypesummary)> | Yes | Array of items on the current page or in the current resource. |
| `total` | integer | Yes | Total number of matches. Minimum 0. |
| `page` | integer | Yes | Page number, starting at 1. Minimum 1. |
| `pageSize` | integer | Yes | Items per page. Default 20, maximum 100. Minimum 1; maximum 100. |


### Response example

All IDs, timestamps, hashes, and run results are sample data. They don't indicate that the sample was executed.

```json
{
  "data": {
    "items": [
      {
        "id": "browser_waitTime",
        "action": "waitTime",
        "title": "Wait",
        "description": "**Branch rules:** In fixed mode, timeout defaults to 1000ms. In randomInterval mode, the default is [1000,3000]ms, and timeoutMin ≤ timeoutMax.",
        "category": "browser",
        "nodeVersion": 1,
        "authorable": true,
        "runtimeSupported": true,
        "externalRunnable": true,
        "documentationComplete": true,
        "unavailableReasons": []
      }
    ],
    "total": 1,
    "page": 1,
    "pageSize": 20
  },
  "meta": {
    "requestId": "7d498f20-7bab-4e59-9b05-88daf51230e9",
    "catalogRevision": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
  }
}
```

### Error responses

For common 400/401/403/404/429/5xx errors and failure fields, see [Errors and recovery](/browser-rpa/api/common#errors-and-recovery). Error response example (403):

```json
{
  "error": {
    "code": "RPA_PERMISSION_DENIED",
    "message": "The request Host or Origin is not allowed, or the current identity can't access the target environment",
    "retryable": false,
    "issues": [],
    "details": null
  },
  "meta": {
    "requestId": "7d498f20-7bab-4e59-9b05-88daf51230e9",
    "catalogRevision": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
  }
}
```

## Related

[Local API reference](/browser-rpa/local-api) · [API conventions](/browser-rpa/api/common) · [Data models](/browser-rpa/api/data-types) · [Workflow structure](/browser-rpa/api/workflow) · [Quickstart](/browser-rpa/quickstart)