# Managing Merchant Records
source: https://developer.mastercard.com/ob-accept-payments/documentation/payments/merchant-onboarding/managing-merchant-records/index.md

Use the Merchant Onboarding API to retrieve and manage merchants after you
onboard them. Use the `merchantId` returned when you create a merchant to
identify the merchant in subsequent requests.

## Get Merchants {#get-merchants}

Use the **Get Merchants** endpoint to retrieve the merchants you have
onboarded.

API Reference: `GET /merchants`

Use `offset` and `limit` to page through the results. The default `offset` is
`0`. The default and maximum `limit` is `1,000`. Each result includes details
such as the `merchantId`, `companyName`, `tradingName`, status, available
markets, disabled markets, and whether the merchant is disabled.

## Update Merchant Details {#update-merchant-details}

Use the **Update Merchant Details** endpoint to update a merchant record. Pass
the `merchantId` as the `merchant_id` path parameter and provide the updated
merchant details in the request body.

API Reference: `PUT /merchants/{merchant_id}`

## Delete Merchant {#delete-merchant}

Use the **Delete Merchant** endpoint to delete a merchant record. Pass the
`merchantId` as the `merchant_id` path parameter.

API Reference: `DELETE /merchants/{merchant_id}`

## Update Merchant Disabled Markets {#update-merchant-disabled-markets}

Use the **Update Merchant Disabled Markets** endpoint to manage the markets in
which a merchant cannot operate. Pass the `merchantId` as the `merchant_id`
path parameter.

API Reference: `PUT /merchants/{merchant_id}/disabled-markets`

Always submit the complete list of markets to disable, including previously
disabled markets and any new markets. To enable a market, submit an updated
list that excludes that market. Partial or incremental updates are not
supported. Use ISO 3166-1 alpha-2 country codes.

The **Get Merchant** and **Get Merchants** endpoints return these fields:

* `availableMarkets` - Markets available at your level, minus markets disabled for the merchant or its parent merchant.
* `disabledMarkets` - Markets where the merchant cannot operate. A merchant store inherits its parent merchant's disabled markets and can have additional store-specific restrictions.

## Disable or Enable a Merchant {#disable-or-enable-a-merchant}

Use the **Disable Merchant** endpoint to disable or enable a merchant. Pass the
`merchantId` as the `merchant_id` path parameter. Set `isDisabled` to `true` to
prevent the merchant from accepting payments. Set it to `false` to enable the
merchant to accept payments again.

API Reference: `PUT /merchants/{merchant_id}/disabled`

The **Get Merchant** and **Get Merchants** endpoints return the current
`isDisabled` value.