---
updatedAt: 2026-04-06T14:51:06.000Z
agentTools:
  projectIndex: https://developers.hoot.at/llms.txt
---

# List hoots

Get a list of all hoots in reverse chronological order

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "x-proxy-enabled": true,
  "info": {
    "version": "1.0",
    "title": "Hoot",
    "license": {
      "name": "ISC"
    }
  },
  "paths": {
    "/timeline": {
      "get": {
        "summary": "List hoots",
        "description": "Get a list of all hoots in reverse chronological order",
        "tags": [
          "Timeline"
        ],
        "responses": {
          "200": {
            "description": "successfully retrieved all hoots",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/BigHoot"
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ]
      }
    }
  },
  "tags": [
    {
      "name": "Timeline",
      "description": "This endpoint is for Hoot timelines."
    }
  ],
  "servers": [
    {
      "url": "https://{customDomain}/api",
      "variables": {
        "customDomain": {
          "default": "hoot.at"
        }
      }
    },
    {
      "url": "https://{subdomain}.glitch.me/api",
      "variables": {
        "subdomain": {
          "default": "hoot"
        }
      }
    },
    {
      "url": "http://localhost:4007/api"
    }
  ],
  "components": {
    "securitySchemes": {
      "ApiKeyAuth": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-KEY"
      }
    },
    "schemas": {
      "HootPost": {
        "type": "object",
        "required": [
          "post"
        ],
        "properties": {
          "post": {
            "type": "string",
            "description": "The under-280-character content you want to hoot",
            "example": "just setting up my hoot",
            "maxLength": 280
          }
        }
      },
      "ReplyToString": {
        "type": "object",
        "properties": {
          "replyto": {
            "type": "string",
            "description": "Optional id of the hoot being replied to",
            "example": "5c3e39af342143680d31775c"
          }
        }
      },
      "AdditionalHootProperties": {
        "type": "object",
        "properties": {
          "_id": {
            "type": "string",
            "description": "The unique, auto-generated ID for the hoot",
            "example": "5c3e39af342143680d31775c"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "likes": {
            "type": "array",
            "description": "An array containing usernames of the users that liked this hoot",
            "items": {
              "type": "string",
              "example": "owlet"
            }
          },
          "username": {
            "type": "string",
            "example": "owlbert",
            "description": "The username for the user that created this hoot"
          }
        }
      },
      "SmolHoot": {
        "type": "object",
        "allOf": [
          {
            "$ref": "#/components/schemas/AdditionalHootProperties"
          },
          {
            "$ref": "#/components/schemas/HootPost"
          },
          {
            "$ref": "#/components/schemas/ReplyToString"
          }
        ]
      },
      "ReplyToObject": {
        "type": "object",
        "required": [
          "post"
        ],
        "properties": {
          "replyto": {
            "type": "object",
            "$ref": "#/components/schemas/SmolHoot"
          }
        }
      },
      "BigHoot": {
        "type": "object",
        "allOf": [
          {
            "$ref": "#/components/schemas/AdditionalHootProperties"
          },
          {
            "$ref": "#/components/schemas/HootPost"
          },
          {
            "$ref": "#/components/schemas/ReplyToObject"
          }
        ]
      }
    }
  },
  "x-readme": {
    "explorer-enabled": true,
    "samples-enabled": true
  }
}
```