---
title: Application
slug: apis/lending/application-decisioning/application
description: Create or update loan applications via partner-specific schemas using the POST /api/v2/applications endpoint with support for validation and updates.
icon: {"apiMethod":"POST"}
docTags: 
createdAt: 2025-07-21T09:45:55.285Z
---

## Submit application 

Submit a new or update an Application (Upsert),  based on the partner-specific data schema. This API was created to model your company's business model. 

For more info, visit the [Pav2 Schema UI](docId\:VwjhFeFwgjKJ9lggqLVW9) 

:::hint{type="warning"}
This API can only be used on a schema that has been approved and is LIVE. If you would like to test a schema that is still in DRAFT, or just test validation on a LIVE schema, then call the DRY-RUN API. It's the same API setup; simply append "/dryrun" to the above URL path.
:::



:::ApiMethodV2
```json
{
  "name": "Endpoint: /api/v2/applications/{partner_schema_id}",
  "method": "POST",
  "url": "https://lendingsandbox.crbcos.com/preapproval/api/v2/applications/{partner_schema_id}",
  "description": "Create or update an Application. The application_id is the identifier for this application.",
  "tab": "examples",
  "examples": {
    "languages": [
      {
        "id": "L44lyBpEkPvvxd2s4ITGR",
        "language": "curl",
        "code": "",
        "customLabel": ""
      },
      {
        "id": "2zw9pMCFKGqgVkmpC-ZZ1",
        "language": "nodejs",
        "code": "",
        "customLabel": ""
      },
      {
        "id": "YTvnprg_S9ZNG3Kp9WT4k",
        "language": "python",
        "code": "",
        "customLabel": ""
      },
      {
        "id": "q9wGW9osNCsqCp68UDZ0n",
        "language": "ruby",
        "code": "",
        "customLabel": ""
      },
      {
        "id": "UAmstoP2fDbrAiUdxN9ci",
        "language": "go",
        "code": "",
        "customLabel": ""
      }
    ],
    "selectedLanguageId": "2zw9pMCFKGqgVkmpC-ZZ1"
  },
  "results": {
    "languages": [
      {
        "id": "_qq8_titI2NzDm7PhXHyr",
        "language": "200",
        "customLabel": "",
        "code": "OK"
      },
      {
        "id": "qjrEFaPuKavXc3UC1LWA5",
        "language": "400",
        "code": "Bad Request",
        "customLabel": ""
      },
      {
        "id": "mNKWoSGW_1na1Xf4LHQmw",
        "language": "401",
        "code": "Unauthorized",
        "customLabel": ""
      }
    ],
    "selectedLanguageId": "_qq8_titI2NzDm7PhXHyr"
  },
  "request": {
    "pathParameters": [
      {
        "name": "partner_schema_id",
        "kind": "required",
        "type": "string",
        "description": "The schema id of the schema that was built specifically for the partner. All applications for this version, will use this schema id.",
        "": "The schema id of the schema that was built specifically for the partner. All applications for this version, will use this schema id."
      }
    ],
    "queryParameters": [],
    "headerParameters": [],
    "bodyDataParameters": [
      {
        "name": "application_id",
        "kind": "required",
        "type": "string",
        "description": "The identifier of the application that is created for each application in the partner's system. It should be unique for each application. If the system receives another application with this ID, then the system will consider it an update",
        "": "The identifier of the application that is created for each application in the partner's system. It should be unique for each application. If the system receives another application with this ID, then the system will consider it an update"
      },
      {
        "name": "application",
        "kind": "required",
        "type": "object",
        "description": "All of the application details, submitted in the partner schema format",
        "": "All of the application details, submitted in the partner schema format"
      }
    ],
    "formDataParameters": []
  },
  "currentNewParameter": {
    "label": "Path Parameter",
    "value": "pathParameters"
  },
  "response": [
    {
      "name": "entity_id",
      "kind": "optional",
      "type": "string",
      "description": ""
    },
    {
      "name": "created_at",
      "kind": "optional",
      "type": "string",
      "description": "",
      "children": []
    },
    {
      "name": "application",
      "kind": "optional",
      "type": "object",
      "description": "",
      "children": []
    },
    {
      "name": "application_id",
      "kind": "optional",
      "type": "string",
      "description": "",
      "children": []
    },
    {
      "name": "partner_schema_id",
      "kind": "optional",
      "type": "string",
      "description": "",
      "children": []
    },
    {
      "name": "rule_results",
      "kind": "optional",
      "type": "object",
      "description": "",
      "children": [
        {
          "name": "items",
          "kind": "optional",
          "type": "object",
          "description": "",
          "children": [
            {
              "name": "rule_id",
              "kind": "optional",
              "type": "string",
              "description": ""
            },
            {
              "name": "version",
              "kind": "optional",
              "type": "string",
              "description": ""
            },
            {
              "name": "rule_name",
              "kind": "optional",
              "type": "string",
              "description": ""
            },
            {
              "name": "rule_description",
              "kind": "optional",
              "type": "string",
              "description": ""
            },
            {
              "name": "status",
              "kind": "optional",
              "type": "string",
              "description": ""
            },
            {
              "name": "data",
              "kind": "optional",
              "type": "string",
              "description": ""
            },
            {
              "name": "result_info",
              "kind": "optional",
              "type": "string",
              "description": ""
            }
          ]
        },
        {
          "name": "status",
          "kind": "optional",
          "type": "string",
          "description": ""
        },
        {
          "name": "rules_process_date",
          "kind": "optional",
          "type": "string",
          "description": " Default\"2025-10-26T10:53:46.520543Z\""
        }
      ]
    },
    {
      "name": "is_valid",
      "kind": "optional",
      "type": "boolean",
      "description": "",
      "children": []
    }
  ],
  "autoGeneratedAnchorSlug": "endpoint-apiv2applicationspartnerschemaid",
  "legacyHash": "tgQRBebkaP-DPVVBWYCxR"
}
```
:::