--- title: "List all accounts" method: GET path: "/accounts" tags: ["Accounts"] --- # List all accounts `GET /accounts` ## Request - Base URL: `https://core.sivo.com` - URL: `https://core.sivo.com/accounts` - 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: (a function with typed inputs; its response is checked against the schema) ## Query parameters - `limit` integer: Maximum number of results to return, from 1 to 100; defaults to 25 - `page` string: Opaque page token from a previous response's next_page or previous_page; pass it back unchanged, with the same sort and filters - `expand` string[]: Extra fields to include in the page; total_count counts the matching results, exactly up to 10000 - `sort` 'created_at_desc': Result order; defaults to created_at_desc - `name` string: Non-empty text string - `type` 'business' | 'individual': Legal entity type - `metadata` object: Metadata filters, use the following format to construct a clause for a metadata search: metadata[""]: ## Response `200` Successful operation - object: One page of a list - `data` object[], required - `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 - `has_more` boolean, required: Whether more results follow this page in the list order - `next_page` string, nullable, required: Token for the page after this one, or null when this is the last page - `previous_page` string, nullable, required: Token for the page before this one, or null when this is the first page - `total_count` integer: Number of results matching the filters, exact up to 10000; 10001 means more than that. Only present when the request expands total_count ## Changes - **2026-11-03** `4bbab9699612`: 2 breaking, 3 warning, 13 info - added `#/components/schemas/Datacredito, #/components/schemas/Transunion` to the `data/items/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 `data/items/legal_entity_id` response property `oneOf` list for the response status `200` - deleted the `query` request parameter `id` - deleted the `query` request parameter `skip` - …14 more [Operation history](https://skmtc.dev/sivo/apis/sivo-advance-api/changes/accounts/get.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)