Create an account

IdempotencyKeystring

A unique key per operation, could be V4 UUID or other high‑entropy random string. Keys can be up to 255 characters. See Idempotent Requests.

Example:978771af-77de-4e24-ba39-f602502ceb78

A unique key per operation, could be V4 UUID or other high‑entropy random string. Keys can be up to 255 characters. See Idempotent Requests.

Request body

namestring required

Non-empty text string

type'business' | 'individual' required

Legal classification of the seller entity

websitestring

Seller website

emailstring email

Contact email address for the seller

phonestring

Contact phone number for the seller

industrystring

NAICS industry code: https://www.naics.com/search/

kyx_status'draft' | 'submitted' | 'approved' | 'rejected'

Know Your Customer verification status

active_sincestring date

Date when the seller was first active in the platform

monthly_revenueinteger

Monthly revenue of the seller in USD

monthly_costsinteger

Monthly costs of the seller in USD

cash_on_handinteger

Cash on hand of the seller in USD

avg_sale_sizeinteger

Average sale size of the seller in USD

performance_scoreinteger

Performance score between 1 (poor) and 10 (excellent)

buyer_concentrationnumber

Percentage of total revenue from the top 20% of buyers

average_days_to_payinteger

Average days to pay

lifetime_spendinteger

Total amount spent by the buyer in USD

customer_countinteger

Number of customers

metadataobject

Additional custom data associated with this seller

Example request

{
  "website": "https://acme.com",
  "email": "email@domain.com",
  "phone": "+14155551234",
  "industry": "541511",
  "legal_entity_id": "duns:123456789",
  "credit_score": "paydex:123",
  "active_since": "2024-01-15",
  "monthly_revenue": 10000,
  "monthly_costs": 10000,
  "cash_on_hand": 10000,
  "avg_sale_size": 10000,
  "buyer_concentration": 0.05,
  "average_days_to_pay": 42,
  "lifetime_spend": 10000,
  "customer_count": 42,
  "insurance": {
    "rating": "coface:8",
    "limit": 10000,
    "coverage": 0.05
  },
  "metadata": {
    "key": "value"
  }
}

Response

Successful operation