> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/nuxt/nuxt/llms.txt
> Use this file to discover all available pages before exploring further.

# useRequestHeaders

> Use useRequestHeaders to access the incoming request headers.

You can use built-in `useRequestHeaders` composable to access the incoming request headers within your pages, components, and plugins.

```ts theme={null}
// Get all request headers
const headers = useRequestHeaders()

// Get only cookie request header
const { cookie } = useRequestHeaders(['cookie'])
```

<Tip>
  In the browser, `useRequestHeaders` will return an empty object.
</Tip>

## Parameters

<ParamField path="include" type="string[]">
  An optional array of header names to include. If provided, only the specified headers will be returned.
</ParamField>

## Return Values

<ResponseField name="headers" type="Record<string, string>">
  An object containing the requested headers. Returns an empty object on the client side.
</ResponseField>

## Example

We can use `useRequestHeaders` to access and proxy the initial request's `authorization` header to any future internal requests during SSR.

The example below adds the `authorization` request header to an isomorphic `$fetch` call.

```vue [app/pages/some-page.vue] theme={null}
<script setup lang="ts">
const { data } = await useFetch('/api/confidential', {
  headers: useRequestHeaders(['authorization']),
})
</script>
```

## Type

```ts theme={null}
export function useRequestHeaders<K extends string = string>(
  include?: K[]
): Record<Lowercase<K>, string>
```