---
title: "Close an account"
method: POST
path: "/v1/customer-credits/accounts/{id}/close"
tags: ["Customer Credits - Accounts"]
---

# Close an account

`POST /v1/customer-credits/accounts/{id}/close`

## Request

- Base URL: `https://api.creem.io`
- URL: `https://api.creem.io/v1/customer-credits/accounts/{id}/close`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/creem/apis/creem-api/docs/v1/customer-credits/accounts/:id/close/post.ts> (a function with typed inputs; its response is checked against the schema)

Permanently close an account. This action cannot be undone.

## Path parameters

- `id` string, required

## Response `200`

Account closed

- AccountResponseDto
  - `id` string, required: Account ID
  - `store_id` string, required: Store ID
  - `customer_id` string, required: Owner ID
  - `name` string, required: Account name
  - `unit_label` string, required: Unit label
  - `status` 'active' | 'frozen' | 'closed', required: Account status
  - `created_at` string, required: Creation timestamp
  - `updated_at` string, required: Last update timestamp

## Other responses

- `400`: Bad Request - Invalid input parameters
- `401`: Unauthorized - Invalid or missing API key
- `404`: Not Found - Resource does not exist
- `409`: Account already closed

## Changes

- **2026-09-15** `071301350724`: 2 info
  - api tag `Customer Credits - Accounts` added
  - api tag `Customer Credits - Accounts (Experimental)` removed
- **2026-07-26** `aa593160d96c`: 2 breaking
  - the `error/allOf[#/components/schemas/CustomerCreditsErrorDetailDto]/code` response's property type changed from `object` to `string` for status `409`
  - the `error/allOf[#/components/schemas/CustomerCreditsErrorDetailDto]/param` response's property type changed from `object` to `string` for status `409`

[Operation history](https://skmtc.dev/creem/apis/creem-api/changes/v1/customer-credits/accounts/:id/close/post.md)

---

[API](https://skmtc.dev/creem/apis/creem-api.md) - [All operations](https://skmtc.dev/creem/apis/creem-api/llms.txt) - [OpenAPI document](https://skmtc.dev/creem/apis/creem-api/revisions/3f39a8f266c3?raw)