> ## Documentation Index > Fetch the complete documentation index at: https://docs.corpus.intrace.ai/llms.txt > Use this file to discover all available pages before exploring further. # List Events > List events with optional filters and pagination. Pass all_results=true to fetch all matching rows without pagination. Results are intersected with this API key's scope if one is configured. ## OpenAPI ````yaml /api-reference/corpus-product-openapi.json get /v1/events openapi: 3.1.0 info: title: Intrace Corpus Product API version: 1.0.0 description: >- Professional API for accessing events, actors, locations, and metadata from the Intrace corpus database. servers: - url: https://api.corpus.intrace.ai description: Production security: - ApiKeyAuth: [] paths: /v1/events: get: tags: - Events summary: List Events description: |- List events with optional filters and pagination. Pass all_results=true to fetch all matching rows without pagination. Results are intersected with this API key's scope if one is configured. operationId: list_events_v1_events_get parameters: - name: page in: query required: false schema: type: integer minimum: 1 default: 1 title: Page - name: page_size in: query required: false schema: type: integer maximum: 500 minimum: 1 default: 50 title: Page Size - name: all_results in: query required: false schema: type: boolean description: Return all results without pagination default: false title: All Results description: Return all results without pagination - name: country in: query required: false schema: type: array items: type: string description: Filter by country (repeatable) default: [] title: Country description: Filter by country (repeatable) - name: event_type in: query required: false schema: type: array items: type: string description: Filter by event type (repeatable) default: [] title: Event Type description: Filter by event type (repeatable) - name: event_category in: query required: false schema: type: array items: type: string description: Filter by event category (repeatable) default: [] title: Event Category description: Filter by event category (repeatable) - name: event_subtype in: query required: false schema: type: array items: type: string description: Filter by event subtype (repeatable) default: [] title: Event Subtype description: Filter by event subtype (repeatable) - name: date_from in: query required: false schema: anyOf: - type: string format: date - type: 'null' description: Inclusive start date title: Date From description: Inclusive start date - name: date_to in: query required: false schema: anyOf: - type: string format: date - type: 'null' description: Inclusive end date title: Date To description: Inclusive end date - name: search in: query required: false schema: anyOf: - type: string - type: 'null' description: Search in title/description title: Search description: Search in title/description - name: salience_score_min in: query required: false schema: anyOf: - type: number - type: 'null' description: Minimum salience score title: Salience Score Min description: Minimum salience score - name: salience_score_max in: query required: false schema: anyOf: - type: number - type: 'null' description: Maximum salience score title: Salience Score Max description: Maximum salience score - name: article_count_min in: query required: false schema: anyOf: - type: integer minimum: 0 - type: 'null' description: Minimum article count title: Article Count Min description: Minimum article count - name: article_count_max in: query required: false schema: anyOf: - type: integer minimum: 0 - type: 'null' description: Maximum article count title: Article Count Max description: Maximum article count - name: actor_count_min in: query required: false schema: anyOf: - type: integer minimum: 0 - type: 'null' description: Minimum actor count title: Actor Count Min description: Minimum actor count - name: actor_count_max in: query required: false schema: anyOf: - type: integer minimum: 0 - type: 'null' description: Maximum actor count title: Actor Count Max description: Maximum actor count - name: sort_by in: query required: false schema: type: string description: Sort column default: event_date title: Sort By description: Sort column - name: sort_order in: query required: false schema: $ref: '#/components/schemas/SortOrder' description: Sort direction default: desc description: Sort direction - name: api_key in: query required: false schema: anyOf: - type: string - type: 'null' description: Corpus API key title: Api Key description: Corpus API key - name: x-api-key in: header required: false schema: anyOf: - type: string - type: 'null' description: Corpus API key title: X-Api-Key description: Corpus API key responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/PaginatedEventsResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' components: schemas: SortOrder: type: string enum: - asc - desc title: SortOrder description: Sort direction for API queries. PaginatedEventsResponse: properties: items: items: $ref: '#/components/schemas/EventResponse' type: array title: Items total: type: integer title: Total page: type: integer title: Page pageSize: type: integer title: Pagesize totalPages: type: integer title: Totalpages type: object required: - items - total - page - pageSize - totalPages title: PaginatedEventsResponse description: Paginated list of events. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError EventResponse: properties: id: type: string format: uuid title: Id title: type: string title: Title description: anyOf: - type: string - type: 'null' title: Description eventCategory: type: string title: Eventcategory eventType: type: string title: Eventtype eventSubtype: anyOf: - type: string - type: 'null' title: Eventsubtype eventDate: anyOf: - type: string format: date - type: 'null' title: Eventdate eventDateEnd: anyOf: - type: string format: date - type: 'null' title: Eventdateend location: anyOf: - type: string - type: 'null' title: Location locationCountry: anyOf: - type: string - type: 'null' title: Locationcountry locationCoordinates: anyOf: - $ref: '#/components/schemas/CoordinatesResponse' - type: 'null' fatalities: anyOf: - type: integer - type: 'null' title: Fatalities injuries: anyOf: - type: integer - type: 'null' title: Injuries abductions: anyOf: - type: integer - type: 'null' title: Abductions civilianTargeting: anyOf: - type: boolean - type: 'null' title: Civiliantargeting admin1: anyOf: - type: string - type: 'null' title: Admin1 admin2: anyOf: - type: string - type: 'null' title: Admin2 admin3: anyOf: - type: string - type: 'null' title: Admin3 geoPrecision: anyOf: - type: integer - type: 'null' title: Geoprecision salienceScore: anyOf: - type: number - type: 'null' title: Saliencescore salienceRationale: anyOf: - type: string - type: 'null' title: Saliencerationale articleCount: type: integer title: Articlecount default: 0 actorCount: type: integer title: Actorcount default: 0 sourceDomains: anyOf: - items: type: string type: array - type: 'null' title: Sourcedomains sourceTypes: anyOf: - items: type: string type: array - type: 'null' title: Sourcetypes createdAt: type: string format: date-time title: Createdat updatedAt: type: string format: date-time title: Updatedat type: object required: - id - title - eventCategory - eventType - createdAt - updatedAt title: EventResponse description: Public representation of a corpus event. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError CoordinatesResponse: properties: lat: anyOf: - type: number - type: 'null' title: Lat lng: anyOf: - type: number - type: 'null' title: Lng type: object title: CoordinatesResponse description: Geographic coordinates. securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key ````