> ## Documentation Index > Fetch the complete documentation index at: https://docs.light.inc/llms.txt > Use this file to discover all available pages before exploring further. # Get card transaction > Returns a card transaction by ID ## OpenAPI ````yaml /openapi-public.json get /v1/card-transactions/{cardTransactionId} openapi: 3.0.1 info: title: Light API version: 1.0.0 servers: [] security: - apiKeyAuth: [] - bearerAuth: [] paths: /v1/card-transactions/{cardTransactionId}: get: tags: - v1 - Card Transactions summary: Get card transaction description: Returns a card transaction by ID operationId: getCardTransaction parameters: - name: cardTransactionId in: path required: true schema: type: string format: uuid responses: default: description: default response content: application/json;charset=UTF-8: schema: $ref: '#/components/schemas/ExternalBffCardTransactionV1Model' components: schemas: ExternalBffCardTransactionV1Model: type: object properties: id: type: string format: uuid companyId: type: string format: uuid companyEntityId: type: string format: uuid companyEntityName: type: string cardBalanceAccountId: type: string format: uuid cardBalanceAccountLabel: type: string cardId: type: string format: uuid cardVendorId: type: string format: uuid cardVendorAvatarUrl: type: string cardVendorName: type: string cardOwnerName: type: string cardOwnerId: type: string format: uuid cardLastFour: type: string originalAmount: type: integer format: int64 originalCurrency: type: string example: USD amount: type: integer format: int64 currency: type: string example: USD direction: type: string description: >- ⚠️ This enum is not exhaustive; new values may be added in the future. enum: - DEBIT - CREDIT transactionReason: type: string description: >- ⚠️ This enum is not exhaustive; new values may be added in the future. enum: - ACCOUNT_NOT_ACTIVE - AMOUNT_LIMIT_EXCEEDED - APPROVAL_EXPIRED - APPROVED - AUTHENTICATION_FAILED - AUTHENTICATION_REQUIRED - BALANCE_ACCOUNT_BLOCKED_BY_RULE - CALL_REFERRAL - CANCELLED - CARD_BLOCKED - CARD_CAPTURED - CARD_EXPIRED - CARD_LOST_OR_STOLEN - CARD_RESTRICTED - CARD_VERIFICATION_FAILED - CASHBACK_LIMIT_EXCEEDED - CONTACTLESS_FALLBACK - CONTACTLESS_LIMIT_REACHED - COUNTERPARTY_ACCOUNT_UNAVAILABLE - COUNTERPARTY_ADDRESS_REQUIRED - COUNTERPARTY_BANK_UNAVAILABLE - CRYPTOGRAPHIC_FAILURE - DECLINED - DECLINED_BY_BAP_VALIDATION - DECLINED_BY_TRANSACTION_RULE - DECLINED_NON_GENERIC - DOMESTIC_DEBIT_NOT_ALLOWED - DO_NOT_HONOR - DUPLICATE_TRANSMISSION - FORMAT_ERROR - FRAUD - HONOR_WITH_ID - INSUFFICIENT_FUNDS - INTERNAL_TIMEOUT - INVALID_ACCOUNT - INVALID_AMOUNT - INVALID_AUTHORIZATION_LIFECYCLE - INVALID_CARD - INVALID_ISSUER - INVALID_MERCHANT - INVALID_TRANSACTION - ISSUER_SUSPECTED_FRAUD - MOBILE_PIN_REQUIRED - NOT_SUBMITTED - NO_ACCOUNT_OF_TYPE - OTHER - PARTIALLY_APPROVED - PENDING - PIN_INVALID - PIN_NOT_CHANGED - PIN_REQUIRED - PIN_TRIES_EXCEEDED - PIN_VALIDATION_NOT_POSSIBLE - PROVIDER_ERROR - PURCHASE_AMOUNT_ONLY_NO_CASHBACK - REFUSED_BY_COUNTERPARTY_BANK - REFUSED_BY_CUSTOMER - REVOCATION_OF_AUTH - ROUTE_NOT_FOUND - SCHEME_ADVICE - SECURITY_VIOLATION - TRANSACTION_NOT_PERMITTED - TRANSFER_INSTRUMENT_NOT_FOUND - TRANSFER_NOT_SUPPORTED - UNKNOWN - WITHDRAWAL_AMOUNT_EXCEEDED - WITHDRAWAL_COUNT_EXCEEDED purchaseType: type: string description: >- ⚠️ This enum is not exhaustive; new values may be added in the future. enum: - ATM - BALANCE_INQUIRY - ECOMMERCE - POS - RECURRING - UNKNOWN - OTHER status: type: string description: >- ⚠️ This enum is not exhaustive; new values may be added in the future. enum: - AUTHORIZED - DECLINED - CAPTURED - REFUNDED - VOIDED - POSTED type: type: string description: >- ⚠️ This enum is not exhaustive; new values may be added in the future. enum: - PAYMENT - REFUND - OTHER merchant: $ref: '#/components/schemas/ExternalCardTransactionMerchantV1Model' receiptDocumentKey: type: string lines: type: array items: $ref: '#/components/schemas/ExternalBffCardTransactionLineV1Model' failureContext: $ref: '#/components/schemas/ExternalUiClientExceptionV1Model' description: type: string performedAt: type: string format: date-time exportedAt: type: string format: date-time createdAt: type: string format: date-time updatedAt: type: string format: date-time customProperties: type: array items: $ref: '#/components/schemas/ExternalCustomPropertyV1Model' description: List of records for the current page ExternalCardTransactionMerchantV1Model: type: object properties: name: type: string cleanName: type: string country: type: string description: >- ⚠️ This enum is not exhaustive; new values may be added in the future. enum: - UNDEFINED - AC - AD - AE - AF - AG - AI - AL - AM - AN - AO - AQ - AR - AS - AT - AU - AW - AX - AZ - BA - BB - BD - BE - BF - BG - BH - BI - BJ - BL - BM - BN - BO - BQ - BR - BS - BT - BU - BV - BW - BY - BZ - CA - CC - CD - CF - CG - CH - CI - CK - CL - CM - CN - CO - CP - CR - CS - CU - CV - CW - CX - CY - CZ - DE - DG - DJ - DK - DM - DO - DZ - EA - EC - EE - EG - EH - ER - ES - ET - EU - EZ - FI - FJ - FK - FM - FO - FR - FX - GA - GB - GD - GE - GF - GG - GH - GI - GL - GM - GN - GP - GQ - GR - GS - GT - GU - GW - GY - HK - HM - HN - HR - HT - HU - IC - ID - IE - IL - IM - IN - IO - IQ - IR - IS - IT - JE - JM - JO - JP - KE - KG - KH - KI - KM - KN - KP - KR - KW - KY - KZ - LA - LB - LC - LI - LK - LR - LS - LT - LU - LV - LY - MA - MC - MD - ME - MF - MG - MH - MK - ML - MM - MN - MO - MP - MQ - MR - MS - MT - MU - MV - MW - MX - MY - MZ - NA - NC - NE - NF - NG - NI - NL - 'NO' - NP - NR - NT - NU - NZ - OM - PA - PE - PF - PG - PH - PK - PL - PM - PN - PR - PS - PT - PW - PY - QA - RE - RO - RS - RU - RW - SA - SB - SC - SD - SE - SF - SG - SH - SI - SJ - SK - SL - SM - SN - SO - SR - SS - ST - SU - SV - SX - SY - SZ - TA - TC - TD - TF - TG - TH - TJ - TK - TL - TM - TN - TO - TP - TR - TT - TV - TW - TZ - UA - UG - UK - UM - US - UY - UZ - VA - VC - VE - VG - VI - VN - VU - WF - WS - XI - XU - XK - YE - YT - YU - ZA - ZM - ZR - ZW zipcode: type: string id: type: string mcc: type: string acquirerId: type: string logoUrl: type: string ExternalBffCardTransactionLineV1Model: type: object properties: id: type: string format: uuid transactionId: type: string format: uuid companyId: type: string format: uuid accountId: type: string format: uuid accountLabel: type: string taxCodeId: type: string format: uuid taxCodeLabel: type: string costCenterId: type: string format: uuid costCenterName: type: string amount: type: integer format: int64 netAmount: type: integer format: int64 description: type: string createdAt: type: string format: date-time updatedAt: type: string format: date-time customProperties: type: array items: $ref: '#/components/schemas/ExternalCustomPropertyV1Model' amortizationTemplateId: type: string format: uuid amortizationStartDate: type: string format: date amortizationEndDate: type: string format: date ExternalUiClientExceptionV1Model: type: object properties: name: type: string description: The error name type: type: string description: >- The error type ⚠️ This enum is not exhaustive; new values may be added in the future. nullable: false deprecated: false enum: - BAD_REQUEST - UNAUTHORIZED - FORBIDDEN - NOT_FOUND - CONFLICT - UNPROCESSABLE_CONTENT errors: type: array description: List of errors providing details about what went wrong items: $ref: '#/components/schemas/ExternalUiClientExceptionErrorV1Model' description: Failure context when vendor onboarding fails. nullable: true ExternalCustomPropertyV1Model: type: object properties: groupId: type: string description: ID of the custom property group format: uuid groupInternalName: type: string description: Internal name of the custom property group values: type: array description: >- List of values. Note that this will be a single value unless the group input type supports multiple values items: $ref: '#/components/schemas/ExternalCustomPropertyValueV1Model' description: Custom properties set on the vendor. nullable: true ExternalUiClientExceptionErrorV1Model: type: object properties: type: type: string description: A string code identifying the error type message: type: string description: A human-readable message providing more details about the error path: type: array description: >- Optional path of the error when the error is for a specific field. Used mostly on BAD_REQUEST errors, that path will match the field name on the request object nullable: true items: type: string description: >- Optional path of the error when the error is for a specific field. Used mostly on BAD_REQUEST errors, that path will match the field name on the request object nullable: true context: type: object additionalProperties: type: object description: >- Optional context providing additional information about the error. This can include any relevant data that might help in understanding or resolving the error nullable: true description: >- Optional context providing additional information about the error. This can include any relevant data that might help in understanding or resolving the error nullable: true description: List of errors providing details about what went wrong ExternalCustomPropertyValueV1Model: type: object properties: id: type: string description: Unique identifier for the object format: uuid groupId: type: string description: ID of the custom property group format: uuid groupInternalName: type: string description: Internal name of the custom property group companyId: type: string description: ID of the company format: uuid internalName: type: string description: Internal name of the custom property value label: type: string description: Label of the custom property value context: type: string description: Context/description of the custom property value nullable: true createdAt: type: string description: Timestamp when the custom property value was created format: date-time updatedAt: type: string description: Timestamp when the custom property value was last updated format: date-time description: >- List of values. Note that this will be a single value unless the group input type supports multiple values securitySchemes: apiKeyAuth: type: apiKey description: >- Basic authentication header of the form **Basic** ****, where **** is your api key. name: Authorization in: header bearerAuth: type: http scheme: bearer bearerFormat: JWT ````