/underwriting/applications/{id}

GET /underwriting/applications/{id}

Get application details for underwriting

Retrieve detailed application information including risk assessment and underwriting history

Required Parameters

id path string

Application ID

Try it out

Output:

Responses

Description

Application details retrieved successfully

{
  "id": "string",
  "businessName": "string",
  "businessType": "string",
  "mcc": "string",
  "status": "string",
  "priority": "string",
  "assignedTo": "string",
  "riskScore": 0,
  "riskLevel": "string",
  "requestedAmount": "string",
  "annualRevenue": "string",
  "timeInBusiness": 0,
  "creditScore": 0,
  "submittedAt": "string",
  "lastActivity": "string",
  "decisions": [
    {
      "id": "string",
      "applicationId": "string",
      "decision": "string",
      "reasoning": "string",
      "approvedAmount": "string",
      "conditions": [
        "string"
      ],
      "requestedInfo": [
        "string"
      ],
      "reviewerNotes": "string",
      "decidedBy": "string",
      "decidedAt": "string",
      "isAutomatic": false
    }
  ],
  "riskAssessments": [
    {
      "id": "string",
      "applicationId": "string",
      "overallScore": 0,
      "riskLevel": "string",
      "factors": {},
      "recommendation": "string",
      "assessedBy": "string",
      "assessedAt": "string"
    }
  ],
  "notes": [
    {
      "id": "string",
      "applicationId": "string",
      "note": "string",
      "noteType": "string",
      "isInternal": false,
      "authorId": "string",
      "createdAt": "string"
    }
  ]
}

References

#/components/schemas/UnderwritingDecision #/components/schemas/RiskAssessment #/components/schemas/UnderwritingNote

#/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;
}

type: object
properties:
  id:
    type: string
    description: Assessment ID
  applicationId:
    type: string
    description: Application ID
  overallScore:
    type: number
    description: Overall risk score (0-100)
  riskLevel:
    type: string
    enum:
      - low
      - medium
      - high
    description: Risk level
  factors:
    type: object
    description: Individual risk factor scores
  recommendation:
    type: string
    enum:
      - approve
      - decline
      - manual_review
    description: System recommendation
  assessedBy:
    type: string
    nullable: true
    description: ID of assessor (null for automatic)
  assessedAt:
    type: string
    format: date-time
    description: Assessment timestamp

|
export interface RiskAssessment {
  /** Assessment ID */
  id?: string;
  /** Application ID */
  applicationId?: string;
  /** Overall risk score (0-100) */
  overallScore?: number;
  /** Risk level */
  riskLevel?: "low" | "medium" | "high";
  /** Individual risk factor scores */
  factors?: {};
  /** System recommendation */
  recommendation?: "approve" | "decline" | "manual_review";
  /** ID of assessor (null for automatic) */
  assessedBy?: string;
  /** Assessment timestamp */
  assessedAt?: Date;
}

#/components/schemas/UnderwritingNote

OpenAPI
TypeScript

type: object
properties:
  id:
    type: string
    description: Note ID
  applicationId:
    type: string
    description: Application ID
  note:
    type: string
    description: Note content
  noteType:
    type: string
    enum:
      - general
      - risk_assessment
      - decision_rationale
      - follow_up
      - compliance
    description: Note type
  isInternal:
    type: boolean
    description: Whether note is internal
  authorId:
    type: string
    description: ID of note author
  createdAt:
    type: string
    format: date-time
    description: Note creation timestamp

|
export interface UnderwritingNote {
  /** Note ID */
  id?: string;
  /** Application ID */
  applicationId?: string;
  /** Note content */
  note?: string;
  /** Note type */
  noteType?:
    | "general"
    | "risk_assessment"
    | "decision_rationale"
    | "follow_up"
    | "compliance";
  /** Whether note is internal */
  isInternal?: boolean;
  /** ID of note author */
  authorId?: string;
  /** Note creation timestamp */
  createdAt?: Date;
}

Route Source Code

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

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