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

# Get folder results

> Get verification results grouped by result_id within a folder



## OpenAPI

````yaml /api-specs/anycheck.yaml get /folders/{id}/results
openapi: 3.0.3
info:
  title: AnyCheck API
  version: 1.0.0
  description: >
    # AnyCheck API Documentation


    The AnyCheck API (formerly KYB API) provides comprehensive business and
    identity verification services through a RESTful interface.


    ## Features

    - **Identity Verification**: KTP, NIK, and other identity document
    validation

    - **Business Documents**: BPKB, land certificates, and business registration
    verification

    - **Compliance**: PEP screening and fraud detection

    - **Bank Statement Analysis**: OCR extraction and financial analysis

    - **Template Management**: Create and manage verification templates

    - **Async Processing**: Queue-based verification with webhook notifications


    ## Authentication

    All endpoints (except `/ping` and `/health`) require authentication via the
    `X-API-Key` header.
  contact:
    name: API Support
    email: bd@fintelite.ai
  license:
    name: Proprietary
servers:
  - url: https://api.anycheck.ai
    description: Production server
security:
  - apiKey: []
tags:
  - name: Health
    description: Health check endpoints
  - name: Upload
    description: File upload operations
  - name: Authentication
    description: User authentication and registration
  - name: Groups
    description: Group resource management
  - name: Services
    description: Verification service operations
  - name: Folders
    description: Folder management for organizing verifications
  - name: Verifications
    description: Document verification operations
  - name: Templates
    description: Verification template management
  - name: Bank Statement Analysis
    description: Bank statement OCR extraction, review, and financial analytics
  - name: Drafts
    description: 'Draft verification management: save, edit, and submit verifications'
paths:
  /folders/{id}/results:
    get:
      tags:
        - Folders
      summary: Get folder results
      description: Get verification results grouped by result_id within a folder
      operationId: getFolderResults
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: Folder ID
        - name: page_offset
          in: query
          schema:
            type: integer
            default: 0
          description: Number of items to skip
        - name: page_size
          in: query
          schema:
            type: integer
            default: 10
          description: Number of items per page
        - name: service_id
          in: query
          schema:
            type: array
            items:
              type: string
              format: uuid
          style: form
          explode: true
          description: Filter by service IDs
        - name: period_start
          in: query
          schema:
            type: string
            format: date
          description: Start date filter
        - name: period_end
          in: query
          schema:
            type: string
            format: date
          description: End date filter
      responses:
        '200':
          description: List of verification results grouped by result_id
          content:
            application/json:
              schema:
                type: object
                properties:
                  total:
                    type: integer
                    description: Total number of results
                    example: 10
                  items:
                    type: array
                    items:
                      $ref: '#/components/schemas/FolderResult'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '408':
          $ref: '#/components/responses/RequestTimeout'
components:
  schemas:
    FolderResult:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Result ID that groups verifications
        folder:
          type: object
          properties:
            id:
              type: string
              format: uuid
            name:
              type: string
          description: Folder containing these results
        verification_types:
          type: array
          items:
            type: string
          description: Types of verifications in this result
          example:
            - KTP & PEP Verification
            - BPKB DKI Jakarta
        output_statuses:
          type: array
          items:
            type: string
          description: Output statuses of verifications in this result
          example:
            - KTP Verified
            - BPKB DKI Jakarta Not Verified
        overall_status:
          type: string
          enum:
            - PENDING
            - PROCESSING
            - COMPLETED
            - FAILED
          description: Overall status of the result
          example: COMPLETED
        total_files:
          type: integer
          description: Total number of files in this result
          example: 3
        total_pages:
          type: integer
          description: Total number of pages processed
          example: 8
        created_at:
          type: string
          format: date-time
          description: Result creation timestamp
        updated_at:
          type: string
          format: date-time
          description: Result last update timestamp
        processed_by:
          type: string
          description: User ID or API Key who processed the result
        processed_by_name:
          type: string
          description: User name or API Key who processed the result
          example: John Doe
    ErrorResponse:
      type: object
      properties:
        error_code:
          type: string
          example: INVALID_REQUEST
          description: Error code identifying the type of error
        message:
          type: string
          example: Invalid request. Please check input data format and try again
          description: Human-readable error message
        errors:
          type: array
          description: Field-specific validation errors (optional)
          items:
            $ref: '#/components/schemas/FieldError'
    FieldError:
      type: object
      properties:
        field:
          type: string
          description: Name of the field with validation error
          example: service_id
        message:
          type: string
          description: Field-specific error message
          example: This field is required
      required:
        - field
        - message
  responses:
    BadRequest:
      description: Bad request - Invalid input data
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          examples:
            required_field:
              summary: Required field missing
              value:
                error_code: INVALID_REQUEST
                message: Invalid request. Please check input data format and try again
                errors:
                  - field: service_id
                    message: This field is required
            invalid_format:
              summary: Invalid field format
              value:
                error_code: INVALID_REQUEST
                message: Invalid request. Please check input data format and try again
                errors:
                  - field: email
                    message: This field should be a valid email
                  - field: folder_id
                    message: Must be a valid UUID
            multiple_errors:
              summary: Multiple validation errors
              value:
                error_code: INVALID_REQUEST
                message: Invalid request. Please check input data format and try again
                errors:
                  - field: service_id
                    message: This field is required
                  - field: configuration
                    message: This field is required
                  - field: folder_id
                    message: Must be a valid UUID
    Unauthorized:
      description: Unauthorized - Authentication required or invalid
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          examples:
            invalid_api_key:
              summary: Invalid API key
              value:
                error_code: INVALID_API_KEY
                message: API key is invalid
            api_key_expired:
              summary: Expired API key
              value:
                error_code: API_KEY_EXPIRED
                message: API key is expired
            unauthorized:
              summary: Missing authentication
              value:
                error_code: UNAUTHORIZED
                message: You are not authorized to perform this action
    Forbidden:
      description: Forbidden - User lacks required permissions
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            error_code: FORBIDDEN
            message: You are forbidden to perform this action
    NotFound:
      description: Resource not found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            error_code: NOT_FOUND
            message: Resource not found
    RequestTimeout:
      description: Request timeout
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            error_code: REQUEST_TIMEOUT
            message: Request timed out. Please try again later
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: X-API-Key
      description: API key for service-to-service authentication

````