{"openapi":"3.0.3","info":{"title":"Public API","description":"Public API for 3rd party Jobseeker-facing products.","version":"4c23f914519499219e0867a63a876ba9566d5036"},"components":{"schemas":{}},"paths":{"/api/v1/jobs/":{"get":{"tags":["Jobs"],"description":"List jobs.","parameters":[{"schema":{"type":"number","minimum":1,"maximum":9999},"in":"query","name":"first","required":true,"description":"Maximum number of results to return."},{"schema":{"type":"string"},"in":"query","name":"after","required":false,"description":"End cursor of the previous page."},{"schema":{"type":"string"},"in":"query","name":"location","required":false,"description":"Location of the job. Example: \"Remote\", \"Austin\", \"New York City\", etc."},{"schema":{"type":"string"},"in":"query","name":"title","required":false,"description":"Title of the job."},{"schema":{"type":"string"},"in":"query","name":"companyName","required":false,"description":"Name of the company."},{"schema":{"type":"number"},"in":"query","name":"companyId","required":false,"description":"Identifier of the company."},{"schema":{"type":"object","properties":{"lat":{"type":"number","description":"Latitude for geographic-based job search"},"lng":{"type":"number","description":"Longitude for geographic-based job search"},"distanceBoundary":{"type":"string","description":"Maximum distance from coordinates (e.g., \"50km\", \"30mi\")"}},"additionalProperties":false},"in":"query","name":"geographic","required":false},{"schema":{"type":"boolean"},"in":"query","name":"isRemoteSearch","required":false,"description":"Filter to only include remote jobs"},{"schema":{"type":"string","enum":["great","good","low"],"default":"good"},"in":"query","name":"minimumFit","required":false,"description":"Minimum search score threshold (Great, Good, Low)"},{"schema":{"type":"object","properties":{"minimum":{"type":"number","description":"Minimum compensation amount"},"maximum":{"type":"number","description":"Maximum compensation amount"},"interval":{"type":"string","enum":["Hourly","Annually"],"description":"Compensation interval (Hourly or Annually)"}},"additionalProperties":false},"in":"query","name":"compensation","required":false},{"schema":{"type":"string"},"in":"query","name":"industry","required":false,"description":"Industry to filter jobs by (e.g., \"Technology\", \"Healthcare\", \"Finance\")."},{"schema":{"type":"string"},"in":"query","name":"keywords","required":false,"description":"Keywords to search within job descriptions, responsibilities, and qualifications."},{"schema":{"type":"string"},"in":"header","name":"authorization","required":false},{"schema":{"type":"string"},"in":"header","name":"x-api-key","required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"jobs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string","format":"uri"},"title":{"type":"string"},"industry":{"type":"string"},"description":{"type":"string"},"location":{"type":"string"},"detailedLocation":{"type":"object","properties":{"city":{"type":"string"},"state":{"type":"string"},"country":{"type":"string"},"lat":{"type":"number"},"lng":{"type":"number"}},"additionalProperties":false},"companyName":{"type":"string"},"companyLogoUrl":{"type":"string","format":"uri"},"fullyRemote":{"type":"boolean"},"compensation":{"type":"object","properties":{"min":{"type":"number"},"max":{"type":"number"},"interval":{"type":"string"}},"required":["interval"],"additionalProperties":false},"publishedAt":{"type":"string"},"competencyRequirements":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"question":{"type":"string"},"responseType":{"type":"string"},"required":{"type":"boolean"},"choices":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"answer":{"type":"string"}},"required":["id","answer"],"additionalProperties":false}}},"required":["id","question","responseType","required","choices"],"additionalProperties":false}}},"required":["id","url","title","description","location","companyName","fullyRemote","competencyRequirements"],"additionalProperties":false}},"pagination":{"type":"object","properties":{"total":{"type":"number"},"hasNextPage":{"type":"boolean"},"hasPreviousPage":{"type":"boolean"},"startCursor":{"type":"string"},"endCursor":{"type":"string"}},"required":["total","hasNextPage","hasPreviousPage"],"additionalProperties":false}},"required":["jobs","pagination"],"additionalProperties":false,"description":"Successful response"}}}},"4XX":{"description":"Client error","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number"},"message":{"type":"string"},"error":{"type":"string"},"stack":{"type":"string"}},"required":["statusCode","message","error"],"additionalProperties":false,"description":"Client error"}}}},"5XX":{"description":"Server error","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number"},"message":{"type":"string"},"error":{"type":"string"},"stack":{"type":"string"}},"required":["statusCode","message","error"],"additionalProperties":false,"description":"Server error"}}}}}}},"/api/v1/jobs/{id}/":{"get":{"tags":["Jobs"],"description":"Get a job by id.","parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true,"description":"Identifier of the job to retrieve."},{"schema":{"type":"string"},"in":"header","name":"authorization","required":false},{"schema":{"type":"string"},"in":"header","name":"x-api-key","required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"job":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"industry":{"type":"string"},"description":{"type":"string"},"location":{"type":"string"},"companyName":{"type":"string"},"compensation":{"type":"object","properties":{"min":{"type":"number"},"max":{"type":"number"},"interval":{"type":"string"}},"required":["interval"],"additionalProperties":false},"publishedAt":{"type":"string"},"url":{"type":"string","format":"uri"},"fullyRemote":{"type":"boolean"},"responsibilities":{"type":"string"},"qualifications":{"type":"string"},"companyAbout":{"type":"string"},"companyWebsiteUrl":{"type":"string","format":"uri"},"companyLogoUrl":{"type":"string","format":"uri"},"isResumeRequired":{"type":"boolean"},"canonicalJobUrl":{"type":"string"},"detailedLocation":{"type":"object","properties":{"city":{"type":"string"},"state":{"type":"string"},"country":{"type":"string"},"lat":{"type":"number"},"lng":{"type":"number"}},"additionalProperties":false},"remoteType":{"type":"string"},"stage":{"type":"string"},"isClosed":{"type":"boolean"},"competencyRequirements":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"question":{"type":"string"},"responseType":{"type":"string"},"required":{"type":"boolean"},"choices":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"answer":{"type":"string"}},"required":["id","answer"],"additionalProperties":false}}},"required":["id","question","responseType","required","choices"],"additionalProperties":false}}},"required":["id","title","description","location","companyName","url","fullyRemote","isResumeRequired","isClosed","competencyRequirements"],"additionalProperties":false}},"required":["job"],"additionalProperties":false,"description":"Successful response"}}}},"4XX":{"description":"Client error","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number"},"message":{"type":"string"},"error":{"type":"string"},"stack":{"type":"string"}},"required":["statusCode","message","error"],"additionalProperties":false,"description":"Client error"}}}},"5XX":{"description":"Server error","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number"},"message":{"type":"string"},"error":{"type":"string"},"stack":{"type":"string"}},"required":["statusCode","message","error"],"additionalProperties":false,"description":"Server error"}}}}}}},"/api/v1/competencies/":{"get":{"tags":["Competencies","Jobs"],"description":"List competencies.","parameters":[{"schema":{"type":"number","minimum":1,"maximum":9999},"in":"query","name":"first","required":false,"description":"Maximum number of results to return."},{"schema":{"type":"string"},"in":"query","name":"after","required":false,"description":"End cursor of the previous page."},{"schema":{"type":"string"},"in":"header","name":"x-api-key","required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"competencies":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"question":{"type":"string","minLength":1},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"choices":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"answer":{"type":"string","minLength":1},"order":{"type":"integer"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","answer","order","createdAt"],"additionalProperties":false}}},"required":["id","question","createdAt"],"additionalProperties":false}},"pagination":{"type":"object","properties":{"total":{"type":"number"},"hasNextPage":{"type":"boolean"},"hasPreviousPage":{"type":"boolean"},"startCursor":{"type":"string"},"endCursor":{"type":"string"}},"required":["total","hasNextPage","hasPreviousPage"],"additionalProperties":false}},"required":["competencies"],"additionalProperties":false,"description":"Successful response"}}}},"4XX":{"description":"Client error","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number"},"message":{"type":"string"},"error":{"type":"string"},"stack":{"type":"string"}},"required":["statusCode","message","error"],"additionalProperties":false,"description":"Client error"}}}},"5XX":{"description":"Server error","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number"},"message":{"type":"string"},"error":{"type":"string"},"stack":{"type":"string"}},"required":["statusCode","message","error"],"additionalProperties":false,"description":"Server error"}}}}}}},"/api/v1/applies/":{"post":{"tags":["Apply"],"description":"Create a new apply.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"firstName":{"type":"string","minLength":1,"description":"First name of the job applicant"},"lastName":{"type":"string","minLength":1,"description":"Last name of the job applicant"},"email":{"type":"string","format":"email","description":"Email address of the job applicant"},"phoneNumber":{"type":"string","minLength":1,"description":"Phone number of the job applicant"},"resume":{"type":"object","properties":{"base64":{"type":"string","description":"Base64 encoded resume file content"},"fileName":{"type":"string","description":"File name of the resume (e.g., \"john_doe_resume.pdf\")"},"contentType":{"type":"string","description":"Browser-reported MIME type of the resume file (e.g., \"application/pdf\"). When provided, it is used as the stored file's Content-Type."}},"required":["base64","fileName"],"additionalProperties":false,"description":"Resume file to submit with the application. Required if the job has is_resume_required set to true."},"jobId":{"type":"string","description":"The ATS job key/ID from the job search results"},"competencyAnswers":{"type":"array","items":{"type":"object","properties":{"competencyId":{"type":"string","format":"uuid","description":"UUID of the competency question"},"choiceId":{"type":"string","format":"uuid","description":"UUID of the selected choice (for multiple choice questions)"},"text":{"type":"string","minLength":1,"description":"Text answer (for free-form questions)"}},"required":["competencyId"],"additionalProperties":false},"description":"Answers to screening questions (if any)"}},"required":["firstName","lastName","email","phoneNumber","jobId","competencyAnswers"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string"},"in":"header","name":"x-api-key","required":true}],"responses":{"201":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"apply":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"jobId":{"type":"string"},"competencyAnswers":{"type":"array","items":{"type":"object","properties":{"competencyId":{"type":"string","format":"uuid"},"choiceId":{"type":"string","format":"uuid"},"text":{"type":"string"}},"required":["competencyId"],"additionalProperties":false}},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"archivedAt":{"type":"string","format":"date-time"},"deletedAt":{"type":"string","format":"date-time"}},"required":["id","jobId","competencyAnswers","createdAt"],"additionalProperties":false}},"required":["apply"],"additionalProperties":false,"description":"Successful response"}}}},"4XX":{"description":"Client error","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number"},"message":{"type":"string"},"error":{"type":"string"},"stack":{"type":"string"}},"required":["statusCode","message","error"],"additionalProperties":false,"description":"Client error"}}}},"5XX":{"description":"Server error","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number"},"message":{"type":"string"},"error":{"type":"string"},"stack":{"type":"string"}},"required":["statusCode","message","error"],"additionalProperties":false,"description":"Server error"}}}}}}},"/api/v1/applies/{id}":{"get":{"tags":["Apply"],"description":"Get an apply by ID.","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true,"description":"UUID of the apply to retrieve."},{"schema":{"type":"string"},"in":"header","name":"x-api-key","required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"apply":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"jobId":{"type":"string"},"competencyAnswers":{"type":"array","items":{"type":"object","properties":{"competencyId":{"type":"string","format":"uuid"},"choiceId":{"type":"string","format":"uuid"},"text":{"type":"string"}},"required":["competencyId"],"additionalProperties":false}},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"archivedAt":{"type":"string","format":"date-time"},"deletedAt":{"type":"string","format":"date-time"}},"required":["id","jobId","competencyAnswers","createdAt"],"additionalProperties":false}},"required":["apply"],"additionalProperties":false,"description":"Successful response"}}}},"4XX":{"description":"Client error","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number"},"message":{"type":"string"},"error":{"type":"string"},"stack":{"type":"string"}},"required":["statusCode","message","error"],"additionalProperties":false,"description":"Client error"}}}},"5XX":{"description":"Server error","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number"},"message":{"type":"string"},"error":{"type":"string"},"stack":{"type":"string"}},"required":["statusCode","message","error"],"additionalProperties":false,"description":"Server error"}}}}}}}},"servers":[{"url":"https://api.gateway.wizehiredev.com","description":"Staging server"},{"url":"http://localhost:5001","description":"Local server"}],"tags":[]}