---
title: "Resolve an identifier to its graph entity"
method: GET
path: "/api/v1/entity/resolve"
tags: ["Entity Graph"]
---

# Resolve an identifier to its graph entity

`GET /api/v1/entity/resolve`

## Request

- Base URL: `https://fonteum.com`
- URL: `https://fonteum.com/api/v1/entity/resolve`
- Auth: HTTP bearer

Resolve any registered identifier (npi, ccn, ccn_asc, pecos_enrlmt_id, pac_id, and more) to its entity-graph node. A 400 lists the authoritative `valid_schemes`.

## Query parameters

- `scheme` string, required
- `value` string, required

## Response `200`

Resolution result.

- EntityResolution
  - `scheme` string
  - `value` string
  - `entity` EntityNode
    - `entity` object
      - `id` string, uuid
      - `type` string
      - `display_name` string
      - `state` string
      - `status` string
    - `identifiers` object[]
      - `scheme` string
      - `value` string
      - `source_table` string
      - `link_method` string
      - `link_confidence` number
    - `edges` object[]
    - `edges_truncated` boolean
    - `methodology_version` string
  - `identifier` object
  - `entity_url` string, uri
  - `methodology_version` string

## Other responses

- `400`: Unknown/missing scheme or value fails the scheme normalization guard.
- `404`: Identifier not present in the resolved graph.

---

[API](https://skmtc.dev/fonteum/apis/fonteum-api.md) · [All operations](https://skmtc.dev/fonteum/apis/fonteum-api/llms.txt) · [OpenAPI document](https://skmtc.dev/fonteum/apis/fonteum-api/revisions/334e6e179d0d?raw)