Identity Reconciliation API
Node.jsTypescriptMongoDB
Friday, May 30, 2025
Overview
The Identity Reconciliation API is a robust solution designed to streamline user identity management by consolidating contact information based on email and phone number. Built with Node.js, Express.js, and MongoDB using TypeScript, this project efficiently handles identity reconciliation, linking related contacts while ensuring data integrity and avoiding duplicates.
Key Features:
- Identity Reconciliation: Matches and consolidates user identities using email, phone number, or both.
- Primary and Secondary Contacts: Links secondary contacts to a single primary contact based on the oldest record.
- Duplicate Prevention: Ensures no redundant data with unique email and phone number consolidation.
- RESTful API: Provides a scalable POST /identify endpoint for seamless integration.
- Error Handling: Robust validation with meaningful error responses (e.g., 400 for invalid input, 500 for server issues).
Tech Stack:
- Backend: Node.js, Express.js
- Database: MongoDB with Mongoose
- Language: TypeScript for type-safe development
- Deployment: Hosted on Render for live testing
Try it out
The API is live at:
Test it with Postman using a JSON payload like:
json
{
"email": "test@example.com",
"phoneNumber": "19192"
}