organizations:query

Status: 📅 Planned - Coming Soon

Description

This query message will retrieve a list of organizations from an Arkipel community. Organizations represent external entities, partners, vendors, or other groups that interact with the community.

Expected Functionality

When implemented, this query will support:

Listing organizations with pagination (page, per_page)
Filtering by name, category, status, or public key
Searching with text matching (name_cont, description_cont)
Filtering by organization category
Sorting by name, created date, or updated date

Expected Request Schema

{
  "payload": {
    "type": "organizations:query",
    "q": {
      "per_page": 20,
      "page": 1,
      "name_cont": "community center",
      "organization_category_id_eq": 5
    }
  },
  "signature": "payload_ed25519_hex_signature",
  "source_public_key": "your_client_public_key"
}

Expected Response Schema

{
  "source_public_key": "community_public_key",
  "source_site": {
    "protocol": "https",
    "fqdn": "arkipel.example.com"
  },
  "created_at": "2025-11-13T20:52:49Z",
  "signature": "...",
  "payload": {
    "type": "organizations:query",
    "q": {
      "per_page": 20,
      "page": 1,
      "total": 150
    },
    "resources": [
      {
        "id": 1,
        "name": "Community Center",
        "description": "Local community support organization",
        "public_key": "org_public_key_here",
        "organization_category_id": 5,
        "addresses": [...],
        "contact_informations": [...]
      }
    ]
  }
}

Timeline

Expected implementation: Q2 2025

Get Notified

Want to know when this feature launches? Contact us at devkit@arkipel.co

organizations:upsert - Create or update organizations
organization:delete - Delete a single organization
people:query - Query people records (similar pattern)
households:query - Query households (similar pattern)

Use Cases

Partner Management: Track external organizations your community works with
Vendor Directory: Maintain a list of approved suppliers and service providers
Network Mapping: See which organizations are connected to your community members

Return to API Specifications