Get Account Overview

post https://api-{corename}.{env}.gpsrv.com/intserv/4.0/getAccountOverview

Use the Get Account Overview endpoint to retrieve the combined response data from several other endpoints. Best practice is to use this endpoint to retrieve the data for a customer's landing page or other similar display.

Data sets returned by Get Account Overview:

General account information (balance, status, application date)
Cardholder profile data
Posted transactions
Pending card authorizations
Pending fees (generally because of insufficient funds)
Savings interest data, applicable only if an associated savings account exists; otherwise, a unary savings_interest element is returned.

📘
Note
Transactions created by Program API endpoints (such as Create Payment, Create Adjustment, and Create Account Transfer) are not present in this endpoint's response for several seconds after creation.

Recipes

Get Account Overview response, primary and secondary accounts

Open Recipe

Form Data

apiLogin

string

required

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

apiTransKey

string

required

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

providerId

int32

required

Galileo-issued provider identifier.
Pattern: Max 10 digits
Example: 9999

transactionId

string

required

1 to 60

A unique provider-generated ID to identify this API call. A UUID is preferred.
Pattern: 60 characters or less
Example: "9845dk-39fdk3fj3-4483483478"

accountNo

string

required

The PRN or PAN of the account.
Pattern: PAN or PRN
Example: "074103447228"

startDate

date | null

Defaults to null

The beginning date for the date range, either a date or a date-time.
Pattern: YYYY-MM-DD or YYYY-MM-DD hh:mm:ss
Example: "2016-01-01"

endDate

date | null

Defaults to null

The end date for the date range, either a date or a date-time. Must be equal to or later than startDate. Max 1098 days (~3 years) after startDate.
Pattern: YYYY-MM-DD or YYYY-MM-DD hh:mm:ss
Example: "2016-01-01"

Headers

response-content-type

string

Defaults to json

Use xml or json to specify the type of response. The default value is xml. Use this instead of the standard accept header.

Response

Response body

object

status_code

int32 | null

required

The response status code. May return a string for some statuses.

status

string | null

required

The condition of a process or response

processing_time

float | null

required

The time elapsed in processing the transaction

echo

object | null

required

A structure that contains transaction ID information

transaction_id

string | null

required

An ID that represents an API transaction

provider_timestamp

date-time | null

required

Store a related timestamp for reporting and troubleshooting purposes

provider_transaction_id

string | null

required

Secondary transaction identifier (generated by a provider)

system_timestamp

date-time | null

required

A system generated timestamp

rtoken

string | null

required

A Galileo-generated ID used for tracking

errors

array of strings

A list of errors generated while the request was processed

errors

response_data

object | null

required

A structure for the response data. It can be empty but usually will contain information.

pmt_ref_no

string

required

Galileo-generated account number. Also called the PRN.

status

string

required

Status of the account

first_fund_date

date | null

required

Date the account was first funded

application_date

date | null

required

Date the account application was received

balance

float

required

The current account balance

currency_code

string

required

A three-character code to represent global currencies

profile

object

required

start_date

date-time | null

required

The start date for the range that account information is displayed

end_date

date-time | null

required

The end date for the range that account information is displayed

transaction_count

int32

required

The number of transactions listed in the response

transactions

array of objects

required

List of transactions

transactions*

object

pmt_ref_no

string

required

Galileo-generated account number. Also called the PRN.

act_id

string | null

required

Transaction activity identifier used in Galileo's system

act_type

string | null

required

Identifier for the transaction activity type. See the Activity Type enumeration.

mcc

string

required

Merchant Category Code (MCC) for the merchant that initiated the transaction (DE018)

post_ts

date-time | null

required

The Galileo system timestamp when the transaction posted to the customer account, in Mountain Standard Time (-0700)

amt

string

required

The transaction amount in the currency of the account. A negative amount debits funds from the customer account.

details

string

required

Description provided by the merchant about the transaction (DE043)

description

string | null

required

Description of the activity type (act_type). See the Activity Type enumeration.

source_id

string

required

Galileo-generated identifier that maps to the original transaction, such as auth_id, pmt_id, or adj_id

bal_id

string

required

Balance ID, a Galileo-generated identifier for the account on which the transaction occurs. Maps to galileo_account_number.

prod_id

string

required

Identifier for the product associated with the account

auth_ts

date-time

required

Galileo system timestamp when the transaction was authorized, in Mountain Standard Time (-0700)

trans_code

string

required

Reference your program's activity and transaction types for possible values.

ach_transaction_id

string | null

required

Identifier for the ACH transaction, if applicable

external_trans_id

string | null

required

Optional identifier for a transaction that you supply. External to the Galileo system.

original_auth_id

string | null

required

The auth_id of the previous transaction in the sequence, if any. Maps to prior_id.

network_id

string | null

required

A Galileo-generated code to identify the subnetwork over which the transaction took place. Maps to network_code.

local_amt

string | null

required

Amount, in cents, of the authorization request, in the currency at the point of sale. 12-digit number including leading zeros. This amount does not include upcharges or program fees. (DE004)

local_curr_code

