# vespa curl

[](/en/reference/clients/vespa-cli/vespa_curl.html.md "View as Markdown") 

## vespa curl

Access Vespa directly using curl

### Synopsis

Access Vespa directly using curl.

Execute curl with the appropriate URL, certificate and private key for your application. Assumes MTLS authentication.

For a more high-level interface to query and feeding, see the 'query' and 'document' commands.

```
vespa curl [curl-options] path [flags]
```

### Examples

```
$ vespa curl /ApplicationStatus
$ vespa curl -- -X POST -H "Content-Type:application/json" --data-binary @src/test/resources/A-Head-Full-of-Dreams.json /document/v1/namespace/music/docid/1
$ vespa curl -- -v --data-urlencode "yql=select * from music where album contains 'head'" /search/\?hits=5
```

### Options

```
-n, --dry-run Print the curl command that would be executed
  -h, --help help for curl
  -w, --wait int Number of seconds to wait for service(s) to become ready. 0 to disable (default 0)
```

### Options inherited from parent commands

```
-a, --application string The application to use. Format "tenant.application.instance" - instance is optional (tenant required for cloud targets)
  -C, --cluster string The container cluster to use. This is only required for applications with multiple clusters
  -c, --color string Whether to use colors in output. Must be "auto", "never", or "always" (default "auto")
  -i, --instance string The instance of the application to use
  -q, --quiet Print only errors
  -t, --target string The target platform to use. Must be "local", "cloud", "hosted" or an URL (default "local")
  -z, --zone string The zone to use. This defaults to a dev zone (cloud only)
```

### SEE ALSO

- [vespa](vespa.html) - The command-line tool for Vespa.ai

 Copyright © 2026 - [Cookie Preferences](#)

### On this page:

- [vespa curl](#page-title)
- [vespa curl](#vespa-curl)
- [Synopsis](#synopsis)
- [Examples](#examples)
- [Options](#options)
- [Options inherited from parent commands](#options-inherited-from-parent-commands)
- [SEE ALSO](#see-also)