---
title: "Block account"
method: PATCH
path: "/v2/accounts/{account_id}/block"
tags: ["Account management"]
---

# Block account

`PATCH /v2/accounts/{account_id}/block`

## Request

- Base URL: `https://marketplace-api.dlocal.com`
- URL: `https://marketplace-api.dlocal.com/v2/accounts/{account_id}/block`
- Auth: API key in header `X-Date` and API key in header `X-Login` and API key in header `X-Trans-Key` and API key in header `X-Version` and API key in header `User-Agent` and API key in header `Authorization`

This service is responsible for blocking an account.

## Path parameters

- `account_id` string, required

## Response `200`

OK

- ResponseBlockAccount
  - `account_id` string: User’s dLocal account ID.
  - `account_external_reference` string, byte: ID given by the merchant in their system.
  - `status` string: Account status. <br><br> [See details](ref:status-description-v2-platforms#blocked).
  - `status_code` number: Account status code. <br><br> [See details](ref:status-description-v2-platforms#blocked).
  - `status_detail` string: Account status detail.
  - `last_updated` string, date-time: Account update timestamp. ISO-8601 - Notification’s timestamp (YYYY-MM-DDTHH:mm:ss.SSSSZ).

## Other responses

- `400`: Bad request

---

[API](https://skmtc.dev/dlocal/apis/platforms.md) - [All operations](https://skmtc.dev/dlocal/apis/platforms/llms.txt) - [OpenAPI document](https://skmtc.dev/dlocal/apis/platforms/revisions/4be9adbbfce5?raw)