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

# Get Entity References

> List external references attached to one Shoal entity

Returns external references attached to one canonical Shoal entity.

This route is part of the canonical entity contract. The dedicated `ExternalReference` storage layer is live, but responses may still be sparse until source population and backfill expand coverage.

## Path Parameters

* `id` (integer, required)

## Request

```bash cURL theme={null}
curl -X GET "https://api.shoal.xyz/v1/entities/23151/references" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Response (200)

```json theme={null}
{
  "entity": {
    "id": 23151,
    "canonicalName": "Ethereum",
    "displayName": "Ethereum",
    "entityType": "project",
    "status": "active",
    "aliases": ["Ethereum Foundation", "ETH"],
    "references": []
  },
  "data": []
}
```

## Notes

* This route establishes the entity-attached reference contract.
* The storage layer is live; sparse results now mean the entity has not been enriched yet.
* Over time, this surface is intended to include sources like CoinGecko, DefiLlama, CoinMarketCap, official websites, and GitHub.

## Errors

* 400 if `id` is missing
* 404 if the entity does not exist
* 500 on internal server error