string | null

required

Currency code for local_amt (DE049)

settle_amt

string | null

required

The transaction amount, in cents, in the settlement currency (DE005). 12-digit number including leading zeros.

settle_curr_code

string | null

required

Currency code for settle_amt (DE050)

billing_amt

string | null

required

The transaction amount, in cents, in the currency of the account (DE006). 12-digit number including leading zeros.

billing_curr_code

string | null

required

Currency code for billing_amt (DE051)

iac_tax

float | null

Impuesto al Consumo. Colombian consumption tax. Required for the Mastercard Interchange Intracountry Calculation Program.

iva_tax

float | null

Impuesto al Valor Agregado. Colombian value-added tax. Required for the Mastercard Interchange Intracountry Calculation Program.

funding_account_prn

string | null

The PRN of the RTF funding account

spending_account_prn

string | null

The PRN of the RTF spending account

authorization_count

int32

required

The number of authorizations listed in the response

authorizations

array of objects

required

List of authorizations

authorizations*

object

auth_id

string

required

A Galileo-generated identifier for an authorization.

details

string

required

Description provided by the merchant about the transaction (DE043)

details_formatted

string

required

The same information as in the details field, with formatting

amount

string

required

The authorization amount, in the currency of the account

timestamp

date-time | null

required

The Galileo system timestamp for the authorization, in Mountain Standard Time (-0700)

type

string

required

Reference your program's authorization transaction types for possible values.

mcc

string

required

Category code for the merchant that initiated the transaction (DE018)

merchant_id

string

required

Network-assigned identifier for a merchant (DE042)

acq_id

string

required

The identifier for the acquirer (DE032)

terminal_id

string

required

Identifier for the card reader at the point of sale (DE041)

can_be_expired

string

required

Whether to allow an expiration on this authorization: 1 = Allow, or 0 = Do not allow

original_auth_id

string | null

required

The auth_id of the previous transaction in the sequence, if any. Maps to prior_id in other contexts.

network_code

string | null

required

A Galileo-generated code to identify the network over which the transaction took place. Maps to network_id.

local_amt

string | null

required

Amount in cents of the transaction based on the currency at the point of sale (DE004). 12-digit number including leading zeros.

local_curr_code

string | null

required

Currency code for local_amt (DE049)

settle_amt

string | null

required

The transaction amount, in cents, in the settlement currency (DE005). 12-digit number including leading zeros.

settle_curr_code

string | null

required

Currency code for settle_amt (DE050)

billing_amt

string | null

required

The billing amount in cents (DE006). 12-digit number including leading zeros.

billing_curr_code

string | null

required

Currency code for billing_amt (DE051)

iac_tax

float | null

Impuesto al Consumo. Colombian consumption tax. Required for the Mastercard Interchange Intracountry Calculation Program.

iva_tax

float | null

Impuesto al Valor Agregado. Colombian value-added tax. Required for the Mastercard Interchange Intracountry Calculation Program.

latest_incremental_id

string | null

The auth_id of the previous authorization in an incremental sequence, if any. This field contains the same information as original_auth_id and is present only by request.

original_incremental_id

string | null

The auth_id of the first authorization in an incremental sequence, if any. This field is present only by request.

pending_fees

array of objects

required

List of fees

pending_fees*

object

fee_event_id

string

required

Galileo generated fee transaction integer ID

type

string

required

Three-letter fee code. This is not the transaction type (otype).

type_description

string

required

A description of the type code

amt

string

required

Amount of the fee charge

fee_date

date-time

required

A timestamp for the time the fee was charged

card_id

int32 | null

required

Integer identifier of the card as found in the raw data file (RDF). Unique identifier for a PAN.

fee_description

string

required

The description on a fee

related_transaction

object | null

required

A data structure that contains information on transactions related to a fee

savings_interest

object

required

holds

array of objects

List of holds. Holds being returned are dependant on product parameters

holds

object

hold_id

string

required

Identifier for the hold

create_dt

date-time | null

required

Timestamp when the hold was created

expiry_dt

date-time | null

required

Date the hold expires

source_id

string | null

required

Source ID for the hold

change_ts

date-time | null

Timestamp when the hold was changed

hold_type

string | null

required

Identifier for the hold type

ext_id

string | null

required

External identifier for the hold

dscr

string | null

required

Description of the hold

originating_system_id

string | null

required

Identifier that specifies the source system for the hold

agent_id

string | null

required

Identifier for the agent that created the hold

amount

float

required

The amount for the hold

xid

string | null

required

The transaction ID associated with the hold

expiring_system_id

string | null

required

Identifier for the process that expired the hold

expiring_agent_id

string | null

required

Identifier for the agent that expired the hold

Status codes

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

Language

URL


xxxxxxxxxx
1
curl --request POST \
2
     --url https://api-corename.env.gpsrv.com/intserv/4.0/getAccountOverview \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/x-www-form-urlencoded' \
5
     --header 'response-content-type: json' \
6
     --data startDate=null \
7
     --data endDate=null

Click Try It! to start a request and see the response here! Or choose an example:

application/json

application/xml