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 'X-Client-Id: SOME_STRING_VALUE' \
  --header 'X-Client-Secret: SOME_STRING_VALUE' \
  --header 'content-type: application/json' \
  --data '{"transactions":[{"account_id":"74583934","transaction_id":"string","amount":"384.05","date":"2023-02-16T09:14:11Z","description":"Regina'\''s Mulberry","type":"food_and_drinks.restaurants"}]}'
const options = {
  method: 'POST',
  headers: {
    'X-Client-Id': 'SOME_STRING_VALUE',
    'X-Client-Secret': 'SOME_STRING_VALUE',
    Authorization: 'Bearer REPLACE_BEARER_TOKEN',
    'content-type': 'application/json'
  },
  body: '{"transactions":[{"account_id":"74583934","transaction_id":"string","amount":"384.05","date":"2023-02-16T09:14:11Z","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 = {"transactions": [
        {
            "account_id": "74583934",
            "transaction_id": "string",
            "amount": "384.05",
            "date": "2023-02-16T09:14:11Z",
            "description": "Regina's Mulberry",
            "type": "food_and_drinks.restaurants"
        }
    ]}
headers = {
    "X-Client-Id": "SOME_STRING_VALUE",
    "X-Client-Secret": "SOME_STRING_VALUE",
    "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("{\"transactions\":[{\"account_id\":\"74583934\",\"transaction_id\":\"string\",\"amount\":\"384.05\",\"date\":\"2023-02-16T09:14:11Z\",\"description\":\"Regina's Mulberry\",\"type\":\"food_and_drinks.restaurants\"}]}")

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

	req.Header.Add("X-Client-Id", "SOME_STRING_VALUE")
	req.Header.Add("X-Client-Secret", "SOME_STRING_VALUE")
	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["X-Client-Id"] = 'SOME_STRING_VALUE'
request["X-Client-Secret"] = 'SOME_STRING_VALUE'
request["Authorization"] = 'Bearer REPLACE_BEARER_TOKEN'
request["content-type"] = 'application/json'
request.body = "{\"transactions\":[{\"account_id\":\"74583934\",\"transaction_id\":\"string\",\"amount\":\"384.05\",\"date\":\"2023-02-16T09:14:11Z\",\"description\":\"Regina's Mulberry\",\"type\":\"food_and_drinks.restaurants\"}]}"

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

let headers = [
  "X-Client-Id": "SOME_STRING_VALUE",
  "X-Client-Secret": "SOME_STRING_VALUE",
  "Authorization": "Bearer REPLACE_BEARER_TOKEN",
  "content-type": "application/json"
]
let parameters = ["transactions": [
    [
      "account_id": "74583934",
      "transaction_id": "string",
      "amount": "384.05",
      "date": "2023-02-16T09:14:11Z",
      "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,
  "provider": "akoya",
  "link_tags": [
    "smoke_test",
    "user_type:admin"
  ],
  "webhook": "https://example.com/webhook",
  "products": {
    "accounts": {
      "refreshed_at": "2023-02-16T09:14:11Z",
      "last_attempted_at": "2023-02-16T09:14:11Z",
      "error_code": "rate_limit",
      "error_message": string,
      "unavailable": string
    },
    "account_numbers": {
      "refreshed_at": "2023-02-16T09:14:11Z",
      "last_attempted_at": "2023-02-16T09:14:11Z",
      "error_code": "rate_limit",
      "error_message": string,
      "unavailable": string
    },
    "identity": {
      "refreshed_at": "2023-02-16T09:14:11Z",
      "last_attempted_at": "2023-02-16T09:14:11Z",
      "error_code": "rate_limit",
      "error_message": string,
      "unavailable": string
    },
    "transactions": {
      "refreshed_at": "2023-02-16T09:14:11Z",
      "last_attempted_at": "2023-02-16T09:14:11Z",
      "error_code": "rate_limit",
      "error_message": string,
      "unavailable": string
    },
    "investments": {
      "refreshed_at": "2023-02-16T09:14:11Z",
      "last_attempted_at": "2023-02-16T09:14:11Z",
      "error_code": "rate_limit",
      "error_message": string,
      "unavailable": string
    },
    "enrichment": {
      "refreshed_at": "2023-02-16T09:14:11Z",
      "last_attempted_at": "2023-02-16T09:14:11Z",
      "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
}

transactions

: array

required

The transactions to import.

id

: string

required

The unique ID for this link.

example: mk_eqkWN34UEoa2NxyALG8pcV

X-Client-Id

: string

Your client ID.

example: live_dcc75c42eb6122127356

X-Client-Secret

: string

Your client secret

example: vzPznCv3kT7fHsAr6y3jk38d

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

: stringnull

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

deprecated

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

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

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. Not all providers are automatically available or usable; provider selection is dynamic and depends on many factors.

example: akoya

Allowed values:

moneykit

finicity

plaid

yodlee

mx

akoya

tags

deprecated

use link_tags instead

webhook

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"

error_message

: string

Error message

default: "Rate limit exceeded"

documentation_url