API ReferenceKyb
Get KYB status
Returns the current KYB verification status for the authenticated merchant.
Possible statuses: not_submitted, pending_review, approved, rejected.
Authorization
privy AuthorizationBearer <token>
Privy JWT authentication for dashboard and management endpoints. This is used internally by the Bag Dashboard and is not intended for direct API integrations. Use API keys instead.
In: header
Response Body
application/json
application/json
curl -X GET "https://api.justusebag.xyz/api/kyb"{
"status": "success",
"data": {
"kybStatus": "approved",
"businessName": "Acme Corp",
"submittedAt": "2025-11-01T12:00:00.000Z"
}
}{
"status": "error",
"message": "Invalid or revoked API key",
"code": "UNAUTHORIZED",
"hint": "Include a valid API key in the Authorization header: Bearer bag_live_sk_..."
}