# useRecords

> For the complete documentation index, see [llms.txt](https://ensforge.com/llms.txt).

Reads any mix of a name's records in one request; the result has exactly the requested fields. Signature, result and examples for useRecords.

Source: https://ensforge.com/docs/reference/react/use-records

<ApiMeta kind="Read hook" stability="stable" since="1.0.0" source="packages/react/src/hooks/named/reads.ts#L277" />

Reads any mix of a name's records in one request; the result has exactly the requested fields.
Preset of `useRead(Actions.record.get, …)`.

It wraps [`record.get`](/docs/reference/sdk/record/get): the same options, result and errors.

## Signature [#signature]

```ts
function useRecords<const options extends Actions.record.get.Options>(options: options | undefined, config?: ReadConfig): ReadResult<Actions.record.get.ReturnType<options>, Actions.record.get.ErrorType>
```

## Examples [#examples]

```tsx title="A profile card"
import { useRecords } from "@ensforge/react"

function Profile() {
  const { data } = useRecords({ name: "nick.eth", texts: ["url", "avatar"], addresses: ["eth"] })
  return <span>{data?.texts.url}</span>
}
```

## See also [#see-also]

- The [hook types](/docs/reference/react#types): `ReadResult`, `WriteResult` and `ReadConfig`.