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

# Resolution Responses

> Interpret resolved, ambiguous, and not_found entity-resolution results.

Entity resolution answers what a raw input refers to in Kyberis.

## Response Envelope

`/v2/entity-resolution` returns:

| Field        | Meaning                                                                                                  |
| ------------ | -------------------------------------------------------------------------------------------------------- |
| `input`      | Normalized echo of the submitted query and requested type constraints.                                   |
| `resolution` | Resolution result object containing status, canonical entity details, candidates, and confidence fields. |

Batch resolution responses use the standard batch envelope described in [Batch responses](/responses/batches).

## Status Values

| Status      | Meaning                            | Agent action                                                   |
| ----------- | ---------------------------------- | -------------------------------------------------------------- |
| `resolved`  | Kyberis found a canonical entity.  | Continue with `canonical_id` and `entity_type`.                |
| `ambiguous` | Multiple candidates are plausible. | Ask for disambiguation or retry with tighter `expected_types`. |
| `not_found` | No canonical entity matched.       | Stop or pivot to a different enrichment path.                  |

## Key Fields

* `canonical_id`
* `canonical_name`
* `entity_type`
* `resolution_confidence`
* `candidates[]`
* `match_type`
* `score`
* aliases and metadata when requested

## Common Mistakes

* Do not guess when status is `ambiguous`.
* Do not continue to assessment when status is `not_found` unless you intentionally switch to `query` mode.
* Do not use `ioc` as an expected type. Use `ip`, `domain`, `url`, `hash`, or `email`.