Chennai, India

Madarth API documentation

These endpoints back the website's contact and career forms and the geolocation proxy. They are rate-limited (5 requests per 15 minutes per IP) and intended for use by the site itself; agents may call them but should respect the rate limit and the honeypot field.

Service catalog: /.well-known/api-catalog · Health check: /api/status

POST /api/contact

Submits the contact form.

Content-Type: application/json

Required fields: name, email, phone

Optional fields: company, message, source_url, ip_address, location, honeypot (leave empty)

Response: 200 on success, 400 on validation error, 429 on rate limit.

curl -X POST https://www.madarth.com/api/contact \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Sample Name",
    "email": "[email protected]",
    "phone": "+91 99999 99999",
    "message": "Hello"
  }'

POST /api/career

Submits a career application, including an optional resume PDF.

Content-Type: multipart/form-data

Required fields: firstName, email, mobileNumber, position (Intern | Full Time), jobRole

Optional fields: lastName, portfolio, resume (PDF, ≤5 MB), ipAddress, location, sourceUrl, honeypot (leave empty)

Response: 200 on success, 400 on validation error, 429 on rate limit.

GET /api/geo

Server-side proxy for IP geolocation lookups. Returns city, region, country and timezone for the requesting client. Used by the site's location/time display.

Response: 200 with a JSON body.

curl https://www.madarth.com/api/geo

Notes