---
title: "CreateLineItemRequest"
url: "https://developer.pexa.co.uk/apis/financials-v1-v1/versions/d3f169b2-8b77-47f6-8696-d6efa1bd09f2/schemas/CreateLineItemRequest"
---

> Full API specification: https://developer.pexa.co.uk/apis/financials-v1-v1/versions/d3f169b2-8b77-47f6-8696-d6efa1bd09f2.md

# CreateLineItemRequest

## OpenAPI definition

```yaml
openapi: 3.0.1
info:
  title: Financial
  version: v1
servers:
  - url: https://api.pexa.co.uk
    description: API Gateway URL
components:
  schemas:
    CreateLineItemRequest:
      type: object
      properties:
        type:
          type: string
          pattern: ^(SOURCE|DESTINATION)$
          example: SOURCE
          description: |
            Allowed values:
             [`SOURCE`, `DESTINATION`]
        category:
          type: string
          description: |
            Allowed values for source line item:
             [`Mortgage Advance`]
            <br> Allowed values for destination line item:
             [`Redemption`, `Conveyancing Fees`, `Surplus`, `Onward Funds`]
        amount:
          type: number
          minimum: 1
          maximum: 999999999999.99
          description: Amount to be credited / debited
          example: 10
        reference:
          type: string
          minLength: 1
          maxLength: 18
          pattern: ^[a-zA-Z0-9\/\-\\?:().,'#=!"%&*<>;@{+\s]*$
          example: Nation wide
        bankAccount:
          type: object
          nullable: true
          description: This field is required and can be updated only for type DESTINATION.
          properties:
            accountName:
              type: string
              maxLength: 35
              minLength: 1
              pattern: ^[a-zA-Z0-9\/\-\\?:().,'#=!"%&*<>;@{+\s]*$
              example: Bob Smith
            accountNumber:
              type: string
              pattern: ^\d{8}$
              example: "12345678"
            bankCode:
              type: string
              pattern: ^\d{6}$
              example: "123456"
            accountType:
              type: string
              pattern: ^(BUSINESS|PERSONAL)$
              example: BUSINESS
              description: |
                Allowed Values: [`BUSINESS`, `PERSONAL`]
            displayName:
              type: string
              nullable: true
              maxLength: 35
              pattern: ^[0-9a-zA-Z/\-\?:\(\)\.,'\+ !#$%&\*=^_`\{\|\}~";<>@\[\\\]]+$
              example: Mortgage account
          required:
            - accountName
            - accountNumber
            - bankCode
        hasLinkedAccount:
          type: boolean
          description: Flag to indicate whether account is linked to a financial account
      required:
        - type
        - amount
        - reference
        - category
```