The Q&A API is now launched! Migration work is required. Please see our deprecation schedule for more information related to deprecated endpoints.
v1.1 of the Notifications API is now launched! Please see our change log for more information. You may also sign up for our mailing list to receive updates.


Searches the chain based on chain name.

HTTP request


The URL uses gRPC Transcoding syntax.

Query parameters



Search for a chain by its name. Exact/partial/fuzzy/related queries are supported. Examples: "walmart", "wal-mart", "walmmmart", "沃尔玛"



The maximum number of matched chains to return from this query. The default is 10. The maximum possible value is 500.

Request body

The request body must be empty.

Response body

If successful, the response body contains data with the following structure:

Response message for Locations.SearchChains.

JSON representation
  "chains": [
      object (Chain)

object (Chain)

Chains that match the queried chainDisplayName in SearchChainsRequest. If there are no matches, this field will be empty. Results are listed in order of relevance.

Authorization Scopes

Requires one of the following OAuth scopes:


For more information, see the OAuth 2.0 Overview.