---
title: "Get cross-file usages of a symbol definition"
method: GET
path: "/api/v1/code-search/usages"
tags: ["Code Search"]
---

# Get cross-file usages of a symbol definition

`GET /api/v1/code-search/usages`

Fetches all usage locations for a definition at a given file/line from peregrine via entire-api. Anonymous callers (no session, no bearer) are served for public repos via entire-api's public-repo path; a private or unknown repo yields 404.

## Response `200`

Usage locations for the definition

- object
  - `definition` object, required
    - `path` string, required
    - `line` number, required
    - `name` string, required
  - `usages` object[], required
    - `path` string, required
    - `line` number, required
    - `col_start` number, required
    - `col_end` number, required
    - `context` string, required
  - `total_count` number, required
  - `truncated` boolean, required

## Other responses

- `400` — Missing repo, path, or line
- `404` — Repository not found (or not public, for anonymous callers)
- `503` — Code search not configured

---

[API](https://skmtc.dev/entire/apis/entire-api.md) · [All operations](https://skmtc.dev/entire/apis/entire-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/entire/entire-api/revisions/c3d737ae064e/schema)