Let's Pizza Developersv1.0.0

API reference

Identity

Who the key is and what it may do.

GETThe key, its partner and settings#

GET/partner/v1/me

Any valid key may call it: the first call to make with a new key. environment is the host’s (always the key’s own, or the key would be refused). settings say how orders, statuses, the menu and invoices flow for your system.

Authentication
Partner key in the Authorization header
Scopes required
Any valid key
curl -sS "$LP_BASE_URL/partner/v1/me" \
  -H "Authorization: Bearer $LP_API_KEY"

Responses

200OKPartnerMe

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

  • partnerobjectrequired

    The partner the key belongs to.

    Child attributes (3)
    • idstringrequired

      The partner's id at Let's Pizza.

      length 1 – 64

    • namestringrequired

      The partner name, as the console shows it.

    • kindPartnerKindrequired

      What the system is; decides the default settings and scopes.

      Values: "erp""pos""kds""delivery""marketplace""accounting""analytics""other"

  • keyobjectrequired

    The key this request was made with.

    Child attributes (8)
    • idstringrequired

      length 1 – 64

    • envIntegrationModerequired

      The key's environment: sandbox or live.

      Values: "sandbox""live"

    • labelstringrequired

      The key's label, chosen by Let's Pizza.

    • prefixstringrequired

      The first characters of the key, to tell keys apart; never the key.

    • scopesPartnerScope[]required

      The scopes the key carries.

      Values: "branches:read""catalog:read""catalog:write""availability:write""orders:read""orders:ack""orders:status""orders:cancel""orders:events""payments:read""reports:read""webhooks:manage""mappings:write"

    • branchesstring[]requirednullable

      The branches the key may act on; null = every branch.

    • ratePerMinuteintegerrequired

      Requests per minute allowed for this key.

    • expiresAtstring<date-time>requirednullable

      When the key expires; null = no end.

  • environmentIntegrationModerequired

    The environment of the host that answered; always the key's own.

    Values: "sandbox""live"

  • settingsPartnerSettingsrequired

    How orders, statuses, the menu and invoices flow for your system.

    Child attributes (6)
    • ordersobjectrequired
      Child attributes (5)
      • deliveryOrderDeliveryrequired

        How you learn about orders: none, pull, webhooks, or connector (we call your system).

        Values: "none""pull""webhooks""connector"

      • acceptanceOrderAcceptancerequired

        Who accepts a new order: lp (our branch board) or partner (your system).

        Values: "lp""partner"

      • ackMinutesintegerrequired

        Minutes an order waits for your acknowledgement before the branch is alerted (0 = no alert).

        value 0 – 120

      • statusesPartnerStatusTarget[]required

        The statuses your system may report.

        Values: "accepted""rejected""preparing""ready""picked_up""cancelled""out_for_delivery""delivered""delivery_failed"

        items ≤ 9

      • connectorstringrequirednullable

        The connector used when delivery is `connector`.

        length ≤ 40

    • catalogobjectrequired
      Child attributes (5)
      • sourcebooleanrequired

        True: your system is the menu source (only one partner may be).

      • fieldsCatalogField[]required

        The menu fields your system owns; the rest (pictures, order) stay the console's.

        Values: "names""descriptions""prices""sizes""groups""options""categories""availability"

        items ≤ 8

      • publishCatalogPublishPolicyrequired

        What happens to a menu you send: manual review, auto_prices (price-only changes publish by themselves), or auto.

        Values: "manual""auto_prices""auto"

      • maxPriceChangePctintegerrequired

        The largest price change, in percent, that publishes by itself.

        value 0 – 100

      • maxRemovalsintegerrequired

        The most items an automatic publish may remove.

        value 0 – 1000

    • availabilitybooleanrequired

      True: your availability flags apply (they only take items off; staff flags stay staff's).

    • invoicesobjectrequired
      Child attributes (1)
      • issuerInvoiceIssuerrequired

        Who issues the customer's tax invoice: lp (our platform) or partner (your system).

        Values: "lp""partner"

    • customerDatastringrequired

      Values: "full""masked"

    • liveBranchesstring[]required

      The branches where your flows are switched on; empty until we switch them on with you.

      items ≤ 200

  • apiVersionstringrequired

    The API version.

    Values: "v1"

  • serverTimestring<date-time>required

    The server clock: compare it with yours before checking signatures.

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 · PartnerMe
{
  "partner": {
    "id": "ptn_01JD5ZB2",
    "name": "Business Central (EDM)",
    "kind": "erp"
  },
  "key": {
    "id": "key_01JD5ZC9",
    "env": "sandbox",
    "label": "EDM sandbox",
    "prefix": "lpk_test_Ab3d",
    "scopes": [
      "branches:read",
      "catalog:read",
      "catalog:write",
      "availability:write",
      "orders:read",
      "orders:ack",
      "orders:status",
      "orders:cancel",
      "orders:events",
      "payments:read",
      "reports:read",
      "webhooks:manage",
      "mappings:write"
    ],
    "branches": null,
    "ratePerMinute": 600,
    "expiresAt": null
  },
  "environment": "sandbox",
  "settings": {
    "orders": {
      "delivery": "pull",
      "acceptance": "partner",
      "ackMinutes": 3,
      "statuses": [
        "accepted",
        "rejected",
        "preparing",
        "ready",
        "picked_up",
        "cancelled"
      ],
      "connector": null
    },
    "catalog": {
      "source": false,
      "fields": [
        "names",
        "prices",
        "sizes",
        "groups",
        "options",
        "categories",
        "availability"
      ],
      "publish": "manual",
      "maxPriceChangePct": 20,
      "maxRemovals": 5
    },
    "availability": true,
    "invoices": {
      "issuer": "lp"
    },
    "customerData": "full",
    "liveBranches": [
      "28"
    ]
  },
  "apiVersion": "v1",
  "serverTime": "2026-11-19T19:30:12.000+03:00"
}

POSTOAuth 2.0 access token (client credentials)#

POST/partner/v1/oauth/token

For systems that prefer OAuth to a fixed key. grant_type=client_credentials, client_id = your key’s id (the key.id of GET /me), client_secret = the key; in a JSON or form body, or in HTTP Basic. The answer is a bearer token lpt_… valid for one hour (never past the key’s own end) with the key’s scopes: send it as Authorization: Bearer exactly like the key. A revoked key stops its tokens at once. Refusals carry detail.error (invalid_client, unsupported_grant_type, invalid_request).

Authentication
No authentication
curl -sS -X POST "$LP_BASE_URL/partner/v1/oauth/token" \
  -H "Content-Type: application/json" \
  --data '{
  "grant_type": "client_credentials",
  "client_id": "key_01JD5ZC9",
  "client_secret": "lpk_test_…"
}'

Request body PartnerTokenRequest

  • grant_typestringrequired

    length ≤ 40

  • client_idstringrequired

    length 1 – 64

  • client_secretstringrequired

    length 10 – 200

  • scopestringoptional

    length ≤ 500

Responses

200OKPartnerTokenResponse

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

  • access_tokenstringrequired
  • token_typestringrequired

    Values: "Bearer"

  • expires_inintegerrequired

    value ≥ 1

  • scopestringrequired
400INVALID_REQUEST (detail.error: invalid_request, unsupported_grant_type)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 (detail.error: invalid_client), KEY_ENVIRONMENT_MISMATCHPartnerError

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_LIMITEDPartnerError

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 · PartnerTokenResponse
{
  "access_token": "lpt_…",
  "token_type": "Bearer",
  "expires_in": 3600,
  "scope": "branches:read catalog:read catalog:write availability:write orders:read orders:ack orders:status orders:cancel orders:events payments:read reports:read webhooks:manage mappings:write"
}

GETYour request log#

GET/partner/v1/logs

Every request of your keys in this environment (refusals included), newest first, kept 30 days; never a body. nextBefore pages back. Quote a requestId to support.

Authentication
Partner key in the Authorization header
Scopes required
Any valid key
curl -sS "$LP_BASE_URL/partner/v1/logs" \
  -H "Authorization: Bearer $LP_API_KEY"

Parameters

NameInTypeDescription
beforequeryinteger
limitqueryinteger

Responses

200OKPartnerRequestLogPage

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

  • itemsPartnerRequestLogRow[]required
    Child attributes (12)
    • idintegerrequired

      value ≥ 1

    • requestIdstringrequired
    • keyIdstringrequirednullable

      length 1 – 64

    • keyPrefixstringrequirednullable
    • envIntegrationModerequired

      Values: "sandbox""live"

    • methodstringrequired
    • pathstringrequired
    • statusintegerrequired
    • errorCodestringrequirednullable
    • durationMsintegerrequired

      value ≥ 0

    • ipstringrequirednullable
    • atstring<date-time>required
  • nextBeforeintegerrequirednullable
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 · PartnerRequestLogPage
{
  "items": [
    {
      "id": "7f3a2c10-5b8e-4d21-9c47-1a2b3c4d5e01",
      "requestId": "req_01JD7Q8W3K2M",
      "keyId": "string",
      "keyPrefix": "string",
      "env": "sandbox",
      "method": "string",
      "path": "string",
      "status": 0,
      "errorCode": "string",
      "durationMs": 0,
      "ip": "string",
      "at": "2026-11-19T19:30:12+03:00"
    }
  ],
  "nextBefore": 0
}