Skip to main content
POST
Create file

Authorizations

Authorization
string
header
required

An API key prefixed with finta_, or the access token from a Finta CLI browser login (finta login), prefixed with finta_oat_. A CLI login's access token lasts one hour and the CLI renews it itself.

Body

multipart/form-data
file
file
required

The PDF. Its file name is kept and shown on the Taxes page; a bank statement is renamed after its account and month.

purpose
enum<string>
default:tax_document

What may attach the file. tax_document is a filed tax return or Delaware franchise tax report, for Create income upload or Create franchise upload; it needs Taxes: Manage. bank_statement is a bank or card statement, for Reconcile reconciliation; it needs Reconciliation: Manage and can be at most 10 MB.

Available options:
tax_document,
bank_statement

Response

The file was stored and can be attached until expires_at.

id
string
required
Pattern: ^file_[A-Za-z0-9]+$
object
enum<string>
required
Available options:
file
purpose
enum<string>
default:tax_document
required

What may attach the file. tax_document is a filed tax return or Delaware franchise tax report, for Create income upload or Create franchise upload; it needs Taxes: Manage. bank_statement is a bank or card statement, for Reconcile reconciliation; it needs Reconciliation: Manage and can be at most 10 MB.

Available options:
tax_document,
bank_statement
filename
string
required

The uploaded file name, kept when the file is attached (a Delaware confirmation is renamed).

size
integer
required

Size in bytes.

created
integer
required

Upload time in Unix seconds.

expires_at
integer
required

Unix seconds after which an unattached file is deleted, 24 hours after upload. An attached file stays with the record it's attached to.