> ## Documentation Index > Fetch the complete documentation index at: https://docs.tic.io/llms.txt > Use this file to discover all available pages before exploring further. # List a subject's hits > The hits of one person or company in a screening, strongest first, a page at a time (AG Grid request model: startRow, endRow). `onlyNew`, `onlyPending`, `category`, `minRating` and `hitRating` narrow them. The full list entry of a hit: `GET /screening/{screeningId}/hits/{hitId}`. Pro+ tier Returns the hits of one person or company in a screening, strongest first, a page at a time. Use it for screenings with many hits: fetch the screening with `includeHits=false` to get each subject's hit counts, then page the hits of the subjects you review. Requires the `pep` scope on the API key. The body is the AG Grid request model: `startRow` and `endRow` (at most 500 rows per page). The response is `{ "success": true, "rows": [...], "lastrow": -1 }`, where `lastrow` is `-1` while more rows follow. Each row has the same properties as a [hit](/api-lens/screening/company-screening.md#hit). `onlyNew=true` returns only hits the team had not seen before, `onlyPending=true` only hits without a decision, `category` only one kind of list (`sanction`, `pep`, `regulatoryWarning` or `other`), and `minRating` only hits rated at least that. The full list entry of a hit is fetched with [Get a screening hit](/api-lens/screening/get-a-screening-hit.md). ## OpenAPI ````yaml post /screening/{screeningId}/subjects/{subjectId}/hits openapi: 3.1.1 info: title: TIC Lens API description: "The TIC Lens API provides programmatic access to company, person, property, vehicle, and order data.\r\n\r\n## Authentication\r\n\r\nAll requests require an API key passed via the `x-api-key` header:\r\n\r\n```bash\r\ncurl -H \"x-api-key: YOUR_API_KEY\" https://lens-api.tic.io/companies/123\r\n```\r\n\r\nAPI keys are managed through the TIC Lens web application under **Settings → API Keys**.\r\n\r\n## Base URL\r\n\r\n| Environment | URL |\r\n|-------------|-----|\r\n| Production | `https://lens-api.tic.io` |\r\n\r\n## Feature Access\r\n\r\nEndpoints are gated by your subscription plan. If your plan does not include a feature, the endpoint will return `403 Forbidden`.\r\n\r\n## Rate Limits\r\n\r\nRate limits are applied per API key. If you exceed the limit, requests will return `429 Too Many Requests`.\r\n\r\n## Response Format\r\n\r\nAll responses are JSON. Null values are omitted from responses.\r\n" version: v1 servers: - url: https://lens-api.tic.io security: - ApiKey: [] tags: - name: Addresses - name: Bolagsverket - name: Brf - name: Companies - name: CompanyReports - name: Documents - name: FlightImages - name: Free - name: Orders - name: OrdersExports - name: PaymentControl - name: PaymentControlImport - name: Persons - name: Properties - name: PublicSearch - name: RegistrationCertificate - name: Screening - name: SearchAutocomplete - name: Sentinel - name: ServingPermits - name: Team - name: Teams - name: Vehicles - name: WatchList paths: /screening/{screeningId}/subjects/{subjectId}/hits: post: tags: - Screening summary: List a subject's hits description: >- The hits of one person or company in a screening, strongest first, a page at a time (AG Grid request model: startRow, endRow). `onlyNew`, `onlyPending`, `category`, `minRating` and `hitRating` narrow them. The full list entry of a hit: `GET /screening/{screeningId}/hits/{hitId}`. operationId: GetScreeningSubjectHits parameters: - name: screeningId in: path description: The screening's id required: true schema: type: string format: uuid - name: subjectId in: path description: The subject's id (subjectId in the screening) required: true schema: type: integer format: int32 - name: onlyNew in: query description: Only hits the team had not seen before schema: type: boolean default: false - name: onlyPending in: query description: Only hits without a decision schema: type: boolean default: false - name: category in: query description: >- Only hits of this category: pep, sanction, regulatoryWarning or other schema: $ref: >- #/components/schemas/Ormeo_Library_Entities_TeamScreeningHitCategoryType - name: minRating in: query description: >- Only hits rated at least this (5 identity number, 4 name and birth date, 2 name and country, 1 name only) schema: type: integer format: int32 - name: hitRating in: query description: Only hits with exactly this rating schema: type: integer format: int32 requestBody: content: application/json-patch+json: schema: $ref: '#/components/schemas/Ormeo_Web_Lens_Models_AGGrid_AGGridRequest' application/json: schema: $ref: '#/components/schemas/Ormeo_Web_Lens_Models_AGGrid_AGGridRequest' text/json: schema: $ref: '#/components/schemas/Ormeo_Web_Lens_Models_AGGrid_AGGridRequest' application/*+json: schema: $ref: '#/components/schemas/Ormeo_Web_Lens_Models_AGGrid_AGGridRequest' responses: '200': description: AG Grid page of TeamScreeningHitSummary_Dto rows '404': description: Screening or subject not found components: schemas: Ormeo_Library_Entities_TeamScreeningHitCategoryType: enum: - other - pep - sanction - adverseMedia - regulatoryWarning type: string Ormeo_Web_Lens_Models_AGGrid_AGGridRequest: type: object properties: startRow: type: integer format: int32 endRow: type: integer format: int32 rowGroupCols: type: - 'null' - array items: $ref: '#/components/schemas/Ormeo_Web_Lens_Models_AGGrid_RowGroupModel' groupKeys: type: - 'null' - array items: type: string filterModel: type: - 'null' - array items: $ref: '#/components/schemas/Ormeo_Web_Lens_Models_AGGrid_FilterModel' sortModel: type: - 'null' - array items: $ref: '#/components/schemas/Ormeo_Web_Lens_Models_AGGrid_SortModel' additionalProperties: false Ormeo_Web_Lens_Models_AGGrid_RowGroupModel: type: object properties: id: type: - 'null' - string displayName: type: - 'null' - string field: type: - 'null' - string additionalProperties: false Ormeo_Web_Lens_Models_AGGrid_FilterModel: type: object properties: columnName: type: - 'null' - string columnNameWithAlias: type: - 'null' - string readOnly: true filterType: type: - 'null' - string additionalProperties: false Ormeo_Web_Lens_Models_AGGrid_SortModel: type: object properties: sort: $ref: '#/components/schemas/Ormeo_Web_Lens_Models_AGGrid_SortOrder' colId: type: - 'null' - string additionalProperties: false Ormeo_Web_Lens_Models_AGGrid_SortOrder: enum: - asc - desc type: string securitySchemes: ApiKey: type: apiKey name: x-api-key in: header ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.