Skip to content
Developers
Menu

API reference

Organizations

Every path is relative to https://api.palloo.app/v1. Send a bot token as Authorization: Bearer palloo_bot_... unless the operation says otherwise; see Authentication.

On this page

Get organization

GET /organizations/{id} Bot token: Call it with a bot token (people can call it too).

An organization. Anyone sees verified ones with their active members, leaving out members who hide the verified_organization badge (they still see themselves); its own members and instance admins see it in any state, and the owner and admins also see invitations and every member.

Parameters

Parameters of Get organization
Name In Type Description
id Required path string

Organization ID.

Responses

200

The organization.

Body: Organization

Example response (200)
{
  "id": "01J9ZQ3V5K8M2N4P6R8T0W2Y4A",
  "name": "string",
  "description": "string",
  "owner_id": "01J9ZQ3V5K8M2N4P6R8T0W2Y4A",
  "owner_username": "string",
  "domain": "string",
  "domain_id": "string",
  "status": "pending",
  "verified": false,
  "submitted_at": "2026-10-15T09:00:00Z",
  "reviewed_at": "2026-10-15T09:00:00Z",
  "decision_reason": "string",
  "communities": [
    {
      "id": "01J9ZQ3V5K8M2N4P6R8T0W2Y4A",
      "name": "string"
    }
  ],
  "members": [
    {
      "user": {
        "id": {},
        "username": "string",
        "display_name": "string",
        "kind": {},
        "avatar": {},
        "avatar_dark": {}
      },
      "state": "invited",
      "invited_at": "2026-10-15T09:00:00Z",
      "joined_at": "2026-10-15T09:00:00Z"
    }
  ],
  "my_state": "invited"
}
401

unauthenticated: the bearer token is missing, invalid or expired.

Body: Error

WWW-Authenticate header.

404

organization_not_found.

Body: Error

429

rate_limited: too many attempts. Every operation a bot calls is also limited per bot (50 at once, then 50 per second), so any authenticated operation can answer this to a bot. Changes to a community's structure (creating or changing the community, channels, roles, member roles, overwrites, invites, kicks, bans, timeouts, report updates and actions, and bots) are also limited per caller (30 at once, then 1 per second) and per community (60 at once, then 1 per second), and creating communities per caller (10 at once, then 1 every 5 minutes).

Body: Error

Retry-After header.

500

internal: an unexpected server error. Details are only in server logs.

Body: Error