Get transactions with authorization status includes: [AUTHORIZATION_EVENT,AUTHORIZATION_AND_CLEAR_EVENT]

get

https://api.banking.netevia.dev/api/transactionEvents/authorizations

Get Transactions with Authorization Status

This endpoint returns transaction events filtered to those with an authorization status, specifically events of type AUTHORIZATION_EVENT and AUTHORIZATION_AND_CLEAR_EVENT. Results can be scoped to a specific payment card and filtered by date range. Pagination is supported via a cursor-based after parameter.

Endpoint

GET /api/transactionEvents/authorizations

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 review pending or recently authorized card transactions before they settle. It is useful for fraud monitoring, real-time spend tracking, and reconciling authorization holds against available balances. Partners can also use it to surface in-flight authorizations in customer-facing dashboards.

Query Parameters

Parameter	Type	Required	Description
`paymentCardId`	string	No	Filter results to authorization events for a specific payment card ID.
`from`	string (date-time)	No	Start of the date range filter (ISO 8601 format). Returns events created on or after this timestamp.
`to`	string (date-time)	No	End of the date range filter (ISO 8601 format). Returns events created on or before this timestamp.
`after`	string	No	Cursor value from a previous response's `pageInfo.endCursor` for paginating to the next page of results.

Response

200 OK

The response wraps a paginated list of authorization transaction events.

Top-level response fields (banking.models.response.authorizationsresponse)

Field	Type	Description
`pageInfo`	object	Pagination metadata.
`pageInfo.startCursor`	string	Cursor pointing to the first record in this page.
`pageInfo.endCursor`	string	Cursor to pass as `after` to retrieve the next page.
`pageInfo.hasNextPage`	boolean	`true` if more records exist beyond the current page.
`pageInfo.hasPreviousPage`	boolean	`true` if records exist before the current page.
`uthorizations`	array	List of authorization transaction event objects.

Each authorization event object (bank.client.transactions.transactionevent)

Field	Type	Description
`typename`	string	Type of the transaction event (e.g., `AUTHORIZATION_EVENT`, `AUTHORIZATION_AND_CLEAR_EVENT`).
`responseCode`	string	Authorization response code returned by the card network.
`responseDescription`	string	Human-readable description of the authorization response code.
`createdAt`	string (date-time)	Timestamp when the authorization event was created.
`approvedAmount`	object	The amount that was approved.
`approvedAmount.value`	integer (int64)	Approved amount in the smallest currency unit (e.g., cents).
`approvedAmount.currencyCode`	string	ISO 4217 currency code (e.g., `USD`).
`requestedAmount`	object	The amount originally requested by the merchant.
`requestedAmount.value`	integer (int64)	Requested amount in the smallest currency unit.
`requestedAmount.currencyCode`	string	ISO 4217 currency code.
`merchantDetails`	object	Details about the merchant where the transaction occurred.
`merchantDetails.name`	string	Merchant name.
`merchantDetails.category`	string	Merchant category label (e.g., `GROCERY_STORES_SUPERMARKETS`).
`merchantDetails.categoryCode`	string	Numeric merchant category code (MCC).
`merchantDetails.countryCodeAlpha3`	string	ISO 3166 alpha-3 country code for the merchant location.
`merchantDetails.description`	string	Additional merchant description.
`merchantDetails.merchantId`	string	Unique merchant identifier.
`paymentCard`	object	The payment card used in the transaction.
`paymentCard.id`	string	Unique payment card ID.
`paymentCard.bin`	string	Bank identification number (first 6 digits of the card).
`paymentCard.last4`	string	Last 4 digits of the card number.
`paymentCard.status`	string	Current status of the card (e.g., `OPEN`, `SUSPENDED`).
`paymentCard.formFactor`	string	Card form factor: `PHYSICAL`, `VIRTUAL`, or `BURNER`.
`paymentCard.expirationDate`	string	Full expiration date string.
`paymentCard.network`	string	Card network (e.g., `VISA`, `MASTERCARD`).
`transaction`	object	Reference to the parent transaction record.
`transaction.typename`	string	Type name of the transaction source.
`transaction.id`	string	Unique transaction ID.
`fees`	array	List of any fees associated with the authorization event.
`fees[].type`	string	Fee type descriptor.
`fees[].approvedFeeAmount.value`	integer (int64)	Approved fee amount in smallest currency unit.
`fees[].requestedFeeAmount.value`	integer (int64)	Requested fee amount in smallest currency unit.

