Import Transactions

Import Transactions

Adds transactions to a link imported with the import endpoint. The imported data has a maximum size limit of 1MB, which corresponds very roughly to about 4000 transactions. The data is processed synchronously, so you can expect a delay of up to 10 seconds before the response is transmitted.

URL

POST
/links/{id}/import/transactions
Request
curl --request POST \
  --url https://api.moneykit.com/links/[id]/import/transactions \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN' \
  --header 'content-type: application/json' \
  --data '[{"account_id":"74583934","transaction_id":"string","amount":"384.05","date":"2022-02-08","description":"Regina'\''s Mulberry","type":"food_and_drinks.restaurants"}]'
const options = {
  method: 'POST',
  headers: {
    Authorization: 'Bearer REPLACE_BEARER_TOKEN',
    'content-type': 'application/json'
  },
  body: '[{"account_id":"74583934","transaction_id":"string","amount":"384.05","date":"2022-02-08","description":"Regina\'s Mulberry","type":"food_and_drinks.restaurants"}]'
};

fetch('https://api.moneykit.com/links/[id]/import/transactions', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));
import requests

url = "https://api.moneykit.com/links/[id]/import/transactions"

payload = [
    {
        "account_id": "74583934",
        "transaction_id": "string",
        "amount": "384.05",
        "date": "2022-02-08",
        "description": "Regina's Mulberry",
        "type": "food_and_drinks.restaurants"
    }
]
headers = {
    "Authorization": "Bearer REPLACE_BEARER_TOKEN",
    "content-type": "application/json"
}

response = requests.request("POST", url, json=payload, headers=headers)

print(response.text)
package main

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

func main() {

	url := "https://api.moneykit.com/links/[id]/import/transactions"

	payload := strings.NewReader("[{\"account_id\":\"74583934\",\"transaction_id\":\"string\",\"amount\":\"384.05\",\"date\":\"2022-02-08\",\"description\":\"Regina's Mulberry\",\"type\":\"food_and_drinks.restaurants\"}]")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer REPLACE_BEARER_TOKEN")
	req.Header.Add("content-type", "application/json")

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

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

	fmt.Println(res)
	fmt.Println(string(body))

}
require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://api.moneykit.com/links/[id]/import/transactions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer REPLACE_BEARER_TOKEN'
request["content-type"] = 'application/json'
request.body = "[{\"account_id\":\"74583934\",\"transaction_id\":\"string\",\"amount\":\"384.05\",\"date\":\"2022-02-08\",\"description\":\"Regina's Mulberry\",\"type\":\"food_and_drinks.restaurants\"}]"

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

let headers = [
  "Authorization": "Bearer REPLACE_BEARER_TOKEN",
  "content-type": "application/json"
]
let parameters = [
  [
    "account_id": "74583934",
    "transaction_id": "string",
    "amount": "384.05",
    "date": "2022-02-08",
    "description": "Regina's Mulberry",
    "type": "food_and_drinks.restaurants"
  ]
] as [String : Any]

let postData = JSONSerialization.data(withJSONObject: parameters, options: [])

