Inex API Documentation

Multi-file Upload

With this service, you can upload one or more files to the system. The returned file IDs (UUID) can be used when declaring a parcel.

POST /integrators/files/upload-multiple

Field	Type	In	Required	Example	Description
files[]	array (binary)	BODY (FormData)	Yes	binary data	Files to upload (min: 1, max: 10). Allowed formats: xlsx, pdf, jpeg, png, jpg, doc, docx, xls. Maximum size: 10MB.

Response Structure 201 Created

Attribute	Type	Example	Description
data	array	[]	Array of uploaded files.
data.*.uid	string (uuid)	98a76c5d-4e3f-2g1h-0i9j-8k7l6m5n4o3p	Unique file identifier.
data.*.name	string	98a76c5d-4e3f-2g1h-0i9j-8k7l6m5n4o3p.pdf	File system name.
data.*.originalName	string	invoice.pdf	Original file name.
data.*.extension	string	pdf	File extension.
data.*.size	integer	1024	File size in bytes.
data.*.mime	string	application/pdf	File MIME type.

Possible Responses

Code	Description
201 Created	Files uploaded successfully.
422 Unprocessable Entity	Validation error (invalid format, size, or quantity).
403 Forbidden	You do not have permission to perform this operation.
413 Payload Too Large	Total size of files exceeds the allowed limit.

cURL Request BASH

curl -X POST https://api-staging.inex.ge/api/v1/integrators/files/upload-multiple \
                -H "Authorization: Bearer {TOKEN}" \
-H "Content-Type: multipart/form-data" \
-F "files[]=@/path/to/invoice.pdf" \
-F "files[]=@/path/to/image.jpg"

Response (201 Created)

JSON Response JSON

{
    "data": [
        {
            "uid": "98a76c5d-4e3f-2g1h-0i9j-8k7l6m5n4o3p",
            "name": "98a76c5d-4e3f-2g1h-0i9j-8k7l6m5n4o3p.pdf",
            "originalName": "invoice.pdf",
            "mime": "application\/pdf",
            "size": 102456,
            "extension": "pdf"
        },
        {
            "uid": "12b34c5d-6e7f-8g9h-0i1j-2k3l4m5n6o7p",
            "name": "12b34c5d-6e7f-8g9h-0i1j-2k3l4m5n6o7p.jpg",
            "originalName": "image.jpg",
            "mime": "image\/jpeg",
            "size": 204800,
            "extension": "jpg"
        }
    ]
}

Error Response (422)

JSON Response JSON

{
    "message": "The files.0 must be a file of type: xlsx, pdf, jpeg, png, jpg, doc, docx, xls.",
    "errors": {
        "files.0": [
            "The files.0 must be a file of type: xlsx, pdf, jpeg, png, jpg, doc, docx, xls."
        ]
    }
}