---
title: "Get Document Extraction By User"
method: GET
path: "/api/v1/documents/extractions/{document_extraction_id}/user"
tags: ["Document"]
---

# Get Document Extraction By User

`GET /api/v1/documents/extractions/{document_extraction_id}/user`

## Request

- Base URL: `https://api.gemina.co` (the document declares no server; this is the origin it was published from)
- URL: `https://api.gemina.co/api/v1/documents/extractions/{document_extraction_id}/user`
- Auth: OAuth 2 (password, token URL `token`)

## Path parameters

- `document_extraction_id` string, uuid, required

## Response `200`

Successful Response

- ExtractionPrimaryViewOutDTO
  - `status` 'pending' | 'in_process' | 'failed' | 'success' | 'partial' | 'empty', required
  - `meta` ExtractionViewMetaOutDTO, required
    - `extractionId` string, uuid, nullable
    - `modelType` 'gemina' | 'google' | 'openai' | 'velox' | 'praetorian' | 'invictus', required
    - `thinking` boolean, required
    - `correction` boolean, required
    - `evaluation` boolean, required
    - `includeCoordinates` boolean, required
    - `processorClass` string, required
    - `extractionType` 'ocr' | 'document_details_hebrew' | 'document_line_items_hebrew' | 'invoice_headers' | 'invoice_line_items' | 'custom_template' | 'filetag', required: Defines the type of operation to perform on the uploaded document
    - `latencySeconds` number, nullable
    - `numberOfFields` integer, nullable
    - `purgeAt` string, date-time, nullable, required
    - `purgedAt` string, date-time, nullable, required
    - `purgeReason` 'user_deleted' | 'retention_expired' | 'admin_action', required
    - `validationFeedback` ValidationSchemaModel
      - `validationSchema` string[], required
      - `validationFields` ValidationFieldModel[]
        - `key` string, required
        - `label` string, required
        - `type` 'string' | 'number' | 'integer' | 'boolean' | 'date', required
        - `enum` string[], nullable
        - `format` string, nullable
        - `description` string, nullable
      - `rowMutableTables` RowMutableTableModel[]
        - `pointer` string, required
        - `keyTemplate` string, required
        - `columns` ValidationColumnModel[]
          - `name` string, required
          - `type` 'string' | 'number' | 'integer' | 'boolean' | 'date', required
          - `enum` string[], nullable
          - `format` string, nullable
          - `description` string, nullable
    - `validated` boolean
    - `processingStatus` 'pending' | 'in_process' | 'failed' | 'success' | 'partial' | 'empty', required
    - `createdAt` string, date-time, required
    - `creditsConsumed` string, nullable
    - `costCents` integer, nullable
    - `costExplanation` string, nullable
    - `meter` 'processing_credits' | 'filetag_credits': Discriminates which balance a credit transaction debits/credits. ``processing_credits`` covers both subscription and enterprise ledgers (distinguished by ``subscription_id IS NULL`` on enterprise rows). ``filetag_credits`` covers the per-user FileTag allowance stored in ``filetag_credit_balances``. Separate meters so reports and history views can filter cleanly without conflating the two accounting pools.
  - `values` object, nullable, required
  - `verifiedValues` object, nullable
  - `verifiedDiff` VerifiedDiffEntryOutDTO[], nullable
    - `field` string, required
    - `status` 'corrected' | 'added' | 'removed', required
    - `pointer` string, nullable
    - `original` union
      - string
      - integer
      - number
      - boolean
      - unknown[]
        - unknown
      - object
    - `verified` union
      - string
      - integer
      - number
      - boolean
      - unknown[]
        - unknown
      - object
  - `errors` object[]
  - `document` ExtractionDocumentViewMetaOutDTO, required
    - `externalId` string, nullable
    - `documentId` string, uuid, nullable
    - `endUserId` string, nullable
    - `apiKeyId` string, uuid, nullable
    - `apiKeyName` string, nullable
    - `filename` string, nullable
    - `numberOfPages` integer, nullable
    - `normalizedWidth` integer, nullable
    - `normalizedHeight` integer, nullable
    - `normalizedMegapixels` number, nullable
    - `contentType` string, nullable
    - `storageLocation` 'israel' | 'europe' | 'united_states' | 'asia'
    - `imageUrl` string, uri, nullable
    - `thumbnailUrl` string, uri, nullable
    - `originalDocumentUrl` string, uri, nullable
  - `createdAt` string, date-time, nullable
  - `createdAtTimestamp` number, nullable

## Other responses

- `404`: The resource does not exist, or is not visible to the caller. Ownership failures are deliberately indistinguishable from a missing resource.
- `422`: Validation Error

---

[API](https://skmtc.dev/gemina/apis/gemina-api.md) · [All operations](https://skmtc.dev/gemina/apis/gemina-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gemina/apis/gemina-api/revisions/152fd3f6f6ec?raw)