Platform usage
Use the client console from upload to webhook delivery
The client workflow is intentionally short: upload a PDF, watch the request status, and keep webhook URLs ready so the finished result reaches your downstream system.
Upload a PDF
Start from Requests and send one invoice PDF at a time. The platform creates a new request as soon as the upload is accepted.
Track request status
Watch the request move through pending, processing, and completed. If the extraction confidence is low, the request pauses for manual review first.
Review webhook readiness
Open Webhooks to manage the URLs that should receive completed results. The platform sends the same final payload to every active URL.
Use the result downstream
Open completed requests to inspect the extracted JSON and confirm the data your downstream system will receive from the webhook delivery.
Add at least one active webhook URL before your first live upload so completed requests can be picked up automatically by your own system.
API usage
Quick start for request creation and webhook delivery
Send the PDF to POST /client/requests as multipart form data with a client access token.
The platform stores the file, creates a request, and processes it asynchronously. When the request is
completed, every active client webhook URL receives the same final payload.
Request example
curl -X POST "$RELIA_BASE_URL/client/requests" \
-H "Authorization: Bearer <access-token>" \
-F "file=@invoice.pdf"
Immediate API response
{
"id": "<request-id>",
"client_id": "<client-id>",
"filename": "invoice.pdf",
"s3_bucket": "<document-bucket>",
"s3_key": "<stored-object-key>",
"status": "pending",
"error_message": null,
"result": null
}
Webhook payload example
{
"request_id": "<request-id>",
"status": "completed",
"confidence": 0.98,
"result": {
"invoice_number": "INV-1001",
"total_amount": 130.0,
"currency": "EUR"
},
"file": "https://presigned-download.example.test/invoice.pdf",
"file_url_valid_until": "2026-04-28T13:00:00+00:00"
}
If extraction confidence is too low, the request moves to manual review first. The completed webhook is sent after that final review finishes.
When a request comes from your email alias instead of POST /client/requests, the final webhook also includes source_email.url so your downstream system can open the archived raw .eml message if needed.
Email usage
Send invoices to your dedicated Relia inbox
Use your assigned @relia.gr inbox when you want to forward invoices straight from a mailbox or mobile device instead of uploading them manually in the console.
One email can create one request per supported attachment. Supported attachments include PDFs and common phone-photo formats such as JPG, PNG, HEIC, HEIF, TIFF, WEBP, BMP, and GIF.
Your email is archived, each supported attachment becomes its own request, and older aliases can still continue delivering if your admins rotate the main address later.