> ## Documentation Index > Fetch the complete documentation index at: https://docs.engine.usesophic.com/llms.txt > Use this file to discover all available pages before exploring further. # List events > Retrieve events, optionally filtered by name, resource ID, or creation time. ## OpenAPI ````yaml /openapi.json get /events openapi: 3.1.0 info: title: Sophic Engine API version: 0.1.0 servers: - url: https://api.engine.usesophic.com security: [] tags: - description: Retrieve accounts, statements, and account documents. name: accounts x-group: Accounts - description: Read the audit trail of platform activity. name: activity x-group: Activity - description: Obtain OAuth access tokens for the Engine API. name: auth x-group: Authentication - description: Inspect the authenticated user or service actor. name: identity x-group: Identity - description: Retrieve fee schedules and billing information. name: billing x-group: Billing - description: Browse instruments and tradable products. name: catalog x-group: Catalog - description: Track onboarding applications through completion. name: onboarding x-group: Onboarding - description: Manage customer records and related person data. name: customers x-group: Customers - description: List platform events and inspect individual occurrences. name: events x-group: Events - description: Read positions, transactions, and account holdings. name: holdings x-group: Holdings - description: Retrieve legal agreements and required disclosures. name: legal-documents x-group: Legal Documents - description: Access prices and market data for instruments. name: market-data x-group: Market Data - description: Manage deposits, withdrawals, and funding accounts. name: payments x-group: Payments - description: Retrieve returns, earnings, and performance metrics. name: performance x-group: Performance - description: Place and manage orders, quotes, and trades. name: trading x-group: Trading - description: Read position and account valuations over time. name: valuation x-group: Valuation - description: Configure webhook endpoints and inspect deliveries. name: webhooks x-group: Webhooks - description: Upload files and retrieve stored documents. name: files x-group: Files paths: /events: get: tags: - events summary: List events description: >- Retrieve events, optionally filtered by name, resource ID, or creation time. operationId: list_events_events_get parameters: - description: Filter by fully-qualified event name, e.g. `customer.created`. in: query name: name required: false schema: description: Filter by fully-qualified event name, e.g. `customer.created`. title: Name type: string x-remove-null-from-type-union: true - description: Filter by the resource ID that the events describe. in: query name: resource[id] required: false schema: description: Filter by the resource ID that the events describe. title: Resource[Id] type: string x-remove-null-from-type-union: true - description: Return events created strictly after this timestamp. in: query name: created[gt] required: false schema: description: Return events created strictly after this timestamp. format: date-time title: Created[Gt] type: string x-remove-null-from-type-union: true - description: Return events created on or after this timestamp. in: query name: created[gte] required: false schema: description: Return events created on or after this timestamp. format: date-time title: Created[Gte] type: string x-remove-null-from-type-union: true - description: Return events created strictly before this timestamp. in: query name: created[lt] required: false schema: description: Return events created strictly before this timestamp. format: date-time title: Created[Lt] type: string x-remove-null-from-type-union: true - description: Return events created on or before this timestamp. in: query name: created[lte] required: false schema: description: Return events created on or before this timestamp. format: date-time title: Created[Lte] type: string x-remove-null-from-type-union: true responses: '200': content: application/json: schema: items: $ref: '#/components/schemas/Event' title: Response List Events Events Get type: array description: OK '400': content: application/json: schema: $ref: '#/components/schemas/Error' description: Bad Request security: - HTTPBearer: [] components: schemas: Event: properties: created_at: description: Time the event was recorded. examples: - '2026-07-14T09:30:00Z' format: date-time title: Created At type: string data: description: Event-specific payload data. title: Data type: object id: description: Unique resource identifier. title: Id type: string name: description: Fully qualified event name, such as `customer.created`. title: Name type: string resource: allOf: - $ref: '#/components/schemas/EventResource' description: Resource associated with the event. required: - id - name - resource - data - created_at title: Event type: object Error: properties: code: description: A machine-readable error code. title: Code type: string context: additionalProperties: anyOf: - type: string - type: integer description: An optional object for adding extra context to the error. title: Context type: object x-remove-null-from-type-union: true detail: description: A human-readable description of the error. title: Detail type: string docs: description: A URL to documentation about this error code. title: Docs type: string x-remove-null-from-type-union: true params: description: An optional list of params that failed validation. items: $ref: '#/components/schemas/InvalidParam' title: Params type: array x-remove-null-from-type-union: true required: - detail - code title: Error type: object EventResource: properties: id: description: ID of the resource the event relates to. title: Id type: string resource_type: description: Canonical resource type. title: Resource Type type: string required: - id - resource_type title: EventResource type: object InvalidParam: properties: code: description: A machine-readable error code. title: Code type: string detail: description: Human-readable detail for error. title: Detail type: string path: description: Path to the field name (or index if a list) that errored. items: anyOf: - type: integer - type: string title: Path type: array required: - path - detail - code title: InvalidParam type: object securitySchemes: HTTPBearer: scheme: bearer type: http ````