KYC Export

What is KYC Export?

KYC Export allows partner platforms to retrieve verified identity data from Kulipa for users who have already completed full KYC verification. This enables partners to onboard Kulipa-verified users without requiring them to repeat the identity verification process.

This is the inverse of Shared KYC (which imports
data into Kulipa). KYC Export returns verified data for you to send to trusted partners.

How KYC Export Works

Prerequisites

• The user must be in active status
• The user must have a verified full KYC on record

Request Export

The kulipa platform exposes the export endpoint that can be called with the target user's ID:

GET /v1/kycs/export?userId={userId}

Kulipa validates that:

1. The user exists and is in active status
2. The user has at least one verified full KYC
3. The KYC has a valid provider reference

If multiple verified KYCs exist, the most recently verified one is used.

Kulipa returns the full identity dataset from the KYC provider, including personal details, identity documents, selfie data, and compliance questionnaire responses.

Exported Data

The export response includes the following sections:

Personal Information

Field	Description
name.first	First name
name.middle	Middle name (if available)
name.last	Last name
emailAddress	Email address
phoneNumber	Phone number
dateOfBirth	Date of birth

Address

Field	Description
address.street1	Street address line 1
address.street2	Street address line 2 (if available)
address.city	City
address.state	State/province (if available)
address.zipCode	Postal/ZIP code
address.country	ISO country code

Identity Document

Field	Description
identityDocument.countryCode	Issuing country (if available)
identityDocument.type	Document type (e.g. passport, driving licence)
identityDocument.number	Document number
identityDocument.documentFront	Front image URL
identityDocument.documentBack	Back image URL (if applicable)
identityDocument.issuedDate	Issue date (if available)
identityDocument.placeOfBirth	Place of birth (if available)

Selfie

Field	Description
selfie.photo	Selfie image URL
selfie.collectedAt	Timestamp when the selfie was captured

KYC Questionnaire

Field	Description
kycQuestionnaire.intendedUse	Intended use of funds
kycQuestionnaire.employmentStatus	Employment status
kycQuestionnaire.sourceOfWealth	Source of wealth
kycQuestionnaire.occupation	Occupation
kycQuestionnaire.approximateNetWorth	Approximate net worth

IP Address

Field	Description
ipAddress	IP address from the most recent verification session

Rate Limiting

The export endpoint is rate-limited to 10 requests per 60 seconds per distributor. This protects upstream provider API limits and prevents abuse. See Rate Limiting for general rate limiting behaviour.

Error Cases

Scenario	Error
User is not in active status	400
No verified full KYC found	404

Getting Started

To use KYC Export, call the Export KYC endpoint with the user ID of a verified user.