Public REST/JSON reference

Invoice Delay API

Sync your AR invoices, predict per-invoice pay-date and delay-risk score, see which clients pay slowly (and how consistently), surface the highest-risk open invoices, and project cash-flow inflow N days ahead. Send graduated reminders (HIGH then CRITICAL) automatically as risk crosses your thresholds. Part of the Logic Igniter Finance & Revenue Intelligence bundle.

Access boundary

These examples describe public API calls only. Use the service output to review, score, summarize, analyze, or recommend; do not treat the API reference as permission for an assistant to write, send, publish, charge, schedule, notify, delete, or modify records.

Base URL

https://api.logicigniter.com

Auth

Authorization: Bearer YOUR_API_KEY

Version

OpenAPI 3.0.3 · 1.0.0

Spec

/api-specs/invoicedelay.json

Operations rendered

Response models rendered

GET/api/v1/invoicedelay/health

Service liveness

Liveness probe — returns 200 if the service is reachable.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X GET "https://api.logicigniter.com/api/v1/invoicedelay/health" \
  -H "Accept: application/json"

Responses

200

Service healthy

POST/api/v1/invoicedelay/invoices/sync

Sync invoices from your AR system

Pull the latest invoices from the connected accounting/AR integration. Each is scored for delay risk on ingest; subsequent calls re-score open invoices.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X POST "https://api.logicigniter.com/api/v1/invoicedelay/invoices/sync" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Responses

200SyncResult

Sync result

401Error

Missing or invalid API key.

402Error

Endpoint requires an active subscription. Free tier covers daily sync + read-only invoice listing; paid plans unlock predictions, reminders, and cash-flow projection.

424Error

AR integration not configured

GET/api/v1/invoicedelay/invoices

List invoices

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Parameters

Name	In	Type	Notes
`page_size`	query	integer
`page_token`	query	string

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X GET "https://api.logicigniter.com/api/v1/invoicedelay/invoices" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Responses

200InvoicesResponse

Page of invoices

401Error

Missing or invalid API key.

GET/api/v1/invoicedelay/invoices/{id}/prediction

Predicted pay date + risk for one invoice

Returns the predicted_pay_date, delay risk_score (0–100), and confidence in the prediction. The prediction is a function of the client's historical payment behavior + invoice attributes (amount, terms, due_date).

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Parameters

Name	In	Type	Notes
`id`required	path	string (uuid)

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X GET "https://api.logicigniter.com/api/v1/invoicedelay/invoices/:id/prediction" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Responses

200DelayPrediction

Delay prediction

401Error

Missing or invalid API key.

404Error

Invoice not found

GET/api/v1/invoicedelay/reminders

List sent reminders

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Parameters

Name	In	Type	Notes
`page_size`	query	integer
`page_token`	query	string

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X GET "https://api.logicigniter.com/api/v1/invoicedelay/reminders" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Responses

200RemindersResponse

Page of reminders

401Error

Missing or invalid API key.

POST/api/v1/invoicedelay/reminders

Send a reminder for an invoice

Send a graduated reminder. The reminder type (HIGH or CRITICAL) is selected automatically based on the invoice's days-overdue and risk_score.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Request body (required)

Schema: SendReminderRequest

Sample JSON payload for evaluation.

{
  "invoice_id": "11111111-1111-1111-1111-111111111111"
}

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X POST "https://api.logicigniter.com/api/v1/invoicedelay/reminders" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"invoice_id":"11111111-1111-1111-1111-111111111111"}'

Responses

200ReminderResult

Reminder sent

400Error

Missing invoice_id

401Error

Missing or invalid API key.

402Error

Endpoint requires an active subscription. Free tier covers daily sync + read-only invoice listing; paid plans unlock predictions, reminders, and cash-flow projection.

404Error

Invoice not found

PUT/api/v1/invoicedelay/reminders/config

Configure reminder lead-time

Set how many days before due_date the system sends the first reminder. Default: 7 days.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Request body (required)

Schema: ConfigureRequest

Sample JSON payload for evaluation.

{
  "lead_days": 7
}

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X PUT "https://api.logicigniter.com/api/v1/invoicedelay/reminders/config" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"lead_days":7}'

Responses

200ReminderConfig

