Get Daily ATM Withdrawal Limit
Deprecated: This endpoint is deprecated. Consult the related spend rules endpoints for current ATM limit management functionality.
The GET /api/spendRules/atmDailyLimit endpoint retrieves the current daily ATM withdrawal limit configured on a specific payment card. It returns the maximum dollar amount that can be withdrawn from ATMs within a 24-hour period. This information helps partners and their customers monitor cash access boundaries and plan daily transactions accordingly.
Endpoint
GET /api/spendRules/atmDailyLimit
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 a customer or authorized user needs to check the current daily ATM withdrawal limit on their payment card before attempting a cash withdrawal. It is useful for financial planning workflows where the application needs to display spending limits to the cardholder. This endpoint is also relevant when building account management dashboards that surface card-level spend rule information.
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| paymentCardId | string | No | The unique identifier of the payment card whose daily ATM withdrawal limit is being queried. |
Response
200 OK
Returns a single integer (int64) representing the daily ATM withdrawal limit in cents or the configured currency unit for the card.
| Field | Type | Description |
|---|---|---|
| (root value) | integer (int64) | The current daily ATM withdrawal limit amount on the specified payment card. |
50000Error Codes
| Code | When it happens |
|---|---|
| 400 | The provided paymentCardId is malformed or refers to a card in an invalid state. |
| 401 | Token missing, expired, or invalid. |
| 403 | Insufficient permissions to view spend rules for the specified card. |
| 404 | No payment card found matching the provided paymentCardId. |
| 500 | Internal server error. |
Common Mistakes
- Omitting
paymentCardIdmay return a default or unexpected limit value rather than an error; always supply the card ID to retrieve a card-specific limit. - This endpoint is deprecated — integrate against the current spend rules endpoints for new development to avoid breakage when this endpoint is removed.
- The returned integer represents the limit amount in the smallest currency unit (e.g., cents); divide by 100 to display as a dollar amount.
Related Endpoints
GET /api/spendRules— Retrieve all spend rules configured on a payment cardPOST /api/spendRules/atmDailyLimit— Set or update the daily ATM withdrawal limit on a payment cardGET /api/spendRules/dailySpendLimit— Retrieve the overall daily spend limit for a payment card
Example
curl -X GET "https://api.banking.netevia.dev/api/spendRules/atmDailyLimit?paymentCardId=YOUR_CARD_ID" \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json"