Developer API

# Step 1: Upload your file
curl -X POST https://payablesagent.ai/api/documents/upload \
 -H"Authorization: Bearer YOUR_API_TOKEN"\
 -F" document=@/path/to/invoice.pdf"

# Step 2: Start extraction (use file_id from step 1)
curl -X POST https://payablesagent.ai/api/documents/extract \
 -H"Authorization: Bearer YOUR_API_TOKEN"\
 -H"Content-Type: application/json"\
 -d '{"file_id": 1234}'

# Step 3: Get results (use extraction_hash from step 2)
curl -X GET https://payablesagent.ai/api/documents/extraction/abc123-def456-ghi789-jkl012 \
 -H"Authorization: Bearer YOUR_API_TOKEN"

<?php

$token = 'YOUR_API_TOKEN';
$baseUrl = 'https://payablesagent.ai/api';

// Upload the invoice
$ch = curl_init("$baseUrl/documents/upload");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer $token"]);
curl_setopt($ch, CURLOPT_POSTFIELDS, [
 'document' => new CURLFile('/path/to/invoice.pdf')
]);

$uploadResponse = json_decode(curl_exec($ch), true);
curl_close($ch);

if (!$uploadResponse['success']) {
 die('Upload failed: ' . $uploadResponse['message']);
}

$fileId = $uploadResponse['data']['file_id'];
echo"Uploaded file ID: $fileId\n";

// Start extraction
$ch = curl_init("$baseUrl/documents/extract");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
"Authorization: Bearer $token",
"Content-Type: application/json"
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode(['file_id' => $fileId]));

$extractResponse = json_decode(curl_exec($ch), true);
curl_close($ch);

if (!$extractResponse['success']) {
 die('Extraction failed: ' . $extractResponse['message']);
}

$hash = $extractResponse['data']['extraction_hash'];
echo"Extraction hash: $hash\n";

// Fetch results
$ch = curl_init("$baseUrl/documents/extraction/$hash");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer $token"]);

$results = json_decode(curl_exec($ch), true);
curl_close($ch);

// Display extracted fields
foreach ($results['data']['fields'] as $field) {
 echo"{$field['content']}: {$field['value']}\n";
}

const API_TOKEN = 'YOUR_API_TOKEN';
const BASE_URL = 'https://payablesagent.ai/api';

async function extractInvoice(file) {
 // Step 1: Upload
 const formData = new FormData();
 formData.append('document', file);

 const uploadRes = await fetch(`${BASE_URL}/documents/upload`, {
 method: 'POST',
 headers: { 'Authorization': `Bearer ${API_TOKEN}` },
 body: formData
 });
 const uploadData = await uploadRes.json();

 if (!uploadData.success) throw new Error(uploadData.message);
 console.log('File ID:', uploadData.data.file_id);

 // Step 2: Extract
 const extractRes = await fetch(`${BASE_URL}/documents/extract`, {
 method: 'POST',
 headers: {
 'Authorization': `Bearer ${API_TOKEN}`,
 'Content-Type': 'application/json'
 },
 body: JSON.stringify({ file_id: uploadData.data.file_id })
 });
 const extractData = await extractRes.json();

 if (!extractData.success) throw new Error(extractData.message);
 console.log('Extraction hash:', extractData.data.extraction_hash);

 // Step 3: Get results (may need polling for large files)
 const resultsRes = await fetch(
 `${BASE_URL}/documents/extraction/${extractData.data.extraction_hash}`,
 { headers: { 'Authorization': `Bearer ${API_TOKEN}` } }
 );
 const results = await resultsRes.json();

 // Return structured data
 return results.data.fields.reduce((acc, field) => {
 acc[field.content] = field.is_table ? field.rows : field.value;
 return acc;
 }, {});
}

// Usage with file input
document.querySelector('#invoice-input').addEventListener('change', async (e) => {
 const file = e.target.files[0];
 const data = await extractInvoice(file);
 console.log('Extracted:', data);
});

import requests
import time

API_TOKEN = 'YOUR_API_TOKEN'
BASE_URL = 'https://payablesagent.ai/api'

def extract_invoice(file_path):
 headers = {'Authorization': f'Bearer {API_TOKEN}'}

 # Step 1: Upload
 with open(file_path, 'rb') as f:
 upload_res = requests.post(
 f'{BASE_URL}/documents/upload',
 headers=headers,
 files={'document': f}
 )

 upload_data = upload_res.json()
 if not upload_data.get('success'):
 raise Exception(f"Upload failed: {upload_data.get('message')}")

 file_id = upload_data['data']['file_id']
 print(f"File ID: {file_id}")

 # Step 2: Start extraction
 extract_res = requests.post(
 f'{BASE_URL}/documents/extract',
 headers={**headers, 'Content-Type': 'application/json'},
 json={'file_id': file_id}
 )

 extract_data = extract_res.json()
 if not extract_data.get('success'):
 raise Exception(f"Extraction failed: {extract_data.get('message')}")

 hash_id = extract_data['data']['extraction_hash']
 print(f"Extraction hash: {hash_id}")

 # Step 3: Poll for results
 time.sleep(2) # Wait for processing

 results_res = requests.get(
 f'{BASE_URL}/documents/extraction/{hash_id}',
 headers=headers
 )

 results = results_res.json()

 # Return as dictionary
 extracted = {}
 for field in results['data']['fields']:
 extracted[field['content']] = field.get('rows') if field['is_table'] else field['value']

 return extracted

# Run it
if __name__ == '__main__':
 data = extract_invoice('/path/to/invoice.pdf')
 print(data)