# Quickstart

Four steps from zero to your first records. You need an API token with Non-Human Identities (NHI) API permission.

## 1. Get your token

Find your API `token` in your Webz.io dashboard. Your account must have Non-Human Identities (NHI) API access - without it, requests return `401`.

## 2. Run a query

`GET`

```bash
https://api.webz.io/nhi?token=YOUR_TOKEN&domain=example.com
```

Every request needs a `token` and a `domain`. Send the bare domain (`example.com`) - schemes, paths, and ports are ignored.

## 3. Read the response

The JSON response contains a `records` array plus paging and status fields:

```json
{
  "records": [ ... ],
  "totalResults": 105,
  "moreResultsAvailable": 5,
  "next": "/nhi?token=YOUR_TOKEN&domain=example.com&next=CURSOR",
  "requestsLeft": 989,
  "domainStatus": "active"
}
```

If this is the first time anyone queried the domain, `domainStatus` is `pending` and `records` may be empty - come back in a few minutes.

## 4. Get the next page

Append the `next` value to `https://api.webz.io` and call it again. Repeat until `moreResultsAvailable` reaches `0`. See [Pagination](nhi-pagination).

That's it - you are up and running. Next, learn the [Filters](nhi-filters) and [Record Data Fields](nhi-data-fields).

> [!NOTE]
> Responses return up to **100** records each. There is no default time window - a query covers everything collected for the domain. See [Request Parameters](nhi-parameters).