> ## Documentation Index > Fetch the complete documentation index at: https://docs.layerfi.com/llms.txt > Use this file to discover all available pages before exploring further. # 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. ## 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](/api-details/rate-limiting). ## OpenAPI ````yaml post /v1/businesses/{businessId}/custom-accounts/{customAccountId}/transactions openapi: 3.0.1 info: title: API version: latest servers: [] security: - BearerAuth: [] tags: [] externalDocs: url: / paths: /v1/businesses/{businessId}/custom-accounts/{customAccountId}/transactions: post: tags: [] summary: Import transactions description: >- 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. operationId: business.custom-accounts.transactions.post parameters: - name: businessId in: path description: The UUID of the business to import transactions for. required: true schema: type: string - name: customAccountId in: path description: The UUID of the custom account to import transactions for. required: true schema: type: string - name: Content-Type in: header description: Content-Type must be set to application/json. schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/NewCustomTransactions' responses: '200': description: '' headers: {} content: application/json: schema: $ref: '#/components/schemas/EmptyResponse' '400': description: >- Transaction creation failure. This is most commonly due to invalid transaction data, such incorrect enum values or negative transaction amounts. content: application/json: schema: $ref: '#/components/schemas/ApiError' '404': description: >- Business id or custom account id is not found. This indicates the business id is invalid or the business has been archived, or the custom account id is invalid or the custom account has been deleted. content: application/json: schema: $ref: '#/components/schemas/ApiError' deprecated: false components: schemas: NewCustomTransactions: type: object properties: transactions: type: array items: $ref: '#/components/schemas/NewCustomTransactionParams' description: List of new transactions to import. EmptyResponse: type: object properties: type: type: string description: >- Resource type. Value will be 'com.layerfi.controllers.EmptyResponse'. example: '{}' ApiError: type: object description: An error object returned in API error responses. properties: type: $ref: '#/components/schemas/ApiErrorType' description: >- A fixed category for the error, helpful for categorizing and processing errors. description: type: string description: A human-readable error description. error_enum: $ref: '#/components/schemas/ApiEnumErrorType' description: >- A stable, machine-readable identifier for programmatically handling specific error conditions. Only present for 4xx client errors—not included for 5xx server errors. Use this instead of parsing the description field, as enum values remain stable across API versions. nullable: true meta: type: object description: Optional additional information about the error. nullable: true required: - type - description NewCustomTransactionParams: type: object properties: external_id: type: string description: >- Unique ID of the custom transaction in an external system for linking and idempotency. example: custom-transaction-id-1234 amount: type: integer format: int64 description: Amount of the external transaction, in cents. direction: $ref: '#/components/schemas/BankTransactionDirection' description: Direction of the custom transaction. date: type: string format: date-time description: >- The date that the custom transaction occurred. ISO 8601 format required. merchant_name: type: string nullable: true description: Counterparty name for the custom transaction. example: My example merchant merchant_category_code: type: string nullable: true description: MCC for the custom transaction. example: '4072' description: type: string description: Original description for the custom transaction. example: Original description display_description: type: string nullable: true description: Description to display to users which can include enrichment beyond. example: Current description to display with details currency_code: $ref: '#/components/schemas/CurrencyCode' description: >- Currency code that the custom transaction's amount is denominated in. nullable: true example: USD balance: type: integer format: int64 nullable: true description: Balance for the custom account after the transaction in cents. tags: type: array items: $ref: '#/components/schemas/TagKeyValue' memo: type: string nullable: true description: >- Memo for any text you would like to associate with the transaction (for example, to display to end users). metadata: $ref: '#/components/schemas/PlatformDefinedJson' nullable: true description: Arbitrary custom metadata in JSON format with a size limit of 1KB. reference_number: type: string nullable: true description: >- Any (typically user-visible) identifier you would like to associate with the custom transaction. Can be used to filter when listing bank transactions. ApiErrorType: type: string enum: - ResourceArchived - AuthFailure - Plaid - Stripe - InvalidState - ResourceNotFound - InvalidParameters - JsonSerialization - Unknown - BadRequest - PaginationCursor - Conflict - LedgerOperationFailed ApiEnumErrorType: type: string description: >- Stable enum values for programmatic error handling. Only present in 4xx error responses. enum: - AccessCodeInvalid - BalanceSheetDoesNotBalance - BalanceSheetMissingAccount - BankStatementParserError - BillStateError - BulkCategorizeFailure - BulkMatchFailure - BusinessTaskAlreadyCompleted - BusinessTaskDeleted - CalendlyOAuthError - CallBookingError - CantUpdateTransactionInCustomerPayout - CantUpdateTransactionInVendorPayout - CheckPayrollConfigNotFound - CheckPayrollServiceNotFound - ClerkUserAlreadyExists - ConflictingQueryParams - CustomAccountAlreadyExists - CustomTransactionCsvParsingError - CustomTransactionUploadFailure - CustomerPayoutInputFormatError - DoesNotMatchExistingEntity - EmptyBatchRequest - ExpenseParserError - ExternalAccountBalanceReconciliationError - ExternalIdConflict - InvalidCategory - InvalidEffectiveDate - InvalidLedgerOperation - InvalidMonthlyAverageRange - InvalidMultiPartRequest - InvalidPaginationCursor - InvalidPayload - InvoiceDeleted - InvoiceNotFound - InvoiceReferenceMismatch - InvoiceStateError - ManualRateLimit - MultipleTagKeyFiltersUnsupported - NoCognitoUserFound - NoOpeningBalanceFound - NotYetReconciled - OnePasswordApiError - OnePasswordItemNotFound - OnePasswordVaultNotFound - OpenAICategorizationError - PaymentLinkInvalid - PayrollStateError - PeriodIsClosed - PeriodNotClosed - PhoneNumberAlreadyRegistered - PlaidApiError - PlaidConnectionBroken - PlaidCreateLinkTokenError - PlaidCredentialsNotConfigured - PlaidExchangePublicTokenError - PlaidGetInstitutionByIdError - PlaidGetItemError - PlaidInvalidEnvironment - PlaidItemAlreadyExists - PlaidItemNotFound - PlaidProcessorApiError - PlaidUnlinkItemError - QueryParamFormat - QueryParamMissing - QuickbooksBrokenConnection - QuickbooksConnectionAlreadyExists - QuickbooksConnectionAlreadySyncing - QuickbooksConnectionMissing - QuickbooksConnectionNotActivated - QuickbooksInvalidRequest - QuickbooksInvalidState - QuickbooksNoMatchingAccount - QuickbooksNonPostingAccountType - QuickbooksNotConfigured - QuickbooksOAuthCallbackInvalid - QuickbooksOAuthError - QuickbooksTokenExpired - ResourceArchived - ScheduleCNotConfigured - SmsNotEnabled - SpecifiedBadRequest - SpecifiedIdNotFound - SplitTransactionError - StepEvaluationBadRequest - StripeConnectAccountIdNotFound - StripeCredentialsNotConfigured - StripeGetBalanceForConnectAccountFailure - StripeRedirectOrRefreshUrlNotConfigured - TagFilterNotFound - UnexpectedQueryParam - UnitAccountsInUse - WrongAnswerType BankTransactionDirection: type: string enum: - CREDIT - DEBIT CurrencyCode: type: string enum: - AED - AFN - ALL - AMD - ANG - AOA - ARS - AUD - AWG - AZN - BAM - BBD - BDT - BGN - BHD - BIF - BMD - BND - BOB - BRL - BSD - BTN - BWP - BYR - BZD - CAD - CDF - CHF - CLP - CNY - COP - CRC - CUC - CUP - CVE - CZK - DJF - DKK - DOP - DZD - EGP - ERN - ETB - EUR - FJD - FKP - GBP - GEL - GGP - GHS - GIP - GMD - GNF - GTQ - GYD - HKD - HNL - HRK - HTG - HUF - IDR - ILS - IMP - INR - IQD - IRR - ISK - JEP - JMD - JOD - JPY - KES - KGS - KHR - KMF - KPW - KRW - KWD - KYD - KZT - LAK - LBP - LKR - LRD - LSL - LYD - MAD - MDL - MGA - MKD - MMK - MNT - MOP - MRO - MUR - MVR - MWK - MXN - MYR - MZN - NAD - NGN - NIO - NOK - NPR - NZD - OMR - PAB - PEN - PGK - PHP - PKR - PLN - PYG - QAR - RON - RSD - RUB - RWF - SAR - SBD - SCR - SDG - SEK - SGD - SHP - SLL - SOS - SPL - SRD - STD - SVC - SYP - SZL - THB - TJS - TMT - TND - TOP - TRY - TTD - TVD - TWD - TZS - UAH - UGX - USD - UYU - UZS - VEF - VND - VUV - WST - XAF - XCD - XDR - XOF - XPF - YER - ZAR - ZMW - ZWD TagKeyValue: type: object description: >- A TagKeyValue holds key=value data related to a tag. This is used when creating or updating taggable entities (transactions, invoices, etc.). properties: key: type: string description: The tag dimension key (e.g., "department", "project", "location"). example: department dimension_display_name: type: string nullable: true description: >- If the TagDimension doesn't exist, providing this value specifies the display name upon database insertion. Otherwise, it is left as null on the TagDimension. example: Department value: type: string description: The tag value (e.g., "sales", "marketing", "engineering"). example: sales value_display_name: type: string nullable: true description: >- If the TagValueDefinition doesn't exist, providing this value specifies the display name upon database insertion. Otherwise, it is left as null on the TagValueDefinition. example: Sales Department required: - key - value PlatformDefinedJson: type: object description: Arbitrary JSON data defined by the caller, with a 1KB size constraint. additionalProperties: true example: custom_field: value any valid json: below 1kb nested: meaning of life: 42 array: [] securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: JWT ````