{"openapi":"3.1.0","info":{"title":"Irish Mehta Public Job API","version":"1.0.0","description":"Read-only search over public US job postings. No authentication is required."},"servers":[{"url":"https://job-api.irishmehta.workers.dev"}],"paths":{"/v1/status":{"get":{"operationId":"getDatasetStatus","summary":"Check API readiness and dataset freshness","responses":{"200":{"description":"Current dataset status","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StatusResponse"}}}}}}},"/v1/jobs":{"get":{"operationId":"searchJobs","summary":"Search public jobs with combinable filters","description":"Use /v1/facets to discover exact taxonomy values. Reuse all filters when following next_cursor.","parameters":[{"name":"q","in":"query","required":false,"description":"Keyword search across titles, companies, summaries, and taxonomy terms.","schema":{"type":"string","maxLength":100}},{"name":"career_bucket","in":"query","required":false,"description":"Exact career bucket value returned by /v1/facets.","schema":{"type":"string","maxLength":100}},{"name":"experience_level","in":"query","required":false,"description":"Exact experience level value returned by /v1/facets.","schema":{"type":"string","maxLength":100}},{"name":"authorization_category","in":"query","required":false,"description":"Exact work-authorization category.","schema":{"type":"string","maxLength":100}},{"name":"sponsorship_status","in":"query","required":false,"description":"Exact sponsorship status.","schema":{"type":"string","maxLength":100}},{"name":"company","in":"query","required":false,"description":"Exact company name, matched case-insensitively.","schema":{"type":"string","maxLength":100}},{"name":"state","in":"query","required":false,"description":"Two-letter US region code, such as AZ or CA.","schema":{"type":"string","maxLength":100}},{"name":"domain","in":"query","required":false,"description":"Exact taxonomy domain returned by /v1/facets.","schema":{"type":"string","maxLength":100}},{"name":"specialization","in":"query","required":false,"description":"Exact taxonomy specialization returned by /v1/facets.","schema":{"type":"string","maxLength":100}},{"name":"industry","in":"query","required":false,"description":"Exact taxonomy industry returned by /v1/facets.","schema":{"type":"string","maxLength":100}},{"name":"posted_since","in":"query","required":false,"description":"Inclusive earliest posting date in YYYY-MM-DD format.","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","required":false,"description":"Jobs per response. Defaults to 20; maximum 50.","schema":{"type":"integer","minimum":1,"maximum":50,"default":20}},{"name":"cursor","in":"query","required":false,"description":"Opaque next_cursor from the previous response. Keep all other filters unchanged.","schema":{"type":"string"}}],"responses":{"200":{"description":"A page of matching jobs","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobSearchResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"503":{"$ref":"#/components/responses/DatasetUnavailable"}}}},"/v1/jobs/{job_id}":{"get":{"operationId":"getJob","summary":"Get one job by its stable ID","parameters":[{"name":"job_id","in":"path","required":true,"description":"The complete job ID URL encoded as one path segment.","schema":{"type":"string"}}],"responses":{"200":{"description":"Job details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobDetailResponse"}}}},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/facets":{"get":{"operationId":"listJobFacets","summary":"List valid filter values and current counts","responses":{"200":{"description":"Current filter values","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}}},"components":{"schemas":{"Job":{"type":"object","required":["id","posted_on","company","title","job_link"],"properties":{"id":{"type":"string","format":"uri"},"posted_on":{"type":"string","format":"date"},"company":{"type":"string"},"title":{"type":"string"},"location":{"type":"string"},"location_profile":{"type":"object","additionalProperties":true},"career_bucket":{"type":"string"},"career_bucket_label":{"type":"string"},"experience_level":{"type":"string"},"experience_level_label":{"type":"string"},"yoe_min":{"type":["number","null"]},"yoe_max":{"type":["number","null"]},"experience_display":{"type":"string"},"authorization_category":{"type":"string"},"authorization_category_label":{"type":"string"},"sponsorship_status":{"type":"string"},"work_authorization_display":{"type":"string"},"classification_paths":{"type":"array","items":{"type":"object","additionalProperties":true}},"summary":{"type":"string"},"description_excerpt":{"type":"string"},"job_link":{"type":"string","format":"uri"}}},"JobSearchResponse":{"type":"object","required":["data","pagination","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Job"}},"pagination":{"type":"object","properties":{"limit":{"type":"integer"},"returned":{"type":"integer"},"next_cursor":{"type":["string","null"]}}},"meta":{"type":"object","additionalProperties":true}}},"JobDetailResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Job"},"meta":{"type":"object","additionalProperties":true}}},"StatusResponse":{"type":"object","additionalProperties":true},"ErrorResponse":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"parameter":{"type":"string"}}}}}},"responses":{"BadRequest":{"description":"Invalid or unsupported parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"NotFound":{"description":"Job not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"DatasetUnavailable":{"description":"No validated dataset is active","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}