Get Document

Once the PDF parser completes the job, you can request this endpoint to receive the parsed XML file.

Get Document

GET https://api.tillforty.com/webhook/c01dd71c

This endpoint allows you to check document parsing status or/and get the parsed document in base64 format

Important: Documents stored via the API are accessible for up to 3 days after submission.

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Query

Name	Type	Description
id	string	It's document ID received with the success response when you submitted the file for parsing to request the parsed XML file from this endpoint.
age	number	Age of the user

Response

200

{
    "status_code": 200,
    "id": "c96ac56b-431e-490b-b69b-81269bc38135",
    "date_created": "2025-05-07T14:13:22.198188+00:00",
    "parsed_date": "2025-05-07T15:39:46.727+00:00",
    "bank_code": "PARXLV22",
    "external_id": "ID123",
    "status": "Completed",
    "parsed_base64": "base64",
    "document_version": "v3",
    "execution": "54645"
}

204

{
    "status_code": 204,
    "message": "Document by provided ID was not found",
    "id": "1812c20e-1793-47ad-bf98-498462d57801"
}

400

{
    "status_code": 400,
    "message": "PDF document failed to match any known bank template patterns",
    "id": "1812c20e-1793-47ad-bf98-498462d57801",
    "date_created": "2020-01-01T13:50:19.582262+00:00",
    "external_id": "FER2025211",
    "bank_code": "",
    "status": "Failed"
}

401

{
    "status_code": 401,
    "message": "Unauthorized request. Please provide valid credentials."
}

Sample request

curl -X GET \
  'https://api.tillforty.com/webhook/c01dd71c?id={document_id}' \
  -H 'Authorization: <your_api_key>'

Response Fields

Parameter	Requirement	Description
id	string	The document ID received the success response when you submitted the file for parsing to request the parsed XML file from this endpoint.
status	string	Available statuses: - Pending - Processing - Completed - Failed
parsed_base64		The "parsed_base64" field contains data that has been decoded from its Base64-encoded format and subsequently converted from a PDF to an XML format.
bank_code	string	A code that defines which bank template was used to parse the document. List of banks
external_id	string	Client's individual document ID