Import transactions

Imports transactions for a custom account. This action will import transactions from the specified start date to the present. If the account has already been imported, this action will overwrite the existing transactions.

POST /v1/businesses/{businessId}/custom-accounts/{customAccountId}/transactions

Import transactions

cURL

curl --request POST \
  --url https://sandbox.layerfi.com/v1/businesses/{businessId}/custom-accounts/{customAccountId}/transactions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "transactions": [
    {
      "external_id": "custom-transaction-id-1234",
      "amount": 123,
      "direction": "CREDIT",
      "date": "2023-11-07T05:31:56Z",
      "merchant_name": "My example merchant",
      "merchant_category_code": "4072",
      "description": "Original description",
      "display_description": "Current description to display with details",
      "currency_code": "USD",
      "balance": 123,
      "tags": [
        {
          "key": "department",
          "value": "sales",
          "dimension_display_name": "Department",
          "value_display_name": "Sales Department"
        }
      ],
      "memo": "<string>",
      "metadata": {
        "custom_field": "value",
        "any valid json": "below 1kb",
        "nested": {
          "meaning of life": 42,
          "array": []
        }
      },
      "reference_number": "<string>"
    }
  ]
}
'

200

{
  "type": "{}"
}

Rate Limiting

This endpoint has a custom rate limit policy.

Rate Limit Details:

Environment	Limit	Refill Period	Initial Size
Sandbox	3 requests	1 second	6 requests
Production	20 requests	1 second	40 requests

Response Headers:

All responses include the following rate limit headers:

• X-RateLimit-Limit: The rate limit bucket capacity
• X-RateLimit-Remaining: The number of tokens remaining in the bucket
• X-RateLimit-Reset: UTC timestamp (in seconds) when the bucket will be refilled

For more details on rate limiting, see Rate Limiting.

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Content-Type · string

Content-Type must be set to application/json

Path Parameters

businessId · string · required

The UUID of the business to import transactions for.

customAccountId · string · required

The UUID of the custom account to import transactions for.

Body

application/json

transactions · object[]

List of new transactions to import

Show child attributes

Response

200

application/json

type · string

Resource type. Value will be 'com.layerfi.controllers.EmptyResponse'.

Example:

"{}"