Skip to content

Prudai Developer API: financing records

The operations of this part (Financing records).

Base URL https://api.prudai.com/v1. Logging in is in Login, scopes in Scopes and permissions, errors in Errors. Overview.

MethodPathWhat it doesState
GET/v1/financing-recordsList the financing records of your organisationComing soon
POST/v1/financing-recordsRecord a financing requestComing soon
GET/v1/financing-records/{record_id}Get one financing record with the source of every fieldComing soon
PATCH/v1/financing-records/{record_id}Update a financing record (for example the outcome)Coming soon
DELETE/v1/financing-records/{record_id}Move a financing record to the trash (soft delete, restorable)Coming soon
POST/v1/financing-records/{record_id}/restoreRestore a financing record from the trashComing soon
GET/v1/financing-records/benchmarkBenchmark comparable financing records (aggregates only)Coming soon

List the financing records of your organisation

GET /v1/financing-records

Personal tokens and signed-in users only (403 personal_token_required for a service key). The financing database of the organisation: one record per financing request, with the figures from the financing workflow (sector, revenue, EBITDA, amount, type, leverage, LTV, DSCR, term, securities) and the outcome the adviser adds (financier, accepted or rejected, reason, rate, closing fee, lead time). Never records of another organisation. Newest first; deleted=true lists the trash.

  • State: coming soon, not in production yet.
  • Scope: prudai:financing_records:read
  • Approval: none, no extra step.

Parameters

  • q query · string
    max length 200
  • outcome query · string
    One of: open, accepted, rejected, withdrawn
  • financing_type query · string
    One of: term_loan, revolving_credit, mortgage, lease, factoring, subordinated, mezzanine, private_debt, crowdfunding, bridge, other
  • project_id query · string (uuid)
  • include_deleted query · string
    One of: true, false
  • deleted query · string
    One of: true, false
  • limit query · integer
    default: 20 · min 1 · max 100
  • cursor query · string
    max length 200

Responses

StatusMeaning
200One page of financing records.
401Missing, malformed, unknown, expired or revoked key, or a key used against the wrong environment.
403Authenticated, but not allowed (missing scope, product not on the key or organisation, organisation suspended, Developer API switched off for the organisation, IP not on the allowlist, depth not permitted, licence does not permit redistribution).
422Well-formed request with invalid values (for example an unknown reasoning_effort, empty messages, or an Idempotency-Key reused with a different body).
429Rate limit, concurrency limit, Ultra daily quota or fair-use limit of the free sources operations exceeded.
503Temporarily unavailable (maintenance, overload, or the credit check could not be performed). Nothing ran, nothing is charged.
curl
curl -s "https://api.prudai.com/v1/financing-records" \
-H "Authorization: Bearer $PRUDAI_TOKEN"
CLI (coming soon)
prudai leo financing-records list
Response 200
[
{
"title": "string",
"project_id": "00000000-0000-4000-8000-000000000000",
"sector_sbi": "string",
"financials_year": 1,
"revenue": 1,
"ebitda": 1,
"amount": 1,
"financing_type": "term_loan",
"financing_type_detail": "string",
"leverage": 1,
"ltv_pct": 1,
"dscr": 1,
"dscr_forward": 1,
"rate_base": "string",
"rate_margin_pct": 1,
"interest_rate_pct": 1,
"closing_fee_pct": 1,
"closing_fee_amount": 1,
"term_years": 1,
"securities": [
"string"
],
"financier": "string",
"outcome": "open",
"rejection_category": "dscr_too_low",
"rejection_reason": "string",
"lead_time_days": 1,
"decided_on": "2026-11-05",
"notes": "string",
"object": "financing_record",
"id": "string",
"origin": "workflow",
"source_run_id": "string",
"source_workflow_id": "string",
"sector_section": "string",
"provenance": {},
"version": 1,
"created_at": "2026-11-05T09:30:00.000Z",
"updated_at": "2026-11-05T09:30:00.000Z",
"deleted_at": "2026-11-05T09:30:00.000Z"
}
]

Record a financing request

POST /v1/financing-records

