Lookups

Resolve a domain to its owning org and any matching products

Changed on

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.

get/lookups/by-domain

Request

  • Base URL: https://api.releases.sh
  • URL: https://api.releases.sh/lookups/by-domain
  • Auth: none declared

Query parameters

domainstring required

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

Response

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

domainstring required

Changes

  • 2abc1553baf2Revision changes
    • breaking

      the response property // became nullable for the status

    • breaking

      the response property // became nullable for the status

    • breaking

      the response property // became nullable for the status

    • breaking

      the response property // became nullable for the status

    • breaking

      the response property //// became nullable for the status

    • breaking

      the response property //// became nullable for the status

    • breaking

      the response property //// became nullable for the status

    • info

      response property org/anyOf[subschema #1]/avatarUrl list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property org/anyOf[subschema #1]/category list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property org/anyOf[subschema #1]/description list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property org/anyOf[subschema #1]/domain list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property org/anyOf[subschema #1]/locations/items/productId list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property org/anyOf[subschema #1]/locations/items/sourceId list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property org/anyOf[subschema #1]/locations/items/title list-of-types was narrowed by removing types null from media type application/json of response 200

  • bf27a258a40fRevision changes
    • info

      added the optional property //// to the response with the status

    • info

      added the optional property //// to the response with the status