organization:query

Status: 📅 Planned - Coming Soon

Description

This query message will retrieve a single organization by its ID or public key. Use this to get complete details about a specific organization, including its addresses, contact information, and relationships.

Expected Functionality

When implemented, this query will support:

Retrieve organization by internal ID
Retrieve organization by public key
Include nested addresses
Include nested contact information
Include related people and collaborations

Expected Request Schema

{
  "payload": {
    "type": "organization:query",
    "id": 123
  },
  "signature": "payload_ed25519_hex_signature",
  "source_public_key": "your_client_public_key"
}

Or query by public key:

{
  "payload": {
    "type": "organization:query",
    "public_key": "org_public_key_here"
  },
  "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:query",
    "id": 123,
    "name": "Community Center",
    "description": "Local community support organization",
    "public_key": "org_public_key_here",
    "organization_category_id": 5,
    "addresses": [
      {
        "id": 1,
        "name": "Main Office",
        "street1": "123 Community Ave",
        "city": "Springfield",
        "main": true
      }
    ],
    "contact_informations": [
      {
        "id": 1,
        "type": "Email",
        "info": "contact@communitycenter.org",
        "main": true
      }
    ]
  }
}

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
person:query - Get a single person (similar pattern)
household:query - Get a single household (similar pattern)

Use Cases

Organization Details: Display complete information about a partner organization
Verification: Confirm organization identity before establishing collaborations
Integration: Link external systems using organization public keys

Return to API Specifications