Personal tokens and signed-in users only; a member with a writing role. Requires an Idempotency-Key (8–255 characters): repeating the call returns the same record. Only title is required; outcome defaults to open. Rejection fields belong to outcome: rejected. ?dryRun=true validates and shows the record without storing it. Waits for a human (confirm): the first call answers 202 with an approval request; repeat the exact call with x-prudai-approval: apr_… once a human approved it.

  • State: coming soon, not in production yet.
  • Scope: prudai:financing_records:write
  • Approval: confirm, the user confirms exactly this call.
  • Dry run: ?dryRun=true shows what would happen and stores nothing.
  • Idempotency: send Idempotency-Key; the same key with the same body does not run the action twice.

Parameters

  • Idempotency-Key header · string required
    min length 8 · max length 255
  • dryRun query · string
    One of: true, false

Body

JSON, required.

  • title string
    max length 200
  • project_id string (uuid)
    may be null
  • sector_sbi string
    SBI code (“2562”, “25.62”) or section letter (“C”). may be null
  • financials_year integer
    may be null
  • revenue number
    may be null
  • ebitda number
    may be null
  • amount number
    Financing amount in euros. may be null
  • financing_type string
    One of: term_loan, revolving_credit, mortgage, lease, factoring, subordinated, mezzanine, private_debt, crowdfunding, bridge, other, null · may be null
  • financing_type_detail string
    max length 200 · may be null
  • leverage number
    Net debt / EBITDA. may be null
  • ltv_pct number
    may be null
  • dscr number
    may be null
  • dscr_forward number
    may be null
  • rate_base string
    max length 80 · may be null
  • rate_margin_pct number
    may be null
  • interest_rate_pct number
    Final all-in interest rate. may be null
  • closing_fee_pct number
    may be null
  • closing_fee_amount number
    may be null
  • term_years number
    may be null
  • securities array<string>
  • financier string
    max length 200 · may be null
  • outcome string
    One of: open, accepted, rejected, withdrawn
  • rejection_category string
    One of: dscr_too_low, leverage_too_high, insufficient_collateral, sector_risk, track_record, size_mismatch, pricing, other, null · may be null
  • rejection_reason string
    max length 1000 · may be null
  • lead_time_days integer
    min 0 · may be null
  • decided_on string (date)
    may be null
  • notes string
    max length 4000 · may be null

Responses

StatusMeaning
200A repeat of an earlier call with the same key, or a dry run.
201Created.
202Waiting for human approval (ApprovalRequest).
401Missing, malformed, unknown, expired or revoked key, or a key used against the wrong environment.
403Authenticated, but not allowed (missing scope, product not on the key or organisation, organisation suspended, Developer API switched off for the organisation, IP not on the allowlist, depth not permitted, licence does not permit redistribution).
422Well-formed request with invalid values (for example an unknown reasoning_effort, empty messages, or an Idempotency-Key reused with a different body).
429Rate limit, concurrency limit, Ultra daily quota or fair-use limit of the free sources operations exceeded.
503Temporarily unavailable (maintenance, overload, or the credit check could not be performed). Nothing ran, nothing is charged.

Fields in data (200)

  • title string
    max length 200
  • project_id string (uuid)
    may be null
  • sector_sbi string
    SBI code (“2562”, “25.62”) or section letter (“C”). may be null
  • financials_year integer
    may be null
  • revenue number
    may be null
  • ebitda number
    may be null
  • amount number
    Financing amount in euros. may be null
  • financing_type string
    One of: term_loan, revolving_credit, mortgage, lease, factoring, subordinated, mezzanine, private_debt, crowdfunding, bridge, other, null · may be null
  • financing_type_detail string
    max length 200 · may be null
  • leverage number
    Net debt / EBITDA. may be null
  • ltv_pct number
    may be null
  • dscr number
    may be null
  • dscr_forward number
    may be null
  • rate_base string
    max length 80 · may be null
  • rate_margin_pct number
    may be null
  • interest_rate_pct number
    Final all-in interest rate. may be null
  • closing_fee_pct number
    may be null
  • closing_fee_amount number
    may be null
  • term_years number
    may be null
  • securities array<string>
  • financier string
    max length 200 · may be null
  • outcome string
    One of: open, accepted, rejected, withdrawn
  • rejection_category string
    One of: dscr_too_low, leverage_too_high, insufficient_collateral, sector_risk, track_record, size_mismatch, pricing, other, null · may be null
  • rejection_reason string
    max length 1000 · may be null
  • lead_time_days integer
    min 0 · may be null
  • decided_on string (date)
    may be null
  • notes string
    max length 4000 · may be null
  • object string
    financing_record
  • id string
    pattern ^fin_[A-Za-z0-9]{20}$
  • origin string
    One of: workflow, manual, api
  • source_run_id string
    may be null
  • source_workflow_id string
    may be null
  • sector_section string
    may be null
  • provenance object
    Per field: {source: workflow|adviser|api, slot?, detail?, run_id?, at}.
  • version integer
  • created_at string (date-time)
  • updated_at string (date-time)
  • deleted_at string (date-time)
    may be null
