> ## Documentation Index
> Fetch the complete documentation index at: https://api.housera.ro/llms.txt
> Use this file to discover all available pages before exploring further.

# Your events

> The events of your listings from the last 35 days, from the oldest, according to cursor `after`. What hasn’t arrived via webhook you recover from here.



## OpenAPI

````yaml en/openapi.json GET /events
openapi: 3.1.2
info:
  title: Housera API
  version: 1.0.0
  description: >-
    Publish and manage real estate listings on Housera from your CRM or
    application, with the same rules as the Housera form.
servers:
  - url: https://staging.housera.ro/api/v1
    description: 'Sandbox (staging): test data, the same rules as production.'
  - url: https://housera.ro/api/v1
    description: 'Production: real listings from housera.ro.'
security:
  - bearer: []
tags:
  - name: Your Listings
  - name: Photos
  - name: Events
  - name: Vocabulary
paths:
  /events:
    get:
      tags:
        - Events
      summary: Your events
      description: >-
        The events of your listings from the last 35 days, from the oldest,
        according to cursor `after`. What hasn’t arrived via webhook you recover
        from here.
      operationId: v1.events
      parameters:
        - name: after
          in: query
          schema:
            type:
              - string
              - 'null'
            minLength: 26
            maxLength: 26
          description: >-
            Cursor: the ID of the last event you have. You will receive only
            events after it, in order.
        - name: limit
          in: query
          schema:
            type:
              - integer
              - 'null'
            minimum: 1
            maximum: 500
          description: How many events per page (default 100, maximum 500).
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          description: >-
                            The event ID (ULID, increasing). You send it as
                            `after` to continue where you left off.
                        type:
                          type: string
                          description: Property type.
                        created_at:
                          type: string
                          description: The time of the event (ISO 8601, UTC).
                        data:
                          type: object
                          additionalProperties: {}
                          description: The result of the request.
                      required:
                        - id
                        - type
                        - created_at
                        - data
                    description: The result of the request.
                  meta:
                    type: object
                    properties:
                      next:
                        type: 'null'
                        description: >-
                          The next page: its address, or the cursor to send
                          further. Null when nothing is left.
                    required:
                      - next
                    description: The pagination data.
                required:
                  - data
                  - meta
          description: Successful.
        '401':
          content:
            application/problem+json:
              schema:
                $ref: df9e5864-a2f9-487d-b0db-169bf3dc8506
          description: The key is missing, revoked, or expired (`unauthenticated`).
        '422':
          content:
            application/problem+json:
              schema:
                $ref: e53cadd6-998b-41ac-a57d-ce6040097918
          description: >-
            The data do not pass the rules: one entry per field in `errors[]`,
            with a stable `code`.
components:
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      description: 'Authorization: Bearer <key>'

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.