مرجع الـ API

post/partner/oauth/token

Client credentials: a 10-minute access token for the partner API

Authenticate with HTTP Basic (client_secret_basic, preferred) or with client_id and client_secret in the form (client_secret_post). The token lasts 10 minutes (expires_in); ask for a new one when it ends, there is no refresh token. Answers are never cached. Who: any partner app Ezaz registered and hasn't suspended. Errors: 400 invalid_request, unsupported_grant_type or invalid_scope; 401 invalid_client: unknown client, wrong secret or suspended.

الـ Scope

مفيش: دي اللي بتاخد بيها التوكن

operationId

partnerToken

الـ Parameters

جسم الطلب

client_id=kp_your_client_id&client_secret=ks_your_client_secret&grant_type=client_credentials&scope=venues%3Aread%20availability%3Aread

الردود

{
  "access_token": "eyJhbGciOiJIUzI1NiJ9…",
  "expires_in": 600,
  "scope": "venues:read availability:read",
  "token_type": "Bearer"
}

الأخطاء

get/partner/v1/venues

List the venues that let you sell their courts

Active venues that granted you, with their address, area, contact phone, cancellation cutoff and active courts. Page with after (the previous page's nextCursor) until nextCursor is null; a page can be shorter than limit without being the last. Scopes: venues:read (the token needs every one). Errors: 400 VALIDATION_FAILED; 401 UNAUTHENTICATED; 403 FORBIDDEN; 429 PARTNER_RATE_LIMITED.

الـ Scope

venues:read

operationId

partnerListVenues

الـ Parameters

الردود

{
  "items": [
    {
      "address": {
        "ar": "string",
        "en": "string"
      },
      "area": {
        "code": "new-cairo",
        "name": {
          "ar": "string",
          "en": "string"
        }
      },
      "cancellationHours": 24,
      "contactPhone": "+201001234567",
      "courts": [
        {
          "courtId": "3f6c1a52-8d4e-4b7a-9c2f-5e1d0a9b7c31",
          "environment": "string",
          "kind": "string",
          "name": {
            "ar": "string",
            "en": "string"
          }
        }
      ],
      "latitude": 30.0074,
      "longitude": 31.4913,
      "name": {
        "ar": "string",
        "en": "string"
      },
      "photoUrls": [
        "string"
      ],
      "venueId": "3f6c1a52-8d4e-4b7a-9c2f-5e1d0a9b7c31"
    }
  ],
  "nextCursor": "3f6c1a52-8d4e-4b7a-9c2f-5e1d0a9b7c31"
}

الأخطاء

Problem details (application/problem+json) ومعاها code ثابت. كل كود متشرح في الأخطاء، بالعربي والإنجليزي.

get/partner/v1/venues/{venueId}/availability

Get free slots and prices on a Cairo date

Every active court's free slots of the given length (60, 90 or 120 minutes) starting on the half hour on that Cairo date, inside the venue's opening hours, with the list price of each. Slots are UTC instants; daylight saving is handled (a skipped hour has no slots). Scopes: availability:read (the token needs every one). Errors: 400 VALIDATION_FAILED; 401 UNAUTHENTICATED; 403 FORBIDDEN; 404 VENUE_NOT_FOUND; 429 PARTNER_RATE_LIMITED.

الـ Scope

availability:read

operationId

partnerAvailability

الـ Parameters

الردود

[
  {
    "courtId": "3f6c1a52-8d4e-4b7a-9c2f-5e1d0a9b7c31",
    "slots": [
      {
        "end": "2026-10-10T17:00:00Z",
        "price": {
          "amount": 120000,
          "currency": "EGP"
        },
        "start": "2026-10-10T17:00:00Z"
      }
    ]
  }
]

الأخطاء

Problem details (application/problem+json) ومعاها code ثابت. كل كود متشرح في الأخطاء، بالعربي والإنجليزي.

get/partner/v1/venues/{venueId}/courts

List a venue's courts with their facts

The venue's active courts: facts (surface, walls, lighting, size, dates), public photos, the rating from published reviews (from 3 reviews) and the safety summary (open issues only, never the reports). Scopes: venues:read (the token needs every one). Errors: 401 UNAUTHENTICATED; 403 FORBIDDEN; 404 VENUE_NOT_FOUND; 429 PARTNER_RATE_LIMITED.

الـ Scope

venues:read

operationId

partnerListCourts

الـ Parameters

الردود

[
  {
    "courtId": "3f6c1a52-8d4e-4b7a-9c2f-5e1d0a9b7c31",
    "environment": "string",
    "kind": "string",
    "lastRenovatedOn": "2026-10-10",
    "latestReviews": [
      {
        "authorName": "Omar H.",
        "cleanliness": 1,
        "comment": "Great glass and new turf.",
        "courtId": "3f6c1a52-8d4e-4b7a-9c2f-5e1d0a9b7c31",
        "createdAt": "2026-10-10T17:00:00Z",
        "id": "3f6c1a52-8d4e-4b7a-9c2f-5e1d0a9b7c31",
        "lighting": 1,
        "overall": 1,
        "repliedAt": "2026-10-10T17:00:00Z",
        "reply": "Thanks, see you again!",
        "surface": 1
      }
    ],
    "lighting": "string",
    "name": {
      "ar": "string",
      "en": "string"
    },
    "openedOn": "2026-10-10",
    "photoUrls": [
      "string"
    ],
    "rating": {
      "average": 4.5,
      "cleanliness": 1.5,
      "count": 12,
      "lighting": 1.5,
      "surface": 1.5
    },
    "renovationNote": "string",
    "safety": {
      "lastResolvedOn": "2026-10-10",
      "openIssues": 1
    },
    "size": "string",
    "surface": "string",
    "turfBrand": "string",
    "venueId": "3f6c1a52-8d4e-4b7a-9c2f-5e1d0a9b7c31",
    "walls": "string"
  }
]

الأخطاء

Problem details (application/problem+json) ومعاها code ثابت. كل كود متشرح في الأخطاء، بالعربي والإنجليزي.

get/partner/v1/venues/{venueId}/courts/{courtId}

Get one court with its newest reviews

One active court as in the list, plus its newest published reviews. Scopes: venues:read (the token needs every one). Errors: 401 UNAUTHENTICATED; 403 FORBIDDEN; 404 VENUE_NOT_FOUND, COURT_NOT_FOUND; 429 PARTNER_RATE_LIMITED.

الـ Scope

venues:read

operationId

partnerGetCourt

الـ Parameters

الردود

{
  "courtId": "3f6c1a52-8d4e-4b7a-9c2f-5e1d0a9b7c31",
  "environment": "string",
  "kind": "string",
  "lastRenovatedOn": "2026-10-10",
  "latestReviews": [
    {
      "authorName": "Omar H.",
      "cleanliness": 1,
      "comment": "Great glass and new turf.",
      "courtId": "3f6c1a52-8d4e-4b7a-9c2f-5e1d0a9b7c31",
      "createdAt": "2026-10-10T17:00:00Z",
      "id": "3f6c1a52-8d4e-4b7a-9c2f-5e1d0a9b7c31",
      "lighting": 1,
      "overall": 1,
      "repliedAt": "2026-10-10T17:00:00Z",
      "reply": "Thanks, see you again!",
      "surface": 1
    }
  ],
  "lighting": "string",
  "name": {
    "ar": "string",
    "en": "string"
  },
  "openedOn": "2026-10-10",
  "photoUrls": [
    "string"
  ],
  "rating": {
    "average": 4.5,
    "cleanliness": 1.5,
    "count": 12,
    "lighting": 1.5,
    "surface": 1.5
  },
  "renovationNote": "string",
  "safety": {
    "lastResolvedOn": "2026-10-10",
    "openIssues": 1
  },
  "size": "string",
  "surface": "string",
  "turfBrand": "string",
  "venueId": "3f6c1a52-8d4e-4b7a-9c2f-5e1d0a9b7c31",
  "walls": "string"
}

الأخطاء

Problem details (application/problem+json) ومعاها code ثابت. كل كود متشرح في الأخطاء، بالعربي والإنجليزي.

get/partner/v1/venues/{venueId}/courts/{courtId}/reviews

List a court's published reviews

Published reviews of the court, newest first. Continue with before and beforeId set from the last item's createdAt and id. Hidden reviews never show. Scopes: venues:read (the token needs every one). Errors: 400 VALIDATION_FAILED; 401 UNAUTHENTICATED; 403 FORBIDDEN; 404 VENUE_NOT_FOUND, COURT_NOT_FOUND; 429 PARTNER_RATE_LIMITED.

الـ Scope

venues:read

operationId

partnerListCourtReviews

الـ Parameters

الردود

[
  {
    "authorName": "Omar H.",
    "cleanliness": 1,
    "comment": "Great glass and new turf.",
    "courtId": "3f6c1a52-8d4e-4b7a-9c2f-5e1d0a9b7c31",
    "createdAt": "2026-10-10T17:00:00Z",
    "id": "3f6c1a52-8d4e-4b7a-9c2f-5e1d0a9b7c31",
    "lighting": 1,
    "overall": 1,
    "repliedAt": "2026-10-10T17:00:00Z",
    "reply": "Thanks, see you again!",
    "surface": 1
  }
]

الأخطاء

Problem details (application/problem+json) ومعاها code ثابت. كل كود متشرح في الأخطاء، بالعربي والإنجليزي.

post/partner/v1/venues/{venueId}/player-passes

Get a player's packages and memberships at a venue

The packages (minutes left, expiry) and memberships (discount) the player holds at the venue, found by the phone you verified, sent in the body so it never lands in a URL or a log. Lookups are capped per partner app: 60 a minute and 3,000 a day. Scopes: passes:read (the token needs every one). Errors: 400 VALIDATION_FAILED, PHONE_INVALID; 401 UNAUTHENTICATED; 403 FORBIDDEN; 404 VENUE_NOT_FOUND; 429 PARTNER_RATE_LIMITED, PARTNER_PASS_LOOKUPS_LIMITED.

الـ Scope

passes:read

operationId

partnerPlayerPasses

الـ Parameters

جسم الطلب

{
  "phone": "+201001234567"
}

الردود

{
  "memberships": [
    {
      "discountBps": 1000,
      "endsAt": "2026-10-10T17:00:00Z",
      "id": "3f6c1a52-8d4e-4b7a-9c2f-5e1d0a9b7c31",
      "name": {
        "ar": "string",
        "en": "string"
      },
      "startsAt": "2026-10-10T17:00:00Z"
    }
  ],
  "packages": [
    {
      "expiresAt": "2026-10-10T17:00:00Z",
      "id": "3f6c1a52-8d4e-4b7a-9c2f-5e1d0a9b7c31",
      "minutesLeft": 1,
      "minutesTotal": 1,
      "name": {
        "ar": "string",
        "en": "string"
      }
    }
  ]
}

الأخطاء

Problem details (application/problem+json) ومعاها code ثابت. كل كود متشرح في الأخطاء، بالعربي والإنجليزي.

post/partner/v1/venues/{venueId}/quote

Quote a slot for your player

What the slot costs your player: the list price and, when their phone holds a membership at the venue, the member price, which is what they pay however it is paid, prepaid to you or at the venue (ADR 0015). Quote right before booking with PREPAID_BY_PARTNER so you collect the right amount. The phone goes in the body, never the URL. Scopes: availability:read, passes:read (the token needs every one). Errors: 400 VALIDATION_FAILED, PHONE_INVALID, COURT_SLOT_NOT_BOOKABLE; 401 UNAUTHENTICATED; 403 FORBIDDEN; 404 VENUE_NOT_FOUND, COURT_NOT_FOUND; 429 PARTNER_RATE_LIMITED.

الـ Scopes (التوكن لازم يكون فيه كلهم)

availability:readpasses:read

operationId

partnerQuote

الـ Parameters

جسم الطلب

{
  "courtId": "3f6c1a52-8d4e-4b7a-9c2f-5e1d0a9b7c31",
  "minutes": 90,
  "phone": "+201001234567",
  "start": "2026-10-10T17:00:00Z"
}

الردود

{
  "charge": {
    "amount": 120000,
    "currency": "EGP"
  },
  "courtId": "3f6c1a52-8d4e-4b7a-9c2f-5e1d0a9b7c31",
  "discountBps": 1000,
  "end": "2026-10-10T17:00:00Z",
  "price": {
    "amount": 120000,
    "currency": "EGP"
  },
  "start": "2026-10-10T17:00:00Z"
}

الأخطاء

Problem details (application/problem+json) ومعاها code ثابت. كل كود متشرح في الأخطاء، بالعربي والإنجليزي.

get/partner/v1/reservations

List your reservations in a period

Your reservations overlapping [from, to), at most 31 days and 500 reservations, by start; other partners' and the desk's never show. Scopes: reservations:read (the token needs every one). Errors: 400 VALIDATION_FAILED; 401 UNAUTHENTICATED; 403 FORBIDDEN; 429 PARTNER_RATE_LIMITED.

الـ Scope

reservations:read

operationId

partnerListReservations

الـ Parameters

الردود

[
  {
    "cancelReason": "string",
    "cancelledAt": "2026-10-10T17:00:00Z",
    "charge": {
      "amount": 120000,
      "currency": "EGP"
    },
    "checkedInAt": "2026-10-10T17:00:00Z",
    "courtId": "3f6c1a52-8d4e-4b7a-9c2f-5e1d0a9b7c31",
    "createdAt": "2026-10-10T17:00:00Z",
    "customer": {
      "name": "Omar Hassan",
      "phone": "+201001234567"
    },
    "end": "2026-10-10T17:00:00Z",
    "externalRef": "kb_8f2c41",
    "id": "3f6c1a52-8d4e-4b7a-9c2f-5e1d0a9b7c31",
    "payment": {
      "collected": {
        "amount": 120000,
        "currency": "EGP"
      },
      "method": "PAY_AT_VENUE",
      "packageCreditId": "3f6c1a52-8d4e-4b7a-9c2f-5e1d0a9b7c31"
    },
    "price": {
      "amount": 120000,
      "currency": "EGP"
    },
    "start": "2026-10-10T17:00:00Z",
    "status": "CONFIRMED",
    "venueId": "3f6c1a52-8d4e-4b7a-9c2f-5e1d0a9b7c31"
  }
]

الأخطاء

Problem details (application/problem+json) ومعاها code ثابت. كل كود متشرح في الأخطاء، بالعربي والإنجليزي.

post/partner/v1/reservations

Book a court for your player

Confirmed at once, or COURT_TAKEN when the court is booked then (the database refuses double bookings). Pay at the venue (the desk collects the charge), prepaid by you (you collected; you owe the venue the charge on your statement) or with the player's package (customer.phoneVerified must be true; its minutes are taken now and come back on cancellation). The venue's desk sees the player's name and phone. Sessions are 60, 90 or 120 minutes from a half hour, inside opening hours, up to 30 days ahead. Scopes: reservations:write (the token needs every one). Idempotent: send a unique Idempotency-Key (yours alone, up to 80 characters); a retry with the same key returns the first result instead of creating another. Errors: 400 VALIDATION_FAILED, PHONE_INVALID, COURT_INVALID, COURT_SLOT_NOT_BOOKABLE, COURT_PAYMENT_INVALID, PARTNER_PHONE_NOT_VERIFIED; 401 UNAUTHENTICATED; 403 FORBIDDEN; 404 VENUE_NOT_FOUND, COURT_NOT_FOUND; 409 COURT_TAKEN, EXTERNAL_REF_IN_USE, VENUE_NOT_TAKING_BOOKINGS, COURT_PASS_NOT_USABLE, COURT_RESERVATION_STATE_INVALID; 429 PARTNER_RATE_LIMITED.

الـ Scope

reservations:write

operationId

partnerBook

محتاجة هيدر Idempotency-Key

الـ Parameters

جسم الطلب

{
  "courtId": "3f6c1a52-8d4e-4b7a-9c2f-5e1d0a9b7c31",
  "customer": {
    "name": "Omar Hassan",
    "phone": "+201001234567",
    "phoneVerified": true
  },
  "externalRef": "kb_8f2c41",
  "minutes": 90,
  "payment": {
    "collected": {
      "amount": 120000,
      "currency": "EGP"
    },
    "method": "PAY_AT_VENUE",
    "packageCreditId": "3f6c1a52-8d4e-4b7a-9c2f-5e1d0a9b7c31"
  },
  "start": "2026-10-10T17:00:00Z",
  "venueId": "3f6c1a52-8d4e-4b7a-9c2f-5e1d0a9b7c31"
}

الردود

{
  "cancelReason": "string",
  "cancelledAt": "2026-10-10T17:00:00Z",
  "charge": {
    "amount": 120000,
    "currency": "EGP"
  },
  "checkedInAt": "2026-10-10T17:00:00Z",
  "courtId": "3f6c1a52-8d4e-4b7a-9c2f-5e1d0a9b7c31",
  "createdAt": "2026-10-10T17:00:00Z",
  "customer": {
    "name": "Omar Hassan",
    "phone": "+201001234567"
  },
  "end": "2026-10-10T17:00:00Z",
  "externalRef": "kb_8f2c41",
  "id": "3f6c1a52-8d4e-4b7a-9c2f-5e1d0a9b7c31",
  "payment": {
    "collected": {
      "amount": 120000,
      "currency": "EGP"
    },
    "method": "PAY_AT_VENUE",
    "packageCreditId": "3f6c1a52-8d4e-4b7a-9c2f-5e1d0a9b7c31"
  },
  "price": {
    "amount": 120000,
    "currency": "EGP"
  },
  "start": "2026-10-10T17:00:00Z",
  "status": "CONFIRMED",
  "venueId": "3f6c1a52-8d4e-4b7a-9c2f-5e1d0a9b7c31"
}

الأخطاء

Problem details (application/problem+json) ومعاها code ثابت. كل كود متشرح في الأخطاء، بالعربي والإنجليزي.

get/partner/v1/reservations/{reservationId}

Get one of your reservations

One reservation you made, with its status, price, charge and payment; another partner's is a 404. Scopes: reservations:read (the token needs every one). Errors: 401 UNAUTHENTICATED; 403 FORBIDDEN; 404 COURT_RESERVATION_NOT_FOUND; 429 PARTNER_RATE_LIMITED.

الـ Scope

reservations:read

operationId

partnerGetReservation

الـ Parameters

الردود

{
  "cancelReason": "string",
  "cancelledAt": "2026-10-10T17:00:00Z",
  "charge": {
    "amount": 120000,
    "currency": "EGP"
  },
  "checkedInAt": "2026-10-10T17:00:00Z",
  "courtId": "3f6c1a52-8d4e-4b7a-9c2f-5e1d0a9b7c31",
  "createdAt": "2026-10-10T17:00:00Z",
  "customer": {
    "name": "Omar Hassan",
    "phone": "+201001234567"
  },
  "end": "2026-10-10T17:00:00Z",
  "externalRef": "kb_8f2c41",
  "id": "3f6c1a52-8d4e-4b7a-9c2f-5e1d0a9b7c31",
  "payment": {
    "collected": {
      "amount": 120000,
      "currency": "EGP"
    },
    "method": "PAY_AT_VENUE",
    "packageCreditId": "3f6c1a52-8d4e-4b7a-9c2f-5e1d0a9b7c31"
  },
  "price": {
    "amount": 120000,
    "currency": "EGP"
  },
  "start": "2026-10-10T17:00:00Z",
  "status": "CONFIRMED",
  "venueId": "3f6c1a52-8d4e-4b7a-9c2f-5e1d0a9b7c31"
}

الأخطاء

Problem details (application/problem+json) ومعاها code ثابت. كل كود متشرح في الأخطاء، بالعربي والإنجليزي.

post/partner/v1/reservations/{reservationId}/cancel

Cancel one of your reservations

Free of charge until the venue's cancellation cutoff (Venue.cancellationHours before the start) and before the player checks in; after that only the venue can cancel. Package minutes come back, and the venue's owner is told. A reservation that is no longer confirmed can't be cancelled again. Scopes: reservations:write (the token needs every one). Errors: 401 UNAUTHENTICATED; 403 FORBIDDEN; 404 COURT_RESERVATION_NOT_FOUND; 409 COURT_RESERVATION_NOT_CANCELLABLE; 429 PARTNER_RATE_LIMITED.

الـ Scope

reservations:write

operationId

partnerCancelReservation

الـ Parameters

الردود

{
  "cancelReason": "string",
  "cancelledAt": "2026-10-10T17:00:00Z",
  "charge": {
    "amount": 120000,
    "currency": "EGP"
  },
  "checkedInAt": "2026-10-10T17:00:00Z",
  "courtId": "3f6c1a52-8d4e-4b7a-9c2f-5e1d0a9b7c31",
  "createdAt": "2026-10-10T17:00:00Z",
  "customer": {
    "name": "Omar Hassan",
    "phone": "+201001234567"
  },
  "end": "2026-10-10T17:00:00Z",
  "externalRef": "kb_8f2c41",
  "id": "3f6c1a52-8d4e-4b7a-9c2f-5e1d0a9b7c31",
  "payment": {
    "collected": {
      "amount": 120000,
      "currency": "EGP"
    },
    "method": "PAY_AT_VENUE",
    "packageCreditId": "3f6c1a52-8d4e-4b7a-9c2f-5e1d0a9b7c31"
  },
  "price": {
    "amount": 120000,
    "currency": "EGP"
  },
  "start": "2026-10-10T17:00:00Z",
  "status": "CONFIRMED",
  "venueId": "3f6c1a52-8d4e-4b7a-9c2f-5e1d0a9b7c31"
}

الأخطاء

Problem details (application/problem+json) ومعاها code ثابت. كل كود متشرح في الأخطاء، بالعربي والإنجليزي.

get/partner/v1/reservations/{reservationId}/review

Get the review of your reservation

The review your player wrote for a reservation you made, with the venue owner's reply when there is one. Scopes: reservations:read (the token needs every one). Errors: 401 UNAUTHENTICATED; 403 FORBIDDEN; 404 COURT_RESERVATION_NOT_FOUND, COURT_REVIEW_NOT_FOUND; 429 PARTNER_RATE_LIMITED.

الـ Scope

reservations:read

operationId

partnerGetReservationReview

الـ Parameters

الردود

{
  "authorName": "Omar H.",
  "comment": "Great glass and new turf.",
  "courtId": "3f6c1a52-8d4e-4b7a-9c2f-5e1d0a9b7c31",
  "createdAt": "2026-10-10T17:00:00Z",
  "id": "3f6c1a52-8d4e-4b7a-9c2f-5e1d0a9b7c31",
  "repliedAt": "2026-10-10T17:00:00Z",
  "reply": "Thanks, see you again!",
  "reservationId": "3f6c1a52-8d4e-4b7a-9c2f-5e1d0a9b7c31",
  "scores": {
    "cleanliness": 1,
    "lighting": 1,
    "overall": 1,
    "surface": 1
  },
  "status": "string",
  "venueId": "3f6c1a52-8d4e-4b7a-9c2f-5e1d0a9b7c31"
}

الأخطاء

Problem details (application/problem+json) ومعاها code ثابت. كل كود متشرح في الأخطاء، بالعربي والإنجليزي.

post/partner/v1/reservations/{reservationId}/review

Review a reservation for your player

Your player's stars and words about the court of a reservation you made, once it was played (completed, or confirmed past its end), within 14 days of its end, once. Published at once; sending the same review again returns it, a different one is COURT_REVIEW_EXISTS. You get review.replied when the owner answers. Scopes: reviews:write (the token needs every one). Errors: 400 VALIDATION_FAILED, COURT_REVIEW_INVALID; 401 UNAUTHENTICATED; 403 FORBIDDEN; 404 COURT_RESERVATION_NOT_FOUND; 409 COURT_REVIEW_NOT_ALLOWED, COURT_REVIEW_EXISTS; 429 PARTNER_RATE_LIMITED.

الـ Scope

reviews:write

operationId

partnerReviewReservation

الـ Parameters

جسم الطلب

{
  "cleanliness": 1,
  "comment": "Great glass and new turf.",
  "lighting": 1,
  "overall": 1,
  "surface": 1
}

الردود

{
  "authorName": "Omar H.",
  "comment": "Great glass and new turf.",
  "courtId": "3f6c1a52-8d4e-4b7a-9c2f-5e1d0a9b7c31",
  "createdAt": "2026-10-10T17:00:00Z",
  "id": "3f6c1a52-8d4e-4b7a-9c2f-5e1d0a9b7c31",
  "repliedAt": "2026-10-10T17:00:00Z",
  "reply": "Thanks, see you again!",
  "reservationId": "3f6c1a52-8d4e-4b7a-9c2f-5e1d0a9b7c31",
  "scores": {
    "cleanliness": 1,
    "lighting": 1,
    "overall": 1,
    "surface": 1
  },
  "status": "string",
  "venueId": "3f6c1a52-8d4e-4b7a-9c2f-5e1d0a9b7c31"
}

الأخطاء

Problem details (application/problem+json) ومعاها code ثابت. كل كود متشرح في الأخطاء، بالعربي والإنجليزي.

post/partner/v1/player-safety-reports

List a player's safety reports through you

The reports your player filed through you, newest first, found by the phone you verified (in the body, never the URL). Continue with before and beforeId from the last item. Scopes: safety_reports:read (the token needs every one). Errors: 400 VALIDATION_FAILED, PHONE_INVALID; 401 UNAUTHENTICATED; 403 FORBIDDEN; 429 PARTNER_RATE_LIMITED.

الـ Scope

safety_reports:read

operationId

partnerPlayerSafetyReports

جسم الطلب

{
  "before": "2026-10-10T17:00:00Z",
  "beforeId": "3f6c1a52-8d4e-4b7a-9c2f-5e1d0a9b7c31",
  "limit": 1,
  "phone": "+201001234567"
}

الردود

[
  {
    "courtId": "3f6c1a52-8d4e-4b7a-9c2f-5e1d0a9b7c31",
    "courtName": {
      "ar": "string",
      "en": "string"
    },
    "createdAt": "2026-10-10T17:00:00Z",
    "description": "A glass panel by the door is loose.",
    "id": "3f6c1a52-8d4e-4b7a-9c2f-5e1d0a9b7c31",
    "occurredAt": "2026-10-10T17:00:00Z",
    "photoUrls": [
      "string"
    ],
    "resolutionNote": "string",
    "resolvedAt": "2026-10-10T17:00:00Z",
    "status": "string",
    "type": "string",
    "venueId": "3f6c1a52-8d4e-4b7a-9c2f-5e1d0a9b7c31",
    "venueName": {
      "ar": "string",
      "en": "string"
    }
  }
]

الأخطاء

Problem details (application/problem+json) ومعاها code ثابت. كل كود متشرح في الأخطاء، بالعربي والإنجليزي.

post/partner/v1/safety-reports

File a safety report for your player

Your player reports a safety problem on a court (a slippery surface, broken glass, an injury); the venue is told at once and never learns who reported. No medical details or names of the injured. At most 5 a day per player through you. You get safety_report.resolved when the venue fixes it. Scopes: safety_reports:write (the token needs every one). Idempotent: send a unique Idempotency-Key (yours alone, up to 80 characters); a retry with the same key returns the first result instead of creating another. Errors: 400 VALIDATION_FAILED, PHONE_INVALID, SAFETY_REPORT_INVALID; 401 UNAUTHENTICATED; 403 FORBIDDEN; 404 VENUE_NOT_FOUND, COURT_NOT_FOUND; 429 PARTNER_RATE_LIMITED, TOO_MANY_SAFETY_REPORTS.

الـ Scope

safety_reports:write

operationId

partnerFileSafetyReport

محتاجة هيدر Idempotency-Key

الـ Parameters

جسم الطلب

{
  "courtId": "3f6c1a52-8d4e-4b7a-9c2f-5e1d0a9b7c31",
  "description": "A glass panel by the door is loose.",
  "occurredAt": "2026-10-10T17:00:00Z",
  "phone": "+201001234567",
  "type": "INJURY",
  "venueId": "3f6c1a52-8d4e-4b7a-9c2f-5e1d0a9b7c31"
}

الردود

{
  "courtId": "3f6c1a52-8d4e-4b7a-9c2f-5e1d0a9b7c31",
  "courtName": {
    "ar": "string",
    "en": "string"
  },
  "createdAt": "2026-10-10T17:00:00Z",
  "description": "A glass panel by the door is loose.",
  "id": "3f6c1a52-8d4e-4b7a-9c2f-5e1d0a9b7c31",
  "occurredAt": "2026-10-10T17:00:00Z",
  "photoUrls": [
    "string"
  ],
  "resolutionNote": "string",
  "resolvedAt": "2026-10-10T17:00:00Z",
  "status": "string",
  "type": "string",
  "venueId": "3f6c1a52-8d4e-4b7a-9c2f-5e1d0a9b7c31",
  "venueName": {
    "ar": "string",
    "en": "string"
  }
}

الأخطاء

Problem details (application/problem+json) ومعاها code ثابت. كل كود متشرح في الأخطاء، بالعربي والإنجليزي.

post/partner/v1/safety-reports/{reportId}/photos

Add a photo to a safety report

A photo of the problem while the report is open: JPEG, PNG or WebP up to 5 MB, at most 3 per report. Stored in the private bucket without its metadata (location, camera) and shown only through links that expire. Scopes: safety_reports:write (the token needs every one). Errors: 400 FILE_REJECTED; 401 UNAUTHENTICATED; 403 FORBIDDEN; 404 SAFETY_REPORT_NOT_FOUND; 409 SAFETY_REPORT_STATE_INVALID; 429 PARTNER_RATE_LIMITED.

الـ Scope

safety_reports:write

operationId

partnerAddSafetyReportPhoto

الـ Parameters

جسم الطلب

--boundary
Content-Disposition: form-data; name="file"; filename="court.jpg"
Content-Type: image/jpeg

<file bytes>

الردود

{
  "courtId": "3f6c1a52-8d4e-4b7a-9c2f-5e1d0a9b7c31",
  "courtName": {
    "ar": "string",
    "en": "string"
  },
  "createdAt": "2026-10-10T17:00:00Z",
  "description": "A glass panel by the door is loose.",
  "id": "3f6c1a52-8d4e-4b7a-9c2f-5e1d0a9b7c31",
  "occurredAt": "2026-10-10T17:00:00Z",
  "photoUrls": [
    "string"
  ],
  "resolutionNote": "string",
  "resolvedAt": "2026-10-10T17:00:00Z",
  "status": "string",
  "type": "string",
  "venueId": "3f6c1a52-8d4e-4b7a-9c2f-5e1d0a9b7c31",
  "venueName": {
    "ar": "string",
    "en": "string"
  }
}

الأخطاء

Problem details (application/problem+json) ومعاها code ثابت. كل كود متشرح في الأخطاء، بالعربي والإنجليزي.

post/partner/v1/players/erasure

Forward a player's erasure request

For a player who asked you to delete their data (PDPL, ADR 0014): your reservations lose their name and phone, your reviews lose their words (the stars stay), your safety reports are unlinked from them. Only what came through you; amounts stay for the statements. Idempotent: zeros once done. Refused while one of your bookings for them is still to come. Scopes: players:erase (the token needs every one). Errors: 400 VALIDATION_FAILED, PHONE_INVALID; 401 UNAUTHENTICATED; 403 FORBIDDEN; 409 CUSTOMER_HAS_OPEN_COMMITMENTS; 429 PARTNER_RATE_LIMITED.

الـ Scope

players:erase

operationId

partnerErasePlayer

جسم الطلب

{
  "phone": "+201001234567"
}

الردود

{
  "reservations": 1,
  "reviews": 1,
  "safetyReports": 1
}

الأخطاء

Problem details (application/problem+json) ومعاها code ثابت. كل كود متشرح في الأخطاء، بالعربي والإنجليزي.

get/partner/v1/webhook

Get your webhook

Where your events are posted; the secret is not shown again (set the webhook to get a new one). Scopes: webhooks:manage (the token needs every one). Errors: 401 UNAUTHENTICATED; 403 FORBIDDEN; 429 PARTNER_RATE_LIMITED.

الـ Scope

webhooks:manage

operationId

partnerGetWebhook

الردود

{
  "secret": "whsec_…",
  "url": "https://partner.example/ezaz/webhooks"
}

الأخطاء

Problem details (application/problem+json) ومعاها code ثابت. كل كود متشرح في الأخطاء، بالعربي والإنجليزي.

put/partner/v1/webhook

Set or remove your webhook

Events (reservation changes, review replies, resolved safety reports) are posted to this public https URL, signed with HMAC-SHA256 in Ezaz-Signature, and retried for a day. Setting it returns a new signing secret; null removes it. Scopes: webhooks:manage (the token needs every one). Errors: 400 VALIDATION_FAILED, PARTNER_WEBHOOK_URL_INVALID; 401 UNAUTHENTICATED; 403 FORBIDDEN; 429 PARTNER_RATE_LIMITED.

الـ Scope

webhooks:manage

operationId

partnerSetWebhook

جسم الطلب

{
  "url": "https://partner.example/ezaz/webhooks"
}

الردود

{
  "secret": "whsec_…",
  "url": "https://partner.example/ezaz/webhooks"
}

الأخطاء

Problem details (application/problem+json) ومعاها code ثابت. كل كود متشرح في الأخطاء، بالعربي والإنجليزي.