curl
curl -s -X POST "https://api.prudai.com/v1/financing-records" \
-H "Authorization: Bearer $PRUDAI_TOKEN" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{
"title": "string",
"project_id": "00000000-0000-4000-8000-000000000000",
"sector_sbi": "string",
"financials_year": 1,
"revenue": 1,
"ebitda": 1,
"amount": 1,
"financing_type": "term_loan",
"financing_type_detail": "string",
"leverage": 1,
"ltv_pct": 1,
"dscr": 1,
"dscr_forward": 1,
"rate_base": "string",
"rate_margin_pct": 1,
"interest_rate_pct": 1,
"closing_fee_pct": 1,
"closing_fee_amount": 1,
"term_years": 1,
"securities": [
"string"
],
"financier": "string",
"outcome": "open",
"rejection_category": "dscr_too_low",
"rejection_reason": "string",
"lead_time_days": 1,
"decided_on": "2026-11-05",
"notes": "string"
}'
CLI (coming soon)
prudai leo financing-records create
Response 200
{
"title": "string",
"project_id": "00000000-0000-4000-8000-000000000000",
"sector_sbi": "string",
"financials_year": 1,
"revenue": 1,
"ebitda": 1,
"amount": 1,
"financing_type": "term_loan",
"financing_type_detail": "string",
"leverage": 1,
"ltv_pct": 1,
"dscr": 1,
"dscr_forward": 1,
"rate_base": "string",
"rate_margin_pct": 1,
"interest_rate_pct": 1,
"closing_fee_pct": 1,
"closing_fee_amount": 1,
"term_years": 1,
"securities": [
"string"
],
"financier": "string",
"outcome": "open",
"rejection_category": "dscr_too_low",
"rejection_reason": "string",
"lead_time_days": 1,
"decided_on": "2026-11-05",
"notes": "string",
"object": "financing_record",
"id": "string",
"origin": "workflow",
"source_run_id": "string",
"source_workflow_id": "string",
"sector_section": "string",
"provenance": {},
"version": 1,
"created_at": "2026-11-05T09:30:00.000Z",
"updated_at": "2026-11-05T09:30:00.000Z",
"deleted_at": "2026-11-05T09:30:00.000Z"
}

Get one financing record with the source of every field

GET /v1/financing-records/{record_id}

provenance names per field where the value came from: the workflow slot (fin.2025.dscr, loan.principal) with the run, or adviser/api when a person set it. An unknown id and a record of another organisation both answer 404 financing_record_not_found.

  • State: coming soon, not in production yet.
  • Scope: prudai:financing_records:read
  • Approval: none, no extra step.

Parameters

  • record_id path · string required
    pattern ^fin_[A-Za-z0-9]{20}$
  • include_deleted query · string
    One of: true, false

Responses

StatusMeaning
200The record.
401Missing, malformed, unknown, expired or revoked key, or a key used against the wrong environment.
403Authenticated, but not allowed (missing scope, product not on the key or organisation, organisation suspended, Developer API switched off for the organisation, IP not on the allowlist, depth not permitted, licence does not permit redistribution).
404Unknown model, source or document.
429Rate limit, concurrency limit, Ultra daily quota or fair-use limit of the free sources operations exceeded.
503Temporarily unavailable (maintenance, overload, or the credit check could not be performed). Nothing ran, nothing is charged.

