Get Payment card with limits data

get deprecated

https://api.banking.netevia.dev/api/paymentCards/findPaymentCardWithInfo

Get Payment Card with Limits Data

The GET /api/paymentCards/findPaymentCardWithInfo endpoint retrieves comprehensive information about a specific payment card, including its limits and usage details. It returns card metadata, cardholder address, burner card spending constraints, and a paginated list of recent financial activity associated with the card. This endpoint is deprecated; partners should migrate to the current payment card detail endpoint when available.

Endpoint

GET /api/paymentCards/findPaymentCardWithInfo

Deprecated: This endpoint is marked as deprecated. Use it only for legacy integrations until a replacement endpoint is available.

Authentication

Bearer token required. Obtain via:

POST https://api.banking.netevia.dev/api/auth/v2

Include in header: Authorization: Bearer {token}
Token lifetime: 10 minutes. Refresh via POST /api/auth/refresh.

When to use

Use this endpoint when you need to display a payment card's current limits, available spending balance, and recent transaction history in a single call. It is particularly useful for dashboards that show card-level activity alongside spending caps, and for burner card management where remaining spending and transaction counts must be tracked. Partners building card management UIs can use it to populate card detail screens with both card metadata and activity data.

Query Parameters

Parameter	Type	Required	Description
`paymentCardId`	string	Yes	Unique identifier of the payment card to retrieve
`from`	string (date-time)	No	Start of the date range for filtering transaction activity (ISO 8601 format)
`to`	string (date-time)	No	End of the date range for filtering transaction activity (ISO 8601 format)
`count`	integer (int32)	No	Number of activity records to return per page. Default: `20`
`afterCursor`	string	No	Pagination cursor — pass the cursor value from the previous response to fetch the next page

Response

200 OK

Field	Type	Description
`card`	any (nullable)	Card object with core card details
`cardType`	integer (int32)	Numeric card type identifier (e.g., Physical, Virtual, Burner)
`burnerCardInfo`	object	Spending and transaction limits for burner cards; `null` for non-burner cards
`burnerCardInfo.maxTotalSpending`	integer (int64)	Maximum cumulative spending allowed on the burner card (in cents)
`burnerCardInfo.maxTransactionsCount`	integer (int32)	Maximum number of transactions allowed on the burner card
`burnerCardInfo.totalSpending`	integer (int64)	Total amount spent on the burner card to date (in cents)
`burnerCardInfo.totalTransactionsCount`	integer (int32)	Total number of transactions used on the burner card
`burnerCardInfo.availableSpending`	integer (int64)	Remaining spending balance on the burner card (in cents)
`burnerCardInfo.availableTransactionsCount`	integer (int32)	Remaining number of transactions available on the burner card
`burnerCardInfo.burnerExpirationDate`	string (date-time)	Expiration date/time of the burner card
`address`	string	Street address associated with the card
`city`	string	City associated with the card
`postalCode`	string	Postal code associated with the card
`state`	string	State associated with the card
`dba`	string	Doing-business-as name associated with the card
`cardHolder`	string	Name of the cardholder
`reissueAvailable`	boolean	Whether the card is eligible for reissuance
`activity`	object	Paginated list of financial activity records for this card
`activity.data`	array	Array of financial activity response objects
`activity.data[].id`	string	Unique identifier of the activity record
`activity.data[].financialAccountId`	string	Identifier of the associated financial account
`activity.data[].date`	string (date-time)	Date and time of the activity
`activity.data[].sortDate`	string (date-time)	Sort date used for ordering activity records
`activity.data[].balance`	object	Account balance at the time of the activity (`value` in cents, `currencyCode`)
`activity.data[].status`	string	Activity status — one of: `OTHER`, `PENDING`, `COMPLETED`, `FAILED`
`activity.data[].riskHold`	boolean	Whether the activity is on a risk hold
`activity.data[].settlementDate`	string (date-time)	Date the transaction settled
`activity.data[].purpose`	string	Purpose description of the activity
`activity.data[].statusReasonCode`	string	Machine-readable reason code for the current status
`activity.data[].amount`	object	Transaction amount (`value` in cents, `currencyCode`, `symbol`)
`activity.data[].clearAmount`	object	Cleared amount (`value` in cents, `currencyCode`, `symbol`)
`activity.data[].pendingAmount`	object	Pending amount (`value` in cents, `currencyCode`)
`activity.data[].name`	string	Display name for the activity
`activity.data[].last4`	object	Last 4 digits info (`type`: `CARD` or `ACCOUNT`, `value`: last 4 digits string)
`activity.data[].type`	string	Activity type label
`activity.data[].authorizedUser`	string	Name of the authorized user who initiated the activity, if applicable
`activity.data[].merchantCategory`	string	Merchant category for card transactions
`activity.data[].rewardPoints`	integer (int64)	Reward points earned or applied in this activity
`activity.paginationResponse.totalItems`	integer (int32)	Total number of activity records matching the query

