curl -X GET "https://app.commodityai.com/api/v1/issues?status=open&severity=high&limit=50" \
-H "Authorization: Bearer cai_live_your_api_key_here"
{
"data": [
{
"id": "iss-550e8400-e29b-41d4-a716-446655440000",
"title": "Contract/Invoice price mismatch",
"description": "Invoice INV-2024-1847 bills at $14.25/bushel, but the linked contract CON-2024-044 specifies $12.80/bushel. This represents an 11.3% price variance ($1.45/bushel) which exceeds the 5% tolerance threshold. Total financial impact: $72,500 on 50,000 bushels.",
"severity": "high",
"status": "open",
"category": "mismatch",
"linked_objects": [
{
"id": "obj-770e8400-e29b-41d4-a716-446655440001",
"definition_id": "def-contracts-001",
"definition_name": "contracts",
"record_identifier": "CON-2024-044",
"role": "reference",
"relevant_fields": {
"price_per_unit": 12.80,
"quantity": 50000,
"counterparty": "Pacific Trading Corp"
}
},
{
"id": "obj-880e8400-e29b-41d4-a716-446655440002",
"definition_id": "def-invoices-001",
"definition_name": "invoices",
"record_identifier": "INV-2024-1847",
"role": "compared",
"relevant_fields": {
"price_per_unit": 14.25,
"quantity": 50000,
"counterparty": "Pacific Trading Corp"
}
}
],
"source_documents": [
{
"id": "src-990e8400-e29b-41d4-a716-446655440003",
"filename": "contract-2024-044.pdf",
"document_type": "contract"
},
{
"id": "src-990e8400-e29b-41d4-a716-446655440004",
"filename": "invoice-1847.pdf",
"document_type": "invoice"
}
],
"discrepancy_details": {
"field": "price_per_unit",
"expected_value": 12.80,
"actual_value": 14.25,
"variance": 1.45,
"variance_percent": 11.33
},
"assigned_to": null,
"resolution": null,
"created_at": "2024-01-22T14:35:00Z",
"updated_at": "2024-01-22T14:35:00Z"
},
{
"id": "iss-550e8400-e29b-41d4-a716-446655440005",
"title": "Delivery date mismatch between contract and shipment",
"description": "Shipment SHP-2024-892 scheduled for March 28, 2024 does not align with contract CON-2024-039 delivery window of April 1-5, 2024. Early delivery may incur storage costs or violate delivery terms.",
"severity": "medium",
"status": "open",
"category": "mismatch",
"linked_objects": [
{
"id": "obj-770e8400-e29b-41d4-a716-446655440006",
"definition_id": "def-contracts-001",
"definition_name": "contracts",
"record_identifier": "CON-2024-039",
"role": "reference",
"relevant_fields": {
"delivery_start": "2024-04-01",
"delivery_end": "2024-04-05",
"counterparty": "Midwest Grain Co"
}
},
{
"id": "obj-880e8400-e29b-41d4-a716-446655440007",
"definition_id": "def-shipments-001",
"definition_name": "shipments",
"record_identifier": "SHP-2024-892",
"role": "compared",
"relevant_fields": {
"scheduled_date": "2024-03-28",
"counterparty": "Midwest Grain Co"
}
}
],
"source_documents": [
{
"id": "src-990e8400-e29b-41d4-a716-446655440008",
"filename": "contract-2024-039.pdf",
"document_type": "contract"
},
{
"id": "src-990e8400-e29b-41d4-a716-446655440009",
"filename": "shipping-notice-892.pdf",
"document_type": "shipment_notice"
}
],
"discrepancy_details": {
"field": "delivery_date",
"expected_value": "2024-04-01 to 2024-04-05",
"actual_value": "2024-03-28",
"variance": "-4 days",
"variance_percent": null
},
"assigned_to": "user-110e8400-e29b-41d4-a716-446655440010",
"resolution": null,
"created_at": "2024-01-22T15:10:00Z",
"updated_at": "2024-01-22T15:45:00Z"
},
{
"id": "iss-550e8400-e29b-41d4-a716-446655440011",
"title": "Quantity variance on invoice",
"description": "Invoice INV-2024-1901 claims 82,000 bushels delivered, but the associated bill of lading BOL-2024-445 records only 78,500 bushels. Variance of 3,500 bushels (4.3%) exceeds acceptable tolerance.",
"severity": "high",
"status": "acknowledged",
"category": "discrepancy",
"linked_objects": [
{
"id": "obj-770e8400-e29b-41d4-a716-446655440012",
"definition_id": "def-invoices-001",
"definition_name": "invoices",
"record_identifier": "INV-2024-1901",
"role": "compared",
"relevant_fields": {
"quantity": 82000,
"commodity": "Corn",
"counterparty": "Delta Commodities LLC"
}
},
{
"id": "obj-880e8400-e29b-41d4-a716-446655440013",
"definition_id": "def-bills-of-lading-001",
"definition_name": "bills_of_lading",
"record_identifier": "BOL-2024-445",
"role": "reference",
"relevant_fields": {
"quantity": 78500,
"commodity": "Corn",
"counterparty": "Delta Commodities LLC"
}
}
],
"source_documents": [
{
"id": "src-990e8400-e29b-41d4-a716-446655440014",
"filename": "invoice-1901.pdf",
"document_type": "invoice"
},
{
"id": "src-990e8400-e29b-41d4-a716-446655440015",
"filename": "bol-445.pdf",
"document_type": "bill_of_lading"
}
],
"discrepancy_details": {
"field": "quantity",
"expected_value": 78500,
"actual_value": 82000,
"variance": 3500,
"variance_percent": 4.46
},
"assigned_to": "user-110e8400-e29b-41d4-a716-446655440016",
"resolution": null,
"created_at": "2024-01-23T09:20:00Z",
"updated_at": "2024-01-23T10:15:00Z"
}
],
"meta": {
"has_more": true,
"next_cursor": "eyJpZCI6ImlzcyI6IjU1MGU4NDAwLWUyOWItNDFkNC1hNzE2LTQ0NjY1NTQ0MDAxMSJ9",
"limit": 50,
"total_count": 127
}
}
Retrieve business exceptions and data discrepancies across objects
curl -X GET "https://app.commodityai.com/api/v1/issues?status=open&severity=high&limit=50" \
-H "Authorization: Bearer cai_live_your_api_key_here"
{
"data": [
{
"id": "iss-550e8400-e29b-41d4-a716-446655440000",
"title": "Contract/Invoice price mismatch",
"description": "Invoice INV-2024-1847 bills at $14.25/bushel, but the linked contract CON-2024-044 specifies $12.80/bushel. This represents an 11.3% price variance ($1.45/bushel) which exceeds the 5% tolerance threshold. Total financial impact: $72,500 on 50,000 bushels.",
"severity": "high",
"status": "open",
"category": "mismatch",
"linked_objects": [
{
"id": "obj-770e8400-e29b-41d4-a716-446655440001",
"definition_id": "def-contracts-001",
"definition_name": "contracts",
"record_identifier": "CON-2024-044",
"role": "reference",
"relevant_fields": {
"price_per_unit": 12.80,
"quantity": 50000,
"counterparty": "Pacific Trading Corp"
}
},
{
"id": "obj-880e8400-e29b-41d4-a716-446655440002",
"definition_id": "def-invoices-001",
"definition_name": "invoices",
"record_identifier": "INV-2024-1847",
"role": "compared",
"relevant_fields": {
"price_per_unit": 14.25,
"quantity": 50000,
"counterparty": "Pacific Trading Corp"
}
}
],
"source_documents": [
{
"id": "src-990e8400-e29b-41d4-a716-446655440003",
"filename": "contract-2024-044.pdf",
"document_type": "contract"
},
{
"id": "src-990e8400-e29b-41d4-a716-446655440004",
"filename": "invoice-1847.pdf",
"document_type": "invoice"
}
],
"discrepancy_details": {
"field": "price_per_unit",
"expected_value": 12.80,
"actual_value": 14.25,
"variance": 1.45,
"variance_percent": 11.33
},
"assigned_to": null,
"resolution": null,
"created_at": "2024-01-22T14:35:00Z",
"updated_at": "2024-01-22T14:35:00Z"
},
{
"id": "iss-550e8400-e29b-41d4-a716-446655440005",
"title": "Delivery date mismatch between contract and shipment",
"description": "Shipment SHP-2024-892 scheduled for March 28, 2024 does not align with contract CON-2024-039 delivery window of April 1-5, 2024. Early delivery may incur storage costs or violate delivery terms.",
"severity": "medium",
"status": "open",
"category": "mismatch",
"linked_objects": [
{
"id": "obj-770e8400-e29b-41d4-a716-446655440006",
"definition_id": "def-contracts-001",
"definition_name": "contracts",
"record_identifier": "CON-2024-039",
"role": "reference",
"relevant_fields": {
"delivery_start": "2024-04-01",
"delivery_end": "2024-04-05",
"counterparty": "Midwest Grain Co"
}
},
{
"id": "obj-880e8400-e29b-41d4-a716-446655440007",
"definition_id": "def-shipments-001",
"definition_name": "shipments",
"record_identifier": "SHP-2024-892",
"role": "compared",
"relevant_fields": {
"scheduled_date": "2024-03-28",
"counterparty": "Midwest Grain Co"
}
}
],
"source_documents": [
{
"id": "src-990e8400-e29b-41d4-a716-446655440008",
"filename": "contract-2024-039.pdf",
"document_type": "contract"
},
{
"id": "src-990e8400-e29b-41d4-a716-446655440009",
"filename": "shipping-notice-892.pdf",
"document_type": "shipment_notice"
}
],
"discrepancy_details": {
"field": "delivery_date",
"expected_value": "2024-04-01 to 2024-04-05",
"actual_value": "2024-03-28",
"variance": "-4 days",
"variance_percent": null
},
"assigned_to": "user-110e8400-e29b-41d4-a716-446655440010",
"resolution": null,
"created_at": "2024-01-22T15:10:00Z",
"updated_at": "2024-01-22T15:45:00Z"
},
{
"id": "iss-550e8400-e29b-41d4-a716-446655440011",
"title": "Quantity variance on invoice",
"description": "Invoice INV-2024-1901 claims 82,000 bushels delivered, but the associated bill of lading BOL-2024-445 records only 78,500 bushels. Variance of 3,500 bushels (4.3%) exceeds acceptable tolerance.",
"severity": "high",
"status": "acknowledged",
"category": "discrepancy",
"linked_objects": [
{
"id": "obj-770e8400-e29b-41d4-a716-446655440012",
"definition_id": "def-invoices-001",
"definition_name": "invoices",
"record_identifier": "INV-2024-1901",
"role": "compared",
"relevant_fields": {
"quantity": 82000,
"commodity": "Corn",
"counterparty": "Delta Commodities LLC"
}
},
{
"id": "obj-880e8400-e29b-41d4-a716-446655440013",
"definition_id": "def-bills-of-lading-001",
"definition_name": "bills_of_lading",
"record_identifier": "BOL-2024-445",
"role": "reference",
"relevant_fields": {
"quantity": 78500,
"commodity": "Corn",
"counterparty": "Delta Commodities LLC"
}
}
],
"source_documents": [
{
"id": "src-990e8400-e29b-41d4-a716-446655440014",
"filename": "invoice-1901.pdf",
"document_type": "invoice"
},
{
"id": "src-990e8400-e29b-41d4-a716-446655440015",
"filename": "bol-445.pdf",
"document_type": "bill_of_lading"
}
],
"discrepancy_details": {
"field": "quantity",
"expected_value": 78500,
"actual_value": 82000,
"variance": 3500,
"variance_percent": 4.46
},
"assigned_to": "user-110e8400-e29b-41d4-a716-446655440016",
"resolution": null,
"created_at": "2024-01-23T09:20:00Z",
"updated_at": "2024-01-23T10:15:00Z"
}
],
"meta": {
"has_more": true,
"next_cursor": "eyJpZCI6ImlzcyI6IjU1MGU4NDAwLWUyOWItNDFkNC1hNzE2LTQ0NjY1NTQ0MDAxMSJ9",
"limit": 50,
"total_count": 127
}
}
open, acknowledged, resolved, dismissedcritical, high, medium, lowmismatch, no_match_found, discrepancyeq, gt, gte, lt, lteExamples:created_at[gte]=2024-01-01T00:00:00Z - Created on or after Jan 1, 2024created_at[lt]=2024-12-31T23:59:59Z - Created before Dec 31, 2024eq, gt, gte, lt, ltecurl -X GET "https://app.commodityai.com/api/v1/issues?status=open&severity=high&limit=50" \
-H "Authorization: Bearer cai_live_your_api_key_here"
{
"data": [
{
"id": "iss-550e8400-e29b-41d4-a716-446655440000",
"title": "Contract/Invoice price mismatch",
"description": "Invoice INV-2024-1847 bills at $14.25/bushel, but the linked contract CON-2024-044 specifies $12.80/bushel. This represents an 11.3% price variance ($1.45/bushel) which exceeds the 5% tolerance threshold. Total financial impact: $72,500 on 50,000 bushels.",
"severity": "high",
"status": "open",
"category": "mismatch",
"linked_objects": [
{
"id": "obj-770e8400-e29b-41d4-a716-446655440001",
"definition_id": "def-contracts-001",
"definition_name": "contracts",
"record_identifier": "CON-2024-044",
"role": "reference",
"relevant_fields": {
"price_per_unit": 12.80,
"quantity": 50000,
"counterparty": "Pacific Trading Corp"
}
},
{
"id": "obj-880e8400-e29b-41d4-a716-446655440002",
"definition_id": "def-invoices-001",
"definition_name": "invoices",
"record_identifier": "INV-2024-1847",
"role": "compared",
"relevant_fields": {
"price_per_unit": 14.25,
"quantity": 50000,
"counterparty": "Pacific Trading Corp"
}
}
],
"source_documents": [
{
"id": "src-990e8400-e29b-41d4-a716-446655440003",
"filename": "contract-2024-044.pdf",
"document_type": "contract"
},
{
"id": "src-990e8400-e29b-41d4-a716-446655440004",
"filename": "invoice-1847.pdf",
"document_type": "invoice"
}
],
"discrepancy_details": {
"field": "price_per_unit",
"expected_value": 12.80,
"actual_value": 14.25,
"variance": 1.45,
"variance_percent": 11.33
},
"assigned_to": null,
"resolution": null,
"created_at": "2024-01-22T14:35:00Z",
"updated_at": "2024-01-22T14:35:00Z"
},
{
"id": "iss-550e8400-e29b-41d4-a716-446655440005",
"title": "Delivery date mismatch between contract and shipment",
"description": "Shipment SHP-2024-892 scheduled for March 28, 2024 does not align with contract CON-2024-039 delivery window of April 1-5, 2024. Early delivery may incur storage costs or violate delivery terms.",
"severity": "medium",
"status": "open",
"category": "mismatch",
"linked_objects": [
{
"id": "obj-770e8400-e29b-41d4-a716-446655440006",
"definition_id": "def-contracts-001",
"definition_name": "contracts",
"record_identifier": "CON-2024-039",
"role": "reference",
"relevant_fields": {
"delivery_start": "2024-04-01",
"delivery_end": "2024-04-05",
"counterparty": "Midwest Grain Co"
}
},
{
"id": "obj-880e8400-e29b-41d4-a716-446655440007",
"definition_id": "def-shipments-001",
"definition_name": "shipments",
"record_identifier": "SHP-2024-892",
"role": "compared",
"relevant_fields": {
"scheduled_date": "2024-03-28",
"counterparty": "Midwest Grain Co"
}
}
],
"source_documents": [
{
"id": "src-990e8400-e29b-41d4-a716-446655440008",
"filename": "contract-2024-039.pdf",
"document_type": "contract"
},
{
"id": "src-990e8400-e29b-41d4-a716-446655440009",
"filename": "shipping-notice-892.pdf",
"document_type": "shipment_notice"
}
],
"discrepancy_details": {
"field": "delivery_date",
"expected_value": "2024-04-01 to 2024-04-05",
"actual_value": "2024-03-28",
"variance": "-4 days",
"variance_percent": null
},
"assigned_to": "user-110e8400-e29b-41d4-a716-446655440010",
"resolution": null,
"created_at": "2024-01-22T15:10:00Z",
"updated_at": "2024-01-22T15:45:00Z"
},
{
"id": "iss-550e8400-e29b-41d4-a716-446655440011",
"title": "Quantity variance on invoice",
"description": "Invoice INV-2024-1901 claims 82,000 bushels delivered, but the associated bill of lading BOL-2024-445 records only 78,500 bushels. Variance of 3,500 bushels (4.3%) exceeds acceptable tolerance.",
"severity": "high",
"status": "acknowledged",
"category": "discrepancy",
"linked_objects": [
{
"id": "obj-770e8400-e29b-41d4-a716-446655440012",
"definition_id": "def-invoices-001",
"definition_name": "invoices",
"record_identifier": "INV-2024-1901",
"role": "compared",
"relevant_fields": {
"quantity": 82000,
"commodity": "Corn",
"counterparty": "Delta Commodities LLC"
}
},
{
"id": "obj-880e8400-e29b-41d4-a716-446655440013",
"definition_id": "def-bills-of-lading-001",
"definition_name": "bills_of_lading",
"record_identifier": "BOL-2024-445",
"role": "reference",
"relevant_fields": {
"quantity": 78500,
"commodity": "Corn",
"counterparty": "Delta Commodities LLC"
}
}
],
"source_documents": [
{
"id": "src-990e8400-e29b-41d4-a716-446655440014",
"filename": "invoice-1901.pdf",
"document_type": "invoice"
},
{
"id": "src-990e8400-e29b-41d4-a716-446655440015",
"filename": "bol-445.pdf",
"document_type": "bill_of_lading"
}
],
"discrepancy_details": {
"field": "quantity",
"expected_value": 78500,
"actual_value": 82000,
"variance": 3500,
"variance_percent": 4.46
},
"assigned_to": "user-110e8400-e29b-41d4-a716-446655440016",
"resolution": null,
"created_at": "2024-01-23T09:20:00Z",
"updated_at": "2024-01-23T10:15:00Z"
}
],
"meta": {
"has_more": true,
"next_cursor": "eyJpZCI6ImlzcyI6IjU1MGU4NDAwLWUyOWItNDFkNC1hNzE2LTQ0NjY1NTQ0MDAxMSJ9",
"limit": 50,
"total_count": 127
}
}
Show issue
critical, high, medium, lowopen, acknowledged, resolved, dismissedmismatch, no_match_found, discrepancyShow linked object
reference (expected/source of truth) or compared (value being validated)| Category | Description |
|---|---|
mismatch | Values do not match between related objects |
no_match_found | Expected related object could not be found |
discrepancy | Data inconsistency or variance detected |
| Severity | Description |
|---|---|
critical | Significant financial exposure or compliance risk; requires immediate attention |
high | Material discrepancy; should be addressed before processing |
medium | Moderate variance; review recommended |
low | Minor discrepancy; informational |
| Status | Code | Description |
|---|---|---|
400 | validation_error | Invalid query parameters |
401 | unauthorized | Invalid or missing API key |
429 | rate_limit_exceeded | Too many requests (see Rate Limits) |
500 | internal_error | Internal server error |