Document File API

Manage files attached to documents — upload, retrieve, and delete

Base URL

https://{tenant}.logzi.com/api/receipt_file/

Every request returns a JSON response. On success result.code == 1, on error result.code == 0. A document file is a binary file attached to a document (invoice, order, contract, etc.) — stored with base64-encoded content.

GET /api/receipt_file/get

Retrieve a single document file by identifier.

Query parameters

ParameterTypeRequiredDescription
idintFile record identifier

Example request

GET /api/receipt_file/get?id=10
X-API-KEY: {your_api_key}
GET /api/receipt_file/list

Paginated list of document files with filtering options.

Query parameters

ParameterTypeRequiredDescription
list_offsetintPagination offset (default: 0)
list_condition[receipt_id]intFilter by document identifier
list_condition[receipt_type_id]intFilter by document type
list_condition[partner_id]intFilter by all document files of a partner

Example request

GET /api/receipt_file/list?list_condition[receipt_id]=150&list_condition[receipt_type_id]=8
X-API-KEY: {your_api_key}
GET /api/receipt_file/list_light

A lightweight list of document files — without file content (file_source), metadata only.

Query parameters

ParameterTypeRequiredDescription
list_offsetintPagination offset (default: 0)
list_conditionobjectFilter criteria (same as the /list endpoint)

Example request

GET /api/receipt_file/list_light?list_condition[receipt_id]=150&list_condition[receipt_type_id]=8
X-API-KEY: {your_api_key}
POST /api/receipt_file/save

Upload a file or modify an existing one. For a new file use data[id] = 0.

POST fields — data object

FieldTypeRequiredDescription
idint0 = new file, >0 = update
receipt_type_idintDocument type identifier
receipt_idintDocument identifier
file_namestringFile name with extension (e.g. invoice.pdf)
file_sourcestringFile content, base64-encoded
file_type_idintFile type identifier (default: 1)
file_classification_idintFile classification identifier

Example request

POST /api/receipt_file/save
X-API-KEY: {your_api_key}
Content-Type: application/json

{
  "data": {
    "id": 0,
    "receipt_type_id": 8,
    "receipt_id": 150,
    "file_name": "szamla_150.pdf",
    "file_source": "JVBERi0x..."
  }
}
POST /api/receipt_file/delete

Delete a document file by identifier.

POST fields — data object

FieldTypeRequiredDescription
idintIdentifier of the file to delete

Example request

POST /api/receipt_file/delete
X-API-KEY: {your_api_key}
Content-Type: application/json

{ "data": { "id": 10 } }

Get in touch with us

Interested in our software? Feel free to write to us!

Need help?

If you can't find the answer and need assistance

Create your account now,
pay later!

Try it free for 3 days, no risk, no obligation!