Careers (Public)

Public endpoints for job listings, applications, and candidate portals. These endpoints require no authentication and are accessible to anyone.

Note: All endpoints below are public and do not require any authentication token.

Get All Open Jobs

GET/api/public/jobs

Get all open job listings grouped by company. No authentication required.

Response (200)

{ "companies": [ { "company": { "id": "...", "name": "Acme Corp", "icon": "..." }, "jobs": [ { "id": "...", "title": "Software Engineer", "department": "Engineering", "location": "Remote", "employmentType": "full-time", "salaryRangeMin": 80000, "salaryRangeMax": 120000, "salaryType": "per-annum", "currency": "USD", "openings": 3, "description": "...", "requiredSkills": ["React", "Node.js"], "status": "open", "createdAt": "2024-01-15T10:30:00Z" } ] } ] }

Get Job Details

GET/api/public/jobs/[id]

Get details of a specific open job.

Field	Type	Required	Description
`id`	string	Required	Job ID (path param)

Response (200)

{ "job": { "id": "...", "title": "Software Engineer", "department": "Engineering", "location": "Remote", "employmentType": "full-time", "salaryRangeMin": 80000, "salaryRangeMax": 120000, "description": "...", "requiredSkills": ["React", "Node.js"], "company": { "id": "...", "name": "Acme Corp", "icon": "..." } } }

Errors

Status	Message
`404`	Job not found

Verify Referral

GET/api/public/jobs/[id]/verify-referral

Verify a referral ID is valid for a specific job.

Query Param	Type	Required	Description
`referralId`	string	Required	Referral ID to verify

Response (200)

{ "name": "John Doe", "company": "Acme Corp" }

Errors

Status	Message
`400`	referralId query parameter is required
`404`	Job not found / Referral employee not found

Verify Identity Code

GET/api/public/verify/[identityCode]

Verify an employee's identity code. Returns employee info if valid.

Field	Type	Required	Description
`identityCode`	string	Required	Identity code (path param)

Response (200) - Verified

{ "verified": true, "name": "John Doe", "role": "Software Engineer", "companyIdentityCode": "ACME-001", "companyJoined": "2024-01-15T00:00:00Z", "avatarUrl": "...", "company": { "name": "Acme Corp", "icon": "...", "status": "active", "primaryColor": "#6366f1" } }

Response (200) - Not Verified

{ "verified": false, "reason": "not-found", "message": "No employee found with this ID." }

Reasons

Reason	Description
`not-found`	No employee found with this identity code
`revoked`	ID card has been revoked
`not-issued`	No ID card has been issued

Verify Visitor Identity

GET/api/public/verify-visitor/[identityCode]

Verify a visitor's identity code.

Field	Type	Required	Description
`identityCode`	string	Required	Visitor identity code (path param)

{ "verified": true, "visitorName": "Jane Smith", "purpose": "Meeting", "hostName": "John Doe" }

Get Visitor Event

GET/api/public/visitor/event/[slug]

Get visitor event details by slug.

Field	Type	Required	Description
`slug`	string	Required	Event slug (path param)

{ "event": { "id": "...", "slug": "tech-meetup-2024", "visitorCompany": "Tech Inc", "expectedDate": "2024-02-01", "purpose": "Tech Meetup", "hostName": "John Doe", "status": "upcoming" } }

Register for Visitor Event

POST/api/public/visitor/register/[slug]

Field	Type	Required	Description
`slug`	string	Required	Event slug (path param)
`visitorName`	string	Required	Your full name
`visitorEmail`	string	Required	Your email
`visitorPhone`	string	Optional	Your phone number
`purpose`	string	Optional	Purpose of visit

Response (201)

{ "pass": { "id": "...", "status": "pending", "identityCode": "VIS789" } }

Careers (Public)

Public endpoints for job listings, applications, and candidate portals. These endpoints require no authentication and are accessible to anyone.

Note: All endpoints below are public and do not require any authentication token.

Get All Open Jobs

GET/api/public/jobs

Get all open job listings grouped by company. No authentication required.

Response (200)

Get Job Details

GET/api/public/jobs/[id]

Get details of a specific open job.

Field	Type	Required	Description
`id`	string	Required	Job ID (path param)

Response (200)

Errors

Status	Message
`404`	Job not found

Verify Referral

GET/api/public/jobs/[id]/verify-referral

Verify a referral ID is valid for a specific job.

Query Param	Type	Required	Description
`referralId`	string	Required	Referral ID to verify

Response (200)

{ "name": "John Doe", "company": "Acme Corp" }

Errors

Status	Message
`400`	referralId query parameter is required
`404`	Job not found / Referral employee not found

Verify Identity Code

GET/api/public/verify/[identityCode]

Verify an employee's identity code. Returns employee info if valid.

Field	Type	Required	Description
`identityCode`	string	Required	Identity code (path param)

Response (200) - Verified

Response (200) - Not Verified

{ "verified": false, "reason": "not-found", "message": "No employee found with this ID." }

Reasons

Reason	Description
`not-found`	No employee found with this identity code
`revoked`	ID card has been revoked
`not-issued`	No ID card has been issued

Verify Visitor Identity

GET/api/public/verify-visitor/[identityCode]

Verify a visitor's identity code.

Field	Type	Required	Description
`identityCode`	string	Required	Visitor identity code (path param)

{ "verified": true, "visitorName": "Jane Smith", "purpose": "Meeting", "hostName": "John Doe" }

Get Visitor Event

GET/api/public/visitor/event/[slug]

Get visitor event details by slug.

Field	Type	Required	Description
`slug`	string	Required	Event slug (path param)

{ "event": { "id": "...", "slug": "tech-meetup-2024", "visitorCompany": "Tech Inc", "expectedDate": "2024-02-01", "purpose": "Tech Meetup", "hostName": "John Doe", "status": "upcoming" } }

Register for Visitor Event

POST/api/public/visitor/register/[slug]

Field	Type	Required	Description
`slug`	string	Required	Event slug (path param)
`visitorName`	string	Required	Your full name
`visitorEmail`	string	Required	Your email
`visitorPhone`	string	Optional	Your phone number
`purpose`	string	Optional	Purpose of visit

Response (201)

{ "pass": { "id": "...", "status": "pending", "identityCode": "VIS789" } }

Careers (Public)

Get All Open Jobs

Response (200)

Get Job Details

Response (200)

Errors

Verify Referral

Response (200)

Errors

Verify Identity Code

Response (200) - Verified

Response (200) - Not Verified

Reasons

Verify Visitor Identity

Get Visitor Event

Register for Visitor Event

Response (201)

Loading FlowZen

Careers (Public)

Get All Open Jobs

Response (200)

Get Job Details

Response (200)

Errors

Verify Referral

Response (200)

Errors

Verify Identity Code

Response (200) - Verified

Response (200) - Not Verified

Reasons

Verify Visitor Identity

Get Visitor Event

Register for Visitor Event

Response (201)