Skip to main content
EUDR due diligence obligations require operators to demonstrate that agricultural commodities originate from land held under legitimate legal tenure. This endpoint accepts a land tenure document — such as a title deed, government land certificate, or concession agreement — as a multipart file upload. Upon successful ingestion, the document is hashed, stored securely in the compliance vault, and a reference URL is generated for use during TRACES NT submission. The returned documentId and hash can be referenced when generating a DDS to embed certified land rights evidence into the declaration payload.

​
Endpoint

POST /api/v1/enterprise/eudr/declarations/documents/upload

​
Request

This endpoint accepts multipart/form-data encoding. Do not send a JSON body.
​
file
file
required
The land tenure document file to upload. Accepted formats are application/pdf, image/jpeg, and image/png. Maximum file size is 20 MB.
​
documentType
string
required
The category of land tenure document being uploaded. Accepted values are:
  • TITLE_DEED — Official property title or land ownership certificate.
  • GOVERNMENT_CERTIFICATE — A government-issued land use or occupancy certificate.
  • CONCESSION_AGREEMENT — A formal concession or lease agreement from a government authority.
  • CUSTOMARY_RIGHTS — Documentation of customary or community land rights.
​
batchId
string
The batch ID to associate this document with. If provided, the document is automatically linked to the specified batch record. Optional if you intend to link the document manually at DDS generation time.
​
issuingAuthority
string
The name of the government body, registry, or authority that issued the document. Used for audit trail completeness.
​
issueDate
string
The date the document was officially issued, in YYYY-MM-DD format.

​
Response Fields

​
documentId
string
The unique identifier assigned to the uploaded document within the AgriBackup compliance vault. Use this ID to reference the document when generating a DDS.
​
hash
string
The SHA-256 cryptographic hash of the uploaded file, computed at ingestion time. Pass this hash value in the legalDocumentHashes array when calling the Generate DDS endpoint. You can also verify document integrity at any time by hashing your local copy and comparing it against this value.
​
referenceUrl
string
The internal URL used to retrieve the document during TRACES NT submission. This URL is used internally by AgriBackup and does not need to be stored by your application.
​
status
string
The storage status of the uploaded document. Will be SECURED once the file has been successfully hashed and vaulted.

​
Code Examples

import agribackup
from agribackup.rest import ApiException

configuration = agribackup.Configuration(host="https://live.agribackup.com/api/v1")
configuration.api_key['ApiKeyAuth'] = 'sk_live_YOUR_API_KEY'

with agribackup.ApiClient(configuration) as api_client:
    try:
        declarations_api = agribackup.EnterpriseDeclarationsApi(api_client)

        with open("land_title_certificate.pdf", "rb") as doc_file:
            response = declarations_api.upload_land_tenure_document(
                file=doc_file,
                document_type="TITLE_DEED",
                batch_id="batch_a1b2c3d4e5",
                issuing_authority="Kenya National Land Commission",
                issue_date="2024-03-15"
            )

        print("Document ID:", response.document_id)
        print("SHA-256 Hash:", response.hash)
        print("Status:", response.status)

    except ApiException as e:
        print("Exception when calling EnterpriseDeclarationsApi: %s\n" % e)

import { AgriBackupClient } from '@agribackup/sdk';
import fs from 'fs';

const client = new AgriBackupClient({
  apiKey: 'sk_live_YOUR_API_KEY',
  baseUrl: 'https://live.agribackup.com/api/v1'
});

async function uploadDocument() {
  try {
    const fileStream = fs.createReadStream('./land_title_certificate.pdf');

    const response = await client.declarations.uploadLandTenureDocument({
      file: fileStream,
      documentType: 'TITLE_DEED',
      batchId: 'batch_a1b2c3d4e5',
      issuingAuthority: 'Kenya National Land Commission',
      issueDate: '2024-03-15'
    });

    console.log('Document ID:', response.documentId);
    console.log('SHA-256 Hash:', response.hash);
    console.log('Status:', response.status);
  } catch (error) {
    console.error('Error uploading document:', error.message);
  }
}

uploadDocument();

curl --request POST \
  --url https://live.agribackup.com/api/v1/enterprise/eudr/declarations/documents/upload \
  --header 'X-API-Key: sk_live_YOUR_API_KEY' \
  --form 'file=@land_title_certificate.pdf;type=application/pdf' \
  --form 'documentType=TITLE_DEED' \
  --form 'batchId=batch_a1b2c3d4e5' \
  --form 'issuingAuthority=Kenya National Land Commission' \
  --form 'issueDate=2024-03-15'

​
Example Response

{
  "documentId": "doc_123456789abc",
  "hash": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
  "referenceUrl": "https://live.agribackup.com/api/v1/enterprise/eudr/documents/doc_123456789abc/download",
  "status": "SECURED"
}
Store the hash value returned by this endpoint and pass it in the legalDocumentHashes array when generating a DDS. This cryptographically links your land tenure documents to the declaration without transmitting the raw document to TRACES NT.