---
title: "Create a Card Validation"
method: POST
path: "/card_validations"
---

# Create a Card Validation

`POST /card_validations`

## Request body

- CreateACardValidationParameters
  - `account_id` string, required — The identifier of the Account from which to send the validation.
  - `card_token_id` string, required — The Increase identifier for the Card Token that represents the card number you're validating.
  - `cardholder_first_name` string — The cardholder's first name.
  - `cardholder_last_name` string — The cardholder's last name.
  - `cardholder_middle_name` string — The cardholder's middle name.
  - `cardholder_postal_code` string — The postal code of the cardholder's address.
  - `cardholder_street_address` string — The cardholder's street address.
  - `merchant_category_code` string, required — A four-digit code (MCC) identifying the type of business or service provided by the merchant.
  - `merchant_city_name` string, required — The city where the merchant (typically your business) is located.
  - `merchant_name` string, required — The merchant name that will appear in the cardholder’s statement descriptor. Typically your business name.
  - `merchant_postal_code` string, required — The postal code for the merchant’s (typically your business’s) location.
  - `merchant_state` string, required — The U.S. state where the merchant (typically your business) is located.

## Response `200`

Card Validation

- CardValidation — Card Validations are used to validate a card and its cardholder before sending funds to or pulling funds from a card.
  - `acceptance` object, nullable, required — If the validation is accepted by the recipient bank, this will contain supplemental details.
    - `accepted_at` string, date-time, required — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the validation was accepted by the issuing bank.
    - `authorization_identification_response` string, required — The authorization identification response from the issuing bank.
    - `card_verification_value2_result` 'match' | 'no_match', nullable, required — The result of the Card Verification Value 2 match.
    - `cardholder_first_name_result` 'match' | 'no_match' | 'partial_match', nullable, required — The result of the cardholder first name match.
    - `cardholder_full_name_result` 'match' | 'no_match' | 'partial_match', nullable, required — The result of the cardholder full name match.
    - `cardholder_last_name_result` 'match' | 'no_match' | 'partial_match', nullable, required — The result of the cardholder last name match.
    - `cardholder_middle_name_result` 'match' | 'no_match' | 'partial_match', nullable, required — The result of the cardholder middle name match.
    - `cardholder_postal_code_result` 'match' | 'no_match', nullable, required — The result of the cardholder postal code match.
    - `cardholder_street_address_result` 'match' | 'no_match', nullable, required — The result of the cardholder street address match.
    - `network_transaction_identifier` string, nullable, required — A unique identifier for the transaction on the card network.
  - `account_id` string, required — The identifier of the Account from which to send the validation.
  - `card_token_id` string, required — The ID of the Card Token that was used to validate the card.
  - `cardholder_first_name` string, nullable, required — The cardholder's first name.
  - `cardholder_last_name` string, nullable, required — The cardholder's last name.
  - `cardholder_middle_name` string, nullable, required — The cardholder's middle name.
  - `cardholder_postal_code` string, nullable, required — The postal code of the cardholder's address.
  - `cardholder_street_address` string, nullable, required — The cardholder's street address.
  - `created_at` string, date-time, required — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the validation was created.
  - `created_by` object, nullable, required — What object created the validation, either via the API or the dashboard.
    - `api_key` object, nullable — If present, details about the API key that created the transfer.
      - `description` string, nullable, required — The description set for the API key when it was created.
    - `category` 'api_key' | 'oauth_application' | 'user', required — The type of object that created this transfer.
    - `oauth_application` object, nullable — If present, details about the OAuth Application that created the transfer.
      - `name` string, required — The name of the OAuth Application.
    - `user` object, nullable — If present, details about the User that created the transfer.
      - `email` string, required — The email address of the User.
  - `decline` object, nullable, required — If the validation is rejected by the card network or the destination financial institution, this will contain supplemental details.
    - `declined_at` string, date-time, required — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the validation was declined.
    - `network_transaction_identifier` string, nullable, required — A unique identifier for the transaction on the card network.
    - `reason` 'do_not_honor' | 'activity_count_limit_exceeded' | 'refer_to_card_issuer' | 'refer_to_card_issuer_special_condition' | 'invalid_merchant' | 'pick_up_card' | 'error' | 'pick_up_card_special' | 'invalid_transaction' | 'invalid_amount' | 'invalid_account_number' | 'no_such_issuer' | 're_enter_transaction' | 'no_credit_account' | 'pick_up_card_lost' | 'pick_up_card_stolen' | 'closed_account' | 'insufficient_funds' | 'no_checking_account' | 'no_savings_account' | 'expired_card' | 'transaction_not_permitted_to_cardholder' | 'transaction_not_allowed_at_terminal' | 'transaction_not_supported_or_blocked_by_issuer' | 'suspected_fraud' | 'activity_amount_limit_exceeded' | 'restricted_card' | 'security_violation' | 'transaction_does_not_fulfill_anti_money_laundering_requirement' | 'blocked_by_cardholder' | 'blocked_first_use' | 'credit_issuer_unavailable' | 'negative_card_verification_value_results' | 'issuer_unavailable' | 'financial_institution_cannot_be_found' | 'transaction_cannot_be_completed' | 'duplicate_transaction' | 'system_malfunction' | 'additional_customer_authentication_required' | 'surcharge_amount_not_permitted' | 'decline_for_cvv2_failure' | 'stop_payment_order' | 'revocation_of_authorization_order' | 'revocation_of_all_authorizations_order' | 'unable_to_locate_record' | 'file_is_temporarily_unavailable' | 'incorrect_pin' | 'allowable_number_of_pin_entry_tries_exceeded' | 'unable_to_locate_previous_message' | 'pin_error_found' | 'cannot_verify_pin' | 'verification_data_failed' | 'surcharge_amount_not_supported_by_debit_network_issuer' | 'cash_service_not_available' | 'cashback_request_exceeds_issuer_limit' | 'transaction_amount_exceeds_pre_authorized_approval_amount' | 'transaction_does_not_qualify_for_visa_pin' | 'offline_declined' | 'unable_to_go_online' | 'valid_account_but_amount_not_supported' | 'invalid_use_of_merchant_category_code_correct_and_reattempt' | 'card_authentication_failed', required — The reason why the validation was declined.
  - `id` string, required — The Card Validation's identifier.
  - `idempotency_key` string, nullable, required — The idempotency key you chose for this object. This value is unique across Increase and is used to ensure that a request is only processed once. Learn more about [idempotency](https://increase.com/documentation/idempotency-keys).
  - `merchant_category_code` string, required — A four-digit code (MCC) identifying the type of business or service provided by the merchant.
  - `merchant_city_name` string, required — The city where the merchant (typically your business) is located.
  - `merchant_name` string, required — The merchant name that will appear in the cardholder’s statement descriptor. Typically your business name.
  - `merchant_postal_code` string, required — The postal code for the merchant’s (typically your business’s) location.
  - `merchant_state` string, required — The U.S. state where the merchant (typically your business) is located.
  - `route` 'visa' | 'mastercard' | 'pulse', required — The card network route used for the validation.
  - `status` 'requires_attention' | 'pending_submission' | 'submitted' | 'complete' | 'declined', required — The lifecycle status of the validation.
  - `submission` object, nullable, required — After the validation is submitted to the card network, this will contain supplemental details.
    - `retrieval_reference_number` string, required — A 12-digit retrieval reference number that identifies the validation. Usually a combination of a timestamp and the trace number.
    - `submitted_at` string, date-time, required — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the validation was submitted to the card network.
    - `trace_number` string, required — A 6-digit trace number that identifies the validation within a short time window.
  - `type` 'card_validation', required — A constant representing the object's type. For this resource it will always be `card_validation`.

## Other responses

- `4XX` — Error
- `5XX` — Error

---

[API](https://skmtc.net/increase/apis/increase-api-2.md) · [All operations](https://skmtc.net/increase/apis/increase-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/increase/increase-api-2/versions/e968bcd4dcf9/schema)