---
title: "List all accounts"
method: GET
path: "/accounts"
tags: ["Accounts"]
---

# List all accounts

`GET /accounts`

## Query parameters

- `skip` integer — For pagination, skip a number of results
- `take` integer — Only take up to a number of results.
- `id` string — A cursor (bookmark) used to only return results equal or lower than the given id. More efficient than skip for large result sets.
- `metadata` object — Metadata filters, use the following format to construct a clause for a metadata search: metadata["<field>"]:<value>
- `name` string — Non-empty text string
- `type` 'business' | 'individual' — Legal entity type

## Response `200`

Successful operation

- object — List of items
  - `data` object[], required
    - `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)