Get Account by ID

Use the Get Account by ID endpoint to retrieve account information using exactly one of the following mutually exclusive lookup keys:

  • id + idType — a customer identifier such as SSN or driver license number, depending on which ID types your program supports.
  • externalCustomerId — a provider-supplied identifier.
  • customerId — Galileo's internal, unique customer identifier. Because client_id has a guaranteed 1:1 relationship with externalCustomerId, this is the deterministic way to resolve a single customer. When customerId is supplied, the response also returns that customer's externalCustomerId. If the customerId does not resolve to a customer, an Invalid customer account error is returned.

Providing more than one lookup key, or none at all, returns an invalid-parameter error.

This endpoint returns customer data such as enrollment status and onboarding date as well as a list of all accounts associated with the customer. Each account includes closureDate, a UTC timestamp (YYYY-MM-DD HH:MM:SS) indicating when the account was closed. closureDate is populated when the account status is closed (C), frozen (Z), or charged off (R); it is null for open accounts.

Status codes

See Global Response Statuses for status codes that are common across endpoints.

Form Data
string
required

Web service username, as provided by SoFi Tech Solutions.
Pattern: Max 50 characters
Example: "AbC123-9999"

string
required

Web service password, as provided by SoFi Tech Solutions.
Pattern: Max 15 characters
Example: "4sb62fh6w4h7w34g"

int32
required

Your unique provider identifier from SoFi Tech Solutions.
Pattern: Max 10 digits
Example: 9999

string
required
1 to 60

Supply a globally unique ID to identify this endpoint request ("transaction"). Might be used for idempotency. A UUID is preferred.
Pattern: Maximum 60 characters
Example: "9845dk-39fdk3fj3-4483483478"

string | null

Unique identifier for an account holder. This is the primary id that was passed in an enrollment endpoint request during account creation. The system converts all letters to lowercase.
Pattern: See Customer ID Types
Example: "123456789"

int32 | null
enum

Specifies the type of primary identifier in the id parameter. This parameter is required when id is populated. See the ID column in the Customer ID Types table for valid values.
Pattern: 1- or 2-digit integer
Example: 2

string | null
≤ 512

User-supplied identifier that is related to an external system.
Pattern: Max 512 characters: all ASCII characters
Example: "acv#-@45!sbsxm%-"

int32 | null
≥ 1

Galileo's internal, unique customer identifier. This is a deterministic 1:1 lookup key for a single customer. When provided, the response includes the customer's externalCustomerId.
Pattern: Positive integer
Example: 123456789

Headers
string
enum
Defaults to json

Use this header instead of the standard accept header to specify the response format.

Allowed:
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Response

Language
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
application/xml

© SoFi Technology Solutions, LLC 2026    Privacy Disclosure

All documentation, including but not limited to text, graphics, images, and any other content, are the exclusive property of SoFi Technology Solutions, LLC and are protected by copyright laws. These materials may not be reproduced, distributed, transmitted, displayed, or otherwise used without the prior written permission of SoFi Technology Solutions, LLC. Any unauthorized use or reproduction of these materials are expressly prohibited.