Transactions

List transaction uploads

Lists the uploads on the Uploads page, newest first: files uploaded in the Finta app and uploads made with POST /transaction_uploads, with how many transactions each holds. Drafts that were never committed and uploads with no transactions are left out. Synced bank and card transactions never belong to an upload. Requires API access and Transactions: View.

Pass transaction_id to find the upload a transaction came from; a split part returns the upload of the transaction it was split from. A transaction that wasn’t uploaded returns an empty list.

GET

transaction_uploads

curl --request GET \
  --url https://app.finta.com/api/v1/transaction_uploads \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://app.finta.com/api/v1/transaction_uploads', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.finta.com/api/v1/transaction_uploads",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.finta.com/api/v1/transaction_uploads"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.finta.com/api/v1/transaction_uploads")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "object": "list",
  "url": "<string>",
  "has_more": true,
  "next_cursor": "<string>",
  "data": [
    {
      "id": "upl_8Hq2Lm4Np6Rs0T",
      "object": "transaction_upload",
      "account_id": "<string>",
      "account_name": "<string>",
      "file_name": "<string>",
      "origin": "csv",
      "uploaded_by": "<string>",
      "transaction_count": 123,
      "status": "importing",
      "created": 123
    }
  ]
}

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.

Query Parameters

transaction_id

string

A txn_ ID. Returns only the upload that holds it.

account_id

string

An acct_ ID. Returns only uploads to that account.

limit

integer

default:25

Required range: 1 <= x <= 100

starting_after

string

The previous page's next_cursor, unchanged.

Response

One page of uploads.

object

enum<string>

required

Available options:

list

url

string

required

has_more

boolean

required

next_cursor

string | null

required

Pass as starting_after for the next page; null on the last page.

data

object[]

required

Show child attributes

List transaction uploads

curl --request GET \
  --url https://app.finta.com/api/v1/transaction_uploads \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://app.finta.com/api/v1/transaction_uploads', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.finta.com/api/v1/transaction_uploads",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.finta.com/api/v1/transaction_uploads"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.finta.com/api/v1/transaction_uploads")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "object": "list",
  "url": "<string>",
  "has_more": true,
  "next_cursor": "<string>",
  "data": [
    {
      "id": "upl_8Hq2Lm4Np6Rs0T",
      "object": "transaction_upload",
      "account_id": "<string>",
      "account_name": "<string>",
      "file_name": "<string>",
      "origin": "csv",
      "uploaded_by": "<string>",
      "transaction_count": 123,
      "status": "importing",
      "created": 123
    }
  ]
}

API Reference

Onboarding

Sheets

Taxes

Files

Company

Plans & billing

Team

Categories

Rules

Tags

Departments

Integrations

Inbox

Aggregations

Transactions

Forms

Reconciliation

Journal Entries

Invoices

Parties

Metrics

Reports

Feedback

Tax Credits

List transaction uploads

Authorizations

Query Parameters

Response