---
title: "Delete an account"
method: DELETE
path: "/accounts/{id}"
tags: ["Accounts"]
---

# Delete an account

`DELETE /accounts/{id}`

## Request

- Base URL: `https://core.sivo.com`
- URL: `https://core.sivo.com/accounts/{id}`
- Auth: one of:
  - API key in header `Authorization`
  - OAuth 2
    - Authorization code: `https://dashboard.sivo.com/oauth/authorize`
    - Client credentials
    - Token URL: `https://core.sivo.com/oauth/token`
- TypeScript: <https://skmtc.dev/sivo/apis/sivo-advance-api/docs/accounts/:id/delete.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `id` string, required: An object ID assigned and owned by the originator

## Response `200`

Successful operation

- object
  - `name` string, required: Non-empty text string
  - `type` 'business' | 'individual', required: Legal classification of the seller entity
  - `first_name` string: First (given) name of an individual
  - `last_name` string: Last (family) name of an individual
  - `address` object: Primary business address of the seller
    - `region` string: State, province, prefecture, or region component. For the US and Canada, MUST be 2-letter abbreviation.
    - `country` string, required: ISO 3166-1 alpha-2 country code
    - `formatted` string: Full mailing address, formatted for display or use on a mailing label. This field MAY contain multiple lines, separated by newlines.
    - `street_address` string: Full street address component, which MAY include house number, street name, Post Office Box, and multi-line extended street address information. This field MAY contain multiple lines, separated by newlines.
    - `locality` string: City, town, or locality component.
    - `postal_code` string: Zip code or postal code component.
  - `shipping` object: Delivery address for shipments
    - `region` string: State, province, prefecture, or region component. For the US and Canada, MUST be 2-letter abbreviation.
    - `country` string, required: ISO 3166-1 alpha-2 country code
    - `formatted` string: Full mailing address, formatted for display or use on a mailing label. This field MAY contain multiple lines, separated by newlines.
    - `street_address` string: Full street address component, which MAY include house number, street name, Post Office Box, and multi-line extended street address information. This field MAY contain multiple lines, separated by newlines.
    - `locality` string: City, town, or locality component.
    - `postal_code` string: Zip code or postal code component.
  - `website` string: Seller website
  - `email` string, email: Contact email address for the seller
  - `phone` string: Contact phone number for the seller
  - `industry` string: NAICS industry code: https://www.naics.com/search/
  - `legal_entity_id` union: Legal entity identifier. National schemes must match the address country: ein: and ssn: US, rfc: MX, nit: CO or BO, nif: ES, crn: GB, bn: CA; duns: is valid in any country
    - string: DUNS (Data Universal Numbering System) - An 9-digit code with duns: prefix
    - string: EIN (Employer Identification Number) - An 9-digit code with ein: prefix
    - string: SSN (Social Security Number) - An 9-digit code with ssn: prefix
    - string: RFC (Registro Federal de Contribuyentes - Mexico) - A 12 or 13-character alphanumeric code with rfc: prefix
    - string: NIT (Número de Identificación Tributaria - Colombia and Bolivia) - For Colombia the 5 to 10-digit base number, without dots and without the check digit (DV); for Bolivia the 7 to 12-digit number. With nit: prefix
    - string: NIF (Número de Identificación Fiscal - Spain) - A 9-character code (a company CIF, a DNI or a NIE), uppercase without spaces or dashes, with nif: prefix
    - string: CRN (Companies House registration number - United Kingdom) - An 8-character code (8 digits, or a 2-letter prefix such as SC and 6 digits) with crn: prefix
    - string: BN (Business Number - Canada) - The 9-digit CRA business number, without the program account suffix, with bn: prefix
  - `credit_score` union: Credit score
    - string: Paydex credit score - A 3-digit score with paydex: prefix
    - string: Experian credit score - A 3-digit score with experian: prefix
    - string: DataCrédito Experian (Colombia) credit score - A 3-digit score with datacredito: prefix
    - string: TransUnion credit score - A 3-digit score with transunion: prefix
  - `kyx_status` 'draft' | 'submitted' | 'approved' | 'rejected': Know Your Customer verification status
  - `active_since` string, date: Date when the seller was first active in the platform
  - `monthly_revenue` integer: Monthly revenue of the seller in USD
  - `monthly_costs` integer: Monthly costs of the seller in USD
  - `cash_on_hand` integer: Cash on hand of the seller in USD
  - `avg_sale_size` integer: Average sale size of the seller in USD
  - `performance_score` integer: Performance score between 1 (poor) and 10 (excellent)
  - `buyer_concentration` number: Percentage of total revenue from the top 20% of buyers
  - `average_days_to_pay` integer: Average days to pay
  - `lifetime_spend` integer: Total amount spent by the buyer in USD
  - `customer_count` integer: Number of customers
  - `insurance` object: Indicates that buyer is insured against non-payment
    - `rating` string, required: Insurance rating from 3rd party provider
    - `limit` integer, required: Maximum amount in USD that will be insured for a given buyer across all their invoices
    - `coverage` number, required: Percentage of the invoice that the insurer will pay if the buyer defaults
  - `metadata` object: Additional custom data associated with this seller
  - `id` string, required: The account ID assigned by the originator
  - `created_at` string, date-time, required: Creation date and time
  - `created_by` string, required: ID of the user that created this object
  - `updated_at` string, date-time, required: Last update date and time
  - `updated_by` string, required: ID of the user that last updated this object

## Changes

- **2026-11-03** `4bbab9699612`: 3 breaking, 1 warning, 6 info
  - for the `path` request parameter `id`, the minLength was increased from `0` to `1`
  - added `#/components/schemas/Datacredito, #/components/schemas/Transunion` to the `credit_score` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/Nit, #/components/schemas/Nif, #/components/schemas/Crn, #/components/schemas/Bn` to the `legal_entity_id` response property `oneOf` list for the response status `200`
  - for the `path` request parameter `id`, the maxLength was set to `255`
  - …6 more

[Operation history](https://skmtc.dev/sivo/apis/sivo-advance-api/changes/accounts/:id/delete.md)

---

[API](https://skmtc.dev/sivo/apis/sivo-advance-api.md) - [All operations](https://skmtc.dev/sivo/apis/sivo-advance-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sivo/apis/sivo-advance-api/revisions/4bbab9699612?raw)