v1

latestOpenAPI 3.1.02026-08-041911887.3 KB
Events

Events Search

post/events

Request body

sizeinteger
from-cursorstring

Example request

{
  "where": {
    "date": {
      "gt": "2023-01-01",
      "gte": "2023-01-01",
      "lt": "2023-01-01",
      "lte": "2023-01-01"
    },
    "topics": {
      "id": {
        "any": [
          "bcd2d868-ed38-4382-b94a-622a30fc3215"
        ]
      }
    },
    "entities": {
      "id": {
        "any": [
          "bcd2d868-ed38-4382-b94a-622a30fc3215"
        ]
      }
    },
    "sources": {
      "id": {
        "any": [
          "bcd2d868-ed38-4382-b94a-622a30fc3215"
        ]
      }
    }
  },
  "exclude": {
    "entities": {
      "id": {
        "any": [
          "bcd2d868-ed38-4382-b94a-622a30fc3215"
        ]
      }
    },
    "topics": {
      "id": {
        "any": [
          "bcd2d868-ed38-4382-b94a-622a30fc3215"
        ]
      }
    },
    "sources": {
      "id": {
        "any": [
          "bcd2d868-ed38-4382-b94a-622a30fc3215"
        ]
      }
    }
  },
  "from-cursor": "RjQ2RTRBQUEtQTNGRi00MEI3LUE1NEYtNTA0NEQxMjc5NkU3"
}

Response

Returns a list of events matching the query

event-hash-expirystring date-time required

When the event hashes will expire (note that it could still be available after this time).

next-cursorstring

Example response

{
  "events": [
    {
      "date": "2023-01-01",
      "story-ids": [
        "bcd2d868-ed38-4382-b94a-622a30fc3215"
      ],
      "entities": [
        {
          "id": "bcd2d868-ed38-4382-b94a-622a30fc3215"
        }
      ],
      "topics": [
        {
          "id": "bcd2d868-ed38-4382-b94a-622a30fc3215"
        }
      ]
    }
  ],
  "next-cursor": "RjQ2RTRBQUEtQTNGRi00MEI3LUE1NEYtNTA0NEQxMjc5NkU3"
}