# List of suppliers

**GET /2024-09/suppliers**

Get the list of suppliers for a merchant.


## Servers
- Production server (uses live data): https://app.merchanthq.com/api (Production server (uses live data))


## Authentication methods
- Default


## Parameters


### Query parameters
- **merchant_id** (string(uuid))
  The UUID of the merchant to filter suppliers by
- **q** (string)
  A search query to filter suppliers by name
- **page** (integer)
  The page number to retrieve
- **per_page** (integer)
  The number of results to return per page


## Responses
### 200
A successful response returning the list of suppliers

#### Body: application/json (object)
- **links** (object)

- **meta** (object)

- **data** (array[object])


### 401
The request requires user authentication or the user is not authorized to access this resource.

#### Body: application/json (object)
- **message** (string)


### 403
Forbidden - The user does not have permission to access this resource.

#### Body: application/json (object)
- **message** (string)


### 404
The specified resource was not found

#### Body: application/json (object)
- **message** (string)



[Powered by Bump.sh](https://bump.sh)