---
title: "Resolve a canonical CCN-to-NPI crosswalk link"
method: GET
path: "/api/v1/entity/ccn/{ccn}"
tags: ["Entity Graph"]
---

# Resolve a canonical CCN-to-NPI crosswalk link

`GET /api/v1/entity/ccn/{ccn}`

## Request

- Base URL: `https://fonteum.com`
- URL: `https://fonteum.com/api/v1/entity/ccn/{ccn}`
- Auth: none required

Returns a crosswalk link when one is available. This is not a facility profile, ownership record, or Care Compare quality response.

## Path parameters

- `ccn` string, required

## Response `200`

Canonical CCN-to-NPI link.

- object
  - `ccn` string, required
  - `npi` string, required
  - `link_method` string, required
  - `link_confidence` number, required
  - `link_tier` 'deterministic' | 'candidate_unreviewed', required
  - `source_table` string
  - `methodology_version` string
  - `attested_at` string, date-time, nullable

## Other responses

- `400`: CCN format is invalid.
- `404`: No canonical crosswalk link is available for this CCN.

---

[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)