NSS
Get the Social Security Number from IMSS
Query the NSS directly from IMSS. Asynchronous operation with webhook result. Ideal for HR and hiring processes.
Juan García López
cus_lzk9m4ab3f
Esperando consulta
Pendiente
Direct IMSS query
We obtain the Social Security Number directly from the Mexican Social Security Institute records. Verified and official result.
How does it work?
One API call. Result via webhook.
Step 1
Send the query
POST with the customer_id. Singula starts the IMSS query.
Step 2
Async processing
The query is processed in the background. No polling needed.
Step 3
Webhook with result
You receive the verified NSS at your endpoint when the result is ready.
nss-lookup.sh
curl -X POST https://api.singula.mx/v1/nss/lookup \
-H "Authorization: Bearer sk_live_..." \
-d '{"customer_id": "cus_lzk9m4ab3f"}'
→ { "status": "processing", "webhook": true }
// Webhook:
{ "nss": "1234567890", "customer_id": "cus_lzk9m4ab3f", "source": "IMSS" }Official IMSS source
Data directly from the Mexican Social Security Institute.
Async webhook
Result delivered automatically to your backend without polling.
Ideal for HR
Perfect for hiring processes and employee verification.
KYC integration
Combine with CURP, RFC, and other modules in a complete flow.