Address book
List, read, create, edit and delete the client's saved delivery addresses — replaces the five Shukah /maeda/address-book calls.
Written for the mobile app team.
View all tagsList, read, create, edit and delete the client's saved delivery addresses — replaces the five Shukah /maeda/address-book calls.
Find a client by phone number from a signed-in session — replaces Shukah GET /maeda/client.
Trade a Shukah token for a Locate token, or a Locate token for a Shukah token — a Locate-only endpoint with no Shukah equivalent.
Which Shukah APIs the mobile app calls for users and points already have a Locate replacement, which do not, and how each one was checked on dev.
Log in or register with a phone number and a 4-digit SMS code — replaces Shukah GET /maeda/api/reset-otp and GET /maeda/api/verify-otp.
List the client's point transactions, newest first, one page at a time — replaces Shukah GET /maeda/client/point-history.
List the point packages a client can buy or gift, read one package, and list the gift occasions — replaces Shukah GET /maeda/point-offer and /maeda/point-occasion.
Create, read and pay a point gift order, and build the gift message — replaces the Shukah point-order calls and the two checkout-payment calls the app uses for gifts.
List the points questions and answers in English and Arabic — replaces Shukah GET /maeda/points-faq.
Read the client's point balance and expiry date, the earn-rate table, and redeem a gift-card code — replaces Shukah client/points, point-rate and giftcard-code/use.
Update the client's profile, switch push notifications on or off, and register a device — replaces Shukah PUT /maeda/client/:client_id and POST /maeda/client/add-device-id.
The Shukah (legacy) side of every API the mobile app calls in the user and points areas, set against the Locate API that replaces it, with the differences that cut across all of them.
Every change the mobile app must make to move from Shukah to Locate in the user and points areas, from the 2026-10-02 parity audit.
What replaced each Shukah API the mobile app calls for users, addresses and points — field by field — what is still missing, and how to get a test token to try the endpoints.
Check the app's Locate token and get the signed-in client's profile — replaces Shukah GET /maeda/api/verify-token.