Let's Pizza Developersv1.0.0

API reference

Reports

Your day as Let’s Pizza counts it, and the daily reconciliation.

GETYour day per branch#

GET/partner/v1/reports/daily

Scope reports:read. Your orders created on a Riyadh calendar day (00:00–24:00 +03:00) at the branches your key may see: per branch how many, served (delivered or picked up), ended unserved, still open, the served total and refunds (halalas, VAT-inclusive); and the served orders with your order numbers. Use it every morning for the day before.

Authentication
Partner key in the Authorization header
Scopes required
reports:read
curl -sS "$LP_BASE_URL/partner/v1/reports/daily?date=string" \
  -H "Authorization: Bearer $LP_API_KEY"

Parameters

NameInTypeDescription
date *querystring
branchIdquerystring

Responses

200OKPartnerDailyReport

Headers

NameTypeDescription
X-Request-IdstringThe id of this request: quote it to support. Send your own (8–64 of A-Z a-z 0-9 . _ -) to trace a call end to end.
RateLimit-LimitintegerThe key's requests per minute.
RateLimit-RemainingintegerRequests left in the current minute.
RateLimit-ResetintegerSeconds until the minute window resets.

Schema

  • datestringrequired
  • branchesPartnerDayBranch[]required
    Child attributes (8)
    • branchIdstringrequired

      length 1 – 64

    • externalCodestringrequirednullable
    • ordersintegerrequired

      value ≥ 0

    • servedintegerrequired

      value ≥ 0

    • endedintegerrequired

      value ≥ 0

    • openintegerrequired

      value ≥ 0

    • servedTotalintegerrequired

      Amount in halalas (1 riyal = 100), VAT-inclusive

      value ≥ 0

    • refundedintegerrequired

      Amount in halalas (1 riyal = 100), VAT-inclusive

      value ≥ 0

  • ordersobject[]required
    Child attributes (7)
    • orderIdstringrequired

      length 1 – 64

    • numberstringrequired
    • branchIdstringrequired

      length 1 – 64

    • statusstringrequired

      Values: "pending_payment""payment_failed""placed""accepted""preparing""ready""out_for_delivery""delivered""picked_up""cancelled""rejected""delivery_failed""not_collected"

    • totalintegerrequired

      Amount in halalas (1 riyal = 100), VAT-inclusive

      value ≥ 0

    • externalOrderNostringrequirednullable
    • createdAtstring<date-time>required
400INVALID_REQUEST (field: date)PartnerError

Headers

NameTypeDescription
X-Request-IdstringThe id of this request: quote it to support. Send your own (8–64 of A-Z a-z 0-9 . _ -) to trace a call end to end.
401UNAUTHENTICATED (no key, a wrong or revoked one), KEY_EXPIRED, KEY_ENVIRONMENT_MISMATCH (a test key on production or the other way round)PartnerError

Headers

NameTypeDescription
X-Request-IdstringThe id of this request: quote it to support. Send your own (8–64 of A-Z a-z 0-9 . _ -) to trace a call end to end.
403PARTNER_SUSPENDED, IP_NOT_ALLOWED, SCOPE_REQUIRED (detail.required lists the scopes), BRANCH_NOT_ALLOWEDPartnerError

Headers

NameTypeDescription
X-Request-IdstringThe id of this request: quote it to support. Send your own (8–64 of A-Z a-z 0-9 . _ -) to trace a call end to end.
429RATE_LIMITED: wait Retry-After seconds (also in detail.retryAfterSeconds)PartnerError

Headers

NameTypeDescription
X-Request-IdstringThe id of this request: quote it to support. Send your own (8–64 of A-Z a-z 0-9 . _ -) to trace a call end to end.
500INTERNAL_ERROR: retryable; quote the X-Request-Id if it persistsPartnerError

Headers

NameTypeDescription
X-Request-IdstringThe id of this request: quote it to support. Send your own (8–64 of A-Z a-z 0-9 . _ -) to trace a call end to end.

Example response

200 · PartnerDailyReport
{
  "date": "string",
  "branches": [
    {
      "branchId": "28",
      "externalCode": "STORE-28",
      "orders": 0,
      "served": 0,
      "ended": 0,
      "open": 0,
      "servedTotal": 0,
      "refunded": 0
    }
  ],
  "orders": [
    {
      "orderId": "7f3a2c10-5b8e-4d21-9c47-1a2b3c4d5e01",
      "number": "261119-0041",
      "branchId": "28",
      "status": "pending_payment",
      "total": 0,
      "externalOrderNo": "string",
      "createdAt": "2026-11-19T19:30:12+03:00"
    }
  ]
}

