{"info":{"_postman_id":"f44572ef-7ac8-415f-9fe0-3fcdd536aebb","name":"MyPets Store API","description":"

MyPets Store API

A full-featured e-commerce REST API for a pet food & supplies store — built with real-world architecture decisions, security at every layer, and a complete shopping experience covering everything from authentication to order fulfillment.

🌐 Base URL

https://my-pet-store-api.vercel.app\n

🔐 Authentication

Protected endpoints require a JWT token in the request header:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Key	Value	Required
`token`	JWT token from Sign In	Yes

⚠️ Rate Limiting

200 requests per 15 minutes per IP.

{ \"message\": \"To Many Request Try After 15 Minutes\" }\n

📦 Response Format

Success:

{ \"message\": \"done!\", \"data\": { ... } }\n

Error:

{ \"message\": \"Error description\" }\n

Reference Values

Product Categories: cats · dogs · birds · fish

Gender: male · female

Order Status: pending → confirmed → shipped → delivered · cancelled

Payment Methods: cash · card

Coupon Discount Types: percentage · fixed

Available Coupons:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Code	Type	Discount
`MYPETSSTORE`	percentage	100%
`ENG.DIAA ELDEEN`	percentage	100%
`SAVE10`	percentage	10%
`SAVE20`	percentage	20%
`SAVE30`	percentage	30%
`SAVE50`	percentage	50%
`WELCOME15`	percentage	15%
`PETS25`	percentage	25%
`OFF50`	fixed	50 EGP
`OFF100`	fixed	100 EGP
`OFF200`	fixed	200 EGP
`OFF500`	fixed	500 EGP

","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"MyPets Store API","slug":"mypets-store-api"}],"owner":"49715513","collectionId":"f44572ef-7ac8-415f-9fe0-3fcdd536aebb","publishedId":"2sBXqGqM2x","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-04-24T12:43:47.000Z"},"item":[{"name":"Auth","item":[{"name":"Sign Up","id":"382cabaf-cc87-4c5b-8baf-ebc8d7344357","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","description":"

Required

\n"}],"body":{"mode":"raw","raw":"{\n \"userName\": \"Diaa Eldeen\",\n \"email\": \"diaa.eldeen@gmail.com\",\n \"password\": \"SecurePass123\",\n \"rePassword\": \"SecurePass123\",\n \"age\": 22,\n \"gender\": \"male\",\n \"phone\": \"01012345678\"\n}","options":{"raw":{"language":"json"}}},"url":"https://my-pet-store-api.vercel.app/users/signup","description":"\n

Headers

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Key	Value	Required
`Content-Type`	`application/json`	✅ Yes

Body `raw (json)`

{\n  \"userName\": \"Diaa Eldeen\",\n  \"email\": \"diaa.eldeen@gmail.com\",\n  \"password\": \"SecurePass123\",\n  \"rePassword\": \"SecurePass123\",\n  \"age\": 22,\n  \"gender\": \"male\",\n  \"phone\": \"01012345678\"\n}\n

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Required	Rules
`userName`	string	✅ Yes	3–30 chars, letters/numbers/spaces/`-`/`_`
`email`	string	✅ Yes	Valid email — TLDs: `.com` `.net` `.org` `.eg` `.co`
`password`	string	✅ Yes	Min 8 characters
`rePassword`	string	✅ Yes	Must match `password`
`age`	number	✅ Yes	Integer, min 18
`gender`	string	⬜ No	`male` or `female`
`phone`	string	⬜ No	Egyptian: `010`/`011`/`012`/`015` + 8 digits

Success Response — `201 Created`

{\n  \"message\": \"done!\",\n  \"data\": {\n    \"_id\": \"64f1a2b3c4d5e6f7a8b9c0d1\",\n    \"userName\": \"Diaa Eldeen\",\n    \"email\": \"diaa.eldeen@gmail.com\",\n    \"age\": 22,\n    \"gender\": \"male\"\n  }\n}\n

Error Responses

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Message
`409`	`User Already Exist`
`422`	Validation error with details array
`500`	`Server Error!`

","urlObject":{"path":["users","signup"],"host":["https://my-pet-store-api.vercel.app"],"query":[],"variable":[]}},"response":[],"_postman_id":"382cabaf-cc87-4c5b-8baf-ebc8d7344357"},{"name":"Sign In","id":"a0586649-88b2-4e2a-91ff-56936d7bd286","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","description":"

Required

\n"}],"body":{"mode":"raw","raw":"{\n \"email\": \"diaa.eldeen@gmail.com\",\n \"password\": \"SecurePass123\"\n}","options":{"raw":{"language":"json"}}},"url":"https://my-pet-store-api.vercel.app/users/signin","description":"\n

Authenticate and receive a JWT token.

Headers

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Key	Value	Required
`Content-Type`	`application/json`	✅ Yes

Body `raw (json)`

{\n  \"email\": \"diaa.eldeen@gmail.com\",\n  \"password\": \"SecurePass123\"\n}\n

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Required	Rules
`email`	string	✅ Yes	Valid email
`password`	string	✅ Yes	Min 8 characters

Success Response — `200 OK`

{\n  \"message\": \"LogIn Succefully\",\n  \"data\": {\n    \"token\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...\"\n  }\n}\n

\n
⚠️ Save this token — required in the token header for all protected endpoints.
\n

Error Responses

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Message
`409`	`User Not Exist`
`400`	`Invalid Password`
`422`	Validation error

","urlObject":{"path":["users","signin"],"host":["https://my-pet-store-api.vercel.app"],"query":[],"variable":[]}},"response":[],"_postman_id":"a0586649-88b2-4e2a-91ff-56936d7bd286"},{"name":"Forget Password — Send OTP","id":"4ae5efab-38e8-4fab-9d70-cbc48d2a2bac","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"key":"Content-Type","value":"application/json","description":"

Required

\n"}],"body":{"mode":"raw","raw":"{\n \"email\": \"diaa.eldeen@gmail.com\"\n}","options":{"raw":{"language":"json"}}},"url":"https://my-pet-store-api.vercel.app/users/forgetPassword","description":"

Forget Password — Send OTP

Send a 6-digit OTP to the email. Valid for 2 minutes.

Headers

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Key	Value	Required
`Content-Type`	`application/json`	✅ Yes

Body `raw (json)`

{\n  \"email\": \"diaa.eldeen@gmail.com\"\n}\n

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Required	Rules
`email`	string	✅ Yes	Valid email of existing user

OTP Rate Limiting

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Condition	Result
OTP already sent & not expired	`You Can Resend Otp After {ttl} Second`
3+ attempts	Blocked 5 min: `You Have Exceeded The Max Number Of Tries`
Currently blocked	`Please Try Again After {seconds} Second`

Success Response — `200 OK`

{ \"message\": \"Otp Send Succefully\" }\n

Error Responses

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Message
`409`	`User Not Exist`
`422`	Validation error

","urlObject":{"path":["users","forgetPassword"],"host":["https://my-pet-store-api.vercel.app"],"query":[],"variable":[]}},"response":[],"_postman_id":"4ae5efab-38e8-4fab-9d70-cbc48d2a2bac"},{"name":"Confirm OTP","id":"8bc63ac8-2d3d-46db-abb2-56a91a2f688f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","description":"

Required

\n"}],"body":{"mode":"raw","raw":"{\n \"email\": \"diaa.eldeen@gmail.com\",\n \"otp\": \"482931\"\n}","options":{"raw":{"language":"json"}}},"url":"https://my-pet-store-api.vercel.app/users/confirmPassword","description":"

Confirm OTP

Verify the 6-digit OTP. On success, a verification token is stored in Redis for 5 minutes.

Headers

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Key	Value	Required
`Content-Type`	`application/json`	✅ Yes

Body `raw (json)`

{\n  \"email\": \"diaa.eldeen@gmail.com\",\n  \"otp\": \"482931\"\n}\n

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Required	Rules
`email`	string	✅ Yes	Same email used in Forget Password
`otp`	string	✅ Yes	Exactly 6 characters

Success Response — `200 OK`

{ \"message\": \"Otp Is Valid\" }\n

Error Responses

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Message
`500`	`Invalid or Expired OTP`
`500`	`Otp Is Invalid`
`422`	Validation error

Password Reset Flow

1. PATCH /users/forgetPassword   → Send OTP\n2. POST  /users/confirmPassword  → Verify OTP (valid 2 min)\n3. PATCH /users/resetPassword    → Set new password (within 5 min of step 2)\n

","urlObject":{"path":["users","confirmPassword"],"host":["https://my-pet-store-api.vercel.app"],"query":[],"variable":[]}},"response":[],"_postman_id":"8bc63ac8-2d3d-46db-abb2-56a91a2f688f"},{"name":"Reset Password","id":"a2ca2937-ea33-4a43-9755-9567865d2c15","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"key":"Content-Type","value":"application/json","description":"

Required

\n"}],"body":{"mode":"raw","raw":"{\n \"email\": \"diaa.eldeen@gmail.com\",\n \"newPassword\": \"NewSecurePass456\",\n \"rePassword\": \"NewSecurePass456\"\n}","options":{"raw":{"language":"json"}}},"url":"https://my-pet-store-api.vercel.app/users/resetPassword","description":"

Reset Password

Set a new password after OTP verification. New password must differ from the current one.

Headers

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Key	Value	Required
`Content-Type`	`application/json`	✅ Yes

Body `raw (json)`

{\n  \"email\": \"diaa.eldeen@gmail.com\",\n  \"newPassword\": \"NewSecurePass456\",\n  \"rePassword\": \"NewSecurePass456\"\n}\n

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Required	Rules
`email`	string	✅ Yes	Same email used throughout the flow
`newPassword`	string	✅ Yes	Min 8 chars, must differ from current password
`rePassword`	string	✅ Yes	Must match `newPassword`

Success Response — `200 OK`

{ \"message\": \"Password Reset Successfully\" }\n

Error Responses

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Message
`500`	`Otp not verified`
`409`	`User Not Exist`
`400`	`New password must be different from old password`
`422`	Validation error

","urlObject":{"path":["users","resetPassword"],"host":["https://my-pet-store-api.vercel.app"],"query":[],"variable":[]}},"response":[],"_postman_id":"a2ca2937-ea33-4a43-9755-9567865d2c15"},{"name":"Update Password","id":"08a2754b-59b2-48e2-b50f-bcbef6a45479","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"key":"token","value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiI2NGYxYTJiM2M0ZDVlNmY3YThiOWMwZDEiLCJpYXQiOjE3MDAwMDAwMDB9.abc123","description":"

Required — JWT token from Sign In

\n"},{"key":"Content-Type","value":"application/json","description":"

Required

\n"}],"body":{"mode":"raw","raw":"{\n \"oldPassword\": \"SecurePass123\",\n \"newPassword\": \"NewSecurePass456\",\n \"confirmPassword\": \"NewSecurePass456\"\n}","options":{"raw":{"language":"json"}}},"url":"https://my-pet-store-api.vercel.app/users/updatePassword","description":"

Update Password

Change the authenticated user's password. Updates logOutTime to invalidate previous tokens.

Headers

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Key	Value	Required
`token`	JWT token from Sign In	✅ Yes
`Content-Type`	`application/json`	✅ Yes

Body `raw (json)`

{\n  \"oldPassword\": \"SecurePass123\",\n  \"newPassword\": \"NewSecurePass456\",\n  \"confirmPassword\": \"NewSecurePass456\"\n}\n

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Required	Rules
`oldPassword`	string	✅ Yes	Current password
`newPassword`	string	✅ Yes	Min 8 characters
`confirmPassword`	string	✅ Yes	Must match `newPassword`

Success Response — `200 OK`

{ \"message\": \"done!\" }\n

Error Responses

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Message
`401`	`Token Not Provide` / `Invalid Token` / `User Not Found`
`400`	`Invalid old Password`
`422`	Validation error

","urlObject":{"path":["users","updatePassword"],"host":["https://my-pet-store-api.vercel.app"],"query":[],"variable":[]}},"response":[],"_postman_id":"08a2754b-59b2-48e2-b50f-bcbef6a45479"}],"id":"c549c437-47ef-429e-88a2-7932b8befaed","description":"

Endpoints for registration, login, and password management.

\n","_postman_id":"c549c437-47ef-429e-88a2-7932b8befaed"},{"name":"User","item":[{"name":"Get Profile","id":"621b9c24-d04b-47ce-833e-3d81851396e8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"token","value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiI2NGYxYTJiM2M0ZDVlNmY3YThiOWMwZDEiLCJpYXQiOjE3MDAwMDAwMDB9.abc123","description":"

Required — JWT token from Sign In

\n"}],"url":"https://my-pet-store-api.vercel.app/users/profile","description":"

Get Profile

Fetch the authenticated user's profile. Phone is returned decrypted. Sensitive fields (password, createdAt, updatedAt, __v) are excluded.

Headers

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Key	Value	Required
`token`	JWT token from Sign In	✅ Yes

Success Response — `200 OK`

{\n  \"message\": \"done!\",\n  \"data\": {\n    \"_id\": \"64f1a2b3c4d5e6f7a8b9c0d1\",\n    \"firstName\": \"Diaa\",\n    \"lastName\": \"Eldeen\",\n    \"userName\": \"Diaa Eldeen\",\n    \"email\": \"diaa.eldeen@gmail.com\",\n    \"age\": 22,\n    \"gender\": \"male\",\n    \"phone\": \"01012345678\",\n    \"addresses\": []\n  }\n}\n

Error Responses

\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Message
`401`	`Token Not Provide` / `Invalid Token` / `User Not Found`

","urlObject":{"path":["users","profile"],"host":["https://my-pet-store-api.vercel.app"],"query":[],"variable":[]}},"response":[],"_postman_id":"621b9c24-d04b-47ce-833e-3d81851396e8"},{"name":"Update Profile","id":"17da6957-97ae-4444-8e58-70771154a2a6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"key":"token","value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiI2NGYxYTJiM2M0ZDVlNmY3YThiOWMwZDEiLCJpYXQiOjE3MDAwMDAwMDB9.abc123","description":"

Required — JWT token from Sign In

\n"},{"key":"Content-Type","value":"application/json","description":"

Required

\n"}],"body":{"mode":"raw","raw":"{\n \"firstName\": \"Diaa\",\n \"lastName\": \"Eldeen\",\n \"gender\": \"male\",\n \"phone\": \"01098765432\",\n \"age\": 23\n}","options":{"raw":{"language":"json"}}},"url":"https://my-pet-store-api.vercel.app/users/updateProfile","description":"

Update Profile

Update profile info. All fields are optional — send only the fields you want to update. phone is encrypted before saving.

Headers

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Key	Value	Required
`token`	JWT token from Sign In	✅ Yes
`Content-Type`	`application/json`	✅ Yes

Body `raw (json)`

{\n  \"firstName\": \"Diaa\",\n  \"lastName\": \"Eldeen\",\n  \"gender\": \"male\",\n  \"phone\": \"01098765432\",\n  \"age\": 23\n}\n

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Required	Rules
`firstName`	string	⬜ No	3–30 chars
`lastName`	string	⬜ No	3–30 chars
`gender`	string	⬜ No	`male` or `female`
`phone`	string	⬜ No	Egyptian: `010`/`011`/`012`/`015` + 8 digits
`age`	number	⬜ No	Integer, min 18

Success Response — `200 OK`

{\n  \"message\": \"done!\",\n  \"data\": { \"_id\": \"64f1a2b3c4d5e6f7a8b9c0d1\", \"firstName\": \"Diaa\", ... }\n}\n

Error Responses

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Message
`401`	`Token Not Provide` / `Invalid Token` / `User Not Found`
`422`	Validation error

","urlObject":{"path":["users","updateProfile"],"host":["https://my-pet-store-api.vercel.app"],"query":[],"variable":[]}},"response":[],"_postman_id":"17da6957-97ae-4444-8e58-70771154a2a6"},{"name":"Add Address","id":"19fe399c-b6bb-4e26-8576-2253d211634a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"token","value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiI2NGYxYTJiM2M0ZDVlNmY3YThiOWMwZDEiLCJpYXQiOjE3MDAwMDAwMDB9.abc123","description":"

Required — JWT token from Sign In

\n"},{"key":"Content-Type","value":"application/json","description":"

Required

\n"}],"body":{"mode":"raw","raw":"{\n \"city\": \"Cairo\",\n \"details\": \"123 Tahrir Square, Downtown\",\n \"isDefault\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://my-pet-store-api.vercel.app/users/address","description":"

Add Address

Add a delivery address. Max 10 addresses per user. First address is always set as default automatically.

Headers

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Key	Value	Required
`token`	JWT token from Sign In	✅ Yes
`Content-Type`	`application/json`	✅ Yes

Body `raw (json)`

{\n  \"city\": \"Cairo\",\n  \"details\": \"123 Tahrir Square, Downtown\",\n  \"isDefault\": true\n}\n

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Required	Rules
`city`	string	✅ Yes	Min 2 characters
`details`	string	✅ Yes	Min 5 characters
`isDefault`	boolean	⬜ No	`true` sets this as default

Success Response — `201 Created`

{\n  \"message\": \"done!\",\n  \"data\": [\n    { \"_id\": \"64f1a2b3c4d5e6f7a8b9c0b1\", \"city\": \"Cairo\", \"details\": \"123 Tahrir Square, Downtown\", \"isDefault\": true }\n  ]\n}\n

Error Responses

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Message
`401`	`Token Not Provide` / `Invalid Token` / `User Not Found`
`400`	`City and details are required`
`400`	`Maximum 10 addresses allowed`
`422`	Validation error

","urlObject":{"path":["users","address"],"host":["https://my-pet-store-api.vercel.app"],"query":[],"variable":[]}},"response":[],"_postman_id":"19fe399c-b6bb-4e26-8576-2253d211634a"},{"name":"Get Addresses","id":"598bcaa7-ce65-4881-84b5-68d9a22a823f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"token","value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiI2NGYxYTJiM2M0ZDVlNmY3YThiOWMwZDEiLCJpYXQiOjE3MDAwMDAwMDB9.abc123","description":"

Required — JWT token from Sign In

\n"}],"url":"https://my-pet-store-api.vercel.app/users/address","description":"

Get Addresses

Fetch all delivery addresses of the authenticated user.

Headers

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Key	Value	Required
`token`	JWT token from Sign In	✅ Yes

Success Response — `200 OK`

{\n  \"message\": \"done!\",\n  \"data\": [\n    { \"_id\": \"64f1a2b3c4d5e6f7a8b9c0b1\", \"city\": \"Cairo\", \"details\": \"123 Tahrir Square\", \"isDefault\": true },\n    { \"_id\": \"64f1a2b3c4d5e6f7a8b9c0b2\", \"city\": \"Alexandria\", \"details\": \"45 Corniche Road\", \"isDefault\": false }\n  ]\n}\n

\n
If no addresses, data returns an empty array [].
\n

Error Responses

\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Message
`401`	`Token Not Provide` / `Invalid Token` / `User Not Found`

","urlObject":{"path":["users","address"],"host":["https://my-pet-store-api.vercel.app"],"query":[],"variable":[]}},"response":[],"_postman_id":"598bcaa7-ce65-4881-84b5-68d9a22a823f"},{"name":"Update Address","id":"a1515609-2962-4ba7-9ed0-3f671aa6adae","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"key":"token","value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiI2NGYxYTJiM2M0ZDVlNmY3YThiOWMwZDEiLCJpYXQiOjE3MDAwMDAwMDB9.abc123","description":"

Required — JWT token from Sign In

\n"},{"key":"Content-Type","value":"application/json","description":"

Required

\n"}],"body":{"mode":"raw","raw":"{\n \"city\": \"Giza\",\n \"details\": \"10 Pyramids Road, Haram\",\n \"isDefault\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://my-pet-store-api.vercel.app/users/address/64f1a2b3c4d5e6f7a8b9c0b1","description":"

Update Address

Update an existing address. At least one field required. Setting isDefault: false only allowed if another default exists.

Headers

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Key	Value	Required
`token`	JWT token from Sign In	✅ Yes
`Content-Type`	`application/json`	✅ Yes

URL Params

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Param	Type	Required	Description
`addressId`	string	✅ Yes	The `_id` of the address to update

Body `raw (json)`

{\n  \"city\": \"Giza\",\n  \"details\": \"10 Pyramids Road, Haram\",\n  \"isDefault\": true\n}\n

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Required	Rules
`city`	string	⬜ No	Min 2 characters
`details`	string	⬜ No	Min 5 characters
`isDefault`	boolean	⬜ No	`true` to set as default

Success Response — `200 OK`

{\n  \"message\": \"done!\",\n  \"data\": [ { \"_id\": \"64f1a2b3c4d5e6f7a8b9c0b1\", \"city\": \"Giza\", \"isDefault\": true } ]\n}\n

Error Responses

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Message
`401`	`Token Not Provide` / `Invalid Token` / `User Not Found`
`404`	`Address not found`
`400`	`You must have at least one default address`
`422`	Validation error

","urlObject":{"path":["users","address","64f1a2b3c4d5e6f7a8b9c0b1"],"host":["https://my-pet-store-api.vercel.app"],"query":[],"variable":[]}},"response":[],"_postman_id":"a1515609-2962-4ba7-9ed0-3f671aa6adae"},{"name":"Remove Address","id":"42ff98fb-f6bc-4316-9a0c-13879986eddd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[{"key":"token","value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiI2NGYxYTJiM2M0ZDVlNmY3YThiOWMwZDEiLCJpYXQiOjE3MDAwMDAwMDB9.abc123","description":"

Required — JWT token from Sign In

\n"}],"url":"https://my-pet-store-api.vercel.app/users/address/64f1a2b3c4d5e6f7a8b9c0b1","description":"

Remove Address

Delete an address. If deleted address was default, the first remaining address becomes default automatically.

Headers

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Key	Value	Required
`token`	JWT token from Sign In	✅ Yes

URL Params

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Param	Type	Required	Description
`addressId`	string	✅ Yes	The `_id` of the address to delete

Success Response — `200 OK`

{ \"message\": \"Address removed\" }\n

Error Responses

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Message
`401`	`Token Not Provide` / `Invalid Token` / `User Not Found`
`404`	`Address not found`

","urlObject":{"path":["users","address","64f1a2b3c4d5e6f7a8b9c0b1"],"host":["https://my-pet-store-api.vercel.app"],"query":[],"variable":[]}},"response":[],"_postman_id":"42ff98fb-f6bc-4316-9a0c-13879986eddd"}],"id":"5b0840e1-eba2-44e2-bd71-9c74ae25a849","description":"

Profile and address book management.

\n","_postman_id":"5b0840e1-eba2-44e2-bd71-9c74ae25a849"},{"name":"Products","item":[{"name":"Get All Products","id":"88d28d1b-1b73-4a85-ba4f-dc72193cdd96","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://my-pet-store-api.vercel.app/products","description":"

Get All Products

Fetch all products. Returned in shuffled order. No authentication required.

Pagination is optional — omit both params to get all products at once.

Query Params (Optional)

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Param	Type	Required	Rules
`page`	number	⬜ No	Min 1, default 1
`limit`	number	⬜ No	Min 1, max 50, default 10

Success Response — `200 OK` (without pagination)

{\n  \"message\": \"done!\",\n  \"data\": [\n    {\n      \"_id\": \"64f1a2b3c4d5e6f7a8b9c0d2\",\n      \"name\": \"Royal Canin Adult Cat Food\",\n      \"price\": 250,\n      \"category\": \"cats\",\n      \"rating\": 4.5\n    }\n  ]\n}\n

Success Response — `200 OK` (with pagination)

{\n  \"message\": \"done!\",\n  \"data\": {\n    \"products\": [ { ... } ],\n    \"pagination\": { \"total\": 40, \"page\": 1, \"limit\": 10, \"totalPages\": 4 }\n  }\n}\n

\n","urlObject":{"path":["products"],"host":["https://my-pet-store-api.vercel.app"],"query":[{"disabled":true,"description":{"content":"

Page number (min 1)

\n","type":"text/plain"},"key":"page","value":"1"},{"disabled":true,"description":{"content":"

Results per page (min 1, max 50)

\n","type":"text/plain"},"key":"limit","value":"10"}],"variable":[]}},"response":[],"_postman_id":"88d28d1b-1b73-4a85-ba4f-dc72193cdd96"},{"name":"Get Specific Product","id":"f9bf50d7-a214-47e8-8e16-dbe59dfeebc3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://my-pet-store-api.vercel.app/products/64f1a2b3c4d5e6f7a8b9c0d2","description":"

Get Specific Product

Fetch a single product by its _id. No authentication required.

URL Params

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Param	Type	Required	Description
`productId`	string	✅ Yes	MongoDB `_id` of the product

Success Response — `200 OK`

{\n  \"message\": \"done!\",\n  \"data\": {\n    \"_id\": \"64f1a2b3c4d5e6f7a8b9c0d2\",\n    \"name\": \"Royal Canin Adult Cat Food\",\n    \"slug\": \"royal-canin-adult-cat-food\",\n    \"description\": \"Premium dry cat food for adult cats\",\n    \"price\": 250,\n    \"image\": { \"secure_url\": \"https://res.cloudinary.com/...\", \"public_id\": \"myPetStore/...\" },\n    \"category\": \"cats\",\n    \"weight\": { \"value\": 2, \"unit\": \"kg\" },\n    \"rating\": 4.5\n  }\n}\n

Error Responses

\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Message
`404`	`Product Not Found`

","urlObject":{"path":["products","64f1a2b3c4d5e6f7a8b9c0d2"],"host":["https://my-pet-store-api.vercel.app"],"query":[],"variable":[]}},"response":[],"_postman_id":"f9bf50d7-a214-47e8-8e16-dbe59dfeebc3"},{"name":"Filter Products","id":"d48ab29f-4bee-42ef-8dd3-e93993965357","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://my-pet-store-api.vercel.app/products/filter?category=cats&name=royal&minPrice=100&maxPrice=500","description":"

Filter Products

Search and filter products. All params optional and combinable. No authentication required.

Query Params (All Optional)

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Param	Type	Required	Description
`category`	string	⬜ No	`cats` / `dogs` / `birds` / `fish`
`name`	string	⬜ No	Case-insensitive partial match
`minPrice`	number	⬜ No	Price >= this value
`maxPrice`	number	⬜ No	Price <= this value
`page`	number	⬜ No	Min 1, default 1
`limit`	number	⬜ No	Min 1, max 50, default 10

Success Response — `200 OK`

{\n  \"message\": \"done!\",\n  \"data\": [\n    { \"_id\": \"64f1a2b3c4d5e6f7a8b9c0d2\", \"name\": \"Royal Canin Adult Cat Food\", \"price\": 250, \"category\": \"cats\" }\n  ]\n}\n

\n
If no products match, data returns [].
\n

\n","urlObject":{"path":["products","filter"],"host":["https://my-pet-store-api.vercel.app"],"query":[{"description":{"content":"

cats / dogs / birds / fish

\n","type":"text/plain"},"key":"category","value":"cats"},{"description":{"content":"

Case-insensitive partial match

\n","type":"text/plain"},"key":"name","value":"royal"},{"description":{"content":"

Minimum price (inclusive)

\n","type":"text/plain"},"key":"minPrice","value":"100"},{"description":{"content":"

Maximum price (inclusive)

\n","type":"text/plain"},"key":"maxPrice","value":"500"},{"disabled":true,"description":{"content":"

Page number

\n","type":"text/plain"},"key":"page","value":"1"},{"disabled":true,"description":{"content":"

Results per page (max 50)

\n","type":"text/plain"},"key":"limit","value":"10"}],"variable":[]}},"response":[],"_postman_id":"d48ab29f-4bee-42ef-8dd3-e93993965357"}],"id":"92fa7e79-423c-4002-b144-12532b523e30","description":"

Browse and filter products.

\n","_postman_id":"92fa7e79-423c-4002-b144-12532b523e30"},{"name":"Reviews","item":[{"name":"Get Product Reviews","id":"cb09bd28-6eb9-4453-bbbd-500379ba9040","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://my-pet-store-api.vercel.app/products/64f1a2b3c4d5e6f7a8b9c0d2/reviews","description":"

Get Product Reviews

Fetch all reviews for a product. Sorted by newest first. No authentication required.

URL Params

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Param	Type	Required	Description
`productId`	string	✅ Yes	MongoDB `_id` of the product

Success Response — `200 OK`

{\n  \"message\": \"done!\",\n  \"data\": [\n    {\n      \"_id\": \"64f1a2b3c4d5e6f7a8b9c0a1\",\n      \"user\": { \"_id\": \"64f1a2b3c4d5e6f7a8b9c0d1\", \"firstName\": \"Diaa\", \"lastName\": \"Eldeen\", \"gender\": \"male\" },\n      \"product\": \"64f1a2b3c4d5e6f7a8b9c0d2\",\n      \"rating\": 5,\n      \"comment\": \"Great product, my cat loves it!\",\n      \"createdAt\": \"2026-04-15T10:00:00.000Z\"\n    }\n  ]\n}\n

\n
If no reviews, data returns [].
\n

\n","urlObject":{"path":["products","64f1a2b3c4d5e6f7a8b9c0d2","reviews"],"host":["https://my-pet-store-api.vercel.app"],"query":[],"variable":[]}},"response":[],"_postman_id":"cb09bd28-6eb9-4453-bbbd-500379ba9040"},{"name":"Add Review","id":"5dc1bd52-c5fe-482a-bef5-6a1aa5b304e8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"token","value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiI2NGYxYTJiM2M0ZDVlNmY3YThiOWMwZDEiLCJpYXQiOjE3MDAwMDAwMDB9.abc123","description":"

Required — JWT token from Sign In

\n"},{"key":"Content-Type","value":"application/json","description":"

Required

\n"}],"body":{"mode":"raw","raw":"{\n \"rating\": 5,\n \"comment\": \"Great product, my cat loves it!\"\n}","options":{"raw":{"language":"json"}}},"url":"https://my-pet-store-api.vercel.app/products/64f1a2b3c4d5e6f7a8b9c0d2/reviews","description":"

Add Review

Submit a review. One review per user per product. Product rating is auto-recalculated.

Headers

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Key	Value	Required
`token`	JWT token from Sign In	✅ Yes
`Content-Type`	`application/json`	✅ Yes

URL Params

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Param	Type	Required	Description
`productId`	string	✅ Yes	MongoDB `_id` of the product

Body `raw (json)`

{\n  \"rating\": 5,\n  \"comment\": \"Great product, my cat loves it!\"\n}\n

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Required	Rules
`rating`	number	✅ Yes	Integer between 1 and 5
`comment`	string	✅ Yes	Min 3 characters

Success Response — `201 Created`

{\n  \"message\": \"done!\",\n  \"data\": { \"_id\": \"64f1a2b3c4d5e6f7a8b9c0a1\", \"rating\": 5, \"comment\": \"Great product, my cat loves it!\" }\n}\n

Error Responses

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Message
`401`	`Token Not Provide` / `Invalid Token` / `User Not Found`
`404`	`Product not found`
`400`	`You already reviewed this product`
`422`	Validation error

","urlObject":{"path":["products","64f1a2b3c4d5e6f7a8b9c0d2","reviews"],"host":["https://my-pet-store-api.vercel.app"],"query":[],"variable":[]}},"response":[],"_postman_id":"5dc1bd52-c5fe-482a-bef5-6a1aa5b304e8"},{"name":"Update Review","id":"a78c150f-3276-4a32-b7f6-9eede1981776","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"key":"token","value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiI2NGYxYTJiM2M0ZDVlNmY3YThiOWMwZDEiLCJpYXQiOjE3MDAwMDAwMDB9.abc123","description":"

Required — JWT token from Sign In

\n"},{"key":"Content-Type","value":"application/json","description":"

Required

\n"}],"body":{"mode":"raw","raw":"{\n \"rating\": 4,\n \"comment\": \"Still good but arrived a bit late\"\n}","options":{"raw":{"language":"json"}}},"url":"https://my-pet-store-api.vercel.app/products/64f1a2b3c4d5e6f7a8b9c0d2/reviews/64f1a2b3c4d5e6f7a8b9c0a1","description":"

Update Review

Update own review only. At least one field required. Product rating is auto-recalculated.

Headers

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Key	Value	Required
`token`	JWT token from Sign In	✅ Yes
`Content-Type`	`application/json`	✅ Yes

URL Params

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Param	Type	Required	Description
`productId`	string	✅ Yes	MongoDB `_id` of the product
`reviewId`	string	✅ Yes	MongoDB `_id` of the review

Body `raw (json)`

{\n  \"rating\": 4,\n  \"comment\": \"Still good but arrived a bit late\"\n}\n

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Required	Rules
`rating`	number	⬜ No	Integer between 1 and 5
`comment`	string	⬜ No	Min 3 characters

\n
At least one of rating or comment must be provided.
\n

Success Response — `200 OK`

{\n  \"message\": \"done!\",\n  \"data\": { \"_id\": \"64f1a2b3c4d5e6f7a8b9c0a1\", \"rating\": 4, \"comment\": \"Still good but arrived a bit late\" }\n}\n

Error Responses

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Message
`401`	`Token Not Provide` / `Invalid Token` / `User Not Found`
`404`	`Review not found or not authorized`
`422`	`You must provide at least rating or comment`

","urlObject":{"path":["products","64f1a2b3c4d5e6f7a8b9c0d2","reviews","64f1a2b3c4d5e6f7a8b9c0a1"],"host":["https://my-pet-store-api.vercel.app"],"query":[],"variable":[]}},"response":[],"_postman_id":"a78c150f-3276-4a32-b7f6-9eede1981776"},{"name":"Delete Review","id":"b920cf63-96c2-40f5-973a-8dbcf7f4644e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[{"key":"token","value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiI2NGYxYTJiM2M0ZDVlNmY3YThiOWMwZDEiLCJpYXQiOjE3MDAwMDAwMDB9.abc123","description":"

Required — JWT token from Sign In

\n"}],"url":"https://my-pet-store-api.vercel.app/products/64f1a2b3c4d5e6f7a8b9c0d2/reviews/64f1a2b3c4d5e6f7a8b9c0a1","description":"

Delete Review

Delete own review only. Product rating is auto-recalculated.

Headers

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Key	Value	Required
`token`	JWT token from Sign In	✅ Yes

URL Params

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Param	Type	Required	Description
`productId`	string	✅ Yes	MongoDB `_id` of the product
`reviewId`	string	✅ Yes	MongoDB `_id` of the review

Success Response — `200 OK`

{ \"message\": \"Review deleted successfully\" }\n

Error Responses

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Message
`401`	`Token Not Provide` / `Invalid Token` / `User Not Found`
`404`	`Review not found or not authorized`

","urlObject":{"path":["products","64f1a2b3c4d5e6f7a8b9c0d2","reviews","64f1a2b3c4d5e6f7a8b9c0a1"],"host":["https://my-pet-store-api.vercel.app"],"query":[],"variable":[]}},"response":[],"_postman_id":"b920cf63-96c2-40f5-973a-8dbcf7f4644e"}],"id":"ef3b447d-72fd-45f1-a095-c0772d1a260b","description":"

Product reviews — nested under /products/:productId/reviews. Rating is auto-recalculated after every operation.

\n","_postman_id":"ef3b447d-72fd-45f1-a095-c0772d1a260b"},{"name":"Wishlist","item":[{"name":"Add to Wishlist","id":"0d14e0b9-526b-45c7-b17e-9db86b975227","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"token","value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiI2NGYxYTJiM2M0ZDVlNmY3YThiOWMwZDEiLCJpYXQiOjE3MDAwMDAwMDB9.abc123","description":"

Required — JWT token from Sign In

\n"},{"key":"Content-Type","value":"application/json","description":"

Required

\n"}],"body":{"mode":"raw","raw":"{\n \"productId\": \"64f1a2b3c4d5e6f7a8b9c0d2\"\n}","options":{"raw":{"language":"json"}}},"url":"https://my-pet-store-api.vercel.app/wishlist","description":"

Add to Wishlist

Add a product to the wishlist. Same product cannot be added twice (unique index on user + product).

Headers

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Key	Value	Required
`token`	JWT token from Sign In	✅ Yes
`Content-Type`	`application/json`	✅ Yes

Body `raw (json)`

{\n  \"productId\": \"64f1a2b3c4d5e6f7a8b9c0d2\"\n}\n

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Required	Description
`productId`	string	✅ Yes	MongoDB `_id` of the product

Success Response — `201 Created`

{\n  \"message\": \"Added to wishlist\",\n  \"data\": {\n    \"_id\": \"64f1a2b3c4d5e6f7a8b9c0d9\",\n    \"user\": \"64f1a2b3c4d5e6f7a8b9c0d1\",\n    \"product\": \"64f1a2b3c4d5e6f7a8b9c0d2\",\n    \"createdAt\": \"2026-04-15T10:00:00.000Z\"\n  }\n}\n

Error Responses

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Message
`401`	`Token Not Provide` / `Invalid Token` / `User Not Found`
`400`	`ProductId is required`
`404`	`Product not found`
`400`	`Product already in wishlist`

","urlObject":{"path":["wishlist"],"host":["https://my-pet-store-api.vercel.app"],"query":[],"variable":[]}},"response":[],"_postman_id":"0d14e0b9-526b-45c7-b17e-9db86b975227"},{"name":"Get Wishlist","id":"4feee2a8-3b99-4a73-b120-42e11e7383d6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"token","value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiI2NGYxYTJiM2M0ZDVlNmY3YThiOWMwZDEiLCJpYXQiOjE3MDAwMDAwMDB9.abc123","description":"

Required — JWT token from Sign In

\n"}],"url":"https://my-pet-store-api.vercel.app/wishlist","description":"

Get Wishlist

Fetch all wishlist items. Sorted newest first. Each item includes full product data.

Headers

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Key	Value	Required
`token`	JWT token from Sign In	✅ Yes

Success Response — `200 OK`

{\n  \"message\": \"done!\",\n  \"data\": {\n    \"count\": 1,\n    \"wishlist\": [\n      {\n        \"_id\": \"64f1a2b3c4d5e6f7a8b9c0d9\",\n        \"product\": {\n          \"_id\": \"64f1a2b3c4d5e6f7a8b9c0d2\",\n          \"name\": \"Royal Canin Adult Cat Food\",\n          \"price\": 250,\n          \"category\": \"cats\",\n          \"rating\": 4.5\n        },\n        \"createdAt\": \"2026-04-15T10:00:00.000Z\"\n      }\n    ]\n  }\n}\n

Error Responses

\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Message
`401`	`Token Not Provide` / `Invalid Token` / `User Not Found`

","urlObject":{"path":["wishlist"],"host":["https://my-pet-store-api.vercel.app"],"query":[],"variable":[]}},"response":[],"_postman_id":"4feee2a8-3b99-4a73-b120-42e11e7383d6"},{"name":"Remove from Wishlist","id":"153aae0b-ec14-4f91-ac8d-696c46dacc5c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[{"key":"token","value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiI2NGYxYTJiM2M0ZDVlNmY3YThiOWMwZDEiLCJpYXQiOjE3MDAwMDAwMDB9.abc123","description":"

Required — JWT token from Sign In

\n"}],"url":"https://my-pet-store-api.vercel.app/wishlist/64f1a2b3c4d5e6f7a8b9c0d2","description":"

Remove from Wishlist

Remove a specific product from the wishlist.

Headers

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Key	Value	Required
`token`	JWT token from Sign In	✅ Yes

URL Params

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Param	Type	Required	Description
`productId`	string	✅ Yes	MongoDB `_id` of the product to remove

Success Response — `200 OK`

{ \"message\": \"Removed from wishlist\" }\n

Error Responses

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Message
`401`	`Token Not Provide` / `Invalid Token` / `User Not Found`
`404`	`Item not found in wishlist`

","urlObject":{"path":["wishlist","64f1a2b3c4d5e6f7a8b9c0d2"],"host":["https://my-pet-store-api.vercel.app"],"query":[],"variable":[]}},"response":[],"_postman_id":"153aae0b-ec14-4f91-ac8d-696c46dacc5c"},{"name":"Clear Wishlist","id":"8b50f2fb-6504-4106-8049-e787cc3566ac","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[{"key":"token","value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiI2NGYxYTJiM2M0ZDVlNmY3YThiOWMwZDEiLCJpYXQiOjE3MDAwMDAwMDB9.abc123","description":"

Required — JWT token from Sign In

\n"}],"url":"https://my-pet-store-api.vercel.app/wishlist","description":"

Clear Wishlist

Delete all products from the wishlist in one operation.

Headers

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Key	Value	Required
`token`	JWT token from Sign In	✅ Yes

Success Response — `200 OK`

{\n  \"message\": \"Wishlist cleared successfully\",\n  \"data\": { \"deletedCount\": 3 }\n}\n

Error Responses

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Message
`401`	`Token Not Provide` / `Invalid Token` / `User Not Found`
`404`	`Wishlist is already empty`

","urlObject":{"path":["wishlist"],"host":["https://my-pet-store-api.vercel.app"],"query":[],"variable":[]}},"response":[],"_postman_id":"8b50f2fb-6504-4106-8049-e787cc3566ac"}],"id":"da77528c-50b1-4a6e-9079-99aa6073095f","description":"

User wishlist — all endpoints require authentication. Same product cannot be added twice.

\n","_postman_id":"da77528c-50b1-4a6e-9079-99aa6073095f"},{"name":"Cart","item":[{"name":"Add to Cart","id":"8153d3cd-d724-4163-a2be-f5a314fdfa48","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"token","value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiI2NGYxYTJiM2M0ZDVlNmY3YThiOWMwZDEiLCJpYXQiOjE3MDAwMDAwMDB9.abc123","description":"

Required — JWT token from Sign In

\n"},{"key":"Content-Type","value":"application/json","description":"

Required

\n"}],"body":{"mode":"raw","raw":"{\n \"productId\": \"64f1a2b3c4d5e6f7a8b9c0d2\",\n \"quantity\": 2\n}","options":{"raw":{"language":"json"}}},"url":"https://my-pet-store-api.vercel.app/cart","description":"

Add to Cart

Add a product. If no cart exists, one is created. If product already in cart, quantity is incremented. Price is locked at the time of adding.

Headers

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Key	Value	Required
`token`	JWT token from Sign In	✅ Yes
`Content-Type`	`application/json`	✅ Yes

Body `raw (json)`

{\n  \"productId\": \"64f1a2b3c4d5e6f7a8b9c0d2\",\n  \"quantity\": 2\n}\n

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Required	Rules
`productId`	string	✅ Yes	MongoDB `_id` of the product
`quantity`	number	⬜ No	Min 1, defaults to `1`

Success Response — `200 OK`

{\n  \"message\": \"done!\",\n  \"data\": {\n    \"_id\": \"64f1a2b3c4d5e6f7a8b9c0e1\",\n    \"user\": \"64f1a2b3c4d5e6f7a8b9c0d1\",\n    \"products\": [ { \"product\": \"64f1a2b3c4d5e6f7a8b9c0d2\", \"quantity\": 2, \"price\": 250 } ],\n    \"totalPrice\": 500,\n    \"couponCode\": null,\n    \"discountAmount\": 0,\n    \"discountedPrice\": 0\n  }\n}\n

Error Responses

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Message
`401`	`Token Not Provide` / `Invalid Token` / `User Not Found`
`400`	`ProductId is required`
`404`	`Product not found`
`422`	Validation error

","urlObject":{"path":["cart"],"host":["https://my-pet-store-api.vercel.app"],"query":[],"variable":[]}},"response":[],"_postman_id":"8153d3cd-d724-4163-a2be-f5a314fdfa48"},{"name":"Get Cart","id":"268ea88c-01d7-4504-a195-c6e7f8abcbd1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"token","value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiI2NGYxYTJiM2M0ZDVlNmY3YThiOWMwZDEiLCJpYXQiOjE3MDAwMDAwMDB9.abc123","description":"

Required — JWT token from Sign In

\n"}],"url":"https://my-pet-store-api.vercel.app/cart","description":"

Get Cart

Fetch the current cart. Products are populated with name, price, and image. If no cart exists, an empty structure is returned.

Headers

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Key	Value	Required
`token`	JWT token from Sign In	✅ Yes

Success Response — `200 OK` (cart exists)

{\n  \"message\": \"done!\",\n  \"data\": {\n    \"_id\": \"64f1a2b3c4d5e6f7a8b9c0e1\",\n    \"products\": [\n      {\n        \"product\": { \"_id\": \"64f1a2b3c4d5e6f7a8b9c0d2\", \"name\": \"Royal Canin Adult Cat Food\", \"price\": 250, \"image\": { \"secure_url\": \"...\" } },\n        \"quantity\": 2,\n        \"price\": 250\n      }\n    ],\n    \"totalPrice\": 500,\n    \"couponCode\": \"SAVE20\",\n    \"discountAmount\": 100,\n    \"discountedPrice\": 400\n  }\n}\n

Success Response — `200 OK` (empty cart)

{\n  \"message\": \"Cart Is Empty !\",\n  \"data\": { \"products\": [], \"totalPrice\": 0 }\n}\n

Error Responses

\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Message
`401`	`Token Not Provide` / `Invalid Token` / `User Not Found`

","urlObject":{"path":["cart"],"host":["https://my-pet-store-api.vercel.app"],"query":[],"variable":[]}},"response":[],"_postman_id":"268ea88c-01d7-4504-a195-c6e7f8abcbd1"},{"name":"Update Cart Quantity","id":"cef87304-0e68-4500-92f2-6594325ff53a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"key":"token","value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiI2NGYxYTJiM2M0ZDVlNmY3YThiOWMwZDEiLCJpYXQiOjE3MDAwMDAwMDB9.abc123","description":"

Required — JWT token from Sign In

\n"},{"key":"Content-Type","value":"application/json","description":"

Required

\n"}],"body":{"mode":"raw","raw":"{\n \"productId\": \"64f1a2b3c4d5e6f7a8b9c0d2\",\n \"quantity\": 5\n}","options":{"raw":{"language":"json"}}},"url":"https://my-pet-store-api.vercel.app/cart","description":"

Update Cart Quantity

Set a new quantity for a product in the cart. If quantity is 0 or less, the product is removed automatically.

Headers

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Key	Value	Required
`token`	JWT token from Sign In	✅ Yes
`Content-Type`	`application/json`	✅ Yes

Body `raw (json)`

{\n  \"productId\": \"64f1a2b3c4d5e6f7a8b9c0d2\",\n  \"quantity\": 5\n}\n

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Required	Rules
`productId`	string	✅ Yes	MongoDB `_id` of the product
`quantity`	number	✅ Yes	New quantity — `0` or less removes the product

Success Response — `200 OK`

{\n  \"message\": \"done!\",\n  \"data\": { \"totalPrice\": 1250, \"products\": [ { \"quantity\": 5, \"price\": 250 } ] }\n}\n

Error Responses

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Message
`401`	`Token Not Provide` / `Invalid Token` / `User Not Found`
`404`	`Cart not found`
`404`	`Product not in cart`
`422`	Validation error

","urlObject":{"path":["cart"],"host":["https://my-pet-store-api.vercel.app"],"query":[],"variable":[]}},"response":[],"_postman_id":"cef87304-0e68-4500-92f2-6594325ff53a"},{"name":"Remove from Cart","id":"51ff3db1-e612-4e78-bc55-32ad889e9ec3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[{"key":"token","value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiI2NGYxYTJiM2M0ZDVlNmY3YThiOWMwZDEiLCJpYXQiOjE3MDAwMDAwMDB9.abc123","description":"

Required — JWT token from Sign In

\n"}],"url":"https://my-pet-store-api.vercel.app/cart/64f1a2b3c4d5e6f7a8b9c0d2","description":"

Remove from Cart

Remove a specific product. totalPrice is recalculated automatically.

Headers

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Key	Value	Required
`token`	JWT token from Sign In	✅ Yes

URL Params

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Param	Type	Required	Description
`productId`	string	✅ Yes	MongoDB `_id` of the product to remove

Success Response — `200 OK`

{ \"message\": \"Product removed\" }\n

Error Responses

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Message
`401`	`Token Not Provide` / `Invalid Token` / `User Not Found`
`404`	`Cart not found`
`404`	`Product not found in cart`

","urlObject":{"path":["cart","64f1a2b3c4d5e6f7a8b9c0d2"],"host":["https://my-pet-store-api.vercel.app"],"query":[],"variable":[]}},"response":[],"_postman_id":"51ff3db1-e612-4e78-bc55-32ad889e9ec3"},{"name":"Clear Cart","id":"8ad44a1b-d852-4571-b313-61fb3cbaa86f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[{"key":"token","value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiI2NGYxYTJiM2M0ZDVlNmY3YThiOWMwZDEiLCJpYXQiOjE3MDAwMDAwMDB9.abc123","description":"

Required — JWT token from Sign In

\n"}],"url":"https://my-pet-store-api.vercel.app/cart","description":"

Clear Cart

Empty all products from the cart and reset totalPrice, couponCode, discountAmount, discountedPrice to defaults. Cart document is kept.

Headers

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Key	Value	Required
`token`	JWT token from Sign In	✅ Yes

Success Response — `200 OK`

{ \"message\": \"Cart cleared\" }\n

Error Responses

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Message
`401`	`Token Not Provide` / `Invalid Token` / `User Not Found`
`404`	`Cart not found`

","urlObject":{"path":["cart"],"host":["https://my-pet-store-api.vercel.app"],"query":[],"variable":[]}},"response":[],"_postman_id":"8ad44a1b-d852-4571-b313-61fb3cbaa86f"}],"id":"4e8f5cdd-9d0b-4c57-bc75-986642450a5a","description":"

Shopping cart — all endpoints require authentication. Each user has one cart. totalPrice is always recalculated automatically.

\n","_postman_id":"4e8f5cdd-9d0b-4c57-bc75-986642450a5a"},{"name":"Coupons","item":[{"name":"Apply Coupon","id":"bb474829-61a9-4efa-bf0e-32aef2bd1fe3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"token","value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiI2NGYxYTJiM2M0ZDVlNmY3YThiOWMwZDEiLCJpYXQiOjE3MDAwMDAwMDB9.abc123","description":"

Required — JWT token from Sign In

\n"},{"key":"Content-Type","value":"application/json","description":"

Required

\n"}],"body":{"mode":"raw","raw":"{\n \"code\": \"SAVE20\"\n}","options":{"raw":{"language":"json"}}},"url":"https://my-pet-store-api.vercel.app/coupons/apply","description":"

Apply Coupon

Apply a coupon code to the cart. Updates couponCode, discountAmount, and discountedPrice on the cart directly. When the user places an order after this, the order will use discountedPrice automatically.

Headers

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Key	Value	Required
`token`	JWT token from Sign In	✅ Yes
`Content-Type`	`application/json`	✅ Yes

Body `raw (json)`

{\n  \"code\": \"SAVE20\"\n}\n

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Required	Rules
`code`	string	✅ Yes	Valid coupon code

Coupon Validation Rules

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Check	Error
Code not found	`Coupon not found`
Coupon expired	`Coupon has expired`
Max usage reached	`Coupon has reached its maximum usage limit`
User already used it	`You have already used this coupon`
Cart is empty	`Cart is empty`

Success Response — `200 OK`

{\n  \"message\": \"Coupon applied successfully\",\n  \"data\": {\n    \"couponCode\": \"SAVE20\",\n    \"discountType\": \"percentage\",\n    \"discountValue\": 20,\n    \"originalPrice\": 500,\n    \"discountAmount\": 100,\n    \"discountedPrice\": 400\n  }\n}\n

Error Responses

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Message
`401`	`Token Not Provide` / `Invalid Token` / `User Not Found`
`404`	`Coupon not found`
`400`	`Coupon has expired`
`400`	`Coupon has reached its maximum usage limit`
`400`	`You have already used this coupon`
`400`	`Cart is empty`
`422`	Validation error

","urlObject":{"path":["coupons","apply"],"host":["https://my-pet-store-api.vercel.app"],"query":[],"variable":[]}},"response":[],"_postman_id":"bb474829-61a9-4efa-bf0e-32aef2bd1fe3"},{"name":"Remove Coupon","id":"3e69d17d-6c97-4f97-b3fd-beabf599171a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[{"key":"token","value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiI2NGYxYTJiM2M0ZDVlNmY3YThiOWMwZDEiLCJpYXQiOjE3MDAwMDAwMDB9.abc123","description":"

Required — JWT token from Sign In

\n"}],"url":"https://my-pet-store-api.vercel.app/coupons/remove","description":"

Remove Coupon

Remove the applied coupon from the cart. Resets couponCode, discountAmount, and discountedPrice to defaults. Also removes the user from the coupon's usedBy list so the coupon becomes available again for this user.

Headers

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Key	Value	Required
`token`	JWT token from Sign In	✅ Yes

Success Response — `200 OK`

{ \"message\": \"Coupon removed successfully\" }\n

Error Responses

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Message
`401`	`Token Not Provide` / `Invalid Token` / `User Not Found`
`404`	`Cart not found`
`400`	`No coupon applied on this cart`

","urlObject":{"path":["coupons","remove"],"host":["https://my-pet-store-api.vercel.app"],"query":[],"variable":[]}},"response":[],"_postman_id":"3e69d17d-6c97-4f97-b3fd-beabf599171a"}],"id":"a79e071c-183d-472d-97d6-dc11ed460e6d","description":"

Coupon management. Apply a coupon to get a discount on totalPrice before placing an order.

Available Coupons: SAVE10 · SAVE20 · SAVE30 · SAVE50 · WELCOME15 · PETS25 · OFF50 · OFF100 · OFF200 · OFF500 · MYPETSSTORE · ENG.DIAA ELDEEN

Flow:

POST /coupons/apply → discount applied on cart (discountedPrice updated)
POST /orders → order uses discountedPrice automatically
DELETE /coupons/remove → remove coupon from cart if not needed

\n","_postman_id":"a79e071c-183d-472d-97d6-dc11ed460e6d"},{"name":"Orders","item":[{"name":"Create Order","id":"a224f933-20f9-489d-b951-9a712ee88278","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"token","value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiI2NGYxYTJiM2M0ZDVlNmY3YThiOWMwZDEiLCJpYXQiOjE3MDAwMDAwMDB9.abc123","description":"

Required — JWT token from Sign In

\n"},{"key":"Content-Type","value":"application/json","description":"

Required

\n"}],"body":{"mode":"raw","raw":"{\n \"address\": \"123 Tahrir Square, Downtown, Cairo\",\n \"phone\": \"01012345678\",\n \"paymentMethod\": \"cash\"\n}","options":{"raw":{"language":"json"}}},"url":"https://my-pet-store-api.vercel.app/orders","description":"

Create Order

Place a new order using cart items. Cart is cleared after successful order.

If a coupon was applied → order uses discountedPrice
If no coupon → order uses totalPrice
card payment → returns a Stripe Checkout URL

Headers

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Key	Value	Required
`token`	JWT token from Sign In	✅ Yes
`Content-Type`	`application/json`	✅ Yes

Body `raw (json)`

{\n  \"address\": \"123 Tahrir Square, Downtown, Cairo\",\n  \"phone\": \"01012345678\",\n  \"paymentMethod\": \"cash\"\n}\n

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Required	Rules
`address`	string	✅ Yes	5–100 characters
`phone`	string	✅ Yes	Egyptian: `010`/`011`/`012`/`015` + 8 digits
`paymentMethod`	string	⬜ No	`cash` or `card`, defaults to `cash`

Success Response — `201 Created` (cash)

{\n  \"message\": \"done!\",\n  \"data\": {\n    \"_id\": \"64f1a2b3c4d5e6f7a8b9c0c1\",\n    \"orderNumber\": 1001,\n    \"user\": \"64f1a2b3c4d5e6f7a8b9c0d1\",\n    \"products\": [ { \"name\": \"Royal Canin Adult Cat Food\", \"quantity\": 2, \"price\": 250 } ],\n    \"totalPrice\": 400,\n    \"address\": \"123 Tahrir Square, Downtown, Cairo\",\n    \"phone\": \"01012345678\",\n    \"paymentMethod\": \"cash\",\n    \"couponCode\": \"SAVE20\",\n    \"status\": \"pending\",\n    \"isPaid\": false\n  }\n}\n

Success Response — `200 OK` (card)

{\n  \"message\": \"done!\",\n  \"data\": { \"url\": \"https://checkout.stripe.com/pay/cs_test_...\" }\n}\n

\n
For card: redirect user to the returned url to complete payment on Stripe.
\n

Error Responses

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Message
`401`	`Token Not Provide` / `Invalid Token` / `User Not Found`
`400`	`Address and phone required`
`400`	`Cart is empty`
`422`	Validation error

","urlObject":{"path":["orders"],"host":["https://my-pet-store-api.vercel.app"],"query":[],"variable":[]}},"response":[],"_postman_id":"a224f933-20f9-489d-b951-9a712ee88278"},{"name":"Get My Orders","id":"a4ef39dc-2ae2-415d-9c5d-3189874a1ea0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"token","value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiI2NGYxYTJiM2M0ZDVlNmY3YThiOWMwZDEiLCJpYXQiOjE3MDAwMDAwMDB9.abc123","description":"

Required — JWT token from Sign In

\n"}],"url":"https://my-pet-store-api.vercel.app/orders","description":"

Get My Orders

Fetch all orders placed by the authenticated user. Sorted newest first.

Headers

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Key	Value	Required
`token`	JWT token from Sign In	✅ Yes

Success Response — `200 OK`

{\n  \"message\": \"done!\",\n  \"data\": [\n    {\n      \"_id\": \"64f1a2b3c4d5e6f7a8b9c0c1\",\n      \"orderNumber\": 1001,\n      \"products\": [ { \"name\": \"Royal Canin Adult Cat Food\", \"quantity\": 2, \"price\": 250 } ],\n      \"totalPrice\": 400,\n      \"address\": \"123 Tahrir Square, Downtown, Cairo\",\n      \"phone\": \"01012345678\",\n      \"paymentMethod\": \"cash\",\n      \"couponCode\": \"SAVE20\",\n      \"status\": \"pending\",\n      \"isPaid\": false,\n      \"createdAt\": \"2026-04-15T10:00:00.000Z\"\n    }\n  ]\n}\n

\n
If no orders, data returns [].
\n

Error Responses

\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Message
`401`	`Token Not Provide` / `Invalid Token` / `User Not Found`

","urlObject":{"path":["orders"],"host":["https://my-pet-store-api.vercel.app"],"query":[],"variable":[]}},"response":[],"_postman_id":"a4ef39dc-2ae2-415d-9c5d-3189874a1ea0"},{"name":"Cancel Order","id":"fb484546-1051-4375-b140-e2d5b8b7a61b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"key":"token","value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiI2NGYxYTJiM2M0ZDVlNmY3YThiOWMwZDEiLCJpYXQiOjE3MDAwMDAwMDB9.abc123","description":"

Required — JWT token from Sign In

\n"}],"url":"https://my-pet-store-api.vercel.app/orders/64f1a2b3c4d5e6f7a8b9c0c1/cancel","description":"

Cancel Order

Cancel an order. Only allowed when status is pending or confirmed.

Headers

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Key	Value	Required
`token`	JWT token from Sign In	✅ Yes

URL Params

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Param	Type	Required	Description
`orderId`	string	✅ Yes	MongoDB `_id` of the order

Success Response — `200 OK`

{ \"message\": \"Order cancelled\" }\n

Error Responses

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Message
`401`	`Token Not Provide` / `Invalid Token` / `User Not Found`
`404`	`Order not found`
`400`	`Cannot cancel this order`

","urlObject":{"path":["orders","64f1a2b3c4d5e6f7a8b9c0c1","cancel"],"host":["https://my-pet-store-api.vercel.app"],"query":[],"variable":[]}},"response":[],"_postman_id":"fb484546-1051-4375-b140-e2d5b8b7a61b"}],"id":"5b0c4078-724c-4682-b12e-62f1a054586a","description":"

Order management.

Payment Flow:

cash → order created immediately, cart cleared
card → Stripe Checkout URL returned, order created via webhook after payment

Order Status Flow:

pending → confirmed (auto after 6h) → shipped (auto 24h after confirmed) → delivered\n       ↘                           ↘\n        cancelled                   cancelled\n

Cancellation only allowed at pending or confirmed status.

\n","_postman_id":"5b0c4078-724c-4682-b12e-62f1a054586a"}],"variable":[{"key":"baseUrl","value":"https://my-pet-store-api.vercel.app"}]}

MyPets Store API

🌐 Base URL

🔐 Authentication

⚠️ Rate Limiting

📦 Response Format

Reference Values

Sign Up

Headers

Body raw (json)

Success Response — 201 Created

Error Responses

Sign In

Headers

Body raw (json)

Success Response — 200 OK

Error Responses

Forget Password — Send OTP

Headers

Body raw (json)

OTP Rate Limiting

Success Response — 200 OK

Error Responses

Confirm OTP

Headers

Body raw (json)

Success Response — 200 OK

Error Responses

Password Reset Flow

Reset Password

Headers

Body raw (json)

Success Response — 200 OK

Error Responses

Update Password

Headers

Body raw (json)

Success Response — 200 OK

Error Responses

Get Profile

Headers

Success Response — 200 OK

Error Responses

Update Profile

Headers

Body raw (json)

Success Response — 200 OK

Error Responses

Add Address

Headers

Body raw (json)

Success Response — 201 Created

Error Responses

Get Addresses

Headers

Success Response — 200 OK

Error Responses

Update Address

Headers

URL Params

Body raw (json)

Success Response — 200 OK

Error Responses

Remove Address

Headers

URL Params

Success Response — 200 OK

Error Responses

Get All Products

Query Params (Optional)

Success Response — 200 OK (without pagination)

Success Response — 200 OK (with pagination)

Get Specific Product

URL Params

Success Response — 200 OK

Error Responses

Filter Products

Query Params (All Optional)

Success Response — 200 OK

Get Product Reviews

URL Params

Body `raw (json)`

Success Response — `201 Created`

Body `raw (json)`

Success Response — `200 OK`

Body `raw (json)`

Success Response — `200 OK`

Body `raw (json)`

Success Response — `200 OK`

Body `raw (json)`

Success Response — `200 OK`

Body `raw (json)`

Success Response — `200 OK`

Success Response — `200 OK`

Body `raw (json)`

Success Response — `200 OK`

Body `raw (json)`

Success Response — `201 Created`

Success Response — `200 OK`

Body `raw (json)`

Success Response — `200 OK`

Success Response — `200 OK`

Success Response — `200 OK` (without pagination)

Success Response — `200 OK` (with pagination)

Success Response — `200 OK`

Success Response — `200 OK`

Success Response — `200 OK`

Body `raw (json)`

Success Response — `201 Created`

Body `raw (json)`

Success Response — `200 OK`

Success Response — `200 OK`

Body `raw (json)`

Success Response — `201 Created`

Success Response — `200 OK`

Success Response — `200 OK`

Success Response — `200 OK`

Body `raw (json)`

Success Response — `200 OK`

Success Response — `200 OK` (cart exists)

Success Response — `200 OK` (empty cart)

Body `raw (json)`

Success Response — `200 OK`

Success Response — `200 OK`

Success Response — `200 OK`

Body `raw (json)`

Success Response — `200 OK`

Success Response — `200 OK`