{"info":{"_postman_id":"d6dc9715-2742-4d8b-a70a-1fb389dc7344","name":"SafeHavenConnect API","description":"

SafeHavenConnect API Documentation

The SafeHavenConnect API provides programmatic access to a centralized database of organizations, resources, and events supporting survivors of domestic abuse. This API enables developers to build applications that can search, filter, and retrieve up-to-date information about shelters, mental health programs, legal aid, and community events.

Base URL

https://backend.safehavenconnect.me/api\n

Getting Started

No authentication required for GET (read) requests.
All requests and responses use JSON format.
Use any HTTP client (Postman, curl, axios, etc.).
POST, PUT, DELETE requests require admin permissions.

Endpoints Overview

/organizations — List and search organizations
/resources — List and search resources
/events — List and search events

Filtering, Sorting, and Pagination

All list endpoints support advanced querying via URL query parameters:

Filtering

Filter by any field using query parameters.
Example: GET /organizations?city=Austin&state=TX

Sorting

Sort results by any field using the sort parameter.
Prefix with - for descending order.
Example: GET /resources?sort=-createdAt

Pagination

Use limit and offset for pagination.
Example: GET /events?limit=10&offset=20

Example Request

GET /organizations?city=Houston&sort=name&limit=5\n

Rate Limits

No enforced rate limits currently.
Rate limit headers are included in all responses:
- X-RateLimit-Limit
- X-RateLimit-Remaining
- X-RateLimit-Reset
\n

Error Handling

Standard HTTP status codes are used.
401 Unauthorized for restricted endpoints.
404 Not Found for missing resources.
400 Bad Request for invalid parameters.

Contact & Support

For questions or support, contact the SafeHavenConnect team or visit the project repository/documentation site.

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"SafeHavenConnect API Documentation","slug":"safehavenconnect-api-documentation"}],"owner":"48794305","collectionId":"d6dc9715-2742-4d8b-a70a-1fb389dc7344","publishedId":"2sB3WjzjPd","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2025-10-26T02:58:16.000Z"},"item":[{"name":"https://backend.safehavenconnect.me/api/organizations","event":[{"listen":"test","script":{"id":"8e233741-ccb6-4fcd-a622-aaeefc0b50fd","exec":["pm.test(\"Status code is 200\", function () {\r"," pm.response.to.have.status(200);\r","});\r","\r","pm.test(\"Response is JSON\", function () {\r"," pm.response.to.be.json;\r","});\r","\r","pm.test(\"Response is an array\", function () {\r"," const data = pm.response.json();\r"," pm.expect(data).to.be.an(\"array\");\r","});\r","\r","pm.test(\"Each organization has required fields\", function () {\r"," const orgs = pm.response.json();\r"," if (orgs.length > 0) {\r"," const org = orgs[0];\r"," pm.expect(org).to.have.property(\"id\");\r"," pm.expect(org).to.have.property(\"name\");\r"," pm.expect(org).to.have.property(\"location\");\r"," pm.expect(org).to.have.property(\"organization_type\");\r"," }\r","});\r",""],"type":"text/javascript","packages":{},"requests":{}}}],"id":"33df64d3-541e-41ef-957f-738d6cb68a74","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://backend.safehavenconnect.me/api/organizations","description":"

Testing organizations endpoint

\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-API-Key"},{"key":"value","value":"{{token}}"}]},"isInherited":true,"source":{"_postman_id":"d6dc9715-2742-4d8b-a70a-1fb389dc7344","id":"d6dc9715-2742-4d8b-a70a-1fb389dc7344","name":"SafeHavenConnect API","type":"collection"}},"urlObject":{"protocol":"https","path":["api","organizations"],"host":["backend","safehavenconnect","me"],"query":[],"variable":[]}},"response":[],"_postman_id":"33df64d3-541e-41ef-957f-738d6cb68a74"},{"name":"https://backend.safehavenconnect.me/api/events","event":[{"listen":"test","script":{"id":"24ff99a9-deb9-4665-bad9-a3e1cde80812","exec":["pm.test(\"Status code is 200\", function () {\r"," pm.response.to.have.status(200);\r","});\r","\r","pm.test(\"Response has JSON array\", function () {\r"," const jsonData = pm.response.json();\r"," pm.expect(jsonData).to.be.an(\"array\");\r","});\r","\r","pm.test(\"Each event has required fields\", function () {\r"," const events = pm.response.json();\r"," if (events.length > 0) {\r"," const e = events[0];\r"," pm.expect(e).to.have.property(\"id\");\r"," pm.expect(e).to.have.property(\"name\");\r"," pm.expect(e).to.have.property(\"location\");\r"," }\r","});\r",""],"type":"text/javascript","packages":{},"requests":{}}}],"id":"f8af86b5-5593-4629-a552-9fe407b175ef","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://backend.safehavenconnect.me/api/events","description":"

Test for events endpoint

\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-API-Key"},{"key":"value","value":"{{token}}"}]},"isInherited":true,"source":{"_postman_id":"d6dc9715-2742-4d8b-a70a-1fb389dc7344","id":"d6dc9715-2742-4d8b-a70a-1fb389dc7344","name":"SafeHavenConnect API","type":"collection"}},"urlObject":{"protocol":"https","path":["api","events"],"host":["backend","safehavenconnect","me"],"query":[],"variable":[]}},"response":[],"_postman_id":"f8af86b5-5593-4629-a552-9fe407b175ef"},{"name":"https://backend.safehavenconnect.me/api/resources","event":[{"listen":"test","script":{"id":"edbe01de-d52a-494d-ab20-5bd01bbe3c34","exec":["pm.test(\"Status code is 200\", function () {\r"," pm.response.to.have.status(200);\r","});\r","\r","pm.test(\"Response is JSON\", function () {\r"," pm.response.to.be.json;\r","});\r","\r","pm.test(\"Response is an array\", function () {\r"," const data = pm.response.json();\r"," pm.expect(data).to.be.an(\"array\");\r","});\r","\r","pm.test(\"Each resource has required fields\", function () {\r"," const resources = pm.response.json();\r"," if (resources.length > 0) {\r"," const r = resources[0];\r"," pm.expect(r).to.have.property(\"id\");\r"," pm.expect(r).to.have.property(\"title\");\r"," pm.expect(r).to.have.property(\"organization_name\");\r"," pm.expect(r).to.have.property(\"topic\");\r"," pm.expect(r).to.have.property(\"location\");\r"," }\r","});\r","\r","pm.test(\"Optional fields are valid when present\", function () {\r"," const resources = pm.response.json();\r"," if (resources.length > 0) {\r"," const r = resources[0];\r"," if (r.description) pm.expect(r.description).to.be.a(\"string\");\r"," if (r.resource_url) pm.expect(r.resource_url).to.be.a(\"string\");\r"," }\r","});\r",""],"type":"text/javascript","packages":{},"requests":{}}}],"id":"0236530f-af41-49eb-9caa-808757f7615a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://backend.safehavenconnect.me/api/resources","description":"

Resources endpoint test