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

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:

{
  "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.

That's it - you are up and running. Next, learn the Filters and Record Data Fields.