Let's Pizza Developersv1.0.0

API reference

API reference

This reference is generated from the same OpenAPI document the API builds, so it matches what actually runs. Its technical texts are in English, as in the document.

Base URL and version#

Every path starts with /partner/v1 on your environment's base URL. Environments

{baseUrl} — The base address given with your keys (sandbox or production).

Authentication#

partnerKey · http bearer — A partner key: `lpk_test_…` (sandbox) or `lpk_live_…` (production).

Keys and scopes

Endpoints#

Branches

Let's Pizza branches as the key may see them (hours and zones stay in the Let's Pizza console).

Sandbox

Tools that exist on the sandbox only: test orders.

About the document#

The one API every outside system uses to work with Let's Pizza: ERPs, POS and kitchen systems, delivery fleets, marketplaces, accounting and analytics.

Authentication. Authorization: Bearer <key>. Keys are issued by Let’s Pizza per partner and environment: lpk_test_… works on the sandbox only, lpk_live_… on production only. Each key carries scopes, optionally a list of branches and of allowed addresses, a rate and an end date.

Conventions. JSON in UTF-8. Money is integer halalas (1 riyal = 100), VAT-inclusive. Texts are {ar, en}. Times are ISO 8601 with an offset. Every answer carries X-Request-Id; authenticated answers carry RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset. Writes require an Idempotency-Key header: a repeat with the same key and body returns the first answer.

Errors. Every refusal is a PartnerError: a stable code, a message in Arabic and English, the offending field, retryable (true only for 408/429/5xx) and the requestId.