---
title: "nctl raw"
diataxis: reference
applies_to:
  product: "nctl"
audience: ["developer","platform-engineer"]
last_updated: 2026-03-07
url: https://docs.nirmata.io/docs/nctl/commands/nctl_raw/
---

## nctl raw

Direct access to the Nirmata REST API

### Synopsis

The raw command allows querying Nirmata REST API endpoints.

```bash
nctl raw <path> [flags]
```

### Examples

```bash

  # Basic GET request  
  nctl raw /path --url https://example.com  

  # GET request with authentication  
  nctl raw /path --url https://example.com --token your-api-token  

  # GET request allowing insecure connection  
  nctl raw /path --url https://example.com --insecure  

  # GET request with json data in a file  
  nctl raw /path --url https://example.com --file data.json  

```

### Options

```text
  -d, --data string     JSON data string
  -f, --file string     JSON data file
  -h, --help            help for raw
      --insecure        allow connection to an address with a self-signed or non-verifiable certificate (not recommended)
  -m, --method string   the HTTP method (default "GET")
      --token string    Nirmata API Login Key (env NIRMATA_TOKEN)
      --url string      Nirmata server base URL (env NIRMATA_URL)
```text

### Options inherited from parent commands

```text
  -v, --v Level   number for the log level verbosity
```

### SEE ALSO

* [nctl](nctl.md)	 - nctl is the command line interface for Nirmata