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

# Retrieve an account

`GET /accounts/{id}`

## Path parameters

- `id` string, required — An object id with prefix

## Response `200`

Successful operation

- object
  - `name` string, required — Non-empty text string
  - `type` 'business' | 'individual', required — Legal classification of the seller entity
  - `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
    - 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
  - `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
  - `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 — An object id with prefix
  - `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

---

[API](https://skmtc.net/sivo/apis/sivo-advance-api.md) · [All operations](https://skmtc.net/sivo/apis/sivo-advance-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sivo/sivo-advance-api/revisions/bfbcd2bfed61/schema)