---
title: "Search for merchants"
method: GET
path: "/corporations"
tags: ["Merchant Search"]
---

# Search for merchants

`GET /corporations`

<Info>This endpoint is in beta. To request access, contact [sales@spade.com](mailto:sales@spade.com).</Info>

Search for merchants in Spade's merchant database by name.

Designed for powering autocomplete experiences, this endpoint returns up to five matching merchants with their name, logo, and website.

To learn more, read the [Merchant Search Guide](https://docs.spade.com/reference/merchant-search-guide).

## Query parameters

- `name` string, required

## Response `200`

Successful operation

- CorporationSearchResponse
  - `corporations` CorporationSearchResult[] — An array of merchants matching the search query, ordered by relevance. Contains up to five results.
    - `name` string — The merchant's name
    - `logo` string, uri, nullable — URL of the merchant's logo, or null if unavailable
    - `website` string, nullable — The merchant's website, or null if unavailable

## Other responses

- `400` — Invalid input
- `403` — Unauthorized
- `429` — Too many requests. Currently, requests are limited to 1000 every 5 minutes per IP address.
- `500` — Unexpected Error

---

[API](https://skmtc.net/spade/apis/spade-api.md) · [All operations](https://skmtc.net/spade/apis/spade-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/spade/spade-api/revisions/a37c626f84de/schema)