# Upload Trial Balance Data

This API endpoint takes trial balance data and uploads it to a user's FloQast tenant. Use this endpoint to assign or update trial balance values for each account in a given entity and period.


Endpoint: PUT /api/v1/trial-balance/upload
Version: 1.0.0
Security: x-api-key

## Request fields (application/json):

  - `data` (array)

  - `data.entityId` (string, required)
    Id of company
    Example: "5e94d5b63f557b001420bbe2"

  - `data.period` (object, required)

  - `data.period.month` (string, required)
    Month of balance
    Enum: "january", "february", "march", "april", "may", "june", "july", "august", "september", "october", "november", "december"

  - `data.period.year` (string, required)
    Year of balance
    Example: "2019"

  - `data.accounts` (array, required)

  - `data.accounts.name` (string)
    Name of account
    Example: "Software Development Costs"

  - `data.accounts.number` (string, required)
    Number of account
    Example: "2210"

  - `data.accounts.balance` (string, required)
    Balance of account
    Example: "123.45"

## Response 200 fields (application/json):

  - `data` (array)

  - `data.entityId` (string)
    Example: "5e94d5b63f557b001420bbe2"

  - `data.period` (object)

  - `data.period.month` (string)
    Example: "january"

  - `data.period.year` (string)
    Example: "2019"

  - `data.success` (boolean)
    Example: true

## Response 303 fields (application/json):

  - `data` (object)

  - `data.url` (string)
    The URL to the new location of the resource.

## Response 400 fields (application/json):

  - `message` (string)
    Reason for the errors related to incorrect query keys or values that are out of bound
    Example: "period is required"

  - `name` (string)
    BadRequest
    Example: "BadRequest"

  - `status` (integer)
    The HTTP status code.
    Example: 400

## Response 401 fields (application/json):

  - `message` (string)
    Reason for the error such as incorrect service access, malformed, expired or deactivated token.
    Example: "Invalid token"

  - `name` (string)
    Unauthorized
    Example: "Unauthorized"

  - `status` (integer)
    The HTTP status code.
    Example: 401

## Response 413 fields (application/json):

  - `message` (string)
    Reason for the error related to the payload size
    Example: "Response size is greater than 1MB"

  - `name` (string)
    PayloadTooLarge
    Example: "PayloadTooLarge"

  - `status` (integer)
    The HTTP status code.
    Example: 413