{"openapi":"3.1.0","info":{"title":"hire.bid API","version":"1.0.0","description":"Post local work and see price bids from verified workers (India first). Public reads need no key and never include contact numbers. Posting for a person needs their key from https://hire.bid/me/ai."},"servers":[{"url":"https://hire.bid"}],"components":{"securitySchemes":{"key":{"type":"http","scheme":"bearer"}}},"paths":{"/api/v1/categories":{"get":{"operationId":"listCategories","summary":"Kinds of work","responses":{"200":{"description":"OK"}}}},"/api/v1/requests":{"get":{"operationId":"searchRequests","summary":"Search open work requests","parameters":[{"name":"q","in":"query","schema":{"type":"string"}},{"name":"category","in":"query","schema":{"type":"string"}},{"name":"pincode","in":"query","schema":{"type":"string"}},{"name":"city","in":"query","schema":{"type":"string"}},{"name":"state","in":"query","schema":{"type":"string"}},{"name":"country","in":"query","schema":{"type":"string"}},{"name":"page","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}}},"post":{"operationId":"postRequest","summary":"Post a request for the key owner (checked by a person before it is live)","security":[{"key":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"category":{"type":"string","enum":["painting","waterproofing","carpentry","plumbing","electrical","tiling","civil","ac","cleaning","pest","interior","shifting","other"],"description":"painting = Painting; waterproofing = Waterproofing & leakage; carpentry = Carpentry & furniture; plumbing = Plumbing; electrical = Electrical; tiling = Tiling & flooring; civil = Renovation & civil work; ac = AC & appliance repair; cleaning = Cleaning; pest = Pest control; interior = Interior design; shifting = Packers & movers; other = Other work"},"title":{"type":"string","description":"Short title, e.g. \"Paint 2BHK flat, inside walls\" (8–90 characters)."},"description":{"type":"string","description":"What needs doing, in plain words. No phone numbers or links."},"pincode":{"type":"string","description":"Indian 6-digit PIN code (or the first 3 digits to search an area)."},"city":{"type":"string","description":"Required outside India."},"locality":{"type":"string","description":"Area or locality (optional)."},"country":{"type":"string","description":"ISO country code, default IN.","enum":["IN","AE","SA","QA","OM","KW","BH","US","GB","CA","AU","NZ","SG","MY","DE","IE","NP","LK","BD"]},"size":{"type":"string","description":"Optional, e.g. \"2 BHK\", \"1,200 sq ft\"."},"start":{"type":"string","enum":["asap","week","month","flexible"]},"budget":{"type":"integer","description":"Optional budget in local currency."},"phone":{"type":"string"},"agent_name":{"type":"string"}},"required":["category","title","description","phone"]}}}},"responses":{"200":{"description":"OK"}}}},"/api/v1/requests/{id}":{"get":{"operationId":"getRequest","summary":"One open request","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/workers":{"get":{"operationId":"searchWorkers","summary":"Verified workers","parameters":[{"name":"trade","in":"query","schema":{"type":"string"}},{"name":"pincode","in":"query","schema":{"type":"string"}},{"name":"city","in":"query","schema":{"type":"string"}},{"name":"state","in":"query","schema":{"type":"string"}},{"name":"country","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/pincode/{pincode}":{"get":{"operationId":"lookupPincode","summary":"Indian PIN code → state, district, localities","parameters":[{"name":"pincode","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/draft":{"post":{"operationId":"prepareRequest","summary":"Ready-filled post link the person submits themselves (no key, nothing stored)","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"category":{"type":"string","enum":["painting","waterproofing","carpentry","plumbing","electrical","tiling","civil","ac","cleaning","pest","interior","shifting","other"],"description":"painting = Painting; waterproofing = Waterproofing & leakage; carpentry = Carpentry & furniture; plumbing = Plumbing; electrical = Electrical; tiling = Tiling & flooring; civil = Renovation & civil work; ac = AC & appliance repair; cleaning = Cleaning; pest = Pest control; interior = Interior design; shifting = Packers & movers; other = Other work"},"title":{"type":"string","description":"Short title, e.g. \"Paint 2BHK flat, inside walls\" (8–90 characters)."},"description":{"type":"string","description":"What needs doing, in plain words. No phone numbers or links."},"pincode":{"type":"string","description":"Indian 6-digit PIN code (or the first 3 digits to search an area)."},"city":{"type":"string","description":"Required outside India."},"locality":{"type":"string","description":"Area or locality (optional)."},"country":{"type":"string","description":"ISO country code, default IN.","enum":["IN","AE","SA","QA","OM","KW","BH","US","GB","CA","AU","NZ","SG","MY","DE","IE","NP","LK","BD"]},"size":{"type":"string","description":"Optional, e.g. \"2 BHK\", \"1,200 sq ft\"."},"start":{"type":"string","enum":["asap","week","month","flexible"]},"budget":{"type":"integer","description":"Optional budget in local currency."}},"required":["category","title","description"]}}}},"responses":{"200":{"description":"OK"}}}},"/api/v1/me/requests":{"get":{"operationId":"myRequests","summary":"The key owner’s requests and status","security":[{"key":[]}],"responses":{"200":{"description":"OK"}}}},"/api/v1/me/requests/{id}":{"get":{"operationId":"requestStatus","summary":"Status and bids","security":[{"key":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"}}},"delete":{"operationId":"deleteRequest","summary":"Delete a request","security":[{"key":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/me/requests/{id}/close":{"post":{"operationId":"closeRequest","summary":"Stop new bids","security":[{"key":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"}}}}}}