API Reference

Object Reference

Understand API objects, schemas and example JSON responses.

User Object

Represents a Hammity user account.

Schema

{
  "id": "string",
  "username": "string",
  "display_name": "string",
  "avatar": "string|null"
}

Example

{
  "id": "1475173060217692160",
  "username": "Coldalliance",
  "display_name": "Charley J. Q",
  "avatar": null
}

Community Object

Represents a Hammity community.

Schema

{
  "id": "string",
  "name": "string",
  "owner_id": "string"
}

Example

{
  "id": "123",
  "name": "Example Community",
  "owner_id": "1475173060217692160"
}

Message Object

Represents a message sent in a channel.

Schema

{
  "id": "string",
  "channel_id": "string",
  "author_id": "string",
  "content": "string",
  "created_at": "datetime"
}

Example

{
  "id": "789",
  "channel_id": "456",
  "author_id": "123",
  "content": "Hello world",
  "created_at": "2026-06-29T00:00:00Z"
}