Delete an account (protected hard delete)

curl --request DELETE \
  --url https://api.arcuserp.com/v1/accounts/{id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.arcuserp.com/v1/accounts/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.arcuserp.com/v1/accounts/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.arcuserp.com/v1/accounts/{id}"

	req, _ := http.NewRequest("DELETE", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.arcuserp.com/v1/accounts/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "data": {
    "deleted": true,
    "display_name": "<string>"
  }
}

{
  "error": "not_found",
  "code": "not_found",
  "type": "not_found",
  "hint": "The requested order does not exist or does not belong to this entity.",
  "param": "expand[0]",
  "required": "accounts:read",
  "request_id": "req_abc123"
}

{
  "error": "not_found",
  "code": "not_found",
  "type": "not_found",
  "hint": "The requested order does not exist or does not belong to this entity.",
  "param": "expand[0]",
  "required": "accounts:read",
  "request_id": "req_abc123"
}

{
  "error": "not_found",
  "code": "not_found",
  "type": "not_found",
  "hint": "The requested order does not exist or does not belong to this entity.",
  "param": "expand[0]",
  "required": "accounts:read",
  "request_id": "req_abc123"
}

{
  "error": "account_not_deletable",
  "code": "account_not_deletable",
  "type": "precondition_failed",
  "hint": "Account has 12 orders, 8 payments, 3 returns. Accounts with financial history cannot be deleted -- deactivate it instead (set inactive).",
  "has_transactions": true,
  "dependencies": {
    "orders": 123,
    "invoices": 123,
    "payments": 123,
    "returns": 123,
    "vendor_bills": 123,
    "ap_payments": 123,
    "vendor_credits": 123,
    "vendor_prepayments": 123,
    "customer_deposits": 123,
    "journal_lines": 123,
    "inventory_transactions": 123,
    "pricing_policies": 123
  }
}

Accounts

Delete an account (protected hard delete)

PROTECTED HARD DELETE. Permanently removes the account row and its transaction-free children (contacts, addresses, payment methods).

Industry standard (NetSuite / QuickBooks / Acumatica): an account that has any financial or transaction history cannot be deleted. If the account is referenced by orders (any document type: quote / sales order / invoice / return / purchase order), payments, returns, vendor bills, AP payments, vendor credits, vendor prepayments, customer deposits, journal entry lines, inventory transactions, or pricing policies, the call returns 409 account_not_deletable with a clear hint and per-type dependency counts. In that case, DEACTIVATE the account instead (POST /v1/accounts/{id}/deactivate).

A transaction-free account is hard-deleted and the call returns { deleted: true, display_name }. This behavior is identical to the in-app (Cognito) delete — one canonical handler serves both callers.

DELETE

accounts

{id}

Delete an account (protected hard delete)

curl --request DELETE \
  --url https://api.arcuserp.com/v1/accounts/{id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.arcuserp.com/v1/accounts/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.arcuserp.com/v1/accounts/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.arcuserp.com/v1/accounts/{id}"

	req, _ := http.NewRequest("DELETE", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.arcuserp.com/v1/accounts/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "data": {
    "deleted": true,
    "display_name": "<string>"
  }
}

{
  "error": "not_found",
  "code": "not_found",
  "type": "not_found",
  "hint": "The requested order does not exist or does not belong to this entity.",
  "param": "expand[0]",
  "required": "accounts:read",
  "request_id": "req_abc123"
}

{
  "error": "not_found",
  "code": "not_found",
  "type": "not_found",
  "hint": "The requested order does not exist or does not belong to this entity.",
  "param": "expand[0]",
  "required": "accounts:read",
  "request_id": "req_abc123"
}

{
  "error": "not_found",
  "code": "not_found",
  "type": "not_found",
  "hint": "The requested order does not exist or does not belong to this entity.",
  "param": "expand[0]",
  "required": "accounts:read",
  "request_id": "req_abc123"
}

{
  "error": "account_not_deletable",
  "code": "account_not_deletable",
  "type": "precondition_failed",
  "hint": "Account has 12 orders, 8 payments, 3 returns. Accounts with financial history cannot be deleted -- deactivate it instead (set inactive).",
  "has_transactions": true,
  "dependencies": {
    "orders": 123,
    "invoices": 123,
    "payments": 123,
    "returns": 123,
    "vendor_bills": 123,
    "ap_payments": 123,
    "vendor_credits": 123,
    "vendor_prepayments": 123,
    "customer_deposits": 123,
    "journal_lines": 123,
    "inventory_transactions": 123,
    "pricing_policies": 123
  }
}

Authorizations

Authorization

string

header

required

API key issued per entity via Settings > Developers > API Keys. Each key carries scopes (e.g. orders:read, products:write). Bearer token format: Authorization: Bearer ark_live_ent_Test keys use ark_test_ent_. Both are issued per entity via Settings > Developers > API Keys.

Path Parameters

string

required

Account UUID or account_number (e.g. ACCT-001, CUST-00042). Polymorphic lookup: if the value is not a UUID it is resolved to a UUID via accounts.account_number within the entity scope before the record is fetched. (NEW-GAP-API-V1-POLYMORPHIC-LOOKUP-CROSS-RESOURCE 2026-05-20)

Response

Account permanently deleted (no financial history).

data

object

Show child attributes

Retrieve an account Update an account (PATCH allowlist)

Overview

All Endpoints

Delete an account (protected hard delete)

Authorizations

Path Parameters

Response