Upload Files

Upload files for processing with automatic document type detection

POST /files/upload

Upload Files (New API)

cURL

curl --request POST \
  --url https://api.invaro.ai/api/v1/files/upload \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'files[0]=document1.pdf' \
  --form 'files[1]=document2.jpg' \
  --form files.items='@example-file'

200

{
  "success": true,
  "data": {
    "files": [
      {
        "doc_id": "72f574a0-b3d2-4a0f-8527-f542e6ea7500",
        "type": "invoice",
        "validation": {
          "page_count": 1,
          "file_size": 84898,
          "format": "PDF"
        }
      }
    ],
    "status": "done"
  }
}

Upload Files

POST /files/upload

Upload files for processing with automatic document type detection. This endpoint supports multiple file formats and maintains backward compatibility with the existing upload endpoint.

Features

• Supports PDF, JPG, JPEG, PNG formats
• Maximum 50 files per request, 10MB per file
• Automatic document type detection
• Maintains backward compatibility with existing upload endpoint

Request

curl -X POST "https://api.invaro.ai/api/v1/files/upload" \
  -H "Authorization: Bearer your_api_key" \
  -F "files=@document.pdf"

Response

{
  "success": true,
  "data": {
    "files": [
      {
        "doc_id": "72f574a0-b3d2-4a0f-8527-f542e6ea7500",
        "type": "invoice",
        "validation": {
          "page_count": 1,
          "file_size": 84898,
          "format": "PDF"
        }
      }
    ],
    "status": "done"
  }
}

Response Fields

Field	Type	Description
doc_id	string	Unique identifier for the uploaded document
type	string	Automatically detected document type (invoice, bank_statement, etc.)
validation.page_count	integer	Number of pages in the document
validation.file_size	integer	File size in bytes
validation.format	string	File format (PDF, JPG, JPEG, PNG)
status	string	Upload status (“done” when successful)

Try It Out

Use the interactive playground above to test the upload endpoint. You can:

1. Add your API key in the Authorization header
2. Select files to upload (PDF, JPG, JPEG, or PNG)
3. Execute the request to see the response

The playground will show you the exact curl command and response format.

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

multipart/form-data

files · file[] · required

Documents to upload (PDF, JPG, JPEG, PNG). Maximum 50 files per request, 10MB per file.

Example:

["document1.pdf", "document2.jpg"]

Response

200 - application/json

Files uploaded successfully

success · boolean

Example:

true

data · object

Show child attributes