Get Authorization Transactions

This endpoint retrieves open authorization transaction events associated with a specific payment card for a specified date period. Open authorizations are card transactions that have been approved but not yet settled. Use this endpoint to monitor pending card activity and track authorized spend before final settlement.

Deprecation Notice: This endpoint is marked as deprecated. Consider migrating to the current transaction events endpoint when available.

Endpoint

POST /api/transactionEvents/openAuthorizations

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 to retrieve a list of authorized-but-unsettled card transactions for a payment card, useful for displaying pending charges to a cardholder or reconciling real-time card spend. It supports optional amount range filtering, keyword search, and pagination for large result sets. This is particularly relevant for dashboards or reporting tools that need to show in-flight authorizations before they post.

Request Body

The request body accepts one of two schemas. The base schema (paymentcardwithperiodandfilterrequest) requires only the card ID and date range. The extended schema (paymentcardwithperiodandamountfilterrequest) adds optional amount filtering, search string, and pagination.

Base fields (both variants):

Extended fields (amount filter variant only):

Base request example:

{
  "paymentCardId": "pcd_abc123def456",
  "dateFrom": "2026-05-01T00:00:00Z",
  "dateTo": "2026-05-31T23:59:59Z"
}

Extended request example (with amount filter and pagination):

{
  "paymentCardId": "pcd_abc123def456",
  "dateFrom": "2026-05-01T00:00:00Z",
  "dateTo": "2026-05-31T23:59:59Z",
  "amountFilter": {
    "minValue": 500,
    "maxValue": 50000
  },
  "searchString": "grocery",
  "paginationSettings": {
    "take": 50,
    "skip": 0
  }
}

Response

200 OK

{
  "data": [
    {
      "typename": "AuthorizationEvent",
      "responseCode": "00",
      "responseDescription": "Approved",
      "createdAt": "2026-05-15T14:32:00Z",
      "approvedAmount": {
        "value": 4250,
        "currencyCode": "USD"
      },
      "requestedAmount": {
        "value": 4250,
        "currencyCode": "USD"
      },
      "merchantDetails": {
        "name": "WHOLE FOODS MARKET",
        "category": "GROCERY_STORES_SUPERMARKETS",
        "categoryCode": "5411",
        "countryCodeAlpha3": "USA",
        "description": "Grocery purchase",
        "merchantId": "mch_7890xyz"
      },
      "paymentCard": {
        "id": "pcd_abc123def456",
        "bin": "411111",
        "last4": "4242",
        "status": "ACTIVE",
        "formFactor": "VIRTUAL",
        "expirationDate": "12/2028",
        "network": "VISA"
      },
      "fees": []
    }
  ],
  "filter": {
    "all": {
      "displayName": "All",
      "value": true
    },
    "pos": {
      "displayName": "Point of Sale",
      "value": true
    }
  }
}

Error Codes

Common Mistakes

• Omitting paymentCardId, dateFrom, or dateTo — all three are required in the base request and will result in a 400 error.
• Providing dates in a format other than ISO 8601 date-time (e.g., omitting the time component or timezone indicator).
• Setting paginationSettings.take to 0 or above 10000 — valid range is 1 to 10000.
• Querying a paymentCardId that does not belong to the authenticated partner's customers, which will return 403 or 404.
• Using this deprecated endpoint for new integrations; plan migration to the current transaction events endpoint.

Related Endpoints

• POST /api/transactionEvents — Retrieve settled transaction events for a payment card
• POST /api/transactionEvents/filter — Retrieve filtered transaction events with extended query options
• GET /api/paymentCards/{paymentCardId} — Retrieve payment card details including status and form factor

Example

curl -X POST https://api.banking.netevia.dev/api/transactionEvents/openAuthorizations \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "paymentCardId": "pcd_abc123def456",
    "dateFrom": "2026-05-01T00:00:00Z",
    "dateTo": "2026-05-31T23:59:59Z",
    "amountFilter": {
      "minValue": 100,
      "maxValue": 100000
    },
    "paginationSettings": {
      "take": 50,
      "skip": 0
    }
  }'