{"openapi":"3.1.0","info":{"title":"GULERS & PARTNERS Public Content API","summary":"Read-only legal-content API for agents and developers","description":"GULERS & PARTNERS is an Istanbul-based law firm providing bilingual legal services in Turkish and English. The firm advises Turkish and international clients on corporate and commercial matters, mergers and acquisitions, employment and social security, personal data protection (KVKK/GDPR), insurance, real estate, tax, and dispute resolution, with a strategic network in the Netherlands and the United States.","version":"1.0.0","contact":{"name":"GULERS & PARTNERS","email":"info@gulers.av.tr","url":"https://www.gulerspartners.com/developers"}},"servers":[{"url":"https://www.gulerspartners.com/api/v1","description":"Production"},{"url":"https://www.gulerspartners.com/api/v1","description":"Sandbox (API key gp_sandbox_readonly)"}],"security":[{"sandboxApiKey":[]},{}],"tags":[{"name":"Content","description":"Public legal-content resources"}],"paths":{"/health":{"get":{"tags":["Content"],"summary":"Health check","description":"Confirms that the GULERS & PARTNERS public content API is available.","operationId":"getHealth","responses":{"200":{"description":"Service is available","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}}},"401":{"description":"Invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/practice-areas":{"get":{"tags":["Content"],"summary":"List practice areas","description":"Returns the firm's legal practice areas in the requested language.","operationId":"listPracticeAreas","parameters":[{"name":"locale","in":"query","required":false,"schema":{"type":"string","enum":["en","tr"],"default":"en"},"description":"Response language"}],"responses":{"200":{"description":"Practice area list","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PracticeAreaList"}}}},"401":{"description":"Invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/team":{"get":{"tags":["Content"],"summary":"List attorneys and team members","description":"Returns public profiles for attorneys and other firm professionals.","operationId":"listTeam","parameters":[{"name":"locale","in":"query","required":false,"schema":{"type":"string","enum":["en","tr"],"default":"en"},"description":"Response language"}],"responses":{"200":{"description":"Team list","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TeamList"}}}},"401":{"description":"Invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/publications":{"get":{"tags":["Content"],"summary":"List publications","description":"Returns the firm's published legal articles and insights.","operationId":"listPublications","parameters":[{"name":"locale","in":"query","required":false,"schema":{"type":"string","enum":["en","tr"],"default":"en"},"description":"Response language"}],"responses":{"200":{"description":"Publication list","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicationList"}}}},"401":{"description":"Invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/contact":{"get":{"tags":["Content"],"summary":"Firm contact details","description":"Returns verified firm contact details, office hours, and canonical resource URLs.","operationId":"getContact","parameters":[{"name":"locale","in":"query","required":false,"schema":{"type":"string","enum":["en","tr"],"default":"en"},"description":"Response language"}],"responses":{"200":{"description":"Contact payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContactResponse"}}}},"401":{"description":"Invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/openapi.json":{"get":{"tags":["Content"],"summary":"OpenAPI document","description":"Returns this OpenAPI 3.1 document for automatic API discovery.","operationId":"getOpenApi","responses":{"200":{"description":"OpenAPI 3.1 specification","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}},"components":{"securitySchemes":{"sandboxApiKey":{"type":"http","scheme":"bearer","description":"Sandbox key: gp_sandbox_readonly. GET endpoints are also public without a key."}},"schemas":{"HealthResponse":{"type":"object","required":["ok","service","sandbox"],"properties":{"ok":{"type":"boolean"},"service":{"type":"string"},"sandbox":{"type":"boolean"}}},"PracticeArea":{"type":"object","required":["name","slug","url","summary"],"properties":{"name":{"type":"string"},"slug":{"type":"string"},"url":{"type":"string","format":"uri"},"summary":{"type":"string"}}},"TeamMember":{"type":"object","required":["name","title","slug","url"],"properties":{"name":{"type":"string"},"title":{"type":"string"},"slug":{"type":"string"},"url":{"type":"string","format":"uri"},"email":{"type":"string","format":"email"},"linkedin":{"type":"string","format":"uri"}}},"Publication":{"type":"object","required":["title","slug","url"],"properties":{"title":{"type":"string"},"slug":{"type":"string"},"url":{"type":"string","format":"uri"},"excerpt":{"type":"string"},"date":{"type":"string","format":"date"},"author":{"type":"string"},"category":{"type":"string"}}},"PracticeAreaList":{"type":"object","required":["firm","locale","count","items"],"properties":{"firm":{"type":"string"},"locale":{"type":"string","enum":["en","tr"]},"count":{"type":"integer","minimum":0},"items":{"type":"array","items":{"$ref":"#/components/schemas/PracticeArea"}}}},"TeamList":{"type":"object","required":["firm","locale","count","items"],"properties":{"firm":{"type":"string"},"locale":{"type":"string","enum":["en","tr"]},"count":{"type":"integer","minimum":0},"items":{"type":"array","items":{"$ref":"#/components/schemas/TeamMember"}}}},"PublicationList":{"type":"object","required":["firm","locale","count","items"],"properties":{"firm":{"type":"string"},"locale":{"type":"string","enum":["en","tr"]},"count":{"type":"integer","minimum":0},"items":{"type":"array","items":{"$ref":"#/components/schemas/Publication"}}}},"ContactResponse":{"type":"object","required":["firm","description","email","telephone","address","urls"],"properties":{"firm":{"type":"string"},"description":{"type":"string"},"email":{"type":"string","format":"email"},"telephone":{"type":"string"},"telephoneDisplay":{"type":"string"},"address":{"type":"string"},"directionsUrl":{"type":"string","format":"uri"},"linkedinUrl":{"type":"string","format":"uri"},"urls":{"type":"object","additionalProperties":{"type":"string","format":"uri"}},"hours":{"type":"object","properties":{"days":{"type":"array","items":{"type":"string"}},"opens":{"type":"string"},"closes":{"type":"string"},"timeZone":{"type":"string"}}},"languages":{"type":"array","items":{"type":"string"}}}},"ErrorResponse":{"type":"object","required":["error","message","resolution"],"properties":{"error":{"type":"string"},"message":{"type":"string"},"resolution":{"type":"string"}}}}},"externalDocs":{"description":"GULERS & PARTNERS developer portal and CLI (gulerspartners)","url":"https://www.gulerspartners.com/developers"}}