---
title: "Get Card"
method: POST
path: "/getCard"
tags: ["Accounts and Cards"]
---

# Get Card

`POST /getCard`

## Request

- Base URL: `api-{corename}.{env}.gpsrv.com/intserv/4.0/` (relative, and the document’s source URL is not known)
- URL: `api-{corename}.{env}.gpsrv.com/intserv/4.0/getCard`
- Auth: none declared

Use the Get Card endpoint to retrieve information for the specified card.

[block:callout]

{
"type": "info",
"title": "Note",
"body": "You can receive PCI-sensitive information only if your provider parameters permit it."
}
[/block]

## Request body `application/x-www-form-urlencoded`

- object
  - `apiLogin` string, required: Web service username, as provided by SoFi Tech Solutions. Pattern: Max 50 characters Example: `"AbC123-9999"`
  - `apiTransKey` string, required: Web service password, as provided by SoFi Tech Solutions. Pattern: Max 15 characters Example: `"4sb62fh6w4h7w34g"`
  - `transactionId` string, required: Supply a globally unique ID to identify this endpoint request ("transaction"). Might be used for <a href="ref:idempotency#endpoints-that-use-transactionid-for-idempotency" target="_blank">idempotency</a>.. A UUID is preferred. Pattern: Maximum 60 characters Example: `"9845dk-39fdk3fj3-4483483478"`
  - `accountNo` string, required: The <<glossary:PRN>>, <<glossary:PAN>> or <<glossary:CAD>> of the account. For card-specific endpoints such as this one, the CAD is preferred. Do not use the PRN if more than one card has ever been associated with this account. Pattern: PAN, PRN, or CAD Example: `"074103447228"`

## Response `default`

- object
  - `status_code` integer, nullable, required: The response status code. May return a string for some statuses.
  - `status` string, nullable, required: The condition of a process or response
  - `processing_time` number, float, nullable, required: The time elapsed in processing the transaction
  - `echo` object, nullable, required: A structure that contains transaction ID information
    - `transaction_id` string, nullable, required: An ID that represents an API transaction
    - `provider_timestamp` string, date-time, nullable, required: Store a related timestamp for reporting and troubleshooting purposes
    - `provider_transaction_id` string, nullable, required: Secondary transaction identifier (generated by a provider)
  - `system_timestamp` string, date-time, nullable, required: A system generated timestamp
  - `rtoken` string, nullable, required: A system-generated ID used for tracking
  - `errors` string[]: A list of errors generated while the request was processed
  - `response_data` object, nullable, required: A structure for the response data. It can be empty but usually will contain information.
    - `card_number` string, required: A 16-digit PAN. Set CINFI when PCI-compliant to see the unmasked PAN.
    - `expiry_date` string, date-time, nullable, required: _Supported data types: date, datetime, null, empty string._ Expiration date of the card (YYYY-MM-DD). (The card expires on the last day of the month [MM], not on the day [DD].) Set CINFD when PCI-compliant to see this value. Set CXPTM to include the time (YYYY-MM-DD hh:mm:ss). When this field is present inside the `embossed_cards` object, it is not nullable.
    - `card_security_code` string, nullable, required: The card verification value (CVV2) printed on the card. Set CINFS when PCI-compliant to see this value.
    - `status` string, required: The status of the card. See <a href="ref:api-reference-card-statuses" target="_blank">Card Statuses</a> for valid values.
    - `card_id` string, required: Also called the CAD, a system-generated identifier for a card
    - `external_card_id` string, nullable, required: User-specified external card identifier
    - `pmt_ref_no` string, required: Payment reference number (PRN). A 12-digit system-generated account number
    - `first_name` string, nullable, required: The first name on the customer profile
    - `middle_name` string, nullable, required: The middle name on the profile
    - `last_name` string, nullable, required: The last name on the profile
    - `encrypted_card_number` string, nullable, required: Encrypted PAN
    - `encrypted_expiry_date` string, nullable, required: Encrypted expiration date
    - `emboss_uuid` string, nullable, required: UUID for an emboss record that has been sent to the embosser. When this field is present outside the `embossed_cards` object, it contains the most recent emboss UUID.
    - `embossed_cards` object[], nullable, required: List of emboss records, one for each time the card was sent to the embosser. This object is populated only when emboss records exist.
      - `emboss_uuid` string, nullable, required: UUID for an emboss record that has been sent to the embosser. When this field is present outside the `embossed_cards` object, it contains the most recent emboss UUID.
      - `status` string, required: Emboss status. For valid values see the <a href="ref:api-reference-emboss-statuses" target="_blank">Emboss Statuses</a> enumeration.
      - `created_date` string, date-time, required: The date the card was created in the system (YYYY-MM-DD). Set CXPTM to include the time (YYYY-MM-DD hh:mm:ss).
      - `emboss_date` string, date, required: The date the card was sent to the embosser (YYYY-MM-DD)
      - `expiry_date` string, date-time, nullable, required: Expiration date of the card (YYYY-MM-DD). (The card expires on the last day of the month [MM], not on the day [DD].) Set CINFD when PCI-compliant to see this value. Set CXPTM to include the time (YYYY-MM-DD hh:mm:ss).
      - `product_id` string, nullable, required: Product ID of the card at the time of embossing
      - `shipping_type` string, required: The shipping type used to send the card to the cardholder: `standard` or `express`
      - `emboss_name` string, nullable, required: The cardholder name embossed on the card, from the emboss record.
      - `shipment_info` object, nullable: Most recent USPS IMb shipment tracking event for this card. Null when no tracking data exists.
        - `tracking_number` string, required: USPS Intelligent Mail barcode (IMb) tracking number.
        - `status` string, required: Current tracking status. One of: `SHIPPED`, `DELIVERY_SCAN`, `RTS` (Return to Sender).
        - `mailed_date` string, nullable: Date the card was mailed by G&D (YYYY-MM-DD).
        - `shipping_method` string, nullable: Shipping method as reported by G&D (e.g. `FirstClass`, `Priority`).
        - `scan_date` string, nullable: Date and time of the most recent delivery scan (YYYY-MM-DD HH:MM:SS).
        - `scan_location` string, nullable: City and state of the most recent scan event.
        - `scan_status` string, nullable: Human-readable scan status description (e.g. `Delivery Prep by MM/DD/YYYY`).
        - `expected_delivery_date` string, nullable: Estimated delivery date extracted from the scan status (YYYY-MM-DD).
    - `freeze_info` object, required
      - `status` string, required: Whether the card is `Frozen` or `Unfrozen`.
      - `start_date` string, date-time, nullable, required: Start date-time for the card freeze.
      - `end_date` string, date-time, nullable, required: End date-time for the card freeze.
    - `pin_fail_count` string, nullable, required: The number of failed-PIN attempts in the counter
    - `pin_fail_date` string, date-time, nullable, required: Date of the last failed PIN attempt
    - `spend_controls` object, required
      - `available_credit` string, nullable, required: The amount available to be charged to a credit card
      - `single_use` string, nullable, required: Whether this is an alias credit card number, exhausted after one use
      - `credit_limit` string, nullable, required: The maximum outstanding balance allowed on a credit card
    - `ssn` string, nullable: The Social Security Number associated with the account. Set CINFN when PCI-compliant to see this value.
    - `card_format` string, nullable: Whether the card is `Physical` or `Virtual`.
    - `card_type` string, nullable: Whether the card account is `Credit` or `Debit`.
    - `activation_date` string, nullable: Date and time the card was activated (YYYY-MM-DD HH:MM:SS). Null if the card has not yet been activated.
    - `address_1` string, nullable: First line of the account holder's address
    - `address_2` string, nullable: Second line of the account holder's address
    - `city` string, nullable: Account holder's city
    - `state` string, nullable: Account holder's state
    - `postal_code` string, nullable: Account holder's postal code
    - `country_code` string, nullable: Identifies the account holder's country. ISO 3166 numeric.
    - `preferred_name` string, nullable: The preferred name on a profile, to appear on cards and CST profiles. The preferred name feature is currently in development. Additional configuration is required. Contact SoFi Tech Solutions if you are interested in this feature.

## Changes

- **2026-11-03** `1ede7567a879`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/galileo-ft/apis/program-api/changes/getCard/post.md)

---

[API](https://skmtc.dev/galileo-ft/apis/program-api.md) - [All operations](https://skmtc.dev/galileo-ft/apis/program-api/llms.txt) - [OpenAPI document](https://skmtc.dev/galileo-ft/apis/program-api/revisions/1ede7567a879?raw)