Download OpenAPI specification:Download
API for managing individual OCR invoice jobs
Retrieve a list of all OCR invoice jobs with optional filtering and pagination
| limit | integer [ 1 .. 100 ] Default: 50 Maximum number of records to return |
| offset | integer >= 0 Default: 0 Number of records to skip for pagination |
| sort | string Field to sort by |
| order | string Default: "desc" Enum: "asc" "desc" Sort order (asc or desc) |
| filter | string Filter conditions in JSON format |
| search | string Search term for text fields |
{- "success": true,
- "data": [
- {
- "_id": "60f7b1b3e4b0e8b3f8b3f8b3",
- "jobNumber": "OCR-2023-001",
- "documentName": "invoice_2023_001.pdf",
- "documentType": "pdf",
- "template": "60f7b1b3e4b0e8b3f8b3f8b4",
- "group": "60f7b1b3e4b0e8b3f8b3f8b5",
- "status": "created",
- "priority": "low",
- "progress": {
- "percentage": 100,
- "currentStep": "string",
- "totalSteps": 0
}, - "startedAt": "2023-01-15T08:00:00Z",
- "completedAt": "2023-01-15T08:05:00Z",
- "processingTime": 45.6,
- "documentInfo": {
- "pages": 0,
- "size": 0,
- "format": "string",
- "resolution": "string",
- "language": "string"
}, - "extractedData": {
- "invoice": {
- "number": "string",
- "date": "2019-08-24",
- "dueDate": "2019-08-24",
- "supplier": {
- "name": "string",
- "address": "string",
- "taxId": "string"
}, - "customer": {
- "name": "string",
- "address": "string"
}, - "amounts": {
- "subtotal": 0,
- "tax": 0,
- "total": 0,
- "currency": "string"
}
}, - "lineItems": [
- {
- "description": "string",
- "quantity": 0,
- "unitPrice": 0,
- "amount": 0
}
]
}, - "confidence": {
- "overall": 1,
- "fields": {
- "property1": 0,
- "property2": 0
}
}, - "validationResults": {
- "isValid": true,
- "errors": [
- {
- "field": "string",
- "message": "string",
- "severity": "error"
}
]
}, - "cost": 0,
- "currency": "USD",
- "errorLog": "string",
- "retryCount": 0,
- "createdBy": "60f7b1b3e4b0e8b3f8b3f8b6",
- "metadata": { },
- "createdAt": "2023-01-15T08:00:00Z",
- "updatedAt": "2023-01-15T10:30:00Z"
}
], - "total": 0
}Create a new OCR invoice job with the provided data
| jobNumber required | string Unique job number |
| documentName required | string Name of the document being processed |
| documentUrl required | string <uri> URL of the document to process |
| documentType | string Enum: "pdf" "png" "jpg" "jpeg" "tiff" "bmp" Type of document |
| template required | string OCR template ID to use |
| group | string OCR job group ID if part of a batch |
| priority | string Default: "medium" Enum: "low" "medium" "high" "urgent" Processing priority |
| createdBy | string User who created the job |
object Additional metadata |
{- "jobNumber": "OCR-2023-001",
- "documentName": "invoice_2023_001.pdf",
- "documentType": "pdf",
- "template": "60f7b1b3e4b0e8b3f8b3f8b4",
- "group": "60f7b1b3e4b0e8b3f8b3f8b5",
- "priority": "low",
- "createdBy": "60f7b1b3e4b0e8b3f8b3f8b6",
- "metadata": { }
}{- "success": true,
- "data": {
- "_id": "60f7b1b3e4b0e8b3f8b3f8b3",
- "jobNumber": "OCR-2023-001",
- "documentName": "invoice_2023_001.pdf",
- "documentType": "pdf",
- "template": "60f7b1b3e4b0e8b3f8b3f8b4",
- "group": "60f7b1b3e4b0e8b3f8b3f8b5",
- "status": "created",
- "priority": "low",
- "progress": {
- "percentage": 100,
- "currentStep": "string",
- "totalSteps": 0
}, - "startedAt": "2023-01-15T08:00:00Z",
- "completedAt": "2023-01-15T08:05:00Z",
- "processingTime": 45.6,
- "documentInfo": {
- "pages": 0,
- "size": 0,
- "format": "string",
- "resolution": "string",
- "language": "string"
}, - "extractedData": {
- "invoice": {
- "number": "string",
- "date": "2019-08-24",
- "dueDate": "2019-08-24",
- "supplier": {
- "name": "string",
- "address": "string",
- "taxId": "string"
}, - "customer": {
- "name": "string",
- "address": "string"
}, - "amounts": {
- "subtotal": 0,
- "tax": 0,
- "total": 0,
- "currency": "string"
}
}, - "lineItems": [
- {
- "description": "string",
- "quantity": 0,
- "unitPrice": 0,
- "amount": 0
}
]
}, - "confidence": {
- "overall": 1,
- "fields": {
- "property1": 0,
- "property2": 0
}
}, - "validationResults": {
- "isValid": true,
- "errors": [
- {
- "field": "string",
- "message": "string",
- "severity": "error"
}
]
}, - "cost": 0,
- "currency": "USD",
- "errorLog": "string",
- "retryCount": 0,
- "createdBy": "60f7b1b3e4b0e8b3f8b3f8b6",
- "metadata": { },
- "createdAt": "2023-01-15T08:00:00Z",
- "updatedAt": "2023-01-15T10:30:00Z"
}
}Retrieve a specific OCR invoice job by its ID
| id required | string OCR invoice job ID |
{- "success": true,
- "data": {
- "_id": "60f7b1b3e4b0e8b3f8b3f8b3",
- "jobNumber": "OCR-2023-001",
- "documentName": "invoice_2023_001.pdf",
- "documentType": "pdf",
- "template": "60f7b1b3e4b0e8b3f8b3f8b4",
- "group": "60f7b1b3e4b0e8b3f8b3f8b5",
- "status": "created",
- "priority": "low",
- "progress": {
- "percentage": 100,
- "currentStep": "string",
- "totalSteps": 0
}, - "startedAt": "2023-01-15T08:00:00Z",
- "completedAt": "2023-01-15T08:05:00Z",
- "processingTime": 45.6,
- "documentInfo": {
- "pages": 0,
- "size": 0,
- "format": "string",
- "resolution": "string",
- "language": "string"
}, - "extractedData": {
- "invoice": {
- "number": "string",
- "date": "2019-08-24",
- "dueDate": "2019-08-24",
- "supplier": {
- "name": "string",
- "address": "string",
- "taxId": "string"
}, - "customer": {
- "name": "string",
- "address": "string"
}, - "amounts": {
- "subtotal": 0,
- "tax": 0,
- "total": 0,
- "currency": "string"
}
}, - "lineItems": [
- {
- "description": "string",
- "quantity": 0,
- "unitPrice": 0,
- "amount": 0
}
]
}, - "confidence": {
- "overall": 1,
- "fields": {
- "property1": 0,
- "property2": 0
}
}, - "validationResults": {
- "isValid": true,
- "errors": [
- {
- "field": "string",
- "message": "string",
- "severity": "error"
}
]
}, - "cost": 0,
- "currency": "USD",
- "errorLog": "string",
- "retryCount": 0,
- "createdBy": "60f7b1b3e4b0e8b3f8b3f8b6",
- "metadata": { },
- "createdAt": "2023-01-15T08:00:00Z",
- "updatedAt": "2023-01-15T10:30:00Z"
}
}Update an existing OCR invoice job with new data
| id required | string OCR invoice job ID |
| jobNumber required | string Unique job number |
| documentName required | string Name of the document being processed |
| documentUrl required | string <uri> URL of the document to process |
| documentType | string Enum: "pdf" "png" "jpg" "jpeg" "tiff" "bmp" Type of document |
| template required | string OCR template ID to use |
| group | string OCR job group ID if part of a batch |
| priority | string Default: "medium" Enum: "low" "medium" "high" "urgent" Processing priority |
| createdBy | string User who created the job |
object Additional metadata |
{- "jobNumber": "OCR-2023-001",
- "documentName": "invoice_2023_001.pdf",
- "documentType": "pdf",
- "template": "60f7b1b3e4b0e8b3f8b3f8b4",
- "group": "60f7b1b3e4b0e8b3f8b3f8b5",
- "priority": "low",
- "createdBy": "60f7b1b3e4b0e8b3f8b3f8b6",
- "metadata": { }
}{- "success": true,
- "data": {
- "_id": "60f7b1b3e4b0e8b3f8b3f8b3",
- "jobNumber": "OCR-2023-001",
- "documentName": "invoice_2023_001.pdf",
- "documentType": "pdf",
- "template": "60f7b1b3e4b0e8b3f8b3f8b4",
- "group": "60f7b1b3e4b0e8b3f8b3f8b5",
- "status": "created",
- "priority": "low",
- "progress": {
- "percentage": 100,
- "currentStep": "string",
- "totalSteps": 0
}, - "startedAt": "2023-01-15T08:00:00Z",
- "completedAt": "2023-01-15T08:05:00Z",
- "processingTime": 45.6,
- "documentInfo": {
- "pages": 0,
- "size": 0,
- "format": "string",
- "resolution": "string",
- "language": "string"
}, - "extractedData": {
- "invoice": {
- "number": "string",
- "date": "2019-08-24",
- "dueDate": "2019-08-24",
- "supplier": {
- "name": "string",
- "address": "string",
- "taxId": "string"
}, - "customer": {
- "name": "string",
- "address": "string"
}, - "amounts": {
- "subtotal": 0,
- "tax": 0,
- "total": 0,
- "currency": "string"
}
}, - "lineItems": [
- {
- "description": "string",
- "quantity": 0,
- "unitPrice": 0,
- "amount": 0
}
]
}, - "confidence": {
- "overall": 1,
- "fields": {
- "property1": 0,
- "property2": 0
}
}, - "validationResults": {
- "isValid": true,
- "errors": [
- {
- "field": "string",
- "message": "string",
- "severity": "error"
}
]
}, - "cost": 0,
- "currency": "USD",
- "errorLog": "string",
- "retryCount": 0,
- "createdBy": "60f7b1b3e4b0e8b3f8b3f8b6",
- "metadata": { },
- "createdAt": "2023-01-15T08:00:00Z",
- "updatedAt": "2023-01-15T10:30:00Z"
}
}Retrieve the OCR processing results for a job
| id required | string OCR invoice job ID |
{- "success": true,
- "data": {
- "extractedData": { },
- "confidence": { },
- "validationResults": { },
- "processingTime": 0
}
}