{ "variable": [ { "id": "baseUrl", "key": "baseUrl", "type": "string", "name": "string", "value": "http:\/\/localhost\/elifesaver-app\/public" } ], "info": { "name": "eLifesaver API Documentation", "_postman_id": "07d78d16-d0dc-4b93-a8f9-e8c72e127e98", "description": "", "schema": "https:\/\/schema.getpostman.com\/json\/collection\/v2.1.0\/collection.json" }, "item": [ { "name": "AI Blood Assistant", "description": "\nGrounded Claude chatbot answering donation questions (can I donate, why\ndeferred, where to donate, what to eat). Works for guests and logged-in users.", "item": [ { "name": "Whether the assistant is configured\/available", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/assistant\/status", "query": [], "raw": "{{baseUrl}}\/api\/v1\/assistant\/status" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "", "auth": { "type": "noauth" } }, "response": [ { "header": [ { "key": "cache-control", "value": "no-cache, private" }, { "key": "content-type", "value": "application\/json" } ], "code": 404, "body": "{\n \"message\": \"The route elifesaver-app\/public\/api\/v1\/assistant\/status could not be found.\"\n}", "name": "" } ] }, { "name": "Send a message to the assistant", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/assistant\/message", "query": [], "raw": "{{baseUrl}}\/api\/v1\/assistant\/message" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"message\":\"vmqeopfuudtdsufvyvddq\",\"conversation_uuid\":\"66529e01-d113-3473-8d6f-9e11e09332ea\"}" }, "description": "Pass `conversation_uuid` to continue a conversation, or omit to start a new one.", "auth": { "type": "noauth" } }, "response": [] } ] }, { "name": "Authentication", "description": "\nRegistration and Sanctum token issuance for the mobile app. Tokens are bearer\ntokens returned in the `token` field; send as `Authorization: Bearer {token}`.", "item": [ { "name": "Login", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/auth\/login", "query": [], "raw": "{{baseUrl}}\/api\/v1\/auth\/login" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"email\":\"qkunze@example.com\",\"phone\":\"consequatur\",\"password\":\"O[2UZ5ij-e\\\/dl4m{o,\"}" }, "description": "Authenticate a donor, patient, doctor or admin by email OR phone.", "auth": { "type": "noauth" } }, "response": [] }, { "name": "Register donor", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/auth\/register\/donor", "query": [], "raw": "{{baseUrl}}\/api\/v1\/auth\/register\/donor" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"name\":\"vmqeopfuudtdsufvyvddq\",\"gender\":\"consequatur\",\"email\":\"carolyne.luettgen@example.org\",\"phone\":\"consequatur\",\"password\":\"[2UZ5ij-e\\\/dl4\",\"address\":\"consequatur\",\"city\":\"consequatur\",\"blood_group\":\"consequatur\"}" }, "description": "", "auth": { "type": "noauth" } }, "response": [] }, { "name": "Register patient", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/auth\/register\/patient", "query": [], "raw": "{{baseUrl}}\/api\/v1\/auth\/register\/patient" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"name\":\"vmqeopfuudtdsufvyvddq\",\"gender\":\"consequatur\",\"email\":\"carolyne.luettgen@example.org\",\"phone\":\"consequatur\",\"password\":\"[2UZ5ij-e\\\/dl4\",\"blood_group\":\"consequatur\"}" }, "description": "", "auth": { "type": "noauth" } }, "response": [] }, { "name": "Current user", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/me", "query": [], "raw": "{{baseUrl}}\/api\/v1\/me" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "" }, "response": [ { "header": [ { "key": "cache-control", "value": "no-cache, private" }, { "key": "content-type", "value": "application\/json" } ], "code": 404, "body": "{\n \"message\": \"The route elifesaver-app\/public\/api\/v1\/me could not be found.\"\n}", "name": "" } ] }, { "name": "Logout", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/auth\/logout", "query": [], "raw": "{{baseUrl}}\/api\/v1\/auth\/logout" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "" }, "response": [] } ] }, { "name": "Blood Requests", "description": "", "item": [ { "name": "List blood requests", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/blood-requests", "query": [], "raw": "{{baseUrl}}\/api\/v1\/blood-requests" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Patients see their own requests; donors see active requests compatible\nwith their blood group." }, "response": [ { "header": [ { "key": "cache-control", "value": "no-cache, private" }, { "key": "content-type", "value": "application\/json" } ], "code": 404, "body": "{\n \"message\": \"The route elifesaver-app\/public\/api\/v1\/blood-requests could not be found.\"\n}", "name": "" } ] }, { "name": "Compatible appeals near me", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/blood-requests\/compatible", "query": [], "raw": "{{baseUrl}}\/api\/v1\/blood-requests\/compatible" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Open appeals the donor can donate to, ranked by urgency + proximity to home\nor the town they're currently visiting." }, "response": [ { "header": [ { "key": "cache-control", "value": "no-cache, private" }, { "key": "content-type", "value": "application\/json" } ], "code": 404, "body": "{\n \"message\": \"The route elifesaver-app\/public\/api\/v1\/blood-requests\/compatible could not be found.\"\n}", "name": "" } ] }, { "name": "Create a blood request", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/blood-requests", "query": [], "raw": "{{baseUrl}}\/api\/v1\/blood-requests" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"blood_group\":\"consequatur\",\"number_of_bags\":45,\"health_facility\":\"consequatur\",\"hospital_id\":17,\"medical_info\":\"consequatur\",\"priority\":\"emergency\"}" }, "description": "" }, "response": [] }, { "name": "Respond to a blood request", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/blood-requests\/:bloodRequest_id\/respond", "query": [], "raw": "{{baseUrl}}\/api\/v1\/blood-requests\/:bloodRequest_id\/respond", "variable": [ { "id": "bloodRequest_id", "key": "bloodRequest_id", "value": 1, "description": "The ID of the bloodRequest." } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "A donor pledges\/accepts a request. Records the response and credits the donor." }, "response": [] }, { "name": "Escalate to Emergency Mode", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/blood-requests\/:bloodRequest_id\/escalate", "query": [], "raw": "{{baseUrl}}\/api\/v1\/blood-requests\/:bloodRequest_id\/escalate", "variable": [ { "id": "bloodRequest_id", "key": "bloodRequest_id", "value": 1, "description": "The ID of the bloodRequest." } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Ranks compatible nearby donors and fans out a multi-channel appeal. Only the\nrequester (or an admin) may escalate." }, "response": [] }, { "name": "Ranked donor matches for a request (staff\/requester view).", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/blood-requests\/:bloodRequest_id\/matches", "query": [], "raw": "{{baseUrl}}\/api\/v1\/blood-requests\/:bloodRequest_id\/matches", "variable": [ { "id": "bloodRequest_id", "key": "bloodRequest_id", "value": 1, "description": "The ID of the bloodRequest." } ] }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "" }, "response": [ { "header": [ { "key": "cache-control", "value": "no-cache, private" }, { "key": "content-type", "value": "application\/json" } ], "code": 404, "body": "{\n \"message\": \"The route elifesaver-app\/public\/api\/v1\/blood-requests\/1\/matches could not be found.\"\n}", "name": "" } ] } ] }, { "name": "Campaigns (Blood Drives)", "description": "", "item": [ { "name": "List published campaigns (public)", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/campaigns", "query": [], "raw": "{{baseUrl}}\/api\/v1\/campaigns" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "", "auth": { "type": "noauth" } }, "response": [ { "header": [ { "key": "cache-control", "value": "no-cache, private" }, { "key": "content-type", "value": "application\/json" } ], "code": 404, "body": "{\n \"message\": \"The route elifesaver-app\/public\/api\/v1\/campaigns could not be found.\"\n}", "name": "" } ] }, { "name": "Show one campaign with progress (public)", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/campaigns\/:campaign_id", "query": [], "raw": "{{baseUrl}}\/api\/v1\/campaigns\/:campaign_id", "variable": [ { "id": "campaign_id", "key": "campaign_id", "value": 3, "description": "The ID of the campaign." } ] }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "", "auth": { "type": "noauth" } }, "response": [ { "header": [ { "key": "cache-control", "value": "no-cache, private" }, { "key": "content-type", "value": "application\/json" } ], "code": 404, "body": "{\n \"message\": \"The route elifesaver-app\/public\/api\/v1\/campaigns\/3 could not be found.\"\n}", "name": "" } ] }, { "name": "Register for a campaign", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/campaigns\/:campaign_id\/register", "query": [], "raw": "{{baseUrl}}\/api\/v1\/campaigns\/:campaign_id\/register", "variable": [ { "id": "campaign_id", "key": "campaign_id", "value": 3, "description": "The ID of the campaign." } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "" }, "response": [] }, { "name": "My campaign registrations", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/my\/campaign-registrations", "query": [], "raw": "{{baseUrl}}\/api\/v1\/my\/campaign-registrations" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "" }, "response": [ { "header": [ { "key": "cache-control", "value": "no-cache, private" }, { "key": "content-type", "value": "application\/json" } ], "code": 404, "body": "{\n \"message\": \"The route elifesaver-app\/public\/api\/v1\/my\/campaign-registrations could not be found.\"\n}", "name": "" } ] } ] }, { "name": "Community Media", "description": "\nUpload community photos\/videos. Prefer the direct-to-Cloudinary flow (get a\nsignature, upload from the device, then attach the descriptor to a post) for\nlarge files \u2014 it keeps media off the app server.", "item": [ { "name": "Upload a media file (server compresses\/offloads); returns a media descriptor", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/media", "query": [], "raw": "{{baseUrl}}\/api\/v1\/media" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "multipart\/form-data" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "formdata", "formdata": [ { "key": "file", "src": [], "type": "file" } ] }, "description": "" }, "response": [] }, { "name": "Signature for a direct browser\/device upload to Cloudinary", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/media\/signature", "query": [], "raw": "{{baseUrl}}\/api\/v1\/media\/signature" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "" }, "response": [ { "header": [ { "key": "cache-control", "value": "no-cache, private" }, { "key": "content-type", "value": "application\/json" } ], "code": 404, "body": "{\n \"message\": \"The route elifesaver-app\/public\/api\/v1\/media\/signature could not be found.\"\n}", "name": "" } ] } ] }, { "name": "Content & Community", "description": "\nKnowledge Center and the community feed.", "item": [ { "name": "Knowledge categories with published article counts", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/knowledge\/categories", "query": [], "raw": "{{baseUrl}}\/api\/v1\/knowledge\/categories" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "", "auth": { "type": "noauth" } }, "response": [ { "header": [ { "key": "cache-control", "value": "no-cache, private" }, { "key": "content-type", "value": "application\/json" } ], "code": 404, "body": "{\n \"message\": \"The route elifesaver-app\/public\/api\/v1\/knowledge\/categories could not be found.\"\n}", "name": "" } ] }, { "name": "List published knowledge articles (optionally by category slug)", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/knowledge\/articles", "query": [], "raw": "{{baseUrl}}\/api\/v1\/knowledge\/articles" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "", "auth": { "type": "noauth" } }, "response": [ { "header": [ { "key": "cache-control", "value": "no-cache, private" }, { "key": "content-type", "value": "application\/json" } ], "code": 404, "body": "{\n \"message\": \"The route elifesaver-app\/public\/api\/v1\/knowledge\/articles could not be found.\"\n}", "name": "" } ] }, { "name": "Show a single knowledge article", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/knowledge\/articles\/:article_id", "query": [], "raw": "{{baseUrl}}\/api\/v1\/knowledge\/articles\/:article_id", "variable": [ { "id": "article_id", "key": "article_id", "value": 1, "description": "The ID of the article." } ] }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "", "auth": { "type": "noauth" } }, "response": [ { "header": [ { "key": "cache-control", "value": "no-cache, private" }, { "key": "content-type", "value": "application\/json" } ], "code": 404, "body": "{\n \"message\": \"The route elifesaver-app\/public\/api\/v1\/knowledge\/articles\/1 could not be found.\"\n}", "name": "" } ] }, { "name": "Community feed (public posts), ranked for the viewer", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/feed", "query": [], "raw": "{{baseUrl}}\/api\/v1\/feed" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "", "auth": { "type": "noauth" } }, "response": [ { "header": [ { "key": "cache-control", "value": "no-cache, private" }, { "key": "content-type", "value": "application\/json" } ], "code": 404, "body": "{\n \"message\": \"The route elifesaver-app\/public\/api\/v1\/feed could not be found.\"\n}", "name": "" } ] }, { "name": "List a post's comments", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/posts\/:post_id\/comments", "query": [], "raw": "{{baseUrl}}\/api\/v1\/posts\/:post_id\/comments", "variable": [ { "id": "post_id", "key": "post_id", "value": 170, "description": "The ID of the post." } ] }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "", "auth": { "type": "noauth" } }, "response": [ { "header": [ { "key": "cache-control", "value": "no-cache, private" }, { "key": "content-type", "value": "application\/json" } ], "code": 404, "body": "{\n \"message\": \"The route elifesaver-app\/public\/api\/v1\/posts\/170\/comments could not be found.\"\n}", "name": "" } ] }, { "name": "Create a post", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/posts", "query": [], "raw": "{{baseUrl}}\/api\/v1\/posts" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"body\":\"vmqeopfuudtdsufvyvddq\",\"type\":\"update\",\"image_url\":\"http:\\\/\\\/www.kunde.com\\\/\",\"is_anonymous\":true,\"media\":[{\"type\":\"video\",\"url\":\"http:\\\/\\\/www.harber.com\\\/fuga-aspernatur-natus-earum-quas\"}]}" }, "description": "" }, "response": [] }, { "name": "React to a post (toggle)", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/posts\/:post_id\/react", "query": [], "raw": "{{baseUrl}}\/api\/v1\/posts\/:post_id\/react", "variable": [ { "id": "post_id", "key": "post_id", "value": 170, "description": "The ID of the post." } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "" }, "response": [] }, { "name": "Comment on a post", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/posts\/:post_id\/comment", "query": [], "raw": "{{baseUrl}}\/api\/v1\/posts\/:post_id\/comment", "variable": [ { "id": "post_id", "key": "post_id", "value": 170, "description": "The ID of the post." } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"body\":\"vmqeopfuudtdsufvyvddq\",\"parent_id\":17,\"is_anonymous\":true}" }, "description": "" }, "response": [] } ] }, { "name": "Donor Data", "description": "", "item": [ { "name": "Get donor credit balance", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/credit", "query": [], "raw": "{{baseUrl}}\/api\/v1\/credit" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "" }, "response": [ { "header": [ { "key": "cache-control", "value": "no-cache, private" }, { "key": "content-type", "value": "application\/json" } ], "code": 404, "body": "{\n \"message\": \"The route elifesaver-app\/public\/api\/v1\/credit could not be found.\"\n}", "name": "" } ] }, { "name": "Next eligible donation date", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/donation-info", "query": [], "raw": "{{baseUrl}}\/api\/v1\/donation-info" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Males wait 3 months, females 4 months between donations." }, "response": [ { "header": [ { "key": "cache-control", "value": "no-cache, private" }, { "key": "content-type", "value": "application\/json" } ], "code": 404, "body": "{\n \"message\": \"The route elifesaver-app\/public\/api\/v1\/donation-info could not be found.\"\n}", "name": "" } ] }, { "name": "Get serology \/ blood test results", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/results", "query": [], "raw": "{{baseUrl}}\/api\/v1\/results" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "" }, "response": [ { "header": [ { "key": "cache-control", "value": "no-cache, private" }, { "key": "content-type", "value": "application\/json" } ], "code": 404, "body": "{\n \"message\": \"The route elifesaver-app\/public\/api\/v1\/results could not be found.\"\n}", "name": "" } ] } ] }, { "name": "Engagement", "description": "\nAchievements, certificates, leaderboards, referrals and the health tracker.", "item": [ { "name": "Public leaderboard (scope: national|region|hospital|gender)", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/leaderboard", "query": [], "raw": "{{baseUrl}}\/api\/v1\/leaderboard" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "", "auth": { "type": "noauth" } }, "response": [ { "header": [ { "key": "cache-control", "value": "no-cache, private" }, { "key": "content-type", "value": "application\/json" } ], "code": 404, "body": "{\n \"message\": \"The route elifesaver-app\/public\/api\/v1\/leaderboard could not be found.\"\n}", "name": "" } ] }, { "name": "My achievements", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/achievements", "query": [], "raw": "{{baseUrl}}\/api\/v1\/achievements" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "" }, "response": [ { "header": [ { "key": "cache-control", "value": "no-cache, private" }, { "key": "content-type", "value": "application\/json" } ], "code": 404, "body": "{\n \"message\": \"The route elifesaver-app\/public\/api\/v1\/achievements could not be found.\"\n}", "name": "" } ] }, { "name": "My certificates", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/certificates", "query": [], "raw": "{{baseUrl}}\/api\/v1\/certificates" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "" }, "response": [ { "header": [ { "key": "cache-control", "value": "no-cache, private" }, { "key": "content-type", "value": "application\/json" } ], "code": 404, "body": "{\n \"message\": \"The route elifesaver-app\/public\/api\/v1\/certificates could not be found.\"\n}", "name": "" } ] }, { "name": "Download a certificate PDF", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/certificates\/:uuid\/download", "query": [], "raw": "{{baseUrl}}\/api\/v1\/certificates\/:uuid\/download", "variable": [ { "id": "uuid", "key": "uuid", "value": "66529e01-d113-3473-8d6f-9e11e09332ea", "description": "" } ] }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "" }, "response": [ { "header": [ { "key": "cache-control", "value": "no-cache, private" }, { "key": "content-type", "value": "application\/json" } ], "code": 404, "body": "{\n \"message\": \"The route elifesaver-app\/public\/api\/v1\/certificates\/66529e01-d113-3473-8d6f-9e11e09332ea\/download could not be found.\"\n}", "name": "" } ] }, { "name": "My referral code + stats", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/referral", "query": [], "raw": "{{baseUrl}}\/api\/v1\/referral" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "" }, "response": [ { "header": [ { "key": "cache-control", "value": "no-cache, private" }, { "key": "content-type", "value": "application\/json" } ], "code": 404, "body": "{\n \"message\": \"The route elifesaver-app\/public\/api\/v1\/referral could not be found.\"\n}", "name": "" } ] }, { "name": "List my health records", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/health-records", "query": [], "raw": "{{baseUrl}}\/api\/v1\/health-records" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "" }, "response": [ { "header": [ { "key": "cache-control", "value": "no-cache, private" }, { "key": "content-type", "value": "application\/json" } ], "code": 404, "body": "{\n \"message\": \"The route elifesaver-app\/public\/api\/v1\/health-records could not be found.\"\n}", "name": "" } ] }, { "name": "Add a health record (BMI auto-computed)", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/health-records", "query": [], "raw": "{{baseUrl}}\/api\/v1\/health-records" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"weight_kg\":21,\"height_cm\":13,\"hemoglobin\":16,\"bp_systolic\":5,\"bp_diastolic\":14,\"pulse\":16,\"temperature\":6,\"recorded_at\":\"2026-07-14T09:48:26\"}" }, "description": "" }, "response": [] } ] }, { "name": "Lookups", "description": "\nReference data for populating mobile dropdowns. Public (no auth required).", "item": [ { "name": "List hospitals & health facilities", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/hospitals", "query": [], "raw": "{{baseUrl}}\/api\/v1\/hospitals" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "", "auth": { "type": "noauth" } }, "response": [ { "header": [ { "key": "cache-control", "value": "no-cache, private" }, { "key": "content-type", "value": "application\/json" } ], "code": 404, "body": "{\n \"message\": \"The route elifesaver-app\/public\/api\/v1\/hospitals could not be found.\"\n}", "name": "" } ] }, { "name": "Get one hospital's GPS coordinates", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/hospitals\/:hospital_id\/location", "query": [], "raw": "{{baseUrl}}\/api\/v1\/hospitals\/:hospital_id\/location", "variable": [ { "id": "hospital_id", "key": "hospital_id", "value": 1, "description": "The ID of the hospital." } ] }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "", "auth": { "type": "noauth" } }, "response": [ { "header": [ { "key": "cache-control", "value": "no-cache, private" }, { "key": "content-type", "value": "application\/json" } ], "code": 404, "body": "{\n \"message\": \"The route elifesaver-app\/public\/api\/v1\/hospitals\/1\/location could not be found.\"\n}", "name": "" } ] }, { "name": "List blood groups", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/blood-groups", "query": [], "raw": "{{baseUrl}}\/api\/v1\/blood-groups" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "", "auth": { "type": "noauth" } }, "response": [ { "header": [ { "key": "cache-control", "value": "no-cache, private" }, { "key": "content-type", "value": "application\/json" } ], "code": 404, "body": "{\n \"message\": \"The route elifesaver-app\/public\/api\/v1\/blood-groups could not be found.\"\n}", "name": "" } ] }, { "name": "List regions (geography)", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/regions", "query": [], "raw": "{{baseUrl}}\/api\/v1\/regions" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "", "auth": { "type": "noauth" } }, "response": [ { "header": [ { "key": "cache-control", "value": "no-cache, private" }, { "key": "content-type", "value": "application\/json" } ], "code": 404, "body": "{\n \"message\": \"The route elifesaver-app\/public\/api\/v1\/regions could not be found.\"\n}", "name": "" } ] }, { "name": "Gamification assets \u2014 mascot moods, celebration banners + sounds, by trigger", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/celebration-assets", "query": [], "raw": "{{baseUrl}}\/api\/v1\/celebration-assets" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "", "auth": { "type": "noauth" } }, "response": [ { "header": [ { "key": "cache-control", "value": "no-cache, private" }, { "key": "content-type", "value": "application\/json" } ], "code": 404, "body": "{\n \"message\": \"The route elifesaver-app\/public\/api\/v1\/celebration-assets could not be found.\"\n}", "name": "" } ] } ] }, { "name": "Notifications", "description": "\nIn-app notification history for the mobile app (blood appeals, emergencies,\nrequest updates, milestones). Push delivery is separate (FCM); this is the\ndurable list the user can browse and mark as read.", "item": [ { "name": "List my notifications (paginated, newest first) + unread count", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/notifications", "query": [], "raw": "{{baseUrl}}\/api\/v1\/notifications" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "" }, "response": [ { "header": [ { "key": "cache-control", "value": "no-cache, private" }, { "key": "content-type", "value": "application\/json" } ], "code": 404, "body": "{\n \"message\": \"The route elifesaver-app\/public\/api\/v1\/notifications could not be found.\"\n}", "name": "" } ] }, { "name": "Mark a single notification as read", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/notifications\/:id\/read", "query": [], "raw": "{{baseUrl}}\/api\/v1\/notifications\/:id\/read", "variable": [ { "id": "id", "key": "id", "value": "consequatur", "description": "The ID of the notification." } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "" }, "response": [] }, { "name": "Mark all my notifications as read", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/notifications\/read-all", "query": [], "raw": "{{baseUrl}}\/api\/v1\/notifications\/read-all" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "" }, "response": [] } ] }, { "name": "Organizations & Volunteers", "description": "", "item": [ { "name": "Public organization leaderboard (by lives impacted)", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/organizations\/leaderboard", "query": [], "raw": "{{baseUrl}}\/api\/v1\/organizations\/leaderboard" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "", "auth": { "type": "noauth" } }, "response": [ { "header": [ { "key": "cache-control", "value": "no-cache, private" }, { "key": "content-type", "value": "application\/json" } ], "code": 404, "body": "{\n \"message\": \"The route elifesaver-app\/public\/api\/v1\/organizations\/leaderboard could not be found.\"\n}", "name": "" } ] }, { "name": "Public organization profile + impact stats", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/organizations\/:organization_id", "query": [], "raw": "{{baseUrl}}\/api\/v1\/organizations\/:organization_id", "variable": [ { "id": "organization_id", "key": "organization_id", "value": 4, "description": "The ID of the organization." } ] }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "", "auth": { "type": "noauth" } }, "response": [ { "header": [ { "key": "cache-control", "value": "no-cache, private" }, { "key": "content-type", "value": "application\/json" } ], "code": 404, "body": "{\n \"message\": \"The route elifesaver-app\/public\/api\/v1\/organizations\/4 could not be found.\"\n}", "name": "" } ] }, { "name": "Join an organization via its invite code (as a registered donor)", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/organizations\/join", "query": [], "raw": "{{baseUrl}}\/api\/v1\/organizations\/join" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"invite_code\":\"consequatur\"}" }, "description": "" }, "response": [] }, { "name": "Apply to volunteer", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/volunteers\/apply", "query": [], "raw": "{{baseUrl}}\/api\/v1\/volunteers\/apply" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"type\":\"regional_ambassador\",\"organization_id\":17}" }, "description": "" }, "response": [] } ] }, { "name": "Payments", "description": "\nCamPay mobile-money flow for the (optional) blood-appeal fee. When payment is\ndisabled the appeal is created immediately and no charge is made.", "item": [ { "name": "Payment configuration (call before showing a payment UI)", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/payments\/info", "query": [], "raw": "{{baseUrl}}\/api\/v1\/payments\/info" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "", "auth": { "type": "noauth" } }, "response": [ { "header": [ { "key": "cache-control", "value": "no-cache, private" }, { "key": "content-type", "value": "application\/json" } ], "code": 404, "body": "{\n \"message\": \"The route elifesaver-app\/public\/api\/v1\/payments\/info could not be found.\"\n}", "name": "" } ] }, { "name": "Check payment status (poll every ~5s) \u2014 reconciles with CamPay.", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/payments\/:reference\/status", "query": [], "raw": "{{baseUrl}}\/api\/v1\/payments\/:reference\/status", "variable": [ { "id": "reference", "key": "reference", "value": "consequatur", "description": "" } ] }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "", "auth": { "type": "noauth" } }, "response": [ { "header": [ { "key": "cache-control", "value": "no-cache, private" }, { "key": "content-type", "value": "application\/json" } ], "code": 404, "body": "{\n \"message\": \"The route elifesaver-app\/public\/api\/v1\/payments\/consequatur\/status could not be found.\"\n}", "name": "" } ] }, { "name": "Initiate a blood-appeal payment", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/payments\/initiate", "query": [], "raw": "{{baseUrl}}\/api\/v1\/payments\/initiate" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"phone\":\"consequatur\",\"blood_group\":\"consequatur\",\"number_of_bags\":45,\"health_facility\":\"consequatur\",\"medical_info\":\"consequatur\"}" }, "description": "If payment is disabled the appeal is created immediately (free). Otherwise a\npayment record is created and a CamPay collection is initiated." }, "response": [] } ] }, { "name": "Profile", "description": "", "item": [ { "name": "Update the authenticated user's profile", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/profile", "query": [], "raw": "{{baseUrl}}\/api\/v1\/profile" }, "method": "PUT", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"name\":\"vmqeopfuudtdsufvyvddq\",\"password\":\"OP>@;4\",\"phone\":\"consequatur\",\"address\":\"consequatur\",\"city\":\"consequatur\",\"blood_group\":\"consequatur\"}" }, "description": "" }, "response": [] }, { "name": "Register \/ update the device FCM token for push notifications", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/profile\/device-token", "query": [], "raw": "{{baseUrl}}\/api\/v1\/profile\/device-token" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"registration_token\":\"consequatur\"}" }, "description": "" }, "response": [] }, { "name": "Update my coarse current location (town I'm visiting)", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/profile\/location", "query": [], "raw": "{{baseUrl}}\/api\/v1\/profile\/location" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"current_subdivision_id\":17,\"current_city\":\"mqeopfuudtdsufvyvddqa\",\"shares_location\":false}" }, "description": "Consent-based and deliberately imprecise (city\/subdivision only) so nearby\nappeals follow the donor when travelling. Send `shares_location:false` to stop." }, "response": [] } ] }, { "name": "Webhooks", "description": "\nServer-to-server callbacks. No user auth \u2014 verified by a shared key instead.", "item": [ { "name": "CamPay payment IPN", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/webhooks\/campay", "query": [], "raw": "{{baseUrl}}\/api\/v1\/webhooks\/campay" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "", "auth": { "type": "noauth" } }, "response": [] } ] } ], "auth": { "type": "bearer", "bearer": [ { "key": "Authorization", "type": "string" } ] } }