---
title: "useConvexHttpClient"
description: "Reference for the advanced helper that returns the active HTTP client."
canonical_url: "https://nuxt-convex.onmax.me/api-reference/use-convex-http-client"
---
# useConvexHttpClient

> Reference for the advanced helper that returns the active HTTP client.

`useConvexHttpClient` returns the current `ConvexHttpClient` instance.

## Import

```ts
import { useConvexHttpClient } from 'vue-convex/advanced'
```

In Nuxt, the same helper is available from `#convex/advanced`.

## Signature

```ts
function useConvexHttpClient(): ConvexHttpClient
```

## Behavior

- Throws when the runtime has no URL
- The client is unauthenticated, and created on first use
- In Nuxt server routes, use [`useConvexServer`](https://nuxt-convex.onmax.me/nuxt-module/server-routes) instead: it authenticates as the request's user

## Related pages

- [useConvexController](https://nuxt-convex.onmax.me/api-reference/use-convex-controller)
- [useConvexClient](https://nuxt-convex.onmax.me/api-reference/use-convex-client)


## Sitemap

See the full [sitemap](https://nuxt-convex.onmax.me/sitemap.md) for all pages.
