# Get merchant

> Returns the full registration of one of your company's merchants by merchant_id: contact, address, terms and the reference from your system.

Página: https://doc.rapidchargeback.com/en/canais/merchants/consultar-merchant/

Returns the full registration of one of your company's merchants. To find the `merchant_id`, use [List merchants](https://doc.rapidchargeback.com/en/canais/merchants/listar-merchants/) (including by `merchant_ref`, the seller ID in your system).

## Endpoint

```
GET https://api.rapidchargeback.com/api/v1/merchants/:merchant_id
```

## Authentication

```
Authorization: Basic base64(client_id:client_secret)
```

---

## URL parameters

| Param | Type | Description |
|---|---|---|
| `merchant_id` | string (UUID) | The merchant `id` |

This route takes no query params: any parameter in the URL is rejected with `422 VALIDATION_ERROR` (`Unknown field: <name>`).

---

## Request example

```bash
curl https://api.rapidchargeback.com/api/v1/merchants/00000000-0000-0000-0000-000000000001 \
  -H "Authorization: Basic Y2xpZW50X2lkOmNsaWVudF9zZWNyZXQ="
```

---

## Response

### Success

```
HTTP/1.1 200 OK
```

```json
{
  "data": {
    "id": "00000000-0000-0000-0000-000000000001",
    "name": "Loja Exemplo",
    "merchant_ref": "PB-1001",
    "status": "active",
    "created_at": "2026-03-10T12:00:00.000Z",
    "updated_at": "2026-11-06T12:00:00.000Z",
    "store_name": "Loja Exemplo",
    "merchant_url": "https://lojaexemplo.com",
    "contact_phone": "+55 11 99999-0000",
    "email": "contato@lojaexemplo.com",
    "mcc": "5999",
    "description": null,
    "logo_url": null,
    "terms": null,
    "terms_url": "https://lojaexemplo.com/termos",
    "refund_policy": null,
    "refund_policy_url": "https://lojaexemplo.com/reembolso",
    "customer_service_instructions": null,
    "address_street": "Rua Exemplo",
    "address_number": "100",
    "address_city": "São Paulo",
    "address_state": "SP",
    "address_postal_code": "01000-000",
    "address_country": "BRA"
  }
}
```

| Field | Description |
|---|---|
| `id`, `name`, `merchant_ref`, `status`, `created_at`, `updated_at` | The same as in [List merchants](https://doc.rapidchargeback.com/en/canais/merchants/listar-merchants/#success) |
| `store_name` | Store name as the cardholder knows it |
| `merchant_url` | Store website |
| `contact_phone` | Customer service phone |
| `email` | Customer service email |
| `mcc` | Store category code (see [MCC](https://doc.rapidchargeback.com/en/referencia/glossario/#mcc-mcc)) |
| `description` | Description of what the store sells |
| `logo_url` | Logo address |
| `terms`, `terms_url` | Terms of use (text and address) |
| `refund_policy`, `refund_policy_url` | Refund policy (text and address) |
| `customer_service_instructions` | How the cardholder reaches the store |
| `address_street`, `address_number`, `address_city`, `address_state`, `address_postal_code` | Address |
| `address_country` | Country, 3-letter uppercase code (e.g. `BRA`) |

A field with no value comes as `null`. It is the same object that [Create or update merchant](https://doc.rapidchargeback.com/en/canais/merchants/criar-ou-atualizar-merchant/) and [Edit merchant](https://doc.rapidchargeback.com/en/canais/merchants/editar-merchant/) return.

### Merchant not found

```
HTTP/1.1 404 Not Found
```

```json
{
  "error": {
    "code": "MERCHANT_NOT_FOUND",
    "message": "Merchant not found"
  }
}
```

The same `404` applies to a `merchant_id` that does not exist, belongs to another company or is not a UUID.

---

## Notes

- **Only your company's merchants.** The company comes from the credential.
- **Auth, rate limit, error codes:** see [Authentication](https://doc.rapidchargeback.com/en/referencia/autenticacao/) and [Response codes](https://doc.rapidchargeback.com/en/referencia/codigos-de-resposta/).
