organization_categories:query

Status: 📅 Planned - Coming Soon

Description

This query message will retrieve a list of organization categories defined in the community. Categories help classify organizations (e.g., “Non-Profit”, “Vendor”, “Partner”, “Government”).

Expected Functionality

When implemented, this query will support:

List all organization categories
Get category names in multiple locales
See which categories are active
Filter by parent category (for hierarchical categories)

Expected Request Schema

{
  "payload": {
    "type": "organization_categories:query"
  },
  "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": "organization_categories:query",
    "resources": [
      {
        "id": 1,
        "name_en": "Non-Profit Organization",
        "name_fr": "Organisme sans but lucratif",
        "active": true
      },
      {
        "id": 2,
        "name_en": "Vendor",
        "name_fr": "Fournisseur",
        "active": true
      },
      {
        "id": 3,
        "name_en": "Partner",
        "name_fr": "Partenaire",
        "active": true
      }
    ]
  }
}

Timeline

Expected implementation: Q2 2025

Get Notified

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

person_categories:query - List person categories (similar pattern)
household_categories:query - List household categories
organizations:upsert - Create organizations with category references

Use Cases

Category Selection: Populate dropdowns when creating/updating organizations
Filtering: Show only organizations of specific types
Reporting: Group organizations by category for analysis

Return to API Specifications