POSTCompare your count of a day with ours#

POST/partner/v1/reports/reconciliation

Scope reports:read. Send your served count and total per branch (and, best, your order numbers): the answer says per branch whether they match, which of your numbers we do not know, and which of our served orders you did not list. Nothing is stored.

Authentication
Partner key in the Authorization header
Scopes required
reports:read
curl -sS -X POST "$LP_BASE_URL/partner/v1/reports/reconciliation" \
  -H "Authorization: Bearer $LP_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "date": "string",
  "branches": [
    {
      "branchId": "28",
      "served": 0,
      "servedTotal": 0,
      "externalOrderNos": [
        "string"
      ]
    }
  ]
}'

Request body PartnerReconciliationRequest

  • datestringrequired
  • branchesobject[]required

    items 1 – 200

    Child attributes (4)
    • branchIdstringrequired

      length 1 – 64

    • servedintegerrequired

      value ≥ 0

    • servedTotalintegerrequired

      Amount in halalas (1 riyal = 100), VAT-inclusive

      value ≥ 0

    • externalOrderNosstring[]optional

      items ≤ 5000

Responses

200OKPartnerReconciliation

Headers

NameTypeDescription
X-Request-IdstringThe id of this request: quote it to support. Send your own (8–64 of A-Z a-z 0-9 . _ -) to trace a call end to end.
RateLimit-LimitintegerThe key's requests per minute.
RateLimit-RemainingintegerRequests left in the current minute.
RateLimit-ResetintegerSeconds until the minute window resets.

Schema

  • datestringrequired
  • matchedbooleanrequired
  • branchesobject[]required
    Child attributes (6)
    • branchIdstringrequired

      length 1 – 64

    • oursobjectrequired
      Child attributes (2)
      • servedintegerrequired
      • servedTotalintegerrequired
    • theirsobjectrequired
      Child attributes (2)
      • servedintegerrequired
      • servedTotalintegerrequired
    • matchedbooleanrequired
    • missingAtPartnerstring[]required
    • unknownAtLpstring[]required
400INVALID_REQUESTPartnerError

Headers

NameTypeDescription
X-Request-IdstringThe id of this request: quote it to support. Send your own (8–64 of A-Z a-z 0-9 . _ -) to trace a call end to end.
401UNAUTHENTICATED (no key, a wrong or revoked one), KEY_EXPIRED, KEY_ENVIRONMENT_MISMATCH (a test key on production or the other way round)PartnerError

Headers

NameTypeDescription
X-Request-IdstringThe id of this request: quote it to support. Send your own (8–64 of A-Z a-z 0-9 . _ -) to trace a call end to end.
403PARTNER_SUSPENDED, IP_NOT_ALLOWED, SCOPE_REQUIRED (detail.required lists the scopes), BRANCH_NOT_ALLOWEDPartnerError

Headers

NameTypeDescription
X-Request-IdstringThe id of this request: quote it to support. Send your own (8–64 of A-Z a-z 0-9 . _ -) to trace a call end to end.
429RATE_LIMITED: wait Retry-After seconds (also in detail.retryAfterSeconds)PartnerError

Headers

NameTypeDescription
X-Request-IdstringThe id of this request: quote it to support. Send your own (8–64 of A-Z a-z 0-9 . _ -) to trace a call end to end.
500INTERNAL_ERROR: retryable; quote the X-Request-Id if it persistsPartnerError

Headers

NameTypeDescription
X-Request-IdstringThe id of this request: quote it to support. Send your own (8–64 of A-Z a-z 0-9 . _ -) to trace a call end to end.

Example response

200 · PartnerReconciliation
{
  "date": "string",
  "matched": true,
  "branches": [
    {
      "branchId": "28",
      "ours": {
        "served": 0,
        "servedTotal": 0
      },
      "theirs": {
        "served": 0,
        "servedTotal": 0
      },
      "matched": true,
      "missingAtPartner": [
        "string"
      ],
      "unknownAtLp": [
        "string"
      ]
    }
  ]
}