---
title: "Get Account Cards"
method: POST
path: "/getAccountCards"
tags: ["Accounts and Cards"]
---

# Get Account Cards

`POST /getAccountCards`

## 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/getAccountCards`
- Auth: none declared

Use the Get Account Cards endpoint to retrieve a customer's profile information along with all accounts and cards that are associated with that customer, regardless of status.

[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>> or <<glossary:PAN>> of the account. Pattern: PAN or PRN Example: `"074103447228"`
  - `includeRelated` 0 | 1: Whether to return data for all accounts that share the same cardholder (`client_id`). - `0` &mdash; Retrieve only the cards for the specified account. - `1` or _blank_ &mdash; Retrieve all accounts and cards that share the same `client_id`. Pattern: Integer Example: `0`

## 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.
    - `customer` object, required
      - `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
      - `address_1` string, nullable, required: First line of the customer address
      - `address_2` string, nullable, required: Second line of the customer address
      - `city` string, nullable, required: City of the address
      - `state` string, nullable, required: State of the address
      - `postal_code` string, nullable, required: Postal code of the address
      - `country_code` string, nullable, required: ISO 3166 numeric country code
      - `phone` string, nullable, required: The home phone number
      - `mobile_phone` string, nullable, required: The mobile phone number on a profile
      - `mobile_phone_country_code` string, nullable: The country code for all phone numbers
      - `email` string, nullable: The email address on a profile
      - `ship_to_address` object, required
        - `address_1` string, nullable, required: First line of the ship-to address where to mail the card
        - `address_2` string, nullable, required: Second line of the address.
        - `city` string, nullable, required: City of the ship-to address
        - `state` string, nullable, required: State of the ship-to address
        - `postal_code` string, nullable, required: Postal code of the ship-to address
        - `country_code` string, nullable, required: ISO 3166 numeric country code of the ship-to address
      - `express_mail` string, nullable, required: Whether the profile uses express-mail service
      - `occupation` string, nullable, required: The occupation of the person in the profile
      - `income_source` string, nullable, required: How the person on a profile earns income
      - `related_accounts` object[], required: List of related accounts
        - `active` string, required: Whether the account is active: `Y` or `N`
        - `application_date` string, date, nullable, required: The date of the application for account creation (YYYY-MM-DD).
        - `bill_cycle_day` string, nullable, required: Day of the month that the customer is billed
        - `galileo_account_number` string, nullable, required: System-generated account number, also known as balance ID
        - `group_id` string, nullable, required: Integer value used for tracking the location (store, entity, etc.) where the customer was acquired
        - `pmt_ref_no` string, nullable, required: Payment reference number (PRN), a 12-digit system-generated account number
        - `product_id` string, nullable, required: A unique product identifier from SoFi Tech Solutions
        - `start_date` string, date, nullable, required: Date the account was first activated (`status: N`) (YYYY-MM-DD)
        - `status` string, nullable, required: The status of the account. See <a href="ref:api-reference-account-statuses" target="_blank">Account Statuses</a> for valid values.
      - `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.
    - `accounts` object[], required: List of accounts
      - `active` string, required: Whether the account is active: `Y` or `N`
      - `application_date` string, date, nullable, required: The date of the application for account creation (YYYY-MM-DD).
      - `bill_cycle_day` string, nullable, required: Day of the month that the customer is billed
      - `galileo_account_number` string, nullable, required: System-generated account number, also known as the balance ID
      - `group_id` string, nullable, required: Integer value used for tracking the location (store, entity, etc.) where the customer was acquired
      - `pmt_ref_no` string, nullable, required: Payment reference number (PRN). A 12-digit system-generated account number
      - `product_id` string, nullable, required: A unique product identifier from SoFi Tech Solutions
      - `start_date` string, date, nullable, required: Date the account was first activated (`status: N`) (YYYY-MM-DD).
      - `status` string, nullable, required: The status of the account. See <a href="ref:api-reference-account-statuses" target="_blank">Account Statuses</a> for valid values.
      - `cards` object[], required: List of cards associated with the PRN
        - `card_id` string, nullable, required: Also called the CAD, a system-generated identifier for a card
        - `card_number` string, required: A 16-digit PAN. Set CINFI when PCI-compliant to see the unmasked PAN.
        - `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.
        - `card_status` string, required: A single-letter code for the status of the card. See <a href="ref:api-reference-card-statuses" target="_blank">Card Statuses</a> for valid values.
        - `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).
        - `external_card_id` string, nullable, required: User-specified external card identifier
        - `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
        - `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.
        - `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.
          - `created_date` string, date-time, nullable, required: _Supported data types: date, datetime, null, empty string._ 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_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.
          - `emboss_date` string, date, nullable, required: The date the card was sent to the embosser (YYYY-MM-DD)
          - `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).
          - `product_id` string, nullable, required: Product ID of card at the time of embossing
          - `status` string, nullable, required: Emboss status. For valid values see the <a href="ref:api-reference-emboss-statuses" target="_blank">Emboss Statuses</a> enumeration.
          - `shipping_type` string, nullable, 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.
        - `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.

## Changes

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

[Operation history](https://skmtc.dev/galileo-ft/apis/program-api/changes/getAccountCards/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)