Updated config

400Error

Invalid lead_days

401Error

Missing or invalid API key.

402Error

Endpoint requires an active subscription. Free tier covers daily sync + read-only invoice listing; paid plans unlock predictions, reminders, and cash-flow projection.

GET/api/v1/invoicedelay/risk

Client risk profile

Returns avg_days_to_pay and a payment_consistency_score for one client across their full payment history.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Parameters

Name	In	Type	Notes
`client_id`required	query	string

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X GET "https://api.logicigniter.com/api/v1/invoicedelay/risk" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Responses

200ClientRisk

Client risk profile

400Error

Missing client_id

401Error

Missing or invalid API key.

404Error

Client not found

GET/api/v1/invoicedelay/risk/high

List high-risk open invoices

Workspace-wide list of open invoices ranked by risk_score descending. Pull this list to drive the next batch of reminders.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Parameters

Name	In	Type	Notes
`page_size`	query	integer
`page_token`	query	string

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X GET "https://api.logicigniter.com/api/v1/invoicedelay/risk/high" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Responses

200HighRiskResponse

High-risk invoices

401Error

Missing or invalid API key.

GET/api/v1/invoicedelay/cashflow/projection

Cash-flow projection

Projects daily inflow N days ahead, using each open invoice's predicted_pay_date weighted by confidence. Returns one entry per day with both projected_inflow_cents (risk-weighted) and invoices_due_cents (face value).

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Parameters

Name	In	Type	Notes
`days_ahead`	query	integer

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X GET "https://api.logicigniter.com/api/v1/invoicedelay/cashflow/projection" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Responses

200CashFlowProjection

Projection entries

401Error

Missing or invalid API key.

402Error

Endpoint requires an active subscription. Free tier covers daily sync + read-only invoice listing; paid plans unlock predictions, reminders, and cash-flow projection.

Data models

Error

Field	Type	Notes
`error`required	string

InvoiceStatus

ReminderType

SyncResult

Field	Type	Notes
`id`	string (uuid)
`invoices_synced`	integer
`synced_at`	string (date-time)

Invoice

Field	Type	Notes
`id`	string (uuid)
`external_id`	string
`client_id`	string
`amount_cents`	integer (int64)
`issued_date`	string (date-time)
`due_date`	string (date-time)
`paid_date`	string (date-time)
`status`	InvoiceStatus
`risk_score`	number (double)

InvoicesResponse

Field	Type	Notes
`items`	array<Invoice>
`next_page_token`	string
`total_count`	integer

DelayPrediction

Field	Type	Notes
`id`	string (uuid)
`invoice_id`	string (uuid)
`predicted_pay_date`	string (date-time)
`risk_score`	number (double)
`confidence`	number (double)

SendReminderRequest

Field	Type	Notes
`invoice_id`required	string (uuid)

ReminderResult

Field	Type	Notes
`id`	string (uuid)
`success`	boolean
`sent_at`	string (date-time)

ConfigureRequest

Field	Type	Notes
`lead_days`required	integer

ReminderConfig

Field	Type	Notes
`id`	string (uuid)
`lead_days`	integer

Reminder

Field	Type	Notes
`id`	string (uuid)
`invoice_id`	string (uuid)
`reminder_type`	ReminderType
`sent_at`	string (date-time)

RemindersResponse

Field	Type	Notes
`items`	array<Reminder>
`next_page_token`	string
`total_count`	integer

ClientRisk

Field	Type	Notes
`id`	string (uuid)
`client_id`	string
`name`	string
`avg_days_to_pay`	number (double)
`payment_consistency_score`	number (double)

HighRiskInvoice

Field	Type	Notes
`id`	string (uuid)
`client_id`	string
`amount_cents`	integer (int64)
`due_date`	string (date-time)
`risk_score`	number (double)

HighRiskResponse

Field	Type	Notes
`items`	array<HighRiskInvoice>
`next_page_token`	string
`total_count`	integer

ProjectionEntry

Field	Type	Notes
`date`	string (date-time)
`projected_inflow_cents`	integer (int64)
`invoices_due_cents`	integer (int64)

CashFlowProjection

Field	Type	Notes
`id`	string (uuid)
`entries`	array<ProjectionEntry>