{"openapi":"3.1.0","info":{"title":"DzalekaPay public integrator API","version":"1.0.0","description":"Unauthenticated payment, campaign, event, storefront, receipt, and content endpoints for DzalekaPay.\nMerchant dashboard and admin APIs are not included. Human docs: https://pay.dzaleka.com/developer\n\n**Versioning.** The current public API version is 1.0.0. Pin it with the optional `API-Version` request header; every response echoes the serving version in the `API-Version` response header. The authenticated merchant API is path-versioned under `/api/v1/`.\n\n**Deprecation.** A surface scheduled for removal is served with the `Deprecation` header (RFC 9745) and a `Sunset` date (RFC 8594), plus a `Link` header with `rel=\"deprecation\"` pointing at the migration note. Removal follows at least 180 days after the Deprecation header first appears. Breaking changes ship as a new version rather than in place; additive fields are not breaking.\n\n**Rate limits.** Responses carry `RateLimit-Limit`, `RateLimit-Remaining`, and `RateLimit-Reset`. A 429 additionally carries `Retry-After`. Self-throttle on those headers rather than on fixed delays.\n\n**Errors.** Every 4xx and 5xx JSON response uses the `Error` schema: branch on `error.code`, show `message` to a person.","contact":{"name":"DzalekaPay support","email":"info@mail.dzaleka.com","url":"https://pay.dzaleka.com/contact"}},"servers":[{"url":"https://pay.dzaleka.com"}],"paths":{"/api/health":{"get":{"operationId":"getApiHealth","summary":"Service health","description":"Unauthenticated liveness document. Use this to confirm DzalekaPay is reachable before calling checkout APIs.","tags":["meta"],"parameters":[{"$ref":"#/components/parameters/ApiVersion"}],"responses":{"200":{"description":"Successful response","headers":{"RateLimit-Limit":{"description":"Requests permitted in the current window.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requests still available in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"API-Version":{"description":"Public API version that served this response.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"description":"Health document","properties":{"status":{"type":"string","enum":["ok"]},"service":{"type":"string"},"time":{"type":"string","format":"date-time"}},"required":["status","service","time"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/api/public/payment-methods":{"get":{"operationId":"getPublicPaymentMethods","summary":"Read collection and payout method availability","description":"Public JSON of which collection and payout methods are currently enabled. No authentication.","tags":["checkout"],"parameters":[{"$ref":"#/components/parameters/ApiVersion"}],"responses":{"200":{"description":"Successful response","headers":{"RateLimit-Limit":{"description":"Requests permitted in the current window.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requests still available in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"API-Version":{"description":"Public API version that served this response.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/api/transactions/checkout":{"post":{"operationId":"createHostedCardCheckout","summary":"Start hosted card checkout","description":"Creates a pending collection and returns a PayChangu hosted checkout URL. Public; no API key. Amount is MWK. May return 404 when the publicCheckout feature is disabled.","tags":["checkout"],"parameters":[{"$ref":"#/components/parameters/ApiVersion"}],"responses":{"201":{"description":"Successful response","headers":{"RateLimit-Limit":{"description":"Requests permitted in the current window.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requests still available in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"API-Version":{"description":"Public API version that served this response.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"description":"Checkout session","properties":{"checkout_url":{"type":"string","format":"uri"},"transactionId":{"type":"string","format":"uuid"}},"required":[]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"description":"Hosted card checkout request","properties":{"merchantId":{"type":"string","format":"uuid"},"amount":{"type":"number","exclusiveMinimum":0},"email":{"type":"string","format":"email"},"first_name":{"type":"string"},"last_name":{"type":"string"}},"required":["merchantId","amount","email"]}}}}}},"/api/public/transactions/{id}/status":{"get":{"operationId":"getPublicTransactionStatus","summary":"Read public transaction status","description":"Poll payment status for a public checkout, donation, ticket, or order. Values include pending, completed, and failed. May return 404 when the publicCheckout feature is disabled.","tags":["checkout"],"parameters":[{"$ref":"#/components/parameters/ApiVersion"},{"name":"id","in":"path","required":true,"description":"Resource UUID or public slug","schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Successful response","headers":{"RateLimit-Limit":{"description":"Requests permitted in the current window.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requests still available in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"API-Version":{"description":"Public API version that served this response.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"description":"Transaction status","properties":{"id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["pending","completed","failed","expired","refunded"]},"amount":{"type":"string"}},"required":["id","status"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/api/public/transactions/{id}/receipt":{"get":{"operationId":"getPublicTransactionReceipt","summary":"Read public receipt metadata","description":"Public receipt fields for a completed or pending collection. Does not expose payer secrets. May return 404 when the publicCheckout feature is disabled.","tags":["checkout"],"parameters":[{"$ref":"#/components/parameters/ApiVersion"},{"name":"id","in":"path","required":true,"description":"Resource UUID or public slug","schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Successful response","headers":{"RateLimit-Limit":{"description":"Requests permitted in the current window.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requests still available in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"API-Version":{"description":"Public API version that served this response.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/api/public/merchants/{merchantId}":{"get":{"operationId":"getPublicMerchantProfile","summary":"Read public merchant profile","description":"Public store name and status for hosted checkout. Does not return balances or owner identity documents. May return 404 when the publicCheckout feature is disabled.","tags":["merchants"],"parameters":[{"$ref":"#/components/parameters/ApiVersion"},{"name":"merchantId","in":"path","required":true,"description":"Merchant UUID","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","headers":{"RateLimit-Limit":{"description":"Requests permitted in the current window.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requests still available in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"API-Version":{"description":"Public API version that served this response.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/api/public/campaigns":{"get":{"operationId":"listPublicCampaigns","summary":"List public fundraising campaigns","description":"Published campaigns that currently accept donations. May return 404 when the publicCheckout feature is disabled.","tags":["campaigns"],"parameters":[{"$ref":"#/components/parameters/ApiVersion"}],"responses":{"200":{"description":"Successful response","headers":{"RateLimit-Limit":{"description":"Requests permitted in the current window.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requests still available in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"API-Version":{"description":"Public API version that served this response.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/api/public/campaigns/{id}":{"get":{"operationId":"getPublicCampaign","summary":"Read public campaign detail","description":"Campaign story, goal, and donation state for a published fundraiser. {id} may be UUID or slug. May return 404 when the publicCheckout feature is disabled.","tags":["campaigns"],"parameters":[{"$ref":"#/components/parameters/ApiVersion"},{"name":"id","in":"path","required":true,"description":"Resource UUID or public slug","schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Successful response","headers":{"RateLimit-Limit":{"description":"Requests permitted in the current window.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requests still available in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"API-Version":{"description":"Public API version that served this response.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/api/public/campaigns/{id}/donations":{"post":{"operationId":"createCampaignDonation","summary":"Start a campaign donation","description":"Creates a pending donation collection. Returns checkout details for the enabled payment method. May return 404 when the publicCheckout feature is disabled.","tags":["campaigns"],"parameters":[{"$ref":"#/components/parameters/ApiVersion"},{"name":"id","in":"path","required":true,"description":"Resource UUID or public slug","schema":{"type":"string","minLength":1}}],"responses":{"201":{"description":"Successful response","headers":{"RateLimit-Limit":{"description":"Requests permitted in the current window.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requests still available in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"API-Version":{"description":"Public API version that served this response.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"description":"Donation request","properties":{"amount":{"type":"number","exclusiveMinimum":0},"donor_name":{"type":"string"},"donor_email":{"type":"string","format":"email"},"donor_phone":{"type":"string"},"message":{"type":"string"},"anonymous":{"type":"boolean"}},"required":["amount"]}}}}}},"/api/public/events":{"get":{"operationId":"listPublicEvents","summary":"List public events","description":"Published events that currently sell tickets. May return 404 when the publicCheckout feature is disabled.","tags":["events"],"parameters":[{"$ref":"#/components/parameters/ApiVersion"}],"responses":{"200":{"description":"Successful response","headers":{"RateLimit-Limit":{"description":"Requests permitted in the current window.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requests still available in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"API-Version":{"description":"Public API version that served this response.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/api/public/events/{id}":{"get":{"operationId":"getPublicEvent","summary":"Read public event detail","description":"Event description, ticket tiers, and availability. May return 404 when the publicCheckout feature is disabled.","tags":["events"],"parameters":[{"$ref":"#/components/parameters/ApiVersion"},{"name":"id","in":"path","required":true,"description":"Resource UUID or public slug","schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Successful response","headers":{"RateLimit-Limit":{"description":"Requests permitted in the current window.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requests still available in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"API-Version":{"description":"Public API version that served this response.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/api/public/events/{id}/tickets":{"post":{"operationId":"createEventTicketPurchase","summary":"Start an event ticket purchase","description":"Creates a pending ticket collection for one or more seats in a tier. May return 404 when the publicCheckout feature is disabled.","tags":["events"],"parameters":[{"$ref":"#/components/parameters/ApiVersion"},{"name":"id","in":"path","required":true,"description":"Resource UUID or public slug","schema":{"type":"string","minLength":1}}],"responses":{"201":{"description":"Successful response","headers":{"RateLimit-Limit":{"description":"Requests permitted in the current window.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requests still available in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"API-Version":{"description":"Public API version that served this response.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"description":"Ticket purchase request","properties":{"tierId":{"type":"string","format":"uuid"},"quantity":{"type":"integer","minimum":1},"buyer_email":{"type":"string","format":"email"},"buyer_name":{"type":"string"},"buyer_phone":{"type":"string"}},"required":["tierId","quantity"]}}}}}},"/api/public/tickets/{id}":{"get":{"operationId":"getPublicTicket","summary":"Read public ticket details","description":"Ticket validity follows the backing payment. Completed tickets can be shown at the gate.","tags":["events"],"parameters":[{"$ref":"#/components/parameters/ApiVersion"},{"name":"id","in":"path","required":true,"description":"Resource UUID or public slug","schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Successful response","headers":{"RateLimit-Limit":{"description":"Requests permitted in the current window.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requests still available in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"API-Version":{"description":"Public API version that served this response.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/api/public/storefronts/{slug}":{"get":{"operationId":"getPublicStorefront","summary":"Read public storefront","description":"Public catalog for a merchant storefront identified by slug. May return 404 when the publicCheckout feature is disabled.","tags":["storefronts"],"parameters":[{"$ref":"#/components/parameters/ApiVersion"},{"name":"slug","in":"path","required":true,"description":"Public URL slug","schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Successful response","headers":{"RateLimit-Limit":{"description":"Requests permitted in the current window.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requests still available in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"API-Version":{"description":"Public API version that served this response.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/api/public/storefronts/{slug}/orders":{"post":{"operationId":"createStorefrontOrder","summary":"Start a storefront order","description":"Creates a pending order collection for a published product. May return 404 when the publicCheckout feature is disabled.","tags":["storefronts"],"parameters":[{"$ref":"#/components/parameters/ApiVersion"},{"name":"slug","in":"path","required":true,"description":"Public URL slug","schema":{"type":"string","minLength":1}}],"responses":{"201":{"description":"Successful response","headers":{"RateLimit-Limit":{"description":"Requests permitted in the current window.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requests still available in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"API-Version":{"description":"Public API version that served this response.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"description":"Storefront order request","properties":{"productId":{"type":"string","format":"uuid"},"quantity":{"type":"integer","minimum":1},"customer_email":{"type":"string","format":"email"},"customer_name":{"type":"string"},"customer_phone":{"type":"string"},"note":{"type":"string"}},"required":["productId","quantity"]}}}}}},"/api/public/blog-posts":{"get":{"operationId":"listPublicBlogPosts","summary":"List public blog posts","description":"Published DzalekaPay blog posts.","tags":["content"],"parameters":[{"$ref":"#/components/parameters/ApiVersion"}],"responses":{"200":{"description":"Successful response","headers":{"RateLimit-Limit":{"description":"Requests permitted in the current window.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requests still available in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"API-Version":{"description":"Public API version that served this response.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/api/public/blog-posts/{slug}":{"get":{"operationId":"getPublicBlogPost","summary":"Read public blog post","description":"A published blog post body and metadata.","tags":["content"],"parameters":[{"$ref":"#/components/parameters/ApiVersion"},{"name":"slug","in":"path","required":true,"description":"Public URL slug","schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Successful response","headers":{"RateLimit-Limit":{"description":"Requests permitted in the current window.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requests still available in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"API-Version":{"description":"Public API version that served this response.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}}}}},"x-browser-entrypoints":[{"url":"https://pay.dzaleka.com/pay/{merchantId}","method":"GET","summary":"Hosted payment page for a merchant","description":"HTML checkout page for a registered store. Displays currently enabled collection methods. Payers do not need an account.","mediaType":"text/html","note":"Human checkout page rendered by the web app. Send a person here; it does not return JSON."}],"x-api-lifecycle":{"version":"1.0.0","versioningScheme":"header","versionHeader":"API-Version","pathVersionedSurfaces":["/api/v1/"],"deprecationHeaders":["Deprecation","Sunset"],"minimumSunsetNoticeDays":180,"policyUrl":"https://pay.dzaleka.com/developer#api-lifecycle"},"components":{"schemas":{"Error":{"type":"object","additionalProperties":true,"description":"Typed error envelope returned by every 4xx and 5xx JSON response.","properties":{"message":{"type":"string","description":"Human-readable summary, safe to show a person."},"error":{"type":"object","additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable code. Branch on this, not on the message text.","enum":["bad_request","unauthorized","forbidden","not_found","conflict","rate_limited","provider_unconfirmed","internal_error"]},"message":{"type":"string"},"hint":{"type":"string","description":"Where to look next: docs or spec URL."}},"required":["code","message"]}},"required":["message","error"]}},"parameters":{"ApiVersion":{"name":"API-Version","in":"header","required":false,"description":"Pin the public API version. Omit to receive the current version (1.0.0). An unknown value is ignored rather than rejected.","schema":{"type":"string","default":"1.0.0"}}},"responses":{"BadRequest":{"description":"Validation or business-rule error.","headers":{"RateLimit-Limit":{"description":"Requests permitted in the current window.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requests still available in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"API-Version":{"description":"Public API version that served this response.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Unauthorized":{"description":"Missing or invalid credentials.","headers":{"RateLimit-Limit":{"description":"Requests permitted in the current window.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requests still available in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"API-Version":{"description":"Public API version that served this response.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"NotFound":{"description":"Record not found, or the feature is disabled for this platform.","headers":{"RateLimit-Limit":{"description":"Requests permitted in the current window.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requests still available in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"API-Version":{"description":"Public API version that served this response.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"RateLimited":{"description":"Too many requests. Wait for `Retry-After` seconds before retrying.","headers":{"RateLimit-Limit":{"description":"Requests permitted in the current window.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requests still available in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"API-Version":{"description":"Public API version that served this response.","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before the next request.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"ServerError":{"description":"Unexpected server error. Retry with backoff.","headers":{"RateLimit-Limit":{"description":"Requests permitted in the current window.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requests still available in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"API-Version":{"description":"Public API version that served this response.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}