> ## Documentation Index > Fetch the complete documentation index at: https://docs.lendflow.com/llms.txt > Use this file to discover all available pages before exploring further. # Update Lender Placement Status > Moves a placement to a new status. Declining a placement records the decline reason and retracts any offers the funder extended. ## OpenAPI ````yaml /openapi.yaml put /api/applications/{application_id}/placements/status openapi: 3.0.3 info: title: Lendflow API docs description: '' version: 1.0.0 servers: - url: https://api.lendflow.com security: - default: [] tags: - name: Authentication description: >- Lendflow uses API Bearer Tokens to permit access to our API. You can register for a new Lendflow API key on our client portal in less than 60 seconds. The Bearer Token needs to be included in all API requests made to the API Service in the following form:
Authorization: Bearer [YOUR_TOKEN]
You must replace [YOUR_TOKEN] with your personal API key.
- name: Access Tokens description: |- Create and manage the personal access tokens used to authenticate API requests. - name: Workflow Management description: |- Create applications and manage them through every stage of their workflow, from intake through decision. - name: Documents description: |- Upload, retrieve, and manage the files attached to an application. - name: Placements description: |- Submit applications to lenders and manage each placement through its lifecycle. - name: Offers description: |- Create and manage offers on an application, from initial terms through funding. - name: Smartviews description: |- Save and manage reusable application filters that organize your pipeline. - name: Workflow Templates description: |- Browse the workflow templates available for creating applications. - name: Consent Templates description: |- Manage the consent documents presented to applicants for signature. - name: Offer Templates description: |- Manage the templates that define the structure and fields of your offers. - name: Data Orchestration description: |- Run data orchestration templates against applications and review their execution logs. - name: Attributes description: |- Define computed attributes and evaluate them against your applications. - name: Scorecards description: |- Run scorecards and scorecard groups against applications and retrieve their results. - name: Entity Profiles description: |- Manage the reusable business and individual profiles shared across applications. - name: Organization description: |- Manage the users in your organization. - name: Metadata description: |- Attach custom key-value data to your applications and files. paths: /api/applications/{application_id}/placements/status: parameters: - in: path name: application_id description: The ID of the application. example: architecto required: true schema: type: string put: tags: - Placements summary: Update Lender Placement Status description: |- Moves a placement to a new status. Declining a placement records the decline reason and retracts any offers the funder extended. parameters: [] requestBody: required: true content: application/json: schema: type: object properties: placement_id: type: string description: Placement ID. Must match an existing stored value. example: architecto status: type: integer description: >- Status numeric value: 1 (Pending), 2 (Declined), 3 (Approved), 4 (Error), 5 (Queued), 6 (Duplicate), 7 (Pending - Review), 8 (Pending - Missing Info or Docs). example: 1 enum: - 1 - 2 - 3 - 4 - 5 - 6 - 7 - 8 decline_reason_id: type: integer description: >- Decline reason ID. Required when the status is Declined. This field is required when status is 2. Must match an existing stored value. example: 16 decline_subreason_id: type: integer description: >- Optional decline subreason ID. Must match an existing stored value. example: 16 nullable: true decline_reason: type: string description: Optional decline reason. example: architecto nullable: true stage_id: type: string description: >- Workflow placement stage ID. list_application_workflow_stages returns the application's stages with their types, and this is the id of the one whose type is "placement". The placement must belong to an application whose workflow has a placement stage. Must be a valid UUID. example: a4855dc5-0acb-33c3-b921-f4291f719ca0 required: - placement_id - status - stage_id responses: '200': description: '' content: application/json: schema: type: object example: data: placement_id: null application_id: c3046b91-3ed2-4766-923a-89b9bf613380 tracking: '' status: null decline_reason: null decline_reason_id: null decline_subreason_id: null method: 1 product_id: 1 created_at: null updated_at: null resubmitted_at: null is_client_funded: null can_send_files: false can_resubmit: false via_automation: false submission_path: null reference_workflow_status: null reference_workflow_sub_status: null reference_workflow_status_color: null origin_offer_template_id: 01958b10-0d3c-73d4-99a1-148aece7409d origin_offer_template: id: 01958b10-0d3c-73d4-99a1-148aece7409d name: ARLOC description: null product: arloc is_enabled: true is_default: true is_fallback: true funder_id: null client_id: null created_at: '2025-03-12T15:53:59.000000Z' updated_at: '2026-10-08T15:42:24.000000Z' destinations: - workflow_template_id: null offer_template_id: 01958b10-0d3c-73d4-99a1-148aece7409d offer_template: id: 01958b10-0d3c-73d4-99a1-148aece7409d name: ARLOC description: null product: arloc is_enabled: true is_default: true is_fallback: true funder_id: null client_id: null created_at: '2025-03-12T15:53:59.000000Z' updated_at: '2026-10-08T15:42:24.000000Z' url: null properties: data: type: object properties: placement_id: type: string example: null nullable: true application_id: type: string example: c3046b91-3ed2-4766-923a-89b9bf613380 tracking: type: string example: '' status: type: string example: null nullable: true decline_reason: type: string example: null nullable: true decline_reason_id: type: string example: null nullable: true decline_subreason_id: type: string example: null nullable: true method: type: integer example: 1 product_id: type: integer example: 1 created_at: type: string example: null nullable: true updated_at: type: string example: null nullable: true resubmitted_at: type: string example: null nullable: true is_client_funded: type: string example: null nullable: true can_send_files: type: boolean example: false can_resubmit: type: boolean example: false via_automation: type: boolean example: false submission_path: type: string example: null nullable: true reference_workflow_status: type: string example: null nullable: true reference_workflow_sub_status: type: string example: null nullable: true reference_workflow_status_color: type: string example: null nullable: true origin_offer_template_id: type: string example: 01958b10-0d3c-73d4-99a1-148aece7409d origin_offer_template: type: object properties: id: type: string example: 01958b10-0d3c-73d4-99a1-148aece7409d name: type: string example: ARLOC description: type: string example: null nullable: true product: type: string example: arloc is_enabled: type: boolean example: true is_default: type: boolean example: true is_fallback: type: boolean example: true funder_id: type: string example: null nullable: true client_id: type: string example: null nullable: true created_at: type: string example: '2025-03-12T15:53:59.000000Z' updated_at: type: string example: '2026-10-08T15:42:24.000000Z' destinations: type: array example: - workflow_template_id: null offer_template_id: 01958b10-0d3c-73d4-99a1-148aece7409d offer_template: id: 01958b10-0d3c-73d4-99a1-148aece7409d name: ARLOC description: null product: arloc is_enabled: true is_default: true is_fallback: true funder_id: null client_id: null created_at: '2025-03-12T15:53:59.000000Z' updated_at: '2026-10-08T15:42:24.000000Z' items: type: object properties: workflow_template_id: type: string example: null nullable: true offer_template_id: type: string example: 01958b10-0d3c-73d4-99a1-148aece7409d offer_template: type: object properties: id: type: string example: 01958b10-0d3c-73d4-99a1-148aece7409d name: type: string example: ARLOC description: type: string example: null nullable: true product: type: string example: arloc is_enabled: type: boolean example: true is_default: type: boolean example: true is_fallback: type: boolean example: true funder_id: type: string example: null nullable: true client_id: type: string example: null nullable: true created_at: type: string example: '2025-03-12T15:53:59.000000Z' updated_at: type: string example: '2026-10-08T15:42:24.000000Z' url: type: string example: null nullable: true components: securitySchemes: default: type: http scheme: bearer description: >-
You can register for a new Lendflow API key on our client portal in less than 60 seconds. The Bearer Token needs to be included in all API requests made to the API Service in the following form:
Authorization: Bearer [YOUR_TOKEN]
You must replace [YOUR_TOKEN] with your personal API key.
````