{
  "pageInfo": {
    "startCursor": "Y3Vyc29yMQ==",
    "endCursor": "Y3Vyc29yMTA=",
    "hasNextPage": true,
    "hasPreviousPage": false
  },
  "uthorizations": [
    {
      "typename": "AUTHORIZATION_EVENT",
      "responseCode": "00",
      "responseDescription": "Approved",
      "createdAt": "2026-06-08T14:22:11Z",
      "approvedAmount": {
        "value": 4599,
        "currencyCode": "USD"
      },
      "requestedAmount": {
        "value": 4599,
        "currencyCode": "USD"
      },
      "merchantDetails": {
        "name": "Whole Foods Market",
        "category": "GROCERY_STORES_SUPERMARKETS",
        "categoryCode": "5411",
        "countryCodeAlpha3": "USA",
        "description": "Grocery Store",
        "merchantId": "MID-00293847"
      },
      "paymentCard": {
        "id": "pc_0a1b2c3d4e5f6a7b",
        "bin": "411111",
        "last4": "4242",
        "status": "OPEN",
        "formFactor": "PHYSICAL",
        "expirationDate": "12/2028",
        "network": "VISA"
      },
      "transaction": {
        "typename": "Transaction",
        "id": "txn_9z8y7x6w5v4u3t2s"
      },
      "fees": []
    },
    {
      "typename": "AUTHORIZATION_AND_CLEAR_EVENT",
      "responseCode": "00",
      "responseDescription": "Approved",
      "createdAt": "2026-06-08T13:05:44Z",
      "approvedAmount": {
        "value": 1250,
        "currencyCode": "USD"
      },
      "requestedAmount": {
        "value": 1250,
        "currencyCode": "USD"
      },
      "merchantDetails": {
        "name": "Amazon",
        "category": "ONLINE_MARKETPLACES",
        "categoryCode": "5999",
        "countryCodeAlpha3": "USA",
        "description": "Online Retail",
        "merchantId": "MID-00112233"
      },
      "paymentCard": {
        "id": "pc_1b2c3d4e5f6a7b8c",
        "bin": "422222",
        "last4": "1111",
        "status": "OPEN",
        "formFactor": "VIRTUAL",
        "expirationDate": "09/2027",
        "network": "MASTERCARD"
      },
      "transaction": {
        "typename": "Transaction",
        "id": "txn_1a2b3c4d5e6f7g8h"
      },
      "fees": [
        {
          "type": "TRANSACTION_FEE",
          "approvedFeeAmount": {
            "value": 25,
            "currencyCode": "USD"
          },
          "requestedFeeAmount": {
            "value": 25,
            "currencyCode": "USD"
          }
        }
      ]
    }
  ]
}

Error Codes

Code	When it happens
400	Invalid query parameter format (e.g., malformed date-time string for `from` or `to`).
401	Token missing, expired, or invalid.
403	Insufficient permissions to access transaction event data.
404	The specified `paymentCardId` does not exist or does not belong to the authenticated partner's scope.
500	Internal server error.

Common Mistakes

Providing from or to values that are not valid ISO 8601 date-time strings will result in a 400 error. Always include timezone information (e.g., 2026-06-01T00:00:00Z).
Passing an after cursor from a different query context (different paymentCardId or date range) will return unexpected or empty results. Always use cursors from the same query configuration.
Note the field name in the response is uthorizations (missing the leading A) — this is the exact field name returned by the API. Do not expect authorizations.
Amount values are returned in the smallest currency unit (cents for USD). A value of 4599 represents $45.99, not $4,599.
This endpoint returns only AUTHORIZATION_EVENT and AUTHORIZATION_AND_CLEAR_EVENT types. For settled transactions, use the ledger entries endpoints instead.

Related Endpoints

GET /api/transactionEvents — Retrieve all transaction events across all event types for a financial account.
GET /api/transactionEvents/declines — Retrieve transaction events that were declined.
GET /api/paymentCards/{paymentCardId} — Retrieve details about a specific payment card.
GET /api/financialAccounts/{financialAccountId}/ledger — Retrieve settled ledger entries for a financial account.

Example

curl -X GET "https://api.banking.netevia.dev/api/transactionEvents/authorizations?paymentCardId=pc_0a1b2c3d4e5f6a7b&from=2026-06-01T00:00:00Z&to=2026-06-08T23:59:59Z" \
  -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