Get events (by collection)

Changed on Nov 3, 2026

Get a list of events for a collection. Optionally filter by traits to only return events for items matching the specified trait criteria.

get/api/v2/events/collection/{slug}

Request

Base URL
https://api.opensea.io
Auth
API key in header x-api-key
TypeScript
https://skmtc.dev/opensea/apis/opensea-api/docs/api/v2/events/collection/:slug/get.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

slugstring required

Unique identifier for the collection

Query parameters

afterinteger

Only show events after this timestamp (Unix timestamp in seconds)

beforeinteger

Only show events before this timestamp (Unix timestamp in seconds)

event_typestring[]

Filter by event types. To get order invalidation and revalidation events, please use the Stream API. The order status can also be checked on the Get Order endpoint.

traitsstring

JSON array of trait filters. Each object has 'traitType' and 'value' fields. Multiple traits are AND-combined (items must match all). Example: [{"traitType":"Background","value":"Red"}]

limitinteger

Number of items to return per page

Example:20

nextstring

Response

nextstring nullable

Changes

Nov 3, 20262c7935d84f90 Revision changes
- breaking
  the response property /////// became nullable for the status
- breaking
  the response property /////// became nullable for the status
- breaking
  the response property /////// became nullable for the status
- breaking
  the response property became nullable for the status
- breaking
  the /////// response's property type changed from object to no type for status
- breaking
  the /////// response's property type changed from object to no type for status
- breaking
  the /////// response's property type changed from object to no type for status
- breaking
  the /////// response's property type changed from object to no type for status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- warning
  removed the optional property //////// from the response with the status
- warning
  removed the optional property //////// from the response with the status
- warning
  removed the optional property //////// from the response with the status
- warning
  removed the optional property //////// from the response with the status
- warning
  removed the optional property //////// from the response with the status
- warning
  removed the optional property //////// from the response with the status
- warning
  removed the optional property //////// from the response with the status
- warning
  removed the optional property //////// from the response with the status
- warning
  removed the optional property //////// from the response with the status
- warning
  removed the optional property //////// from the response with the status
- warning
  removed the optional property //////// from the response with the status
- warning
  removed the optional property //////// from the response with the status
- warning
  removed the optional property //////// from the response with the status
- warning
  removed the optional property //////// from the response with the status
- warning
  removed the optional property //////// from the response with the status
- warning
  removed the optional property //////// from the response with the status
- warning
  removed the optional property //////// from the response with the status
- warning
  removed the optional property //////// from the response with the status
- warning
  removed the optional property //////// from the response with the status
- warning
  removed the optional property //////// from the response with the status
- warning
  removed the optional property //////// from the response with the status
- warning
  removed the optional property //////// from the response with the status
- warning
  removed the optional property //////// from the response with the status
- warning
  removed the optional property //////// from the response with the status
- warning
  removed the optional property //////// from the response with the status
- warning
  removed the optional property //////// from the response with the status
- warning
  removed the optional property //////// from the response with the status
- warning
  removed the optional property //////// from the response with the status
- warning
  removed the optional property //////// from the response with the status
- warning
  removed the optional property //////// from the response with the status
- warning
  removed the optional property //////// from the response with the status
- warning
  removed the optional property //////// from the response with the status
- warning
  removed the optional property //////// from the response with the status
- warning
  removed the optional property //////// from the response with the status
- warning
  removed the optional property //////// from the response with the status
- info
  added the media type */* for the response with the status
- info
  added the media type */* for the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added subschema #2 to the /////// response property anyOf list for the response status
- info
  added subschema #2 to the /////// response property anyOf list for the response status
- info
  added subschema #2 to the /////// response property anyOf list for the response status
- info
  added subschema #2 to the /////// response property anyOf list for the response status

Operation history