API reference

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

None: this is how you get a token

operationId

partnerToken

Parameters

Request body

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

Responses

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

Errors

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

Responses

{
  "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"
}

Errors

Problem details (application/problem+json) with a stable code. Each code is explained under Errors, in Arabic and English.

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

Responses

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

Errors

Problem details (application/problem+json) with a stable code. Each code is explained under Errors, in Arabic and English.

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

Responses

[
  {
    "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"
  }
]

Errors

Problem details (application/problem+json) with a stable code. Each code is explained under Errors, in Arabic and English.

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

Responses

{
  "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"
}

Errors

Problem details (application/problem+json) with a stable code. Each code is explained under Errors, in Arabic and English.

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

Responses

[
  {
    "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
  }
]

Errors

Problem details (application/problem+json) with a stable code. Each code is explained under Errors, in Arabic and English.

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

Request body

{
  "phone": "+201001234567"
}

Responses

{
  "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"
      }
    }
  ]
}

Errors

Problem details (application/problem+json) with a stable code. Each code is explained under Errors, in Arabic and English.

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 (the token needs all of them)

availability:readpasses:read

operationId

partnerQuote

Parameters

Request body

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

Responses

{
  "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"
}

Errors

Problem details (application/problem+json) with a stable code. Each code is explained under Errors, in Arabic and English.

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

Responses

[
  {
    "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"
  }
]

Errors

Problem details (application/problem+json) with a stable code. Each code is explained under Errors, in Arabic and English.

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

Needs an Idempotency-Key header

Parameters

Request body

{
  "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"
}

Responses

{
  "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"
}

Errors

Problem details (application/problem+json) with a stable code. Each code is explained under Errors, in Arabic and English.

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

Responses

{
  "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"
}

Errors

Problem details (application/problem+json) with a stable code. Each code is explained under Errors, in Arabic and English.

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

Responses

{
  "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"
}

Errors

Problem details (application/problem+json) with a stable code. Each code is explained under Errors, in Arabic and English.

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

Responses

{
  "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"
}

Errors

Problem details (application/problem+json) with a stable code. Each code is explained under Errors, in Arabic and English.

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

Request body

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

Responses

{
  "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"
}

Errors

Problem details (application/problem+json) with a stable code. Each code is explained under Errors, in Arabic and English.

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

Request body

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

Responses

[
  {
    "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"
    }
  }
]

Errors

Problem details (application/problem+json) with a stable code. Each code is explained under Errors, in Arabic and English.

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

Needs an Idempotency-Key header

Parameters

Request body

{
  "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"
}

Responses

{
  "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"
  }
}

Errors

Problem details (application/problem+json) with a stable code. Each code is explained under Errors, in Arabic and English.

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

Request body

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

<file bytes>

Responses

{
  "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"
  }
}

Errors

Problem details (application/problem+json) with a stable code. Each code is explained under Errors, in Arabic and English.

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

Request body

{
  "phone": "+201001234567"
}

Responses

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

Errors

Problem details (application/problem+json) with a stable code. Each code is explained under Errors, in Arabic and English.

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

Responses

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

Errors

Problem details (application/problem+json) with a stable code. Each code is explained under Errors, in Arabic and English.

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

Request body

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

Responses

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

Errors

Problem details (application/problem+json) with a stable code. Each code is explained under Errors, in Arabic and English.