API ReferenceKyb
Submit KYB application
Submits a Know Your Business verification application. This is required before you can accept live payments. Bag reviews applications manually and will notify you via email when the status changes.
You can only submit once — subsequent attempts return 409 Conflict. Use PATCH to update fields on a pending application.
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
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
curl -X POST "https://api.justusebag.xyz/api/kyb" \ -H "Content-Type: application/json" \ -d '{ "businessName": "Acme Corp", "businessType": "LLC", "registrationNumber": "DE-123456789", "country": "US", "website": "https://acme.example.com", "contactName": "Jane Smith", "contactEmail": "jane@acme.example.com", "contactRole": "CTO", "productDescription": "SaaS project management tool with team collaboration features", "expectedMonthlyVolume": "$10,000 - $50,000", "primaryUseCase": "Subscription payments" }'{
"status": "success",
"message": "KYB application submitted for review"
}{
"status": "error",
"message": "Invalid or revoked API key",
"code": "UNAUTHORIZED",
"hint": "Include a valid API key in the Authorization header: Bearer bag_live_sk_..."
}{
"status": "error",
"message": "Transaction already recorded",
"code": "CONFLICT"
}