> ## Documentation Index > Fetch the complete documentation index at: https://docs.synctera.com/llms.txt > Use this file to discover all available pages before exploring further. # Get External Card > Get External Card ## OpenAPI ````yaml openapi-v1.json get /external_cards/{external_card_id} openapi: 3.0.3 info: description: >- This is the official reference documentation for Synctera APIs. If you need something specific or have a question, contact us.

license: name: Apache 2.0 url: https://www.apache.org/licenses/LICENSE-2.0.html title: Synctera API version: 1.181.0 servers: - description: Production url: https://api.synctera.com/v1 - description: Sandbox (no real world financial impact) url: https://api-sandbox.synctera.com/v1 security: - bearerAuth: [] tags: - description: | Requests to create and manage Rewards name: Rewards (beta) - description: Requests to generate simulated webhooks name: Card Webhook Simulations - description: >- Testing endpoints to simulate in-store cash deposits. Available in sandbox environments only. name: In-Store Cash Deposit Simulations - description: Create and manage spending controls name: Spend Controls (beta) - description: Rates name: Rates - description: Requests to create and manage webhooks name: Webhooks - description: Tenant Config name: Tenant Config - description: FDX authentication and data transfer using Plaid Core Exchange name: Plaid Core Exchange (beta) - description: Create and manage disputes name: Disputes - description: Requests to simulate card payments name: Card Simulations - description: | Manage fee products and fee configs for automated fee collection name: Fee Products - description: Apple Pay APIs name: Apple Pay - description: Lending Config name: Lending Config - description: Payments related to lending accounts name: Payments - description: Manage negative balance processes name: Negative Balance - description: Configuration for mapping LoanPro events to Payola transaction parameters name: LoanPro Transaction Event Config - description: Requests to generate simulated transactions name: Cash Transaction Simulations (alpha) - description: Create and manage transactions name: Transactions (beta) - description: Autopay payment records for billing periods name: Autopays - description: Create and manage accounts name: Accounts - description: | Requests to create and manage batch payments name: Batch Payments (alpha) - description: Billing rates name: Billing Rates - description: Bank Delinquency Configuration name: Bank Delinquency Configuration - description: >- Rules that map a posted payment transaction (bank/partner + transaction attributes) to a regulatory payment code. NULL match columns act as wildcards. name: Payment Code Configuration - description: Create and manage Synctera Pay templates name: SyncteraPay - description: | Manage reward products and reward configs for automated cashback rewards name: Reward Products - description: Requests to create and manage card disputes name: Card Disputes - description: >- Per bank/partner account-type mapping to FFIEC collateral codes used for regulatory call report furnishment. name: Collateral Code Configuration - description: Bulk card issuance name: Bulk Issuance - description: Autopay configuration management for lending accounts name: Autopay Configs - description: Request to create and manage exclusions name: Statements - description: Create and manage barcodes for in-store cash deposits name: In-Store Cash Deposits - description: Customer Service Details for disputes and billing inquiries name: Customer Service Details - description: Create a credit application. name: Applications (beta) - description: Requests to generate simulated transactions name: Card Transaction Simulations - description: Billing period summaries name: Billing Period Summaries - description: Requests to issue and manage cards name: Cards - description: Push and pull from cards name: External Cards - description: | Requests to create and manage fees name: Fees (beta) paths: /external_cards/{external_card_id}: summary: Get External Card description: | External Card get: tags: - External Cards summary: Get External Card description: | Get External Card operationId: getExternalCard parameters: - $ref: '#/components/parameters/external_card_id' responses: '200': content: application/json: schema: $ref: '#/components/schemas/external_card_response' description: External Card details '400': $ref: '#/components/responses/bad_request' '401': $ref: '#/components/responses/unauthorized' '403': $ref: '#/components/responses/forbidden' '422': $ref: '#/components/responses/unprocessable_entity' '500': $ref: '#/components/responses/internal_server_error' components: parameters: external_card_id: description: The unique identifier of an external card in: path name: external_card_id required: true schema: example: 7d943c51-e4ff-4e57-9558-08cab6b963c7 format: uuid type: string schemas: external_card_response: properties: bin: description: Bank Identification Number type: string creation_time: example: '2010-05-06T12:23:34.321Z' format: date-time type: string currency: $ref: '#/components/schemas/currency_code' customer_id: $ref: '#/components/schemas/customer_id1' deletion_time: example: '2010-05-06T12:23:34.321Z' format: date-time type: string expiration_month: description: Card expiration month example: '06' type: string expiration_year: description: Card expiration year example: '25' type: string id: description: Unique identifier type: string issuer: description: Name of the issuing financial institution type: string last_four: description: The last four digits of the card PAN example: '1234' type: string last_updated_time: example: '2010-05-06T12:23:34.321Z' format: date-time type: string name: $ref: '#/components/schemas/cardholder_name' payment_account_reference: $ref: '#/components/schemas/payment_account_reference' status: $ref: '#/components/schemas/external_card_status' tenant: $ref: '#/components/schemas/tenant_id' verifications: $ref: '#/components/schemas/external_card_verifications' required: - currency - customer_id - expiration_month - expiration_year - id - last_four - name - status - tenant type: object currency_code: description: ISO 4217 Alpha-3 currency code example: USD maxLength: 3 minLength: 3 type: string customer_id1: description: The unique identifier of a customer example: 7d943c51-e4ff-4e57-9558-08cab6b963c7 format: uuid type: string cardholder_name: description: The cardholder name example: Jean Valjean type: string payment_account_reference: description: >- A unique identifier associated with a specific cardholder PAN and its affiliated tokens maxLength: 29 minLength: 29 type: string external_card_status: description: Status of an External Card enum: - ACTIVE - DELETED - SUSPENDED type: string tenant_id: description: | The id of the tenant containing the resource. example: abcdef_ghijkl type: string external_card_verifications: allOf: - properties: state: enum: - FAILED - SUCCEEDED type: string required: - state type: object - $ref: '#/components/schemas/external_card_verification_details' description: >- Verify card passed AVS and CVV checks and if it able to perform PUSH/PULL transfers. required: - address_verification_result - cvv2_result - name_verification_result - pull_enabled - push_enabled type: object error: description: Synctera error responses in API v1 implement a custom error schema. properties: code: description: > A machine-readable string that identifies the error for programmatic use. example: BAD_REQUEST_BODY type: string detail: description: | A human-readable string explaining this particular error. example: 'Missing required fields: first_name, dob' type: string status: description: HTTP status code for this response example: 400 type: integer title: Synctera error response type: object external_card_verification_details: properties: address_verification_result: description: | Address verification results Status | Description --- | --- VERIFIED | AVS verified NOT_VERIFIED | AVS not verified ADDRESS_MISMATCH | ZIP code match, address no match ZIP_MISMATCH | Address match, ZIP code no match ADDRESS_AND_ZIP_MISMATCH | Address and ZIP code no match enum: - ADDRESS_AND_ZIP_MISMATCH - ADDRESS_MISMATCH - NOT_VERIFIED - VERIFIED - ZIP_MISMATCH type: string cvv2_result: description: | Card Verification Value results Status | Description --- | --- VERIFIED | CVV and expiration date verified NOT_VERIFIED | CVV and expiration date not verified CVV_MISMATCH | Either CVV or expiration date does not match NOT_SUPPORTED | Issuer does not participate in CVV2 service enum: - CVV_MISMATCH - NOT_SUPPORTED - NOT_VERIFIED - VERIFIED type: string name_verification_result: description: > Issuer cardholder name verification result with Account Name Inquiry (ANI) service The result of verifying the cardholder name against the name on file at the issuing institution. If this fails, it means the issuing institution has a different person's name on file as the cardholder. Status | Description --- | --- VERIFIED | ANI Name verified NOT_VERIFIED | ANI Name not verified NOT_SUPPORTED | Issuer does not participate in ANI service NAME_MISMATCH | ANI Name does not match enum: - NAME_MISMATCH - NOT_SUPPORTED - NOT_VERIFIED - VERIFIED type: string pull_details: $ref: '#/components/schemas/pull_details' pull_enabled: description: Indicates if the card is able to perform PULL transfers. type: boolean push_details: $ref: '#/components/schemas/push_details' push_enabled: description: Indicates if the card is able to perform PUSH transfers. type: boolean type: object pull_details: description: Additional PULL transfer details properties: country: $ref: '#/components/schemas/country_code' currency: $ref: '#/components/schemas/currency_code' network: description: Payment network type: string product_type: $ref: '#/components/schemas/external_card_product_type' regulated: description: Exemption status from debit card interchange fee standards type: boolean type: object push_details: description: Additional PUSH transfer details properties: country: $ref: '#/components/schemas/country_code' currency: $ref: '#/components/schemas/currency_code' funds_availability: $ref: '#/components/schemas/external_cards_funds_availability' network: description: Payment network type: string product_type: $ref: '#/components/schemas/external_card_product_type' regulated: description: Exemption status from debit card interchange fee standards type: boolean type: object country_code: description: ISO-3166-1 Alpha-2 country code example: US maxLength: 2 minLength: 2 type: string external_card_product_type: description: Product type enum: - CREDIT - DEBIT - PREPAID type: string external_cards_funds_availability: description: | Estimated timeframe of funds availability Value | Description --- | --- NOW | Within 30 minutes NEXT | Within the next business day FEW | Within a few business days enum: - FEW - NEXT - NOW type: string responses: bad_request: content: application/json: schema: $ref: '#/components/schemas/error' description: Bad request unauthorized: content: application/json: schema: $ref: '#/components/schemas/error' description: Unauthorized forbidden: content: application/json: schema: $ref: '#/components/schemas/error' description: Forbidden unprocessable_entity: content: application/json: schema: $ref: '#/components/schemas/error' description: Unprocessable entity internal_server_error: content: application/json: schema: $ref: '#/components/schemas/error' description: Internal server error securitySchemes: bearerAuth: bearerFormat: api_key scheme: bearer type: http ````