The Natours API contain endpoint for Users, Tours, Reviews, Bookings and Stripe.
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"27920009","collectionId":"b838e8c6-5dfe-438f-a0da-0adad502949c","publishedId":"2sA3QtcqG8","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2024-06-22T03:23:55.000Z"},"item":[{"name":"Public","item":[{"name":"Tours","item":[{"name":"Get All Tours","event":[{"listen":"test","script":{"id":"1531cdcd-7fd2-460e-b1ab-34d03eef284e","exec":[""],"type":"text/javascript","packages":{}}}],"id":"f34586fa-8950-4efd-a818-9d028a8fec13","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[],"url":"{{URL}}api/v1/tours?page=1&duration[gte]=2&sort=price","description":"Use this endpoint to retrieve a list of tours.
\nMethod: GET
\nURL: {{URL}}api/v1/tours
query for pagination
\n","type":"text/plain"},"key":"page","value":"1"},{"description":{"content":"query for duration, supports gt, gte, lt. lte operators
\n","type":"text/plain"},"key":"duration[gte]","value":"2"},{"description":{"content":"query to sort by price
\n","type":"text/plain"},"key":"sort","value":"price"}],"variable":[]}},"response":[{"id":"858fb328-a644-4121-b01e-d9e02b725679","name":"Get All Tours","originalRequest":{"method":"GET","header":[],"url":"{{URL}}api/v1/tours"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"http://localhost:3000"},{"key":"Vary","value":"Origin"},{"key":"Access-Control-Allow-Credentials","value":"true"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"10792"},{"key":"ETag","value":"W/\"2a28-wM55kgn8RlfpHKUegurRs56SSb4\""},{"key":"Date","value":"Fri, 21 Jun 2024 05:00:34 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"dataCount\": 4,\n \"data\": {\n \"tours\": [\n {\n \"startLocation\": {\n \"type\": \"Point\",\n \"coordinates\": [\n -115.570154,\n 51.178456\n ],\n \"description\": \"Banff, CAN\"\n },\n \"_id\": \"5c88fa8cf4afda39709c2951\",\n \"name\": \"The Forest Hiker\",\n \"duration\": 5,\n \"maxGroupSize\": 25,\n \"difficulty\": \"easy\",\n \"ratingsAverage\": 5,\n \"ratingsCount\": 9,\n \"price\": 397,\n \"summary\": \"Breathtaking hike through the Canadian Banff National Park\",\n \"description\": \"Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur.\\nLorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.\",\n \"imageCover\": \"https://res.cloudinary.com/dygpd9pkl/image/upload/v1716541557/natours/tours/tour-5c88fa8cf4afda39709c2951-cover.jpg\",\n \"images\": [\n \"https://res.cloudinary.com/dygpd9pkl/image/upload/v1716541565/natours/tours/tour-5c88fa8cf4afda39709c2951-image-1.jpg\",\n \"https://res.cloudinary.com/dygpd9pkl/image/upload/v1716541565/natours/tours/tour-5c88fa8cf4afda39709c2951-image-2.jpg\",\n \"https://res.cloudinary.com/dygpd9pkl/image/upload/v1716541561/natours/tours/tour-5c88fa8cf4afda39709c2951-image-3.jpg\"\n ],\n \"startDates\": [\n \"2024-04-25T09:00:00.000Z\",\n \"2024-07-20T09:00:00.000Z\",\n \"2024-10-05T09:00:00.000Z\"\n ],\n \"locations\": [\n {\n \"type\": \"Point\",\n \"coordinates\": [\n -116.214531,\n 51.417611\n ],\n \"description\": \"Banff National Park\",\n \"day\": 1,\n \"_id\": \"5c88fa8cf4afda39709c2954\"\n },\n {\n \"type\": \"Point\",\n \"coordinates\": [\n -118.076152,\n 52.875223\n ],\n \"description\": \"Jasper National Park\",\n \"day\": 3,\n \"_id\": \"5c88fa8cf4afda39709c2953\"\n },\n {\n \"type\": \"Point\",\n \"coordinates\": [\n -117.490309,\n 51.261937\n ],\n \"description\": \"Glacier National Park of Canada\",\n \"day\": 5,\n \"_id\": \"5c88fa8cf4afda39709c2952\"\n }\n ],\n \"guides\": [\n {\n \"_id\": \"5c8a201e2f8fb814b56fa186\",\n \"email\": \"kate@natours.com\",\n \"name\": \"Kate Morrison\",\n \"photo\": \"https://res.cloudinary.com/dygpd9pkl/image/upload/v1716534638/natours/users/user-5c8a201e2f8fb814b56fa186.jpg\",\n \"role\": \"guide\",\n \"isActive\": true,\n \"createdAt\": \"2024-05-28T14:31:08.197Z\",\n \"updatedAt\": \"2024-05-28T14:31:08.197Z\"\n },\n {\n \"_id\": \"5c8a1f292f8fb814b56fa184\",\n \"email\": \"guide@natours.com\",\n \"name\": \"Leo Gillespie\",\n \"photo\": \"https://res.cloudinary.com/dygpd9pkl/image/upload/v1716534638/natours/users/user-5c8a1f292f8fb814b56fa184.jpg\",\n \"role\": \"guide\",\n \"isActive\": true,\n \"createdAt\": \"2024-05-28T14:31:08.197Z\",\n \"updatedAt\": \"2024-05-28T14:31:08.197Z\"\n }\n ],\n \"createdAt\": \"2024-05-28T14:31:03.892Z\",\n \"updatedAt\": \"2024-05-28T14:31:10.444Z\",\n \"slug\": \"the_forest_hiker\",\n \"__v\": 0\n },\n {\n \"startLocation\": {\n \"type\": \"Point\",\n \"coordinates\": [\n -106.822318,\n 39.190872\n ],\n \"description\": \"Aspen, USA\"\n },\n \"_id\": \"5c88fa8cf4afda39709c295a\",\n \"name\": \"The Snow Adventurer\",\n \"duration\": 4,\n \"maxGroupSize\": 10,\n \"difficulty\": \"difficult\",\n \"ratingsAverage\": 4.5,\n \"ratingsCount\": 6,\n \"price\": 997,\n \"summary\": \"Exciting adventure in the snow with snowboarding and skiing\",\n \"description\": \"Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua, ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum!\\nDolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur, exercitation ullamco laboris nisi ut aliquip. Lorem ipsum dolor sit amet, consectetur adipisicing elit!\",\n \"imageCover\": \"https://res.cloudinary.com/dygpd9pkl/image/upload/v1716534626/natours/tours/tour-5c88fa8cf4afda39709c295a-cover.jpg\",\n \"images\": [\n \"https://res.cloudinary.com/dygpd9pkl/image/upload/v1716534629/natours/tours/tour-5c88fa8cf4afda39709c295a-image-1.jpg\",\n \"https://res.cloudinary.com/dygpd9pkl/image/upload/v1716534634/natours/tours/tour-5c88fa8cf4afda39709c295a-image-2.jpg\",\n \"https://res.cloudinary.com/dygpd9pkl/image/upload/v1716534629/natours/tours/tour-5c88fa8cf4afda39709c295a-image-3.jpg\"\n ],\n \"startDates\": [\n \"2025-01-05T10:00:00.000Z\",\n \"2025-02-12T10:00:00.000Z\",\n \"2026-01-06T10:00:00.000Z\"\n ],\n \"locations\": [\n {\n \"type\": \"Point\",\n \"coordinates\": [\n -106.855385,\n 39.182677\n ],\n \"description\": \"Aspen Highlands\",\n \"day\": 1,\n \"_id\": \"5c88fa8cf4afda39709c295c\"\n },\n {\n \"type\": \"Point\",\n \"coordinates\": [\n -106.516623,\n 39.60499\n ],\n \"description\": \"Beaver Creek\",\n \"day\": 2,\n \"_id\": \"5c88fa8cf4afda39709c295b\"\n }\n ],\n \"guides\": [\n {\n \"_id\": \"5c8a23412f8fb814b56fa18c\",\n \"email\": \"ben@natours.com\",\n \"name\": \"Ben Hadley\",\n \"photo\": \"https://res.cloudinary.com/dygpd9pkl/image/upload/v1716534638/natours/users/user-5c8a23412f8fb814b56fa18c.jpg\",\n \"role\": \"guide\",\n \"isActive\": true,\n \"createdAt\": \"2024-05-28T14:31:08.197Z\",\n \"updatedAt\": \"2024-05-28T14:31:08.197Z\"\n },\n {\n \"_id\": \"5c8a1f4e2f8fb814b56fa185\",\n \"email\": \"jennifer@natours.com\",\n \"name\": \"Jennifer Hardy\",\n \"photo\": \"https://res.cloudinary.com/dygpd9pkl/image/upload/v1716534638/natours/users/user-5c8a1f4e2f8fb814b56fa185.jpg\",\n \"role\": \"guide\",\n \"isActive\": true,\n \"createdAt\": \"2024-05-28T14:31:08.197Z\",\n \"updatedAt\": \"2024-05-28T14:31:08.197Z\"\n }\n ],\n \"createdAt\": \"2024-05-28T14:31:03.892Z\",\n \"updatedAt\": \"2024-05-28T14:31:10.496Z\",\n \"slug\": \"the_snow_adventurer\",\n \"__v\": 0\n },\n {\n \"startLocation\": {\n \"type\": \"Point\",\n \"coordinates\": [\n -73.985141,\n 40.75894\n ],\n \"description\": \"NYC, USA\"\n },\n \"_id\": \"5c88fa8cf4afda39709c295d\",\n \"name\": \"The City Wanderer\",\n \"duration\": 9,\n \"maxGroupSize\": 20,\n \"difficulty\": \"easy\",\n \"ratingsAverage\": 4.6,\n \"ratingsCount\": 5,\n \"price\": 1197,\n \"summary\": \"Living the life of Wanderlust in the US' most beatiful cities\",\n \"description\": \"Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat lorem ipsum dolor sit amet.\\nConsectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur, nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat!\",\n \"imageCover\": \"https://res.cloudinary.com/dygpd9pkl/image/upload/v1716534626/natours/tours/tour-5c88fa8cf4afda39709c295d-cover.jpg\",\n \"images\": [\n \"https://res.cloudinary.com/dygpd9pkl/image/upload/v1716534628/natours/tours/tour-5c88fa8cf4afda39709c295d-image-1.jpg\",\n \"https://res.cloudinary.com/dygpd9pkl/image/upload/v1716534632/natours/tours/tour-5c88fa8cf4afda39709c295d-image-2.jpg\",\n \"https://res.cloudinary.com/dygpd9pkl/image/upload/v1716534632/natours/tours/tour-5c88fa8cf4afda39709c295d-image-3.jpg\"\n ],\n \"startDates\": [\n \"2024-03-11T10:00:00.000Z\",\n \"2024-05-02T09:00:00.000Z\",\n \"2024-06-09T09:00:00.000Z\"\n ],\n \"locations\": [\n {\n \"type\": \"Point\",\n \"coordinates\": [\n -73.967696,\n 40.781821\n ],\n \"description\": \"New York\",\n \"day\": 1,\n \"_id\": \"5c88fa8cf4afda39709c2960\"\n },\n {\n \"type\": \"Point\",\n \"coordinates\": [\n -118.324396,\n 34.097984\n ],\n \"description\": \"Los Angeles\",\n \"day\": 3,\n \"_id\": \"5c88fa8cf4afda39709c295f\"\n },\n {\n \"type\": \"Point\",\n \"coordinates\": [\n -122.408865,\n 37.787825\n ],\n \"description\": \"San Francisco\",\n \"day\": 5,\n \"_id\": \"5c88fa8cf4afda39709c295e\"\n }\n ],\n \"guides\": [\n {\n \"_id\": \"5c8a22c62f8fb814b56fa18b\",\n \"email\": \"miyah@natours.com\",\n \"name\": \"Miyah Myles\",\n \"photo\": \"https://res.cloudinary.com/dygpd9pkl/image/upload/v1716534638/natours/users/user-5c8a22c62f8fb814b56fa18b.jpg\",\n \"role\": \"lead-guide\",\n \"isActive\": true,\n \"createdAt\": \"2024-05-28T14:31:08.197Z\",\n \"updatedAt\": \"2024-05-28T14:31:08.197Z\"\n },\n {\n \"_id\": \"5c8a201e2f8fb814b56fa186\",\n \"email\": \"kate@natours.com\",\n \"name\": \"Kate Morrison\",\n \"photo\": \"https://res.cloudinary.com/dygpd9pkl/image/upload/v1716534638/natours/users/user-5c8a201e2f8fb814b56fa186.jpg\",\n \"role\": \"guide\",\n \"isActive\": true,\n \"createdAt\": \"2024-05-28T14:31:08.197Z\",\n \"updatedAt\": \"2024-05-28T14:31:08.197Z\"\n }\n ],\n \"createdAt\": \"2024-05-28T14:31:03.892Z\",\n \"updatedAt\": \"2024-05-28T14:31:10.391Z\",\n \"slug\": \"the_city_wanderer\",\n \"__v\": 0\n },\n {\n \"startLocation\": {\n \"type\": \"Point\",\n \"coordinates\": [\n -115.172652,\n 36.110904\n ],\n \"description\": \"Las Vegas, USA\"\n },\n \"_id\": \"5c88fa8cf4afda39709c2961\",\n \"name\": \"The Park Camper\",\n \"duration\": 10,\n \"maxGroupSize\": 15,\n \"difficulty\": \"medium\",\n \"ratingsAverage\": 4.7,\n \"ratingsCount\": 7,\n \"price\": 1497,\n \"summary\": \"Breathing in Nature in America's most spectacular National Parks\",\n \"description\": \"Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur.\\nDuis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum!\",\n \"imageCover\": \"https://res.cloudinary.com/dygpd9pkl/image/upload/v1716534627/natours/tours/tour-5c88fa8cf4afda39709c2961-cover.jpg\",\n \"images\": [\n \"https://res.cloudinary.com/dygpd9pkl/image/upload/v1716534634/natours/tours/tour-5c88fa8cf4afda39709c2961-image-1.jpg\",\n \"https://res.cloudinary.com/dygpd9pkl/image/upload/v1716534633/natours/tours/tour-5c88fa8cf4afda39709c2961-image-2.jpg\",\n \"https://res.cloudinary.com/dygpd9pkl/image/upload/v1716534634/natours/tours/tour-5c88fa8cf4afda39709c2961-image-3.jpg\"\n ],\n \"startDates\": [\n \"2024-08-05T09:00:00.000Z\",\n \"2025-03-20T10:00:00.000Z\",\n \"2025-08-12T09:00:00.000Z\"\n ],\n \"locations\": [\n {\n \"type\": \"Point\",\n \"coordinates\": [\n -112.987418,\n 37.198125\n ],\n \"description\": \"Zion Canyon National Park\",\n \"day\": 1,\n \"_id\": \"5c88fa8cf4afda39709c2965\"\n },\n {\n \"type\": \"Point\",\n \"coordinates\": [\n -111.376161,\n 36.86438\n ],\n \"description\": \"Antelope Canyon\",\n \"day\": 4,\n \"_id\": \"5c88fa8cf4afda39709c2964\"\n },\n {\n \"type\": \"Point\",\n \"coordinates\": [\n -112.115763,\n 36.058973\n ],\n \"description\": \"Grand Canyon National Park\",\n \"day\": 5,\n \"_id\": \"5c88fa8cf4afda39709c2963\"\n },\n {\n \"type\": \"Point\",\n \"coordinates\": [\n -116.107963,\n 34.011646\n ],\n \"description\": \"Joshua Tree National Park\",\n \"day\": 9,\n \"_id\": \"5c88fa8cf4afda39709c2962\"\n }\n ],\n \"guides\": [\n {\n \"_id\": \"5c8a21f22f8fb814b56fa18a\",\n \"email\": \"lead-guide@natours.com\",\n \"name\": \"Aarav Lynn\",\n \"photo\": \"https://res.cloudinary.com/dygpd9pkl/image/upload/v1716534638/natours/users/user-5c8a21f22f8fb814b56fa18a.jpg\",\n \"role\": \"lead-guide\",\n \"isActive\": true,\n \"createdAt\": \"2024-05-28T14:31:08.197Z\",\n \"updatedAt\": \"2024-05-28T14:31:08.197Z\"\n },\n {\n \"_id\": \"5c8a23412f8fb814b56fa18c\",\n \"email\": \"ben@natours.com\",\n \"name\": \"Ben Hadley\",\n \"photo\": \"https://res.cloudinary.com/dygpd9pkl/image/upload/v1716534638/natours/users/user-5c8a23412f8fb814b56fa18c.jpg\",\n \"role\": \"guide\",\n \"isActive\": true,\n \"createdAt\": \"2024-05-28T14:31:08.197Z\",\n \"updatedAt\": \"2024-05-28T14:31:08.197Z\"\n },\n {\n \"_id\": \"5c8a201e2f8fb814b56fa186\",\n \"email\": \"kate@natours.com\",\n \"name\": \"Kate Morrison\",\n \"photo\": \"https://res.cloudinary.com/dygpd9pkl/image/upload/v1716534638/natours/users/user-5c8a201e2f8fb814b56fa186.jpg\",\n \"role\": \"guide\",\n \"isActive\": true,\n \"createdAt\": \"2024-05-28T14:31:08.197Z\",\n \"updatedAt\": \"2024-05-28T14:31:08.197Z\"\n }\n ],\n \"createdAt\": \"2024-05-28T14:31:03.892Z\",\n \"updatedAt\": \"2024-05-28T14:31:10.868Z\",\n \"slug\": \"the_park_camper\",\n \"__v\": 0\n }\n ]\n }\n}"}],"_postman_id":"f34586fa-8950-4efd-a818-9d028a8fec13"},{"name":"Get (public) Statistics for Tours","event":[{"listen":"test","script":{"id":"f8512f31-97d8-4d86-b2ca-eb2a817f64c8","exec":[""],"type":"text/javascript","packages":{}}}],"id":"d8a8e861-781d-4e02-adc9-0a52a7cb7ec7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[],"url":"{{URL}}api/v1/tours/stats","description":"Use this endpoint to retrieve (public) statistics for tours.
\nMethod: GET
\nURL: {{URL}}api/v1/tours/stats
Use this endpoint to retrieve a list of the 5 cheapest tours.
\nMethod: GET
\nURL: {{URL}}api/v1/tours/top-5-cheap
Use this endpoint to retrieve a tour by ID
\nMethod: GET
\nURL: {{URL}}api/v1/tours/:id
Use this endpoint to retrieve a list of tours within a specified distance from a given center point, and a given unit (mi or km).
\nMethod: GET
\nURL: {{URL}}api/v1/tours/within/:distance/center/:latlng/unit/:unit
distance: number
\nlatlng: string (\"lat,lng\" comma-separated)
\nunit: \"mi\" | \"km\"
\nUse this endpoint to retrieve a list of distances to all tours, from a given center point and a given unit (mi or km).
\nMethod: GET
\nURL: {{URL}}api/v1/tours/distances-from/:latlng/unit/:unit
latlng: string (\"lat,lng\" comma-separated)
\nunit: \"mi\" | \"km\"
\nPublic endpoints for tours.
\nYou can fetch:
\nall tours
\n1 tour by id
\n5 cheapest tours
\nall tours within a distance
\ndistances to all tours from a point
\n(partial) tours statistics
\nUse this endpoint to sign up.
\nMethod: POST
\nURL: {{URL}}api/v1/users/signup
name (string, required): The name of the user.
email (string, required): The email address of the user.
password (string, required): The password for the user account.
passwordConfirmation (string, required): Confirmation of the password.
Status: 200 OK
\nStatus: 409 Conflict if email already exists
\nUse this endpoint to authenticate and create a new session for the user.
\nMethod: POST
\nURL: {{URL}}api/v1/sessions/login
email (string, required): The email of the user.
password (string, required): The password of the user.
Status: 200 OK
\nStatus: 401 Unauthorized if invalid email or password
\nReset My Password - step 1/2
\nUse this endpoint to initiate the process for resetting a user's password by providing its email.
\nMethod: POST
\nURL: {{URL}}api/v1/users/forgot-my-password
Status: 200 OK
\nStatus: 404 Not Found if user not found
\nReset My Password - step 2/2
\nUse this endpoint to reset the password for a user.
\nMethod: PATCH
\nURL: http://localhost:1337/api/v1/users/reset-my-password
password (string, required): The new password for the user.
passwordConfirmation (string, required): Confirmation of the new password.
resetPasswordToken (string, required): The token used for resetting the password.
Status: 200 OK
\nStatus: 404 Not Found if the reset token is invalid or has expired
\nPublic endpoints for authentication.
\nYou can:
\nsign-up
\nlogin
\nreset your password (3 steps process: submit your email => receive a link with a reset-password-token in your email => submit your new password + reset-password-token)
\nUse this endpoint to retrieve a list of all reviews.
\nMethod: GET
\nURL: http://localhost:1337/api/v1/reviews
Use this endpoint to retrieve a review by ID
\nMethod: GET
\nURL: {{URL}}api/v1/reviews/:id
Status: 200 OK
\nStatus: 404 Not Found if the review does not exist
\nPublic endpoints for reviews.
\nYou can fetch:
\nall reviews
\n1 review by id
\nUse this endpoint to retrieve the reviews for a specific tour identified by its tour ID.
\nMethod: GET
\nURL: {{URL}}api/v1/tours/:id/reviews
Status: 200 OK
\nStatus: 404 Not Found iif tour not found
\nOther public endpoints for reviews.
\nYou can fetch:
\nUse this endpoint to perform a health check on the api.
\nMethod: GET
\nURL: {{URL}}api/v1/healthcheck
Status: 200
\nContent-Type: text/plain
\nBody: \"OK\"
\nPublic endpoints.
\n","_postman_id":"0a9b5f17-53ac-452d-870e-0a9857fe6d88"},{"name":"Protected","item":[{"name":"Role: User","item":[{"name":"Auth","item":[{"name":"Logout","event":[{"listen":"test","script":{"id":"f4fdbdad-b9e3-4b5e-8709-8678675d263e","exec":["// Cookies","var accessToken = pm.cookies.get('accessToken');","var refreshToken = pm.cookies.get('refreshToken');","","postman.setEnvironmentVariable('accessToken',accessToken)","postman.setEnvironmentVariable('refreshToken', refreshToken)",""],"type":"text/javascript","packages":{}}}],"id":"207291cd-5b0a-4794-b81c-3220f1b4c2a7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"DELETE","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"{{URL}}api/v1/sessions/logout","description":"Use this endpoint to logout a session.
\nMethod: DELETE
\nURL: {{URL}}api/v1/sessions/logout
Status: 200 OKProtected endpoints for auth.
\nYou can:
\nUse this endpoint to create a new review on a tour.
\nMethod: POST
\nURL: {{URL}}api/v1/tours/:id/reviews
Status: 201 OK
\nStatus: 404 Not Found if tour not found
\nStatus: 403 forbidden if the user did not book this tour
\nStatus: 403 forbidden if the user did already leave a review for this tour
\nProtected endpoints for reviews.
\nYou can:
\nUse this endpoint to retrieve the data of the current user
\nMethod: GET
\nURL: {{URL}}api/v1/users/me
Use this endpoint to update the current user data (except password)
\nMethod: PATCH
\nURL: {{URL}}api/v1/users/update-me
Accepts
\nphoto: image file
\nname
\nUse this endpoint to update the current user isActive field value to false.
\nMethod: PATCH
\nURL: {{URL}}api/v1/users/delete-me
Use this endpoint to update the current user password.
\nMethod: PATCH
\nURL: {{URL}}api/v1/users/update-my-password
Status: 200 OK
\nStatus: 401 Unauthorized if Invalid email or password
\nProtected endpoints for the current authenticated user.
\nYou can:
\nget user's data
\nupdate user's data (except password)
\n(fake-) delete user : update user (set isActive to false)
\nUse this endpint to update a review (content and/or rating)
\nMethod: PATCH
\nURL: {{URL}}api/v1/reviews/:id
Status: 200 OK
\nStatus: 404 Not Found if review does not exist
\nStatus: 403 Forbidden if the current user is not the author of this review
\nProtected endpoints for reviews.
\nYou can:
\nUse this endpoint to get the stripe checkout session for a booking on a tour.
\nMethod: GET
\nURL: {{URL}}api/v1/bookings/checkout-session/:tourId
Status: 200 OK
\nStatus: 404 Not Found if tour not found
\nAllows Stripe to send a POST HTTP request containing a `checkout.session.completed` event.
\nOnce Stripe signature is verified, the route handler creates a booking record in the database using the corresponding service.
\n","urlObject":{"path":["stripe","webhook"],"host":["{{URL}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"986d2db9-c88d-421d-a870-5b1e189b379e"}],"id":"15ae9824-b6af-459d-a425-e89e06744cf8","description":"Protected endpoints for stripe.
\nYou can:
\nStripe can:
\nUse this endpoint to get 1 booking by id
\nMethod: GET
\nURL: {{URL}}api/v1/bookings/:id
Status: 200 OK
\nStatus: 404 Not Found if booking not found
\nStatus: 403 Forbidden if current user did not book this booking OR if not admin
\nUse this endpoint to get all bookings for the current user.
\nMethod: GET
\nURL: {{URL}}api/v1/users/my-bookings
Protected endpoints for bookings.
\nYou can:
\nget all bookings for the current user
\nget 1 booking by id
\nProtected endpoints for user authenticated as \"user\".
\n","_postman_id":"5fc0f25d-028d-4a85-8af3-d5077c6c86cb"},{"name":"Role: Admin","item":[{"name":"Get All Users","id":"106f78ee-29ec-44bb-8503-1d4346134a12","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[],"url":"{{URL}}api/v1/users","description":"Use this endpoint to get all users.
\nMethod: GET
\nURL: {{URL}}api/v1/users
Use this endpoint to get 1 user by id.
\nMethod: GET
\nURL: {{URL}}api/v1/users/:id
Use this endpoint to update 1 user.
\nMethod: PATCH
\nURL: {{URL}}api/v1/users/:id
Use this endpoint to get all bookings for 1 tour.
\nMethod: GET
\nURL: {{URL}}api/v1/tours/:id/bookings
Use this endpoint to delete a review.
\nMethod: DELETE
\nURL: {{URL}}api/v1/reviews/:id
Use this endpoint to get all bookings.
\nMethod: GET
\nURL: {{URL}}api/v1/bookings
Use this endpoint to get 1 booking by id.
\nMethod: GET
\nURL: {{URL}}api/v1/bookings/:id
Status: 200 OK
\nStatus: 404 Not Found if booking not found
\nStatus: 403 Forbidden if current user did not book this booking OR if not admin
\nProtected endpoints for user authenticated as \"admin\".
\nYou can:
\nget all users
\nget 1 user by id
\nupdate a user
\nget all bookings
\nget all bookings for 1 tour
\nget 1 booking by id
\ndelete a review
\nUse this endpoint to create a new tour.
\nMethod: POST
\nURL: {{URL}}api/v1/tours
Use this endpoint to update a tour.
\nMethod: PATCH
\nURL: {{URL}}api/v1/tours/:id
Use this endpoint to delete a tour.
\nMethod: DELETE
\nURL: {{URL}}api/v1/tours/:id
Protected endpoints for user authenticated as \"admin\" or \"lead-guide\".
\nYou can:
\ncreate a new tour
\nupdate a tour
\ndelete a tour
\nUse this endpoint to get monthly statistics for a given year on all tours.
\nMethod: GET
\nURL: {{URL}}api/v1/tours/monthly-stats/:year
Protected endpoints for user authenticated as \"admin\", \"lead-guide\" or \"guide\".
\n","_postman_id":"e1a9dff6-21b5-4b27-9341-568304babdb4"}],"id":"f53ebc60-f812-432c-a6df-331bf600a0fb","description":"Protected endpoints.
\nAuthentication is required.
\nAuthorizations vary upon authenticated user's role (\"user\", \"admin\", \"lead-guide\" or \"guide\") and endpoints.
\nRequired:
\nAll protected routes require the user to send valid accessToken and refreshToken cookies.
\nIf not logged in, Response Status 401 Unauthorized
\n