/underwriting/applications/{id}/decisions

POST /underwriting/applications/{id}/decisions

Make underwriting decision

Record an underwriting decision for an application

Required Parameters

id path string

Application ID

Request Body

Minimum Required
All Properties

{
  "decision": "string",
  "reasoning": "string"
}

{
  "decision": "string",
  "reasoning": "string",
  "approvedAmount": "string",
  "conditions": [
    "string"
  ],
  "requestedInfo": [
    "string"
  ],
  "reviewerNotes": "string"
}

Try it out

Output:

Responses

Description

Decision recorded successfully

{
  "id": "string",
  "applicationId": "string",
  "decision": "string",
  "reasoning": "string",
  "approvedAmount": "string",
  "conditions": [
    "string"
  ],
  "requestedInfo": [
    "string"
  ],
  "reviewerNotes": "string",
  "decidedBy": "string",
  "decidedAt": "string",
  "isAutomatic": false
}

References

#/components/schemas/UnderwritingDecision

OpenAPI
TypeScript

type: object
properties:
  id:
    type: string
    description: Decision ID
  applicationId:
    type: string
    description: Application ID
  decision:
    type: string
    enum:
      - approved
      - declined
      - requires_info
    description: Decision type
  reasoning:
    type: string
    description: Decision reasoning
  approvedAmount:
    type: string
    nullable: true
    description: Approved amount
  conditions:
    type: array
    items:
      type: string
    description: Approval conditions
  requestedInfo:
    type: array
    items:
      type: string
    description: Requested additional information
  reviewerNotes:
    type: string
    nullable: true
    description: Internal reviewer notes
  decidedBy:
    type: string
    description: ID of decision maker
  decidedAt:
    type: string
    format: date-time
    description: Decision timestamp
  isAutomatic:
    type: boolean
    description: Whether decision was automatic

|
export interface UnderwritingDecision {
  /** Decision ID */
  id?: string;
  /** Application ID */
  applicationId?: string;
  /** Decision type */
  decision?: "approved" | "declined" | "requires_info";
  /** Decision reasoning */
  reasoning?: string;
  /** Approved amount */
  approvedAmount?: string;
  /** Approval conditions */
  conditions?: string[];
  /** Requested additional information */
  requestedInfo?: string[];
  /** Internal reviewer notes */
  reviewerNotes?: string;
  /** ID of decision maker */
  decidedBy?: string;
  /** Decision timestamp */
  decidedAt?: Date;
  /** Whether decision was automatic */
  isAutomatic?: boolean;
}

Route Source Code

Check out the source code for this route entrypoint here: /underwriting/applications/[id]/decisions/route.ts

Or the swagger.yaml spec this documentation was generated from: /underwriting/applications/swagger.yaml