> ## Documentation Index
> Fetch the complete documentation index at: https://doc.youverify.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve an Activity

> Retrieves a paginated, filterable list of activities (verification/check events) recorded against entities.



## OpenAPI

````yaml /api-reference/specs/cowork.json get /v2/api/activities
openapi: 3.0.3
info:
  title: Youverify Cowork API
  version: 2.0.0
  description: >-
    Entity, Activity, Signal and Case Management endpoints — the core Cowork
    platform object model. Assembled from doc.youverify.co/api-reference-sdk,
    endpoints kept in the exact order they appear in the GitBook navigation.


    Account-wide error responses (401, 429, 500 on every endpoint; 402 on paid
    verification calls; 404 on lookup-by-ID calls) are sourced verbatim from
    Youverify's own "Youverify OS Error Codes" and "Response Codes" pages
    (doc.youverify.co/youverify-os-error-codes, /get-started/response-codes) and
    attached via components.responses, since those pages document them
    account-wide rather than per endpoint. Any error example that a specific
    endpoint's own page actually showed is kept exactly as documented there
    instead of being replaced by these.
  contact:
    name: Youverify Support
    email: support@youverify.co
servers:
  - url: https://api.youverify.co
    description: Production (live, billed)
  - url: https://api.sandbox.youverify.co
    description: Sandbox (test data, not billed)
security:
  - ApiKeyAuth: []
tags:
  - name: Entity Management
    description: >-
      Create, retrieve and verify entities (individuals or businesses) — the
      core object every check attaches to.
  - name: Activity Management
    description: Inspect the verification activities run against your account.
  - name: Signal Management
    description: Retrieve monitoring signals and their events, by entity or business.
  - name: Case Management
    description: Create and manage compliance cases, including AI-generated case summaries.
paths:
  /v2/api/activities:
    get:
      tags:
        - Activity Management
      summary: Retrieve an Activity
      description: >-
        Retrieves a paginated, filterable list of activities (verification/check
        events) recorded against entities.
      operationId: retrieveActivities
      parameters:
        - name: token
          in: header
          required: true
          schema:
            type: string
          description: API secret token
        - name: entityId
          in: query
          required: false
          schema:
            type: string
          description: Entity ID to filter activities
        - name: limit
          in: query
          required: false
          schema:
            type: string
          description: 'Number of records to return (Default: 10)'
        - name: sortField
          in: query
          required: false
          schema:
            type: string
          description: 'Field to sort results by (Default: createdAt)'
        - name: sortOrder
          in: query
          required: false
          schema:
            type: string
            enum:
              - asc
              - desc
          description: 'Sort order (Default: desc)'
        - name: next
          in: query
          required: false
          schema:
            type: string
          description: Cursor for fetching the next page
        - name: prev
          in: query
          required: false
          schema:
            type: string
          description: Cursor for fetching the previous page
        - name: type
          in: query
          required: false
          schema:
            type: string
          description: Filter by activity type
        - name: status
          in: query
          required: false
          schema:
            type: string
          description: Filter by activity status
        - name: startDate
          in: query
          required: false
          schema:
            type: string
            format: date
          description: Filter activities created after this date
        - name: endDate
          in: query
          required: false
          schema:
            type: string
            format: date
          description: Filter activities created before this date
      responses:
        '200':
          description: Success
          content:
            application/json:
              example:
                success: true
                statusCode: 200
                message: Activities successfully retrieved!
                data:
                  docs:
                    - entityId: 68b0114137593677539a1638
                      activity: Identity Check
                      type: bvn
                      reportId: 68c169c76271c8b9f0bc25c3
                      status: found
                      createdAt: '2025-09-10T12:06:37.180Z'
                      lastModifiedAt: '2025-09-10T12:06:37.180Z'
                      _createdAt: 2025-09-10T12:06:3737+00:00
                      _lastModifiedAt: 2025-09-10T12:06:3737+00:00
                      id: act_68c169cd9a12af3e53c5dc65
                      _id: act_68c169cd9a12af3e53c5dc65
                  pagination:
                    type: cursor
                    perPage: 20
                    nextPage: '2025-08-15T15:31:51.922Z'
                    prevPage: null
                    hasNextPage: true
                    hasPrevPage: false
                  filters: {}
                links: []
        '401':
          $ref: '#/components/responses/Error401Unauthorized'
        '429':
          $ref: '#/components/responses/Error429TooManyRequests'
        '500':
          $ref: '#/components/responses/Error500ServerError'
components:
  responses:
    Error401Unauthorized:
      description: Unauthorized — the token header is missing or invalid.
      content:
        application/json:
          example:
            success: false
            statusCode: 401
            message: Permission denied
            name: UnauthorizedError
            data: {}
    Error429TooManyRequests:
      description: Too Many Requests — you have exceeded the rate limit; wait and retry.
      content:
        application/json:
          example:
            success: false
            statusCode: 429
            message: Too many requests
            name: RateLimitError
            data: {}
    Error500ServerError:
      description: >-
        Internal Server Error — a rare, unexpected failure on Youverify's side.
        Contact support@youverify.co if it persists.
      content:
        application/json:
          example:
            success: false
            statusCode: 500
            message: Internal Server Error
            name: Error
            data: {}
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: token
      description: Your Youverify API secret key. Never expose client-side.

````