Skip to main content
GET
/
partners
/
{sellerId}
/
buyers
/
{buyerId}
/
kyc
Get KYC status for a buyer.
curl --request GET \
  --url https://api.novatrade24.com/v1/partners/{sellerId}/buyers/{buyerId}/kyc \
  --header 'Authorization: Bearer <token>'
{
  "buyerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "kycMode": "MARKETPLACE_LED",
  "overallStatus": "INCOMPLETE",
  "viesLastCheckedAt": "2023-11-07T05:31:56Z",
  "viesResult": "VALID",
  "documentsComplete": true,
  "verificationStatus": "NOT_STARTED",
  "amlStatus": "NOT_APPLICABLE"
}

Authorizations

​
Authorization
string
header
required

OAuth 2.0 client_credentials grant via Keycloak service account. Clients are provisioned per IntegrationOrganization in the nt24-idp realm.

Path Parameters

​
sellerId
string<uuid>
required

UUID of the seller trade partner (must be in caller's authorized list).

​
buyerId
string<uuid>
required

UUID of the buyer trade partner.

Response

OK

​
buyerId
string<uuid>
​
kycMode
enum<string>

MARKETPLACE_LED (Mode A) — partner provides KYC data; NT24 stores + runs VIES only. NT24_LED (Mode B) — NT24 runs full verification (iDenfy + AML) and generates a profile.

Available options:
MARKETPLACE_LED,
NT24_LED
​
overallStatus
enum<string>
Available options:
INCOMPLETE,
VALID,
INVALID
​
viesLastCheckedAt
string<date-time>
​
viesResult
enum<string>
Available options:
VALID,
INVALID,
PENDING,
UNKNOWN
​
documentsComplete
boolean
​
verificationStatus
enum<string>

Mode B only.

Available options:
NOT_STARTED,
IN_PROGRESS,
VERIFIED,
REJECTED
​
amlStatus
enum<string>

Mode B only.

Available options:
NOT_APPLICABLE,
PENDING,
CLEAR,
FLAGGED