Fields in data (200)

  • title string
    max length 200
  • project_id string (uuid)
    may be null
  • sector_sbi string
    SBI code (“2562”, “25.62”) or section letter (“C”). may be null
  • financials_year integer
    may be null
  • revenue number
    may be null
  • ebitda number
    may be null
  • amount number
    Financing amount in euros. may be null
  • financing_type string
    One of: term_loan, revolving_credit, mortgage, lease, factoring, subordinated, mezzanine, private_debt, crowdfunding, bridge, other, null · may be null
  • financing_type_detail string
    max length 200 · may be null
  • leverage number
    Net debt / EBITDA. may be null
  • ltv_pct number
    may be null
  • dscr number
    may be null
  • dscr_forward number
    may be null
  • rate_base string
    max length 80 · may be null
  • rate_margin_pct number
    may be null
  • interest_rate_pct number
    Final all-in interest rate. may be null
  • closing_fee_pct number
    may be null
  • closing_fee_amount number
    may be null
  • term_years number
    may be null
  • securities array<string>
  • financier string
    max length 200 · may be null
  • outcome string
    One of: open, accepted, rejected, withdrawn
  • rejection_category string
    One of: dscr_too_low, leverage_too_high, insufficient_collateral, sector_risk, track_record, size_mismatch, pricing, other, null · may be null
  • rejection_reason string
    max length 1000 · may be null
  • lead_time_days integer
    min 0 · may be null
  • decided_on string (date)
    may be null
  • notes string
    max length 4000 · may be null
  • object string
    financing_record
  • id string
    pattern ^fin_[A-Za-z0-9]{20}$
  • origin string
    One of: workflow, manual, api
  • source_run_id string
    may be null
  • source_workflow_id string
    may be null
  • sector_section string
    may be null
  • provenance object
    Per field: {source: workflow|adviser|api, slot?, detail?, run_id?, at}.
  • version integer
  • created_at string (date-time)
  • updated_at string (date-time)
  • deleted_at string (date-time)
    may be null
curl
curl -s "https://api.prudai.com/v1/financing-records/<record_id>" \
-H "Authorization: Bearer $PRUDAI_TOKEN"
CLI (coming soon)
prudai leo financing-records get
Response 200
{
"title": "string",
"project_id": "00000000-0000-4000-8000-000000000000",
"sector_sbi": "string",
"financials_year": 1,
"revenue": 1,
"ebitda": 1,
"amount": 1,
"financing_type": "term_loan",
"financing_type_detail": "string",
"leverage": 1,
"ltv_pct": 1,
"dscr": 1,
"dscr_forward": 1,
"rate_base": "string",
"rate_margin_pct": 1,
"interest_rate_pct": 1,
"closing_fee_pct": 1,
"closing_fee_amount": 1,
"term_years": 1,
"securities": [
"string"
],
"financier": "string",
"outcome": "open",
"rejection_category": "dscr_too_low",
"rejection_reason": "string",
"lead_time_days": 1,
"decided_on": "2026-11-05",
"notes": "string",
"object": "financing_record",
"id": "string",
"origin": "workflow",
"source_run_id": "string",
"source_workflow_id": "string",
"sector_section": "string",
"provenance": {},
"version": 1,
"created_at": "2026-11-05T09:30:00.000Z",
"updated_at": "2026-11-05T09:30:00.000Z",
"deleted_at": "2026-11-05T09:30:00.000Z"
}

Update a financing record (for example the outcome)

PATCH /v1/financing-records/{record_id}

Any subset of the writable fields. Optimistic concurrency: send If-Match: "<version>" from the last read; a stale version answers 409 version_conflict. Setting outcome to something other than rejected clears a stored rejection reason. A field you set becomes adviser/api in provenance, and a later workflow run no longer overwrites it. ?dryRun=true shows the result without storing it. Waits for a human (confirm).

  • State: coming soon, not in production yet.
  • Scope: prudai:financing_records:write
  • Approval: confirm, the user confirms exactly this call.
  • Dry run: ?dryRun=true shows what would happen and stores nothing.
  • Concurrent changes: send If-Match with the version you read.

Parameters

  • record_id path · string required
    pattern ^fin_[A-Za-z0-9]{20}$
  • If-Match header · string
  • dryRun query · string
    One of: true, false

Body

