Indian telecom rules require Edesy to verify who uses each number, so KYC must be approved before you can buy a number. You submit your business details and documents (PAN and Aadhaar, plus business documents where they apply) in the portal or through the API, and review usually takes about 24 hours. Until KYC is approved, number purchases return 403 KYC_NOT_APPROVED.

Business types#

`business_type`	Description
`individual`	An individual
`sole_proprietor`	Sole proprietorship
`partnership`	Partnership firm
`private_limited`	Private limited company
`public_limited`	Public limited company
`llp`	Limited liability partnership

Documents#

`document_type`	Document
`pan_card`	PAN card
`aadhaar_front`, `aadhaar_back`	Aadhaar, both sides
`gst_certificate`	GST registration certificate
`business_registration`	Certificate of incorporation or registration
`address_proof`	Address proof
`authorization_letter`	Letter authorising the signatory

PAN and Aadhaar are the core documents. The portal shows which of the others your business type needs.

Status#

`status`	Meaning
`not_started`	Nothing submitted yet
`draft`	Details saved, not submitted
`submitted`	Under review
`approved`	You can buy numbers
`rejected`	See `rejection_reason`, fix it and submit again

Endpoints#

Method	Path	Description
GET	`/v1/kyc`	Your KYC record and documents
PUT	`/v1/kyc`	Save business details
POST	`/v1/kyc/documents`	Upload a document (multipart: `document_type`, `file`)
DELETE	`/v1/kyc/documents/{id}`	Remove a document
POST	`/v1/kyc/submit`	Submit for review

curl -X PUT https://voice-api.edesy.in/v1/kyc \
  -H "Authorization: Bearer $EDESY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "business_name": "Acme Retail Private Limited",
    "business_type": "private_limited",
    "pan_number": "ABCDE1234F",
    "gstin": "27ABCDE1234F1Z5",
    "address_line1": "Unit 4, Example Park",
    "city": "Pune",
    "state": "Maharashtra",
    "pincode": "411001",
    "authorized_signatory_name": "A. Sharma",
    "authorized_signatory_phone": "+9198XXXXXXXX"
  }'

curl -X POST https://voice-api.edesy.in/v1/kyc/documents \
  -H "Authorization: Bearer $EDESY_KEY" \
  -F "document_type=pan_card" -F "[email protected]"

curl -X POST https://voice-api.edesy.in/v1/kyc/submit -H "Authorization: Bearer $EDESY_KEY"

Only the last four digits of Aadhaar are stored as a field (aadhaar_last4). Documents are stored privately and used only for verification.

Tips#

Use the same legal name and GSTIN as your billing profile so invoices match.
Submit early: you can build and test against the API while review is in progress, but you need an approved KYC to buy the number your calls come from.