{
  "card": {
    "id": "card_abc123def456",
    "last4": "7890",
    "bin": "412345",
    "status": "ACTIVE"
  },
  "cardType": 2,
  "burnerCardInfo": {
    "maxTotalSpending": 50000,
    "maxTransactionsCount": 10,
    "totalSpending": 12500,
    "totalTransactionsCount": 3,
    "availableSpending": 37500,
    "availableTransactionsCount": 7,
    "burnerExpirationDate": "2026-07-31T23:59:59Z"
  },
  "address": "123 Main St",
  "city": "Miami",
  "postalCode": "33101",
  "state": "FL",
  "dba": "Acme Corp",
  "cardHolder": "Jane Smith",
  "reissueAvailable": true,
  "activity": {
    "data": [
      {
        "id": "act_001xyz",
        "financialAccountId": "fa_abc987",
        "date": "2026-06-07T14:30:00Z",
        "sortDate": "2026-06-07T14:30:00Z",
        "balance": {
          "value": 250000,
          "currencyCode": "USD"
        },
        "status": "COMPLETED",
        "riskHold": false,
        "settlementDate": "2026-06-08T00:00:00Z",
        "purpose": "Purchase",
        "statusReasonCode": null,
        "amount": {
          "value": 4999,
          "currencyCode": "USD",
          "symbol": "$"
        },
        "clearAmount": {
          "value": 4999,
          "currencyCode": "USD",
          "symbol": "$"
        },
        "pendingAmount": {
          "value": 0,
          "currencyCode": "USD"
        },
        "name": "ACME STORE #42",
        "last4": {
          "type": "CARD",
          "value": "7890"
        },
        "type": "CARD_TRANSACTION",
        "authorizedUser": null,
        "merchantCategory": "Retail",
        "rewardPoints": 50,
        "activityInfo": null,
        "financialEvent": null
      }
    ],
    "filter": {
      "all": { "displayName": "All", "value": true, "items": null },
      "deposit": { "displayName": "Deposits", "value": false, "items": null },
      "withdraw": { "displayName": "Withdrawals", "value": false, "items": null },
      "transfers": { "displayName": "Transfers", "value": false, "items": null },
      "pos": { "displayName": "POS", "value": false, "items": null },
      "transactionStatus": { "displayName": "Status", "value": false, "items": null },
      "others": { "displayName": "Others", "value": false, "items": null }
    },
    "paginationResponse": {
      "totalItems": 1
    }
  }
}

Error Codes

Code	When it happens
400	`paymentCardId` is missing or malformed
401	Token missing, expired, or invalid
403	Insufficient permissions to access the specified card
404	No payment card found for the provided `paymentCardId`
500	Internal server error

Common Mistakes

Omitting the required paymentCardId query parameter will result in a 400 error; it must always be supplied.
Amount values (value fields) are returned in the smallest currency unit (cents for USD) — divide by 100 before displaying to end users.
The burnerCardInfo object is only populated when cardType corresponds to a Burner Card; for Physical and Virtual cards it will be null.
The from and to date filters apply to the activity data only — they do not affect the card metadata fields returned in the response.
Pagination uses cursor-based navigation: pass the cursor from afterCursor in subsequent requests rather than using offset-based page numbers.
This endpoint is deprecated; plan migration to the current card detail endpoint to avoid future breakage.

Related Endpoints

GET /api/paymentCards — List all payment cards for a customer
GET /api/paymentCards/{paymentCardId} — Get basic details for a single payment card
POST /api/paymentCards — Issue a new payment card (Physical, Virtual, or Burner)
PUT /api/paymentCards/{paymentCardId} — Update payment card settings or status

Example

curl -X GET "https://api.banking.netevia.dev/api/paymentCards/findPaymentCardWithInfo?paymentCardId=card_abc123def456&from=2026-06-01T00%3A00%3A00Z&to=2026-06-08T23%3A59%3A59Z&count=20" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json"

Response

Language

Credentials

Bearer

JWT

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

text/plain

application/json

text/json