> ## 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 Actors > List actors 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/actors 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/actors: get: tags: - Actors summary: List Actors description: |- List actors 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_actors_v1_actors_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: actor_type in: query required: false schema: type: array items: type: string description: Filter by actor type (repeatable) default: [] title: Actor Type description: Filter by actor type (repeatable) - 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: search in: query required: false schema: anyOf: - type: string - type: 'null' description: Search in canonical name title: Search description: Search in canonical name - name: event_count_min in: query required: false schema: anyOf: - type: integer minimum: 0 - type: 'null' description: Minimum event count title: Event Count Min description: Minimum event count - name: event_count_max in: query required: false schema: anyOf: - type: integer minimum: 0 - type: 'null' description: Maximum event count title: Event Count Max description: Maximum event count - 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: sort_by in: query required: false schema: type: string description: Sort column default: canonical_name title: Sort By description: Sort column - name: sort_order in: query required: false schema: $ref: '#/components/schemas/SortOrder' description: Sort direction default: asc 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/PaginatedActorsResponse' '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. PaginatedActorsResponse: properties: items: items: $ref: '#/components/schemas/ActorResponse' 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: PaginatedActorsResponse description: Paginated list of actors. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError ActorResponse: properties: id: type: string format: uuid title: Id canonicalName: type: string title: Canonicalname aliases: anyOf: - items: type: string type: array - type: 'null' title: Aliases description: anyOf: - type: string - type: 'null' title: Description articleCount: type: integer title: Articlecount default: 0 eventCount: type: integer title: Eventcount default: 0 sourceDomains: anyOf: - items: type: string type: array - type: 'null' title: Sourcedomains firstMentionDate: anyOf: - type: string format: date - type: 'null' title: Firstmentiondate lastMentionDate: anyOf: - type: string format: date - type: 'null' title: Lastmentiondate createdAt: type: string format: date-time title: Createdat updatedAt: type: string format: date-time title: Updatedat type: object required: - id - canonicalName - createdAt - updatedAt title: ActorResponse description: Public representation of an actor. 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 securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key ````