> ## Documentation Index > Fetch the complete documentation index at: https://docs.cortex.io/llms.txt > Use this file to discover all available pages before exploring further. # Retrieve verifications > Returns every verification in the workspace, one entry per entity and verification period, including entities that have not been verified yet. Each entry names the entity it belongs to, and who verified it once someone has. ## OpenAPI ````yaml /openapi/cortex_swagger.json get /api/v1/verifications openapi: 3.0.1 info: description: >- The Cortex REST API provides programmatic access to the data in the catalog, Scorecards, and more. title: Cortex API version: v1 servers: - url: https://api.getcortexapp.com description: Cortex Cloud API host security: - bearerAuth: [] tags: - name: API Keys - name: Audit Logs - name: Catalog Entities - name: Catalogs - name: Custom Data - name: Custom Data [Advanced] - name: Custom Events - name: Custom Metrics - name: Dependencies - name: Deploys - name: Discovery Audit - name: Docs - name: 'Eng Intel: 1-Registry' - name: 'Eng Intel: 2-Metrics' - name: 'Eng Intel: 3-Trace' - name: 'Eng Intel: User Labels' - name: Entity Relationship Types - name: Entity Relationships - name: Entity Types - name: GitOps Logs - name: Groups - name: IP Allowlist - name: Initiatives - name: My Workspace - name: Notification Logs - name: On-call - name: Packages - name: Plugins - name: Queries - name: SCIM - name: Scaffolder - name: Scorecards - name: Secrets - name: Team Roles - name: Teams - name: Teams Hierarchies - name: Teams [Advanced] - name: Teams [Departments] (legacy) - name: Users - name: Verifications - name: Workflows - name: '[Integrations] AWS' - name: '[Integrations] Anthropic' - name: '[Integrations] Apiiro' - name: '[Integrations] ArgoCD' - name: '[Integrations] Azure Active Directory' - name: '[Integrations] Azure Devops' - name: '[Integrations] Azure Resources' - name: '[Integrations] BambooHR' - name: '[Integrations] Bitbucket' - name: '[Integrations] Bugsnag' - name: '[Integrations] Buildkite' - name: '[Integrations] Checkmarx SAST' - name: '[Integrations] CircleCI' - name: '[Integrations] ClickUp' - name: '[Integrations] Codecov' - name: '[Integrations] Coralogix' - name: '[Integrations] Datadog' - name: '[Integrations] Dynatrace' - name: '[Integrations] Firehydrant' - name: '[Integrations] GitHub' - name: '[Integrations] GitLab' - name: '[Integrations] Harness' - name: '[Integrations] Incident.io' - name: '[Integrations] Instana' - name: '[Integrations] Jenkins' - name: '[Integrations] Jira' - name: '[Integrations] Kubernetes' - name: '[Integrations] LaunchDarkly' - name: '[Integrations] Lightstep' - name: '[Integrations] Mend SAST' - name: '[Integrations] Mend SCA' - name: '[Integrations] New Relic' - name: '[Integrations] Okta' - name: '[Integrations] Opsgenie' - name: '[Integrations] PagerDuty' - name: '[Integrations] Prometheus' - name: '[Integrations] Rollbar' - name: '[Integrations] Rootly' - name: '[Integrations] Semgrep' - name: '[Integrations] Sentry' - name: '[Integrations] ServiceNow' - name: '[Integrations] SignalFx' - name: '[Integrations] Snyk' - name: '[Integrations] SonarQube' - name: '[Integrations] SumoLogic' - name: '[Integrations] Veracode' - name: '[Integrations] VictorOps' - name: '[Integrations] Wiz' - name: '[Integrations] Workday' - name: '[Integrations] xMatters' - name: dev-login-controller - name: public-scim-schema-controller paths: /api/v1/verifications: get: tags: - Verifications summary: Retrieve verifications description: >- Returns every verification in the workspace, one entry per entity and verification period, including entities that have not been verified yet. Each entry names the entity it belongs to, and who verified it once someone has. operationId: listVerifications parameters: - description: >- Number of results to return per page, between 1 and 1000. Default 250. in: query name: pageSize required: true schema: type: integer format: int32 default: 250 - description: Page number to return, 0-indexed. Default 0. in: query name: page required: true schema: type: integer format: int32 default: 0 - description: Return only verifications belonging to this verification period example: vp0a1b2c3d4e5f6789 in: query name: periodCid required: false schema: type: string - description: Return only verifications in this state example: PENDING in: query name: status required: false schema: type: string enum: - PENDING - VERIFIED_CORRECT - VERIFIED_INCORRECT - description: >- Return only verifications whose period is open today (true) or only those whose period is not (false). Omit for all periods. example: true in: query name: isActive required: false schema: type: boolean responses: '200': content: application/json: schema: $ref: '#/components/schemas/ListVerifications' description: A page of verifications '429': $ref: '#/components/responses/TooManyRequests' components: schemas: ListVerifications: required: - page - total - totalPages - verifications type: object properties: page: type: integer description: Current page number, 0-indexed format: int32 total: type: integer description: Total number of results format: int32 totalPages: type: integer description: Total number of pages format: int32 verifications: type: array items: $ref: '#/components/schemas/EntityVerificationWithEntity' description: A page of verifications from across the catalog EntityVerificationWithEntity: required: - entity - period - status type: object properties: entity: $ref: '#/components/schemas/VerificationEntitySummary' period: $ref: '#/components/schemas/VerificationPeriod' reason: type: string description: Why the entity was marked incorrect, when the verifier supplied one example: Ownership moved to the payments team status: type: string description: Whether the entity's data is correct. PENDING is not accepted. example: VERIFIED_CORRECT enum: - PENDING - VERIFIED_CORRECT - VERIFIED_INCORRECT verifiedAt: type: string description: When the entity was verified format: date-time verifiedByApiKey: $ref: '#/components/schemas/ApiKeyVerifier' verifiedByUser: $ref: '#/components/schemas/CortexUserSummary' description: One entity's status for one verification period, with the entity named TooManyRequestsProblemDetail: required: - type - title - status type: object properties: detail: type: string instance: type: string format: uri-reference retryAfter: minimum: 0 type: integer description: The number of seconds until the rate limiting resets. format: int32 status: maximum: 599 minimum: 100 type: integer format: int32 enum: - 429 title: type: string type: type: string format: uri-reference VerificationEntitySummary: required: - cid - name - tag - type type: object properties: cid: type: string description: Stable identifier example: en0a1b2c3d4e5f6789 name: type: string description: Display name example: Payments API tag: type: string description: The entity's tag example: payments-api type: type: string description: The entity's type example: service description: Enough of an entity to identify it and look it up VerificationPeriod: required: - cid - endDate - isActive - name - startDate type: object properties: cid: type: string description: Stable identifier for the period example: vp0a1b2c3d4e5f6789 description: type: string description: What owners are being asked to confirm endDate: type: string description: When the period closes format: date-time isActive: type: boolean description: >- Whether the period is open today, and so still accepting verifications example: true name: type: string description: Display name example: Q3 Ownership Review startDate: type: string description: When the period opens format: date-time description: A time-boxed entity verification campaign ApiKeyVerifier: type: object properties: name: type: string description: The key's name, or null when it has none example: ci-bot description: An API key that verified an entity CortexUserSummary: required: - email - name type: object properties: email: type: string name: type: string description: >- The user who verified the entity. Null while the status is PENDING, and null when a global API key verified it. responses: TooManyRequests: content: application/problem+json: schema: $ref: '#/components/schemas/TooManyRequestsProblemDetail' description: >- The client has exceeded the rate limit by performing too many requests in a short period. Retry the request after a delay. headers: Retry-After: description: The number of seconds until the rate limiting resets. schema: minimum: 0 type: integer format: int32 securitySchemes: bearerAuth: bearerFormat: JWT description: >- All requests to the Cortex API need to provide an `Authorization: Bearer ` header, where `` is an API key created in the Settings page of your workspace. scheme: bearer type: http ```` ## Related topics - [Verifications](/api/rest/verifications.md) - [Retrieve verification periods](/api/rest/verifications/retrieve-verification-periods.md) - [Using the Cortex MCP](/get-started/cortex-ai-assistant/mcp/using-cortex-mcp.md)