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

# Get File Information

> Retrieve detailed information about a specific file

## Get File Information

**GET** `/files/{file_id}`

Retrieve detailed information about a specific file, including metadata, processing status, and validation results.

### Features

* Complete file metadata
* Processing status tracking
* Validation results
* User ownership validation

### Parameters

| Parameter | Type   | Required | Description                   |
| --------- | ------ | -------- | ----------------------------- |
| `file_id` | string | Yes      | Unique identifier of the file |

### Request

```bash theme={null}
curl "https://api.invaro.ai/api/v1/files/72f574a0-b3d2-4a0f-8527-f542e6ea7500" \
  -H "Authorization: Bearer your_api_key"
```

### Response

```json theme={null}
{
  "success": true,
  "data": {
    "id": "72f574a0-b3d2-4a0f-8527-f542e6ea7500",
    "filename": "invoice.pdf",
    "file_id": "1234567890_invoice.pdf",
    "type": "invoice",
    "status": "completed",
    "size": 84898,
    "created_at": "2024-01-07T10:00:00Z",
    "completed_at": "2024-01-07T10:05:00Z",
    "processed_data": {
      // Extracted document data
    }
  }
}
```

### Response Fields

| Field            | Type    | Description                                           |
| ---------------- | ------- | ----------------------------------------------------- |
| `id`             | string  | Unique file identifier                                |
| `filename`       | string  | Original filename                                     |
| `file_id`        | string  | Internal file storage identifier                      |
| `type`           | string  | Document type (auto-detected)                         |
| `status`         | string  | Current processing status                             |
| `size`           | integer | File size in bytes                                    |
| `created_at`     | string  | Upload timestamp (ISO 8601)                           |
| `completed_at`   | string  | Processing completion timestamp                       |
| `processed_data` | object  | Extracted document data (when processing is complete) |

### Status Values

| Status       | Description                           |
| ------------ | ------------------------------------- |
| `pending`    | File uploaded, waiting for processing |
| `processing` | Currently being processed             |
| `completed`  | Processing finished successfully      |
| `failed`     | Processing failed                     |
| `deleted`    | File has been soft-deleted            |

## Try It Out

Use the interactive playground above to test the get file information endpoint. You can:

1. **Add your API key** in the Authorization header
2. **Enter a file ID** in the path parameter (use a UUID from your uploaded files)
3. **Execute the request** to see detailed file information

The response will include processing status and extracted data if available.


## OpenAPI

````yaml GET /files/{file_id}
openapi: 3.0.0
info:
  title: Invaro Document Processing API
  description: API for processing bank statements and invoices using OCR and AI
  version: 1.0.0
  contact:
    name: Invaro Support
    email: support@invaro.ai
    url: https://docs.invaro.ai
servers:
  - url: https://api.invaro.ai/api/v1
    description: Production API
security:
  - bearerAuth: []
paths:
  /files/{file_id}:
    parameters:
      - name: file_id
        in: path
        required: true
        schema:
          type: string
          format: uuid
        description: Unique identifier of the file
        example: 72f574a0-b3d2-4a0f-8527-f542e6ea7500
    get:
      tags:
        - Files API
      summary: Get File Information
      description: Retrieve detailed information about a specific file
      operationId: getFileInfo
      responses:
        '200':
          description: File information retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    $ref: '#/components/schemas/FileObject'
components:
  schemas:
    FileObject:
      type: object
      properties:
        id:
          type: string
          format: uuid
          example: 72f574a0-b3d2-4a0f-8527-f542e6ea7500
        filename:
          type: string
          example: invoice.pdf
        file_id:
          type: string
          example: 1234567890_invoice.pdf
        type:
          type: string
          example: invoice
        status:
          type: string
          enum:
            - pending
            - processing
            - completed
            - failed
            - deleted
          example: completed
        size:
          type: integer
          example: 84898
        created_at:
          type: string
          format: date-time
          example: '2024-01-07T10:00:00Z'
        completed_at:
          type: string
          format: date-time
          example: '2024-01-07T10:05:00Z'
        processed_data:
          type: object
          description: Extracted document data (when processing is complete)
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````