NL-Dating API Quick Reference

Authentication

# Login
curl -X POST https://api.nl-dating.com/api/mobile/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email":"user@example.com","password":"password","device_name":"Device"}'

# Use token in requests
curl -X GET https://api.nl-dating.com/api/user/profile \
  -H "Authorization: Bearer YOUR_TOKEN"

Common Endpoints

Profile

• GET /api/user/profile - Get profile
• PUT /api/user/profile - Update profile
• GET /api/user/profile/completion - Completion status
• GET /api/user/profile/quality - Quality score
• PUT /api/user/profile/preferences - Update preferences
• PUT /api/user/profile/privacy - Update privacy

Matching

• GET /api/user/matches/recent - Recent matches
• GET /api/user/matches/{id} - Match details
• GET /api/user/matches/statistics - Match stats

Meetings

• GET /api/user/meetings - List meetings
• GET /api/user/meetings/upcoming - Upcoming meetings
• PUT /api/user/meetings/{id}/reschedule - Reschedule
• DELETE /api/user/meetings/{id}/cancel - Cancel

Messaging

• GET /api/user/conversations - All conversations
• GET /api/user/messages/{userId} - Messages with user
• POST /api/user/messages/send - Send message
• POST /api/user/messages/mark-read - Mark as read

Discovery

• GET /api/discovery/discover - Discover users
• POST /api/discovery/like - Like user
• POST /api/discovery/pass - Pass on user

Safety

• POST /api/user/safety/block - Block user
• POST /api/user/safety/report - Report user
• GET /api/user/safety/guidelines - Safety tips

Payments

• GET /api/user/payments - Payment history
• POST /api/user/payments - Submit payment
• GET /api/user/payments/info - Payment instructions

Response Format

{
  "success": true,
  "message": "Success message",
  "data": {
    // Response data
  }
}

Error Format

{
  "success": false,
  "message": "Error message",
  "error_code": "ERROR_CODE",
  "errors": {
    "field": ["Validation error"]
  }
}

Rate Limits

• Standard: 1000 req/min
• Premium: 2000 req/min
• Per endpoint limits apply

Headers

Authorization: Bearer YOUR_TOKEN
Content-Type: application/json
Accept: application/json

Status Codes

• 200: Success
• 201: Created
• 400: Bad Request
• 401: Unauthorized
• 403: Forbidden
• 404: Not Found
• 422: Validation Error
• 429: Rate Limited
• 500: Server Error