{"openapi":"3.1.0","jsonSchemaDialect":"https://json-schema.org/draft/2020-12/schema","info":{"title":"Mahkamaty Public Agent API","version":"1.0.0","description":"A read-only discovery API for agents that need an authoritative summary of Mahkamaty and its public services. This contract does not provide access to private cases, accounts, consultations, or payment data.","contact":{"name":"Mahkamaty Support","url":"https://mahkamaty.com/ar-ma/contact","email":"admin@mahkamaty.com"},"license":{"name":"Mahkamaty API Terms","url":"https://mahkamaty.com/ar-ma/terms-and-privacy-policy"}},"security":[],"servers":[{"url":"https://mahkamaty.com","description":"Production"}],"tags":[{"name":"Discovery","description":"Public information about Mahkamaty and its services."}],"paths":{"/api/agent/v1/site":{"get":{"operationId":"getMahkamatySite","summary":"Get Mahkamaty public service information","description":"Returns an authoritative, read-only summary of the platform, supported languages, service areas, public services, and machine-readable discovery files.","tags":["Discovery"],"responses":{"200":{"description":"Mahkamaty public service information.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentSiteDocument"},"example":{"schemaVersion":"1.0.0","name":"Mahkamaty","alternateNames":["محكمتي","Mahkamaty Maroc","محكمتي المغرب"],"description":"Mahkamaty is a private legal services platform for Morocco and the MENA region. It helps people monitor Moroccan court files, receive case alerts, find courts, and request legal consultations. Mahkamaty is not the Moroccan government court portal.","url":"https://mahkamaty.com","languages":["ar","fr","en"],"serviceAreas":["Morocco","Saudi Arabia","United Arab Emirates","Egypt"],"services":[{"id":"morocco-court-case-tracking","name":"Morocco court case tracking","description":"Search for a Moroccan court file and activate monitoring for later hearings, decisions, appeals, and other recorded changes.","url":"https://mahkamaty.com/ar-ma/e-services/cases"},{"id":"legal-consultations","name":"Online legal consultations","description":"Ask a legal question and select a public community answer or a paid review by a legal expert.","url":"https://mahkamaty.com/ar-ma/new"},{"id":"morocco-court-directory","name":"Morocco court directory","description":"Browse supported Moroccan courts and their public case-tracking pages.","url":"https://mahkamaty.com/ar-ma/e-services/cases/courts"}],"machineReadable":{"openApi":"https://mahkamaty.com/openapi.json","robots":"https://mahkamaty.com/robots.txt","sitemap":"https://mahkamaty.com/sitemaps/sitemap_index.xml"}}}}},"405":{"$ref":"#/components/responses/MethodNotAllowed"}}}}},"components":{"schemas":{"AgentService":{"type":"object","additionalProperties":false,"required":["id","name","description","url"],"properties":{"id":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"description":{"type":"string","minLength":1},"url":{"type":"string","format":"uri"}}},"MachineReadableLinks":{"type":"object","additionalProperties":false,"required":["openApi","robots","sitemap"],"properties":{"openApi":{"type":"string","format":"uri"},"robots":{"type":"string","format":"uri"},"sitemap":{"type":"string","format":"uri"}}},"AgentSiteDocument":{"type":"object","additionalProperties":false,"required":["schemaVersion","name","alternateNames","description","url","languages","serviceAreas","services","machineReadable"],"properties":{"schemaVersion":{"type":"string","const":"1.0.0"},"name":{"type":"string","const":"Mahkamaty"},"alternateNames":{"type":"array","minItems":1,"items":{"type":"string","minLength":1}},"description":{"type":"string","minLength":1},"url":{"type":"string","format":"uri"},"languages":{"type":"array","minItems":1,"items":{"type":"string","pattern":"^[a-z]{2}$"}},"serviceAreas":{"type":"array","minItems":1,"items":{"type":"string","minLength":1}},"services":{"type":"array","minItems":1,"items":{"$ref":"#/components/schemas/AgentService"}},"machineReadable":{"$ref":"#/components/schemas/MachineReadableLinks"}}},"AgentErrorResponse":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message","resolution"],"properties":{"code":{"type":"string","enum":["API_ENDPOINT_NOT_FOUND","METHOD_NOT_ALLOWED"]},"message":{"type":"string","minLength":1},"resolution":{"type":"string","minLength":1}}}}}},"responses":{"MethodNotAllowed":{"description":"The HTTP method is not supported by this endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentErrorResponse"},"example":{"error":{"code":"METHOD_NOT_ALLOWED","message":"This endpoint supports GET and HEAD only.","resolution":"Retry the request with GET, or read the operation in https://mahkamaty.com/openapi.json."}}}}}}}}