JSON, required.

  • title string
    max length 200
  • project_id string (uuid)
    may be null
  • sector_sbi string
    SBI code (“2562”, “25.62”) or section letter (“C”). may be null
  • financials_year integer
    may be null
  • revenue number
    may be null
  • ebitda number
    may be null
  • amount number
    Financing amount in euros. may be null
  • financing_type string
    One of: term_loan, revolving_credit, mortgage, lease, factoring, subordinated, mezzanine, private_debt, crowdfunding, bridge, other, null · may be null
  • financing_type_detail string
    max length 200 · may be null
  • leverage number
    Net debt / EBITDA. may be null
  • ltv_pct number
    may be null
  • dscr number
    may be null
  • dscr_forward number
    may be null
  • rate_base string
    max length 80 · may be null
  • rate_margin_pct number
    may be null
  • interest_rate_pct number
    Final all-in interest rate. may be null
  • closing_fee_pct number
    may be null
  • closing_fee_amount number
    may be null
  • term_years number
    may be null
  • securities array<string>
  • financier string
    max length 200 · may be null
  • outcome string
    One of: open, accepted, rejected, withdrawn
  • rejection_category string
    One of: dscr_too_low, leverage_too_high, insufficient_collateral, sector_risk, track_record, size_mismatch, pricing, other, null · may be null
  • rejection_reason string
    max length 1000 · may be null
  • lead_time_days integer
    min 0 · may be null
  • decided_on string (date)
    may be null
  • notes string
    max length 4000 · may be null

Responses

StatusMeaning
200The updated record (or the dry-run result).
202Waiting for human approval (ApprovalRequest).
401Missing, malformed, unknown, expired or revoked key, or a key used against the wrong environment.
403Authenticated, but not allowed (missing scope, product not on the key or organisation, organisation suspended, Developer API switched off for the organisation, IP not on the allowlist, depth not permitted, licence does not permit redistribution).
404Unknown model, source or document.
409The record changed since you read it (version_conflict).
422Well-formed request with invalid values (for example an unknown reasoning_effort, empty messages, or an Idempotency-Key reused with a different body).
429Rate limit, concurrency limit, Ultra daily quota or fair-use limit of the free sources operations exceeded.
503Temporarily unavailable (maintenance, overload, or the credit check could not be performed). Nothing ran, nothing is charged.

Fields in data (200)

  • title string
    max length 200
  • project_id string (uuid)
    may be null
  • sector_sbi string
    SBI code (“2562”, “25.62”) or section letter (“C”). may be null
  • financials_year integer
    may be null
  • revenue number
    may be null
  • ebitda number
    may be null
  • amount number
    Financing amount in euros. may be null
  • financing_type string
    One of: term_loan, revolving_credit, mortgage, lease, factoring, subordinated, mezzanine, private_debt, crowdfunding, bridge, other, null · may be null
  • financing_type_detail string
    max length 200 · may be null
  • leverage number
    Net debt / EBITDA. may be null
  • ltv_pct number
    may be null
  • dscr number
    may be null
  • dscr_forward number
    may be null
  • rate_base string
    max length 80 · may be null
  • rate_margin_pct number
    may be null
  • interest_rate_pct number
    Final all-in interest rate. may be null
  • closing_fee_pct number
    may be null
  • closing_fee_amount number
    may be null
  • term_years number
    may be null
  • securities array<string>
  • financier string
    max length 200 · may be null
  • outcome string
    One of: open, accepted, rejected, withdrawn
  • rejection_category string
    One of: dscr_too_low, leverage_too_high, insufficient_collateral, sector_risk, track_record, size_mismatch, pricing, other, null · may be null
  • rejection_reason string
    max length 1000 · may be null
  • lead_time_days integer
    min 0 · may be null
  • decided_on string (date)
    may be null
  • notes string
    max length 4000 · may be null
  • object string
    financing_record
  • id string
    pattern ^fin_[A-Za-z0-9]{20}$
  • origin string
    One of: workflow, manual, api
  • source_run_id string
    may be null
  • source_workflow_id string
    may be null
  • sector_section string
    may be null
  • provenance object
    Per field: {source: workflow|adviser|api, slot?, detail?, run_id?, at}.
  • version integer
  • created_at string (date-time)
  • updated_at string (date-time)
  • deleted_at string (date-time)
    may be null
curl
curl -s -X PATCH "https://api.prudai.com/v1/financing-records/<record_id>" \
-H "Authorization: Bearer $PRUDAI_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"title": "string",
"project_id": "00000000-0000-4000-8000-000000000000",
"sector_sbi": "string",
"financials_year": 1,
"revenue": 1,
"ebitda": 1,
"amount": 1,
"financing_type": "term_loan",
"financing_type_detail": "string",
"leverage": 1,
"ltv_pct": 1,
"dscr": 1,
"dscr_forward": 1,
"rate_base": "string",
"rate_margin_pct": 1,
"interest_rate_pct": 1,
"closing_fee_pct": 1,
"closing_fee_amount": 1,
"term_years": 1,
"securities": [
"string"
],
"financier": "string",
"outcome": "open",
"rejection_category": "dscr_too_low",
"rejection_reason": "string",
"lead_time_days": 1,
"decided_on": "2026-11-05",
"notes": "string"
}'
CLI (coming soon)
prudai leo financing-records update
Response 200
{
"title": "string",
"project_id": "00000000-0000-4000-8000-000000000000",
"sector_sbi": "string",
"financials_year": 1,
"revenue": 1,
"ebitda": 1,
"amount": 1,
"financing_type": "term_loan",
"financing_type_detail": "string",
"leverage": 1,
"ltv_pct": 1,
"dscr": 1,
"dscr_forward": 1,
"rate_base": "string",
"rate_margin_pct": 1,
"interest_rate_pct": 1,
"closing_fee_pct": 1,
"closing_fee_amount": 1,
"term_years": 1,
"securities": [
"string"
],
"financier": "string",
"outcome": "open",
"rejection_category": "dscr_too_low",
"rejection_reason": "string",
"lead_time_days": 1,
"decided_on": "2026-11-05",
"notes": "string",
"object": "financing_record",
"id": "string",
"origin": "workflow",
"source_run_id": "string",
"source_workflow_id": "string",
"sector_section": "string",
"provenance": {},
"version": 1,
"created_at": "2026-11-05T09:30:00.000Z",
"updated_at": "2026-11-05T09:30:00.000Z",
"deleted_at": "2026-11-05T09:30:00.000Z"
}

Move a financing record to the trash (soft delete, restorable)

DELETE /v1/financing-records/{record_id}

Owner or Admin. The record leaves lists and the benchmark and can be restored with restoreFinancingRecord. ?dryRun=true changes nothing. Waits for a human (review).

  • State: coming soon, not in production yet.
  • Scope: prudai:financing_records:delete
  • Approval: review, a second person or role approves.
  • Dry run: ?dryRun=true shows what would happen and stores nothing.
  • Deleting is soft; see Conventions.

Parameters

  • record_id path · string required
    pattern ^fin_[A-Za-z0-9]{20}$
  • dryRun query · string
    One of: true, false

Responses

StatusMeaning
200In the trash (deleted_at set), or a dry run.
202Waiting for human approval (ApprovalRequest).
401Missing, malformed, unknown, expired or revoked key, or a key used against the wrong environment.
403Authenticated, but not allowed (missing scope, product not on the key or organisation, organisation suspended, Developer API switched off for the organisation, IP not on the allowlist, depth not permitted, licence does not permit redistribution).
404Unknown model, source or document.
429Rate limit, concurrency limit, Ultra daily quota or fair-use limit of the free sources operations exceeded.
503Temporarily unavailable (maintenance, overload, or the credit check could not be performed). Nothing ran, nothing is charged.

Fields in data (200)

  • title string
    max length 200
  • project_id string (uuid)
    may be null
  • sector_sbi string
    SBI code (“2562”, “25.62”) or section letter (“C”). may be null
  • financials_year integer
    may be null
  • revenue number
    may be null
  • ebitda number
    may be null
  • amount number
    Financing amount in euros. may be null
  • financing_type string
    One of: term_loan, revolving_credit, mortgage, lease, factoring, subordinated, mezzanine, private_debt, crowdfunding, bridge, other, null · may be null
  • financing_type_detail string
    max length 200 · may be null
  • leverage number
    Net debt / EBITDA. may be null
  • ltv_pct number
    may be null
  • dscr number
    may be null
  • dscr_forward number
    may be null
  • rate_base string
    max length 80 · may be null
  • rate_margin_pct number
    may be null
  • interest_rate_pct number
    Final all-in interest rate. may be null
  • closing_fee_pct number
    may be null
  • closing_fee_amount number
    may be null
  • term_years number
    may be null
  • securities array<string>
  • financier string
    max length 200 · may be null
  • outcome string
    One of: open, accepted, rejected, withdrawn
  • rejection_category string
    One of: dscr_too_low, leverage_too_high, insufficient_collateral, sector_risk, track_record, size_mismatch, pricing, other, null · may be null
  • rejection_reason string
    max length 1000 · may be null
  • lead_time_days integer
    min 0 · may be null
  • decided_on string (date)
    may be null
  • notes string
    max length 4000 · may be null
  • object string
    financing_record
  • id string
    pattern ^fin_[A-Za-z0-9]{20}$
  • origin string
    One of: workflow, manual, api
  • source_run_id string
    may be null
  • source_workflow_id string
    may be null
  • sector_section string
    may be null
  • provenance object
    Per field: {source: workflow|adviser|api, slot?, detail?, run_id?, at}.
  • version integer
  • created_at string (date-time)
  • updated_at string (date-time)
  • deleted_at string (date-time)
    may be null
curl
curl -s -X DELETE "https://api.prudai.com/v1/financing-records/<record_id>" \
-H "Authorization: Bearer $PRUDAI_TOKEN"
CLI (coming soon)
prudai leo financing-records delete
Response 200
{
"title": "string",
"project_id": "00000000-0000-4000-8000-000000000000",
"sector_sbi": "string",
"financials_year": 1,
"revenue": 1,
"ebitda": 1,
"amount": 1,
"financing_type": "term_loan",
"financing_type_detail": "string",
"leverage": 1,
"ltv_pct": 1,
"dscr": 1,
"dscr_forward": 1,
"rate_base": "string",
"rate_margin_pct": 1,
"interest_rate_pct": 1,
"closing_fee_pct": 1,
"closing_fee_amount": 1,
"term_years": 1,
"securities": [
"string"
],
"financier": "string",
"outcome": "open",
"rejection_category": "dscr_too_low",
"rejection_reason": "string",
"lead_time_days": 1,
"decided_on": "2026-11-05",
"notes": "string",
"object": "financing_record",
"id": "string",
"origin": "workflow",
"source_run_id": "string",
"source_workflow_id": "string",
"sector_section": "string",
"provenance": {},
"version": 1,
"created_at": "2026-11-05T09:30:00.000Z",
"updated_at": "2026-11-05T09:30:00.000Z",
"deleted_at": "2026-11-05T09:30:00.000Z"
}

Restore a financing record from the trash

POST /v1/financing-records/{record_id}/restore

Owner or Admin. 409 project_has_record when the dossier meanwhile has another active workflow record. ?dryRun=true changes nothing. Waits for a human (confirm).

  • State: coming soon, not in production yet.
  • Scope: prudai:financing_records:write
  • Approval: confirm, the user confirms exactly this call.
  • Dry run: ?dryRun=true shows what would happen and stores nothing.

Parameters

  • record_id path · string required
    pattern ^fin_[A-Za-z0-9]{20}$
  • dryRun query · string
    One of: true, false

Responses

StatusMeaning
200Restored (or a dry run).
202Waiting for human approval (ApprovalRequest).
401Missing, malformed, unknown, expired or revoked key, or a key used against the wrong environment.
403Authenticated, but not allowed (missing scope, product not on the key or organisation, organisation suspended, Developer API switched off for the organisation, IP not on the allowlist, depth not permitted, licence does not permit redistribution).
404Unknown model, source or document.
409The dossier already has another active record from the financing workflow (project_has_record), or a version conflict.
429Rate limit, concurrency limit, Ultra daily quota or fair-use limit of the free sources operations exceeded.
503Temporarily unavailable (maintenance, overload, or the credit check could not be performed). Nothing ran, nothing is charged.

Fields in data (200)

  • title string
    max length 200
  • project_id string (uuid)
    may be null
  • sector_sbi string
    SBI code (“2562”, “25.62”) or section letter (“C”). may be null
  • financials_year integer
    may be null
  • revenue number
    may be null
  • ebitda number
    may be null
  • amount number
    Financing amount in euros. may be null
  • financing_type string
    One of: term_loan, revolving_credit, mortgage, lease, factoring, subordinated, mezzanine, private_debt, crowdfunding, bridge, other, null · may be null
  • financing_type_detail string
    max length 200 · may be null
  • leverage number
    Net debt / EBITDA. may be null
  • ltv_pct number
    may be null
  • dscr number
    may be null
  • dscr_forward number
    may be null
  • rate_base string
    max length 80 · may be null
  • rate_margin_pct number
    may be null
  • interest_rate_pct number
    Final all-in interest rate. may be null
  • closing_fee_pct number
    may be null
  • closing_fee_amount number
    may be null
  • term_years number
    may be null
  • securities array<string>
  • financier string
    max length 200 · may be null
  • outcome string
    One of: open, accepted, rejected, withdrawn
  • rejection_category string
    One of: dscr_too_low, leverage_too_high, insufficient_collateral, sector_risk, track_record, size_mismatch, pricing, other, null · may be null
  • rejection_reason string
    max length 1000 · may be null
  • lead_time_days integer
    min 0 · may be null
  • decided_on string (date)
    may be null
  • notes string
    max length 4000 · may be null
  • object string
    financing_record
  • id string
    pattern ^fin_[A-Za-z0-9]{20}$
  • origin string
    One of: workflow, manual, api
  • source_run_id string
    may be null
  • source_workflow_id string
    may be null
  • sector_section string
    may be null
  • provenance object
    Per field: {source: workflow|adviser|api, slot?, detail?, run_id?, at}.
  • version integer
  • created_at string (date-time)
  • updated_at string (date-time)
  • deleted_at string (date-time)
    may be null
curl
curl -s -X POST "https://api.prudai.com/v1/financing-records/<record_id>/restore" \
-H "Authorization: Bearer $PRUDAI_TOKEN"
CLI (coming soon)
prudai leo financing-records restore
Response 200
{
"title": "string",
"project_id": "00000000-0000-4000-8000-000000000000",
"sector_sbi": "string",
"financials_year": 1,
"revenue": 1,
"ebitda": 1,
"amount": 1,
"financing_type": "term_loan",
"financing_type_detail": "string",
"leverage": 1,
"ltv_pct": 1,
"dscr": 1,
"dscr_forward": 1,
"rate_base": "string",
"rate_margin_pct": 1,
"interest_rate_pct": 1,
"closing_fee_pct": 1,
"closing_fee_amount": 1,
"term_years": 1,
"securities": [
"string"
],
"financier": "string",
"outcome": "open",
"rejection_category": "dscr_too_low",
"rejection_reason": "string",
"lead_time_days": 1,
"decided_on": "2026-11-05",
"notes": "string",
"object": "financing_record",
"id": "string",
"origin": "workflow",
"source_run_id": "string",
"source_workflow_id": "string",
"sector_section": "string",
"provenance": {},
"version": 1,
"created_at": "2026-11-05T09:30:00.000Z",
"updated_at": "2026-11-05T09:30:00.000Z",
"deleted_at": "2026-11-05T09:30:00.000Z"
}

Benchmark comparable financing records (aggregates only)

GET /v1/financing-records/benchmark

Aggregates over the DECIDED records (accepted or rejected) of your own organisation in the segment you describe, for example revenue 2–5 million and leverage 2.5–3.0. Returns counts, acceptance rate, median and quartiles (linear interpolation, Excel QUARTILE.INC) of the accepted terms, and the distribution of financing structures, financiers and rejection reasons. Below 10 decided records the answer is status: insufficient without a single figure; a metric with fewer than 10 values is omitted with its reason; a category with fewer than 3 records merges into overig. Never a single record, never data of another organisation. Computed by the server, not by a language model.

  • State: coming soon, not in production yet.
  • Scope: prudai:financing_records:read
  • Approval: none, no extra step.

Parameters

  • revenue_min query · number
  • revenue_max query · number
  • ebitda_min query · number
  • ebitda_max query · number
  • leverage_min query · number
  • leverage_max query · number
  • amount_min query · number
  • amount_max query · number
  • sector query · string
    SBI code prefix (“25”, “2562”) or SBI section letter (“C”). max length 10
  • financing_type query · string
    One of: term_loan, revolving_credit, mortgage, lease, factoring, subordinated, mezzanine, private_debt, crowdfunding, bridge, other
  • year_from query · integer
  • year_to query · integer

Responses

StatusMeaning
200The benchmark, or status insufficient below 10 decided records.
401Missing, malformed, unknown, expired or revoked key, or a key used against the wrong environment.
403Authenticated, but not allowed (missing scope, product not on the key or organisation, organisation suspended, Developer API switched off for the organisation, IP not on the allowlist, depth not permitted, licence does not permit redistribution).
422Well-formed request with invalid values (for example an unknown reasoning_effort, empty messages, or an Idempotency-Key reused with a different body).
429Rate limit, concurrency limit, Ultra daily quota or fair-use limit of the free sources operations exceeded.
503Temporarily unavailable (maintenance, overload, or the credit check could not be performed). Nothing ran, nothing is charged.
curl
curl -s "https://api.prudai.com/v1/financing-records/benchmark" \
-H "Authorization: Bearer $PRUDAI_TOKEN"
CLI (coming soon)
prudai leo financing-records benchmark