---
title: Resolve a bare source slug to its canonical org-scoped home
description: Translation aid for clients holding a bare source slug.
---
# Resolve a bare source slug to its canonical org-scoped home

`GET https://api.releases.sh/v1/lookups/source-by-slug`

Translation aid for clients holding a bare source slug. Returns the org-scoped tuple `{ sourceId, sourceSlug, orgSlug }` so callers can rewrite to the canonical `/v1/orgs/:orgSlug/sources/:sourceSlug` path before the bare API path stops resolving slugs (#698 final piece).

A slug owned by one org returns that row and carries `Sunset: Sun, 01 Nov 2026 00:00:00 GMT`. A slug owned by more than one org returns 409 with `details.candidates` (`org/slug` + `src_` id) instead of picking a row (#2525).

**Auth:** optional Bearer token.

**Parameters**

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `slug` | query | string | yes | Bare source slug to resolve. |

**Responses**

- `200` Canonical home for the slug
- `400` Missing `slug` query parameter
- `404` No source matches the slug
- `409` Slug matches more than one org

Full request and response schemas: [OpenAPI 3.1 spec](https://api.releases.sh/v1/openapi.json).
