{"openapi":"3.1.1","info":{"title":"Pradiota Developer Public Metadata Playground","version":"1.0.0","description":"Anonymous, read-only examples backed by the public MIGHTY geography catalog. A hard limit of 600 requests per minute applies per connected Core peer, per instance. A best-effort 30 requests per minute limit also applies when a client address is reported; individual address enforcement depends on the edge supplying a trusted address. This playground does not grant access to tenant data or provide a provider-backed sandbox. Gated developer capability families and their approval states are unaffected."},"servers":[{"url":"https://www.pradiota.com"}],"security":[],"paths":{"/sandbox/demo/v1/geo/states":{"get":{"operationId":"listPlaygroundStates","summary":"List public Indian state and union territory metadata","description":"Reads MIGHTY's public LGD geography catalog. Response examples are static illustrations; counts may change as the catalog is updated.","x-mighty":{"availability":"PUBLIC_METADATA_DEMO","owner":"MIGHTY Geo","source":"Local Government Directory (LGD) - Sub-Districts","authentication":"ANONYMOUS","scope":"NONE","sideEffects":"NONE","idempotent":true,"rateLimit":"600/min per connected Core peer; best-effort 30/min per reported client address","developerGrantRequired":false},"responses":{"200":{"description":"Published state catalog","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StatesResponse"},"examples":{"staticExample":{"summary":"Static example","description":"Illustrative response shape, not a current-count guarantee.","value":{"contract":"mighty.geo.admin-divisions.v1","source":"Local Government Directory (LGD) - Sub-Districts","sourceRef":"https://www.data.gov.in/resource/local-government-directory-lgd-sub-districts","fallbackUsed":false,"states":[{"code":"AP","lgdCode":"28","name":"Andhra Pradesh","districtCount":27,"mandalCount":679}]}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"403":{"$ref":"#/components/responses/Denied"},"429":{"$ref":"#/components/responses/RateLimited"},"502":{"$ref":"#/components/responses/UpstreamUnavailable"},"default":{"$ref":"#/components/responses/UpstreamUnavailable"}}}},"/sandbox/demo/v1/geo/districts":{"get":{"operationId":"listPlaygroundDistricts","summary":"List public districts in a state","description":"Accepts one two-letter state code and reads MIGHTY's public LGD geography catalog. Response examples are static illustrations; contents may change with the catalog.","x-mighty":{"availability":"PUBLIC_METADATA_DEMO","owner":"MIGHTY Geo","source":"Local Government Directory (LGD) - Sub-Districts","authentication":"ANONYMOUS","scope":"NONE","sideEffects":"NONE","idempotent":true,"rateLimit":"600/min per connected Core peer; best-effort 30/min per reported client address","developerGrantRequired":false},"parameters":[{"name":"state","in":"query","required":true,"description":"Two-letter state code; lowercase input is normalized to uppercase.","schema":{"type":"string","pattern":"^[A-Za-z]{2}$","minLength":2,"maxLength":2},"example":"AP"}],"responses":{"200":{"description":"Published district catalog for the selected state","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DistrictsResponse"},"examples":{"staticExample":{"summary":"Static example","description":"Illustrative response shape, not a current district list.","value":{"contract":"mighty.geo.admin-divisions.v1","source":"Local Government Directory (LGD) - Sub-Districts","sourceRef":"https://www.data.gov.in/resource/local-government-directory-lgd-sub-districts","fallbackUsed":false,"state":"Andhra Pradesh","districts":[{"code":"745","name":"Alluri Sitharama Raju","mandalCount":22}]}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"403":{"$ref":"#/components/responses/Denied"},"429":{"$ref":"#/components/responses/RateLimited"},"502":{"$ref":"#/components/responses/UpstreamUnavailable"},"default":{"$ref":"#/components/responses/UpstreamUnavailable"}}}},"/sandbox/demo/v1/openapi.json":{"get":{"operationId":"getPlaygroundOpenApi","summary":"Read this playground's OpenAPI contract","description":"Returns this public, self-hosted OpenAPI 3.1.1 document; it does not grant access to other MIGHTY service families.","x-mighty":{"availability":"PUBLIC_METADATA_DEMO","owner":"MIGHTY Developers","authentication":"ANONYMOUS","scope":"NONE","sideEffects":"NONE","idempotent":true,"rateLimit":"600/min per connected Core peer; best-effort 30/min per reported client address","developerGrantRequired":false},"responses":{"200":{"description":"OpenAPI 3.1.1 document","content":{"application/json":{"schema":{"type":"object","required":["openapi","info","paths"],"properties":{"openapi":{"type":"string","const":"3.1.1"},"info":{"type":"object"},"paths":{"type":"object"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"403":{"$ref":"#/components/responses/Denied"},"429":{"$ref":"#/components/responses/RateLimited"}}}}},"components":{"schemas":{"CatalogMetadata":{"type":"object","required":["contract"],"properties":{"contract":{"type":"string","const":"mighty.geo.admin-divisions.v1"},"source":{"type":"string"},"sourceRef":{"type":"string","format":"uri"},"sourceUpdatedAt":{"type":"string"},"fallbackUsed":{"type":"boolean"}}},"State":{"type":"object","additionalProperties":false,"required":["code","name","districtCount","mandalCount"],"properties":{"code":{"type":"string"},"lgdCode":{"type":"string"},"name":{"type":"string"},"districtCount":{"type":"integer","minimum":0},"mandalCount":{"type":"integer","minimum":0}}},"District":{"type":"object","additionalProperties":false,"required":["code","name","mandalCount"],"properties":{"code":{"type":"string"},"name":{"type":"string"},"mandalCount":{"type":"integer","minimum":0}}},"StatesResponse":{"allOf":[{"$ref":"#/components/schemas/CatalogMetadata"},{"type":"object","required":["states"],"properties":{"states":{"type":"array","maxItems":64,"items":{"$ref":"#/components/schemas/State"}}}}]},"DistrictsResponse":{"allOf":[{"$ref":"#/components/schemas/CatalogMetadata"},{"type":"object","required":["state","districts"],"properties":{"state":{"type":"string"},"districts":{"type":"array","maxItems":256,"items":{"$ref":"#/components/schemas/District"}}}}]}},"responses":{"BadRequest":{"description":"The request query or body is not supported.","content":{"application/json":{"example":{"status":"INVALID_PLAYGROUND_REQUEST"},"schema":{"type":"object","additionalProperties":false,"required":["status"],"properties":{"status":{"type":"string","const":"INVALID_PLAYGROUND_REQUEST"}}}}}},"Denied":{"description":"The public route policy denied this request.","content":{"application/json":{"example":{"status":"PLAYGROUND_REQUEST_DENIED"},"schema":{"type":"object","additionalProperties":false,"required":["status"],"properties":{"status":{"type":"string","const":"PLAYGROUND_REQUEST_DENIED"}}}}}},"RateLimited":{"description":"The 600/min Core peer limit or best-effort 30/min reported client address limit was exceeded.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"example":{"status":"PLAYGROUND_RATE_LIMITED"},"schema":{"type":"object","additionalProperties":false,"required":["status"],"properties":{"status":{"type":"string","const":"PLAYGROUND_RATE_LIMITED"}}}}}},"UpstreamUnavailable":{"description":"The upstream status is preserved for HTTP errors. A transport or invalid catalog response yields 502.","content":{"application/json":{"example":{"status":"PLAYGROUND_UPSTREAM_UNAVAILABLE"},"schema":{"type":"object","additionalProperties":false,"required":["status"],"properties":{"status":{"type":"string","const":"PLAYGROUND_UPSTREAM_UNAVAILABLE"}}}}}}}}}