# Transaction Limits

Returns applicable transaction limits for a given identity and transaction context.

Limits are derived from:
- payment-provider limits (route/method specific), and
- customer-specific limits (tier-based and/or overrides)

The response returns:
- limits for DAILY/WEEKLY/MONTHLY/ANNUAL windows,
  including provider vs customer sources

Endpoint: POST /eapi/v0/identities/transactions/limits
Version: 0 BETA
Security: HMACAuth

## Request fields (application/json):

  - `identityReference` (string, required)
    Partner identity reference.
    Example: "206-0x56c386b7b49be8618dbcdb2c6d09e161645c31ed"

  - `method` (string, required)
    Payment method / route identifier.
    Example: "payid-bank-transfer"

  - `transactionType` (string, required)
    Transaction type (e.g., ONRAMP/OFFRAMP). Populate enum from your TransactionTypeEnum if desired.
    Example: "ONRAMP"

  - `fiat` (string, required)
    Fiat currency code (typically ISO 4217).
    Example: "AUD"

  - `crypto` (string, required)
    Crypto asset code.
    Example: "BTC"

  - `blockchain` (string, required)
    Blockchain identifier.
    Example: "BTC"

## Response 200 fields (application/json):

  - `identityReference` (string, required)
    Echo of the identity reference.
    Example: "206-0x56c386b7b49be8618dbcdb2c6d09e161645c31ed"

  - `limits` (object, required)

  - `limits.transaction` (object)

  - `limits.transaction.maxFiat` (object)

  - `limits.transaction.maxFiat.amount` (string)
    The maximum value for the transaction
    Example: "100"

  - `limits.transaction.maxFiat.currency` (string)
    Subject fiat currencty
    Example: "AUD"

  - `limits.transaction.minFiat` (object)

  - `limits.periodical` (array)
    List of limit buckets for each time period.

  - `limits.periodical.period` (string, required)
    Time window the limits apply to.
    Enum: "TRANSACTION", "DAILY", "WEEKLY", "MONTHLY", "ANNUAL"

  - `limits.periodical.sources` (object)
    Breakdown of limit sources

  - `limits.periodical.sources.provider` (object)
    Limit amounts for a given context.

  - `limits.periodical.sources.customer` (object)
    Limit amounts for a given context.

## Response 400 fields (application/json):

  - `message` (string)
    Example: "Bad Request"

  - `status` (integer)
    Example: 400

  - `traceId` (string)
    Idempotency key for the error
    Example: "2b6fc5d0-57e4-4b5a-9e3c-6cfbb6d8023f"

## Response 401 fields (application/json):

  - `message` (string)
    Example: "Unauthenticated."

  - `status` (integer)
    Example: 401

## Response 422 fields (application/json):

  - `message` (string)
    Example: "The given data was invalid."

  - `errors` (object)

  - `status` (integer)
    Example: 422

## Response 429 fields (application/json):

  - `message` (string)
    Example: "Too Many Requests. Please try again later."

  - `status` (integer)
    Example: 429

## Response 500 fields (application/json):

  - `message` (string)
    Example: "Server Error"

  - `status` (integer)
    Example: 500

  - `traceId` (string)
    Idempotency key for the error
    Example: "2b6fc5d0-57e4-4b5a-9e3c-6cfbb6d8023f"