Releases Index
Org by domain
View .md

Resolve a domain to its owning org and any matching products

GET
/lookups/by-domain

Normalizes the input domain (lowercased, no scheme/path/www), exact-matches against organizations.domain (primary) and domain_aliases.domain (alias for either an org or a product), and returns whatever it finds.

On a complete miss, when listing-self-serve-enabled is on, the handler may probe https://{domain}/.well-known/releases.json in-request and materialize a stub org (basis: declared) via the same core as the listing activate path and the domain-demand cron. Probe budget is per-domain (a few attempts per ~10 min rolling window) plus a per-IP rate limit on the outbound branch; budget exhaustion returns 404 (not 429). Misses still record domain_demand for the nightly sweep backstop.

Products can be populated even when org is null — a product alias may point at a domain its parent org doesn't claim as primary.

Authorization

bearerAuth
headerAuthorizationBearer <relk_… | relu_… | OAuth JWT>

Machine/operator tokens use the relk_ prefix; self-serve read-only user keys use relu_; Sign in with Releases supplies an OAuth access token. Required scope depends on the endpoint.

Query Parameters

domain*string

Hostname to resolve. Server normalizes (lowercases, strips scheme/path/www).

Response Body

Resolved org and/or product matches (including a just-materialized stub)

application/json
  1. response
domain*string
org*|null
products*array<>
Example Request
curl -X GET 'https://api.releases.sh/v1/lookups/by-domain?domain=string'
Example Response
{  "domain": "string",  "org": {    "id": "string",    "slug": "string",    "name": "string",    "domain": "string",    "description": "string",    "category": "string",    "avatarUrl": "string",    "matchedVia": "primary",    "status": "stub",    "locations": [      {        "url": "string",        "feed": "string",        "github": "string",        "appstore": "string",        "file": "string",        "title": "string",        "canonical": true,        "basis": "curator",        "productId": "string",        "sourceId": "string",        "publish": "push",        "path": "string"      }    ]  },  "products": [    {      "id": "string",      "slug": "string",      "name": "string",      "orgId": "string",      "orgSlug": "string",      "orgName": "string",      "category": "ai",      "kind": "platform"    }  ]}