---
agentTools:
  projectIndex: https://liberis.readme.io/llms.txt
---

# Updates an application with additional fields

[block:callout]
{
  "type": "info",
  "title": "Update application",
  "body": "Once the application has been created using the POST endpoint, use the PATCH endpoint as you collect more data from the customer to enrich the application"
}
[/block]

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Liberis API",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://api.liberis.com"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "oauth2",
        "flows": {
          "clientCredentials": {
            "tokenUrl": "https://example.com/oauth2/token",
            "scopes": {}
          }
        }
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/api/Application/{applicationId}": {
      "patch": {
        "summary": "Updates an application with additional fields",
        "description": "",
        "operationId": "update-application",
        "parameters": [
          {
            "name": "applicationId",
            "in": "path",
            "schema": {
              "type": "string"
            },
            "required": true
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "intendedUseOfFunds": {
                    "type": "string",
                    "description": "Possible values: \"Purchase Stock\", \"Purchase New Equipment\", \"Expand Business\", \"Cash Flow\", \"Payroll\", \"Taxes Due\", \"Other\", \"Refurbishment\""
                  },
                  "bankAccountNumber": {
                    "type": "string",
                    "description": "The account number of the merchant's bank account."
                  },
                  "bankName": {
                    "type": "string"
                  },
                  "bankAccountType": {
                    "type": "string",
                    "description": "Possible values: \"BANKGIRO\", \"PLUSGIRO\", \"IBAN\", \"LOCAL_SE\""
                  },
                  "bankRoutingNumber": {
                    "type": "string",
                    "description": "Bank routing number (US partners)"
                  },
                  "sortCode": {
                    "type": "string",
                    "description": "Bank sort code (UK partners)"
                  },
                  "tradingName": {
                    "type": "string"
                  },
                  "legalConstitution": {
                    "type": "string",
                    "description": "Possible values: \"Limited company\", \"Partnership\", \"Sole trader\", \"LLP\", \"Propietorship\", \"Trading Partnership\", \"Sole Proprietor\", \"Economic Association\", \"Limited Partnership\", \"LLC\", \"Other Corporation\""
                  },
                  "registrationNumber": {
                    "type": "string",
                    "description": "Registered business number (EIN / Company Number)."
                  },
                  "registeredStreet": {
                    "type": "string"
                  },
                  "registeredCity": {
                    "type": "string"
                  },
                  "registeredState": {
                    "type": "string"
                  },
                  "registeredCountry": {
                    "type": "string"
                  },
                  "expectedProvider": {
                    "type": "string",
                    "description": "Where a partner uses multiple external payment providers, provide the appropriate payment provider, e.g. \"Stripe\"."
                  },
                  "consentBureauSearch": {
                    "type": "boolean",
                    "description": "Whether or not the merchant consents to a bureau credit search. This may impact their credit rating."
                  },
                  "consentBureauSearchDate": {
                    "type": "string",
                    "description": "The date/time the merchant consented to a bureau search. If not provided, defaults to the point that the API receives the request.",
                    "format": "date"
                  },
                  "consentPartnerDataSharing": {
                    "type": "boolean",
                    "description": "Whether the merchant consents to sharing data with 3rd parties of Liberis."
                  },
                  "consentSameProductComms": {
                    "type": "boolean",
                    "description": "Whether the merchant consents to being contacted in future about the same product."
                  },
                  "consentSimilarProductComms": {
                    "type": "boolean",
                    "description": "Whether the merchant consents to being contacted in future about a similar product."
                  },
                  "consentOtherProductComms": {
                    "type": "boolean",
                    "description": "Whether the merchant consents to being contacted in future about other products."
                  },
                  "sic": {
                    "type": "string",
                    "description": "Standard industrial classification code"
                  },
                  "industry": {
                    "type": "string",
                    "description": "Possible values: \"General Store\", \"Trade Contractor\", \"Car Sales / Garage Services\", \"Food / Drink Shop\", \"Fashion Retail\", \"Other Retailer\", \"Hotel / B&B\", \"Restaurant\", \"Bar / Pub\", \"Healthcare\", \"Hair & Beauty\", \"Other Services\""
                  },
                  "selectedPrice": {
                    "type": "object",
                    "properties": {
                      "split": {
                        "type": "integer",
                        "format": "int32"
                      },
                      "term": {
                        "type": "number",
                        "format": "double"
                      },
                      "purchaseAmount": {
                        "type": "number",
                        "format": "double"
                      },
                      "purchasePrice": {
                        "type": "number",
                        "format": "double"
                      },
                      "contractPurchasePrice": {
                        "type": "number",
                        "format": "double"
                      },
                      "contractPurchaseAmount": {
                        "type": "number",
                        "format": "double"
                      },
                      "factorRate": {
                        "type": "number",
                        "format": "double"
                      }
                    }
                  },
                  "paymentChannels": {
                    "type": "array",
                    "description": "A payment channel should be created for each merchant identifier. There needs to be at least one payment channel.",
                    "items": {
                      "properties": {
                        "name": {
                          "type": "string",
                          "description": "Partner name - Liberis will provide this"
                        },
                        "reference": {
                          "type": "string",
                          "description": "The merchant's identifier"
                        },
                        "type": {
                          "type": "string",
                          "default": "Card Terminal"
                        },
                        "primary": {
                          "type": "boolean",
                          "description": "There should be exactly one primary payment channel.",
                          "default": true
                        }
                      },
                      "type": "object"
                    }
                  },
                  "applicants": {
                    "type": "array",
                    "description": "An applicant needs to be created for each shareholder of the company. There needs to be at least one applicant.",
                    "items": {
                      "properties": {
                        "id": {
                          "type": "string"
                        },
                        "email": {
                          "type": "string"
                        },
                        "firstName": {
                          "type": "string"
                        },
                        "lastName": {
                          "type": "string"
                        },
                        "dateOfBirth": {
                          "type": "string",
                          "format": "date"
                        },
                        "primary": {
                          "type": "boolean"
                        },
                        "ownershipPercentage": {
                          "type": "number",
                          "format": "double"
                        },
                        "mailingCity": {
                          "type": "string"
                        },
                        "mailingPostcode": {
                          "type": "string"
                        },
                        "mailingState": {
                          "type": "string"
                        },
                        "mailingStreet": {
                          "type": "string"
                        },
                        "mailingCountry": {
                          "type": "string"
                        },
                        "movedInDate": {
                          "type": "string"
                        },
                        "homeOwnership": {
                          "type": "string",
                          "enum": [
                            "1",
                            "2",
                            "3"
                          ]
                        },
                        "mobile": {
                          "type": "string"
                        },
                        "telephone": {
                          "type": "string"
                        },
                        "type": {
                          "type": "string",
                          "enum": [
                            "0",
                            "1",
                            "2"
                          ]
                        },
                        "removeApplicant": {
                          "type": "boolean"
                        },
                        "socialSecurityNumber": {
                          "type": "string"
                        }
                      },
                      "type": "object"
                    }
                  },
                  "monthlyVolumes": {
                    "type": "array",
                    "description": "The monthly transactions volumes for the merchant. An object should be created for each month.",
                    "items": {
                      "properties": {
                        "date": {
                          "type": "string",
                          "description": "e.g. \"2022-11\"",
                          "format": "date"
                        },
                        "amount": {
                          "type": "number",
                          "description": "e.g. \"2850.54\"",
                          "format": "double"
                        }
                      },
                      "type": "object"
                    }
                  },
                  "tradingAddresses": {
                    "type": "array",
                    "items": {
                      "properties": {
                        "tradingName": {
                          "type": "string"
                        },
                        "street": {
                          "type": "string"
                        },
                        "state": {
                          "type": "string"
                        },
                        "city": {
                          "type": "string"
                        },
                        "country": {
                          "type": "string"
                        },
                        "postcode": {
                          "type": "string"
                        },
                        "currency": {
                          "type": "string"
                        }
                      },
                      "type": "object"
                    }
                  },
                  "ownershipPercentage": {
                    "type": "number",
                    "format": "double"
                  },
                  "businessStartDate": {
                    "type": "string",
                    "description": "The date the merchant signed up with the partner.",
                    "format": "date"
                  },
                  "averageMonthlyVolumes": {
                    "type": "number",
                    "format": "double"
                  },
                  "paymentProcessorEmail": {
                    "type": "string"
                  },
                  "legalName": {
                    "type": "string"
                  },
                  "kycDate": {
                    "type": "string",
                    "description": "Where KYC is performed outside of Liberis (specific markets and partners only) provide the date of the check.",
                    "format": "date"
                  },
                  "kycOutcome": {
                    "type": "string",
                    "description": "Where KYC is performed outside of Liberis (specific markets and partners only), provide the outcome of the check."
                  },
                  "kycCustomerRiskCategory": {
                    "type": "string",
                    "description": "Where KYC is performed outside of Liberis (specific markets and partners only) provide the risk category."
                  },
                  "preapprovalStatus": {
                    "type": "string",
                    "description": "Where funding pre-approval occurs outside of Liberis (specific markets and partners only) provide the status."
                  },
                  "referralAgentName": {
                    "type": "string",
                    "description": "Where the merchant was referred by a third party, provide that party's name"
                  },
                  "referralAgentEmail": {
                    "type": "string",
                    "description": "Where the merchant was referred by a third party, provide the contact email address for that party"
                  },
                  "partnerExternalId": {
                    "type": "string"
                  },
                  "taxId": {
                    "type": "string"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"customerId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n  \"applicationId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "customerId": {
                      "type": "string",
                      "example": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
                    },
                    "applicationId": {
                      "type": "string",
                      "example": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"errors\": {\n    \"additionalProp1\": [\n      \"string\"\n    ],\n    \"additionalProp2\": [\n      \"string\"\n    ],\n    \"additionalProp3\": [\n      \"string\"\n    ]\n  },\n  \"type\": \"string\",\n  \"title\": \"string\",\n  \"status\": 0,\n  \"detail\": \"string\",\n  \"instance\": \"string\",\n  \"extensions\": {\n    \"additionalProp1\": {},\n    \"additionalProp2\": {},\n    \"additionalProp3\": {}\n  }\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "errors": {
                      "type": "object",
                      "properties": {
                        "additionalProp1": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "example": "string"
                          }
                        },
                        "additionalProp2": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "example": "string"
                          }
                        },
                        "additionalProp3": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "example": "string"
                          }
                        }
                      }
                    },
                    "type": {
                      "type": "string",
                      "example": "string"
                    },
                    "title": {
                      "type": "string",
                      "example": "string"
                    },
                    "status": {
                      "type": "integer",
                      "example": 0,
                      "default": 0
                    },
                    "detail": {
                      "type": "string",
                      "example": "string"
                    },
                    "instance": {
                      "type": "string",
                      "example": "string"
                    },
                    "extensions": {
                      "type": "object",
                      "properties": {
                        "additionalProp1": {
                          "type": "object",
                          "properties": {}
                        },
                        "additionalProp2": {
                          "type": "object",
                          "properties": {}
                        },
                        "additionalProp3": {
                          "type": "object",
                          "properties": {}
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "401",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"type\": \"string\",\n  \"title\": \"string\",\n  \"status\": 0,\n  \"detail\": \"string\",\n  \"instance\": \"string\",\n  \"extensions\": {\n    \"additionalProp1\": {},\n    \"additionalProp2\": {},\n    \"additionalProp3\": {}\n  }"
                  }
                }
              }
            }
          },
          "403": {
            "description": "403",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"type\": \"string\",\n  \"title\": \"string\",\n  \"status\": 0,\n  \"detail\": \"string\",\n  \"instance\": \"string\",\n  \"extensions\": {\n    \"additionalProp1\": {},\n    \"additionalProp2\": {},\n    \"additionalProp3\": {}\n  }\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "type": {
                      "type": "string",
                      "example": "string"
                    },
                    "title": {
                      "type": "string",
                      "example": "string"
                    },
                    "status": {
                      "type": "integer",
                      "example": 0,
                      "default": 0
                    },
                    "detail": {
                      "type": "string",
                      "example": "string"
                    },
                    "instance": {
                      "type": "string",
                      "example": "string"
                    },
                    "extensions": {
                      "type": "object",
                      "properties": {
                        "additionalProp1": {
                          "type": "object",
                          "properties": {}
                        },
                        "additionalProp2": {
                          "type": "object",
                          "properties": {}
                        },
                        "additionalProp3": {
                          "type": "object",
                          "properties": {}
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true,
  "_id": "6324a30b9e9fb507b75fcd06:633c2ad639718b0d56178fc0"
}
```