{"info":{"_postman_id":"62955191-37f5-4754-85b3-47305973b3d8","name":"B1G1 APIs ","description":"

Welcome to the B1G1 API documentation!

You can use our APIs to add your Giving Stories to the Giving Cart. In future, we will be expanding our public APIs to allow you to add Favourite Projects to the Giving Cart, as well as access and update all your Giving Stories and Favourite Projects.

All responses from the APIs are in JSON. You can view code examples in cURL or your preferred language using the dropdown on the right.

At the moment, all our APIs are available and accessible to B1G1 members for free, and we are actively seeking feedback and suggestions to inform development efforts.

We hope that what we build helps you embed giving into the heart of your business more effectively. And we can't wait to see how you’ll use these APIs to create more impact in the world than anyone has ever imagined.

If you have any feedback or suggestions about our APIs, please reach out to us at team@b1g1.com.

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"6081117","collectionId":"62955191-37f5-4754-85b3-47305973b3d8","publishedId":"S1TN6gJ5","public":true,"customColor":{"right-sidebar":"363537","top-bar":"FFFFFF","highlight":"00B4EB"},"publishDate":"2019-05-21T08:45:44.000Z"},"item":[{"name":"Add Giving Story to Cart","id":"d4a24433-57fc-4a6e-ae67-1f2edf974eae","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"url":"https://api.b1g1.com/cart/post/","description":"

This endpoint adds a specific Giving Story to your company's Giving Cart using the POST method.

Here's how to retrieve the URL of the endpoint from your B1G1 account:

\n\n

Once you have successfully added your Giving Story to the Cart, the API will also send back a payload of the details of the Story you have just added.

Errors

Errors could occur if:

Your B1G1 account is no longer active (blocked, suspended, or deactivated) -> please reach out to the B1G1 team at team@b1g1.com.
The Giving Story is deleted or otherwise no longer available -> please verify that the Giving Story is still in your B1G1 account and that you used the correct endpoint URL.
The Project in the Giving Story is delisted or otherwise no longer available -> please change the project within your Giving Story or use another Giving Story instead.

\n","urlObject":{"protocol":"https","path":["cart","post",""],"host":["api","b1g1","com"],"query":[],"variable":[]}},"response":[{"id":"ed33e007-dc4b-4477-a259-5c38ae24934d","name":"Add Giving Story to Cart - POST method","originalRequest":{"method":"POST","header":[],"url":"https://api.b1g1.com/cart/post/c3RvcnktMTAyNTktMTExMi0yMjQxLTM3ODgtUE9TVA="},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Tue, 02 Jul 2019 06:28:39 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Set-Cookie","value":"b1g1_session=eyJpdiI6Ikd4MWhCRFwvc2NmXC9VVDhBdnE3Z0FlUT09IiwidmFsdWUiOiIza253MXF4QVl0ZzZZNTBcL2c4eVM2aGFOVXpqSzBtR1YyMElBaEVLd2lpSmtPSUJNbEt5YnowMzNFUFJua3ZHYjdabmRcL1N3MHo1MlpvV2x3bHpSY1Z3PT0iLCJtYWMiOiI1OGExOWZhMWZhOGNkNjA4NTFmOWM2Mzc1ZjNhMzc3MjZkNzk0ZjE3MTJiZWExODU3NjQ5NmJhYzY5ODJiMTQ0In0%3D; expires=Tue, 02-Jul-2019 08:28:39 GMT; Max-Age=7200; path=/; httponly"},{"key":"Content-Encoding","value":"gzip"},{"key":"Expect-CT","value":"max-age=604800, report-uri=\"https://report-uri.cloudflare.com/cdn-cgi/beacon/expect-ct\""},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"4efe8f94af0b321a-SIN"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"Success\",\n \"message\": \"Giving Story added successfully\",\n \"story\": {\n \"id\": 123,\n \"user_id\": 12345,\n \"company_id\": 1234,\n \"project_id\": 3434,\n \"impact_level_id\": 1212,\n \"quantity\": 2,\n \"story_text\": \"When we receive feedback on the system, we provide 10 nutritious lunch meals for children in Philippines.\",\n \"giving_story_image\": \"https://api.b1g1.com/uploads/giving_story/1314391834156204873.jpg\",\n \"status\": 1,\n \"is_created_by\": 0,\n \"is_private\": 0,\n \"created_at\": \"2018-06-10 21:05:28\",\n \"updated_at\": \"2019-07-02 14:25:30\",\n \"icon\": \"https://api.b1g1.com/uploads/giving_story/156204873.jpg\",\n \"impact\": {\n \"id\": 1122,\n \"project_id\": 3434,\n \"old_projID\": null,\n \"impact_level_title\": \"Provide lunch meals/week\",\n \"impact_level_cost\": 1.65,\n \"impact_unit\": 5,\n \"impact_description\": \"Help end hunger by feeding a child in Philippines. There are about 15 million Filipino children who face the threat of not realising their full potential not growing to be as tall, as healthy, nor as bright as they can be because they are suffering from hunger today as they grow up. Our kitchens cook daily nutritious lunch meals for children in public schools, in the streets, and in conflict areas to end hunger and malnutrition.\",\n \"impact_category_group\": null,\n \"status\": \"active\",\n \"created_at\": \"2018-05-15 19:25:52\",\n \"updated_at\": null\n }\n },\n \"cart_detail\": {\n \"amt_total_usd\": 3.3,\n \"quantity\": 1,\n \"beneficiaries\": 10\n },\n \"impact_level_cost\": 1.65\n}"}],"_postman_id":"d4a24433-57fc-4a6e-ae67-1f2edf974eae"}],"event":[{"listen":"prerequest","script":{"id":"3848f372-1315-43f0-a68b-5db90357eeaf","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"69576aa5-7b46-4b8f-ac45-a41a0a5a3f29","type":"text/javascript","exec":[""]}}]}