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

# Understanding results

> Interpret Superdata records, clarifications, missing fields, pagination, and errors.

Superdata returns structured company or person records so your client can show,
summarize, or pass them to another approved workflow.

## Response status

| Status                | Meaning                                                                | Next action                                    |
| --------------------- | ---------------------------------------------------------------------- | ---------------------------------------------- |
| `complete`            | The search finished, with or without matching records.                 | Review results or continue pagination.         |
| `needs_clarification` | Important targeting context is missing or ambiguous.                   | Answer the questions and submit a new request. |
| Error code            | Validation, authentication, capacity, credit, or provider work failed. | Follow the safe recovery guidance.             |

Clarification occurs before metered execution and costs zero credits. A
completed no-match response is an accepted execution and costs one credit.

## Company records

Company results can include `id`, `name`, `website`, `industry`, `location`,
and `employeeCount`.

## Person records

People results can include `id`, `name`, `title`, `linkedinUrl`, `location`,
`companyName`, `companyWebsite`, `workEmail`, and `phoneNumber`.

## Missing values

Nullable fields use JSON `null`. A missing email, phone number, website,
location, or employee count means a verified value was not available; it does
not mean the value does not exist.

## Pagination

The default page size is 25 and the maximum is 50. When `hasMore` is `true`,
send `nextCursor` as `cursor` in the next call and keep all filters unchanged.

<Warning>
  Cursors are opaque and tied to the original filters. Do not decode, edit,
  construct, or reuse them with a different search.
</Warning>

## Result provenance and responsible use

Results are structured from external company and professional information.
Review important records before using them for outreach or operational
decisions, and follow applicable privacy, marketing, and data-protection rules.

For exact schemas, see the [Tool catalog](/reference/tools). For public error
codes and recovery steps, see [Errors and limits](/reference/errors-and-limits).