# Loops Partner API

> The Loops Partner API gives approved partners (POS, ERP and management tools) one integration for the orders and locations of the merchants who connect to them, across every delivery app and marketplace those merchants use through Loops. It is in developer preview.

Key facts for generating integration code:

- Authentication: OAuth 2.0 client credentials. The token URL, client ID and client secret are in the Loops Partners portal (Applications). Send `Authorization: Bearer <token>`; tokens last 15 minutes.
- Every request for a platform application names the merchant with the `Loops-Merchant-Id` header.
- Base URLs: sandbox `https://sandbox.partners.loops.sa/v1`, production `https://api.partners.loops.sa/v1`.
- JSON with snake_case fields; opaque prefixed IDs (`mer_`, `loc_`, `ord_`, `evt_`); money as `{ amount, currency }` in minor units; ISO 8601 UTC times.
- Cursor pagination (`limit`, `cursor`, `next_cursor`); incremental order sync with `updated_since`.
- Webhooks are signed with Standard Webhooks (`webhook-id`, `webhook-timestamp`, `webhook-signature`); delivery is at least once and unordered, so deduplicate by event ID and use `version`.
- Errors are RFC 9457 Problem Details; switch on the stable `code` field.
- Only read endpoints exist in the developer preview. Do not invent write endpoints (accept order, menu push); they are planned, not available.

## Documentation Sets

- [Abridged documentation](https://docs.partners.loops.sa/llms-small.txt): a compact version of the documentation for Loops Partner API, with non-essential content removed
- [Complete documentation](https://docs.partners.loops.sa/llms-full.txt): the full documentation for Loops Partner API

## Notes

- The complete documentation includes all content from the official documentation
- The content is automatically generated from the same source as the official documentation

## Optional

- [OpenAPI 3.1 specification](https://docs.partners.loops.sa/openapi.yaml): The complete machine-readable contract: every endpoint, schema, error and webhook.