Bag DocsAPI 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
session AuthorizationBearer <token>
Supabase session 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
Response Body
application/json
application/json
application/json
curl -X POST "https://getbags.app/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"
}