let request = NSMutableURLRequest(url: NSURL(string: "https://api.moneykit.com/links/[id]/import/transactions")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "POST"
request.allHTTPHeaderFields = headers
request.httpBody = postData as Data

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
Response
{
  "link_id": "mk_eqkWN34UEoa2NxyALG8pcV",
  "institution_id": "chase",
  "institution_name": "Chase",
  "institution_avatar": "https://example.com/avatar.png",
  "state": "connected",
  "error_code": null,
    "link_tags": [
    "smoke_test",
    "user_type:admin"
  ],
  "webhook": "https://example.com/webhook",
  "products": {
    "accounts": {
      "refreshed_at": "2023-02-16T09:14:11",
      "last_attempted_at": "2023-02-16T09:14:11",
      "error_code": "rate_limit",
      "error_message": string,
      "unavailable": string
    },
    "account_numbers": {
      "refreshed_at": "2023-02-16T09:14:11",
      "last_attempted_at": "2023-02-16T09:14:11",
      "error_code": "rate_limit",
      "error_message": string,
      "unavailable": string
    },
    "identity": {
      "refreshed_at": "2023-02-16T09:14:11",
      "last_attempted_at": "2023-02-16T09:14:11",
      "error_code": "rate_limit",
      "error_message": string,
      "unavailable": string
    },
    "transactions": {
      "refreshed_at": "2023-02-16T09:14:11",
      "last_attempted_at": "2023-02-16T09:14:11",
      "error_code": "rate_limit",
      "error_message": string,
      "unavailable": string
    },
    "investments": {
      "refreshed_at": "2023-02-16T09:14:11",
      "last_attempted_at": "2023-02-16T09:14:11",
      "error_code": "rate_limit",
      "error_message": string,
      "unavailable": string
    },
    "enrichment": {
      "refreshed_at": "2023-02-16T09:14:11",
      "last_attempted_at": "2023-02-16T09:14:11",
      "error_code": "rate_limit",
      "error_message": string,
      "unavailable": string
    }
  },
  "available_products": [
    "account_numbers"
  ]
}
{
  "error_code": "api_error.auth.expired_access_token",
  "error_message": "Access token expired",
  "documentation_url": string
}
{
  "error_code": "api_error.rate_limit_exceeded",
  "error_message": "Rate limit exceeded",
  "documentation_url": string
}

account_id

: string

required

Your internal ID for the account this transaction belongs to. The account_id must match one of the IDs provided in the accounts list.

example: 74583934

amount

: string

required

The amount of this transaction, denominated in account currency. Use positive numbers for credits (deposits), and negative numbers of debits (withdrawals).

example: 384.05

date

required

The effective (posted) date of the transaction, in ISO-8601 format.

example: 2022-02-08

example: 2023-02-16T09:14:11

description

: string

A description of this transaction.

example: Regina's Mulberry

transaction_id

: string

Your internal ID for this transaction. If supplied, this ID will be returned as the original_id of the transaction in future requests.

type

: string

A type or category for this transaction. Does not need to match MoneyKit types, but see Transaction Categories if you want to match our current schema.

example: food_and_drinks.restaurants

id

: string

required

The unique ID for this link.

example: mk_eqkWN34UEoa2NxyALG8pcV

Responses

200

Successful Response

institution_id

: string

The unique ID for the institution this link is connected to.

example: chase

institution_name

: string

The institution name this link is connected to.

example: Chase

institution_avatar

: string

An avatar image for the link's institution.

example: https://example.com/avatar.png

state

: string

The current state of this link. Links that are not yet connected, or which require reconnection, will be in one of the non-connected states. Please note that recently deleted links can be fetched by this function (and will have a state of deleted); however, MoneyKit completely removes deleted links 90 days after deletion, so older deleted links will not be seen after this time.

example: connected

Allowed values:

connecting

awaiting_token_exchange

connected

deleted

error

error_code

: string

The type of error, if the link is in the error state. See Errors for an explanation of error codes.

Allowed values:

system_error

provider_error

institution_error

user_error

auth_expired

no_accounts

user_setup_required

invalid_credentials

user_oauth_denied

user_input_incorrect

incomplete

last_synced_at

: string

deprecated

An ISO-8601 timestamp indicating the last time that the link was updated.

format:

date-time

example: 2023-02-16T09:14:11

provider

: string

The provider that most recently facilitated the creation of this link. Note that MoneyKit may switch providers if necessary to provide continuous access to the institution.

example: mx

Allowed values:

moneykit

finicity

plaid

yodlee

mx

akoya

tags

: array

deprecated

use link_tags instead

webhook

: string

The webhook url assigned to this link.

example: https://example.com/webhook

products

: object

The granted products available for this link.

available_products

: array

A list of products that could be added to this link. Products can be added to (and removed from) an existing link by creating a new /link-session and supplying the existing_link_id with a new set of products.

Allowed values:

accounts

account_numbers

identity

transactions

investments

enrichment

429

Rate limit exceeded.

error_code

: string

default: "api_error.rate_limit_exceeded"

Allowed values:

api_error.rate_limit_exceeded

error_message

: string

Error message

default: "Rate limit exceeded"

documentation_url

: string