Customer Management
Manage physical and moral persons from the API
Create, query and manage customer profiles. The starting point for any verification flow in Singula.
Customer Management
Physical
Moral
Customer ID
cus_lzk9m4ab3f9c2d1e
Ready to verify
Two person types, one API
Physical Person
Individuals with name, CURP, date of birth and contact data.
Moral Person
Companies with legal name, trade name and legal representative.
How does it work?
Step 1
Create the customer
POST with basic data. Receive a unique ID in cus_xxx format ready to use.
Step 2
Run verifications
Use the customer_id for CURP, RFC, KYC, blacklist and any tool.
Step 3
Query the profile
GET to see the full profile with verification history.
customers.sh
// Crear persona física
curl -X POST https://api.singula.mx/v1/customers \
-H "Authorization: Bearer sk_live_..." \
-d '{ "name": "Maria", "last_name": "Garcia",
"gender": "M", "birth_day": "15",
"birth_month": "03", "birth_year": "1990" }'
→ { "id": "cus_lzk9m4ab3f9c2d1e", "status": "created" }
// Crear persona moral
curl -X POST https://api.singula.mx/v1/customers/moral \
-d '{ "name": "Tech SA", "legal_name": "Tech SA de CV" }'
→ { "id": "cus_mrl8k2bc4e7f3a9d", "type": "moral" }Unique time-sortable IDs
cus_xxx format optimized for database performance.
Search and pagination
Search customers by name, email or ID with native pagination.
Sandbox and production
Separate environments. Same structure, isolated data.
Instant response
Synchronous creation in under 200ms.