> ## Documentation Index > Fetch the complete documentation index at: https://www.marqeta.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Retrieve GPA order > Use this endpoint to retrieve a GPA order. GET/gpaorders/\{token} Use this endpoint to retrieve a GPA order. ## URL path parameters | Fields | Description | | - | - | | token string Required | Unique identifier of the GPA order. Send a `GET` request to `/transactions?type=gpa.credit` to retrieve GPA order tokens. **Allowable Values:** Existing GPA order token | ## Response body | Fields | Description | | - | - | | amount decimal Returned | Amount funded. **Allowable Values:** decimal **Format:** 0.00 | | business\_token string Conditionally returned | Unique identifier of the business. This field is returned if it exists in the resource. **Allowable Values:** Existing `business_token` | | created\_time datetime Returned | Date and time when the GPA order was created, in UTC. **Allowable Values:** datetime **Format:** yyyy-MM-ddThh:mm:ssZ | | currency\_code string Returned | Three-digit ISO 4217 currency code. **Allowable Values:** Valid three-digit [ISO 4217 currency code](https://www.iso.org/iso-4217-currency-codes.html) | | fees array of objects Conditionally returned | List of fees associated with the funding transaction. This array is returned if it exists in the resource. **Allowable Values:** Valid array of one or more `fees` objects | | fees\[].**fee** object Returned | Contains details about the fee. **Allowable Values:** `amount`, `created_time`, `currency_code`, `last_modified_time`, `name`, `tags`, `token` | | fees\[].fee.**amount** decimal Returned | Amount of the fee. **Allowable Values:** decimal **Format:** 0.00 | | fees\[].fee.**created\_time** datetime Returned | Date and time when the `fees` object was created, in UTC. **Allowable Values:** datetime **Format:** yyyy-MM-ddThh:mm:ssZ | | fees\[].fee.**currency\_code** string Returned | Three-digit ISO 4217 currency code. **Allowable Values:** Valid three-digit [ISO 4217 currency code](https://www.iso.org/iso-4217-currency-codes.html) | | fees\[].fee.**last\_modified\_time** datetime Returned | Date and time when the `fees` object was last modified, in UTC. **Allowable Values:** datetime **Format:** yyyy-MM-ddThh:mm:ssZ | | fees\[].fee.**name** string Returned | Name of the fee. **Allowable Values:** 50 char max | | fees\[].fee.**tags** string Conditionally returned | Descriptive metadata about the fee. **Allowable Values:** 255 char max | | fees\[].fee.**token** string Returned | Unique identifier of the `fees` object. **Allowable Values:** Existing `fees` object token | | fees\[].**memo** string Conditionally returned | Additional text describing the fee. **Allowable Values:** 1–255 chars | | fees\[].**overrideAmount** decimal Conditionally returned | Dynamic fee amount that overrides the `fee.amount` field value. **Allowable Values:** decimal **Format:** 0.00 | | fees\[].**tags** string Conditionally returned | Descriptive metadata about the fee. **Allowable Values:** 255 char max | | fees\[].**token** string Returned | Unique identifier of the fee. **Allowable Values:** 1–36 chars | | fees\[].**transaction\_token** string Returned | Unique identifier of the fee transaction. **Allowable Values:** 36 char max | | funding object Returned | Contains funding information for the transaction, including funding amount, type, and time. **Allowable Values:** `amount`, `gateway_log`, `source`, `source_address` | | funding.**amount** decimal Conditionally returned | Amount of funds loaded into the GPA. **Allowable Values:** decimal **Format:** 0.00 | | funding.**gateway\_log** object Conditionally returned | Contains information from the JIT Funding gateway in response to a funding request. **Allowable Values:** `duration`, `message`, `order_number`, `response`, `timed_out`, `transaction_id` | | funding.gateway\_log.**duration** integer Conditionally returned | Length of time in milliseconds that the gateway took to respond to a funding request. **Allowable Values:** Any integer | | funding.gateway\_log.**message** string Returned | Message about the status of the funding request. Useful for determining whether it was approved and completed successfully, declined by the gateway, or timed out. **Allowable Values:** `Approved or completed successfully`, `Declined by gateway`, `Operation timeout` | | funding.gateway\_log.**order\_number** string Returned | Customer order number, same value as `transaction.token`. **Allowable Values:** Existing `transaction.token` value | | funding.gateway\_log.**response** object Conditionally returned | Contains information from the gateway in response to a funding request. **Allowable Values:** `code`, `data` | | funding.gateway\_log.response.**code** string Returned | Code received from the gateway. **Allowable Values:** 255 char max | | funding.gateway\_log.response.**data** object Conditionally returned | Contains the gateway's information about the JIT Funding transaction. **Allowable Values:** `jit_funding` | | funding.gateway\_log.response.data.**jit\_funding** object Returned | Contains information about the JIT Funding load event, in which funds are loaded into an account. This object is returned if your program uses JIT Funding. **Allowable Values:** `acting_user_token`, `address_verification`, `amount`, `balances`, `business_token`, `decline_reason`, `incremental_authorization_jit_funding_tokens`, `memo`, `method`, `original_jit_funding_token`, `tags`, `token`, `user_token` | | funding.gateway\_log.response.data.jit\_funding.**acting\_user\_token** string Conditionally returned | User who conducted the transaction. Can be a child user configured to share its parent's account balance. **Allowable Values:** 36 char max | | funding.gateway\_log.response.data.jit\_funding.**address\_verification** object Conditionally returned | Contains address verification data used to make JIT Funding decisions. **Allowable Values:** `gateway`, `issuer`, `request` | | funding.gateway\_log.response.data.jit\_funding.address\_verification.**gateway** object Conditionally returned | Contains address verification data consisting of address data entered by the cardholder, address data held by the Marqeta platform, and an assertion by the Marqeta platform as to whether the two sets of data match. **Allowable Values:** `on_file`, `response` | | funding.gateway\_log.response.data.jit\_funding.address\_verification.gateway.**on\_file** object Conditionally returned | Contains address verification information. **Allowable Values:** `postal_code`, `street_address`, `zip` | | funding.gateway\_log.response.data.jit\_funding.address\_verification.gateway.on\_file.**postal\_code** string Conditionally returned | Postal code of the address. **Allowable Values:** 10 char max | | funding.gateway\_log.response.data.jit\_funding.address\_verification.gateway.on\_file.**street\_address** string Conditionally returned | Street name and number of the address. **Allowable Values:** 40 char max | | funding.gateway\_log.response.data.jit\_funding.address\_verification.gateway.on\_file.**zip** string Conditionally returned | United States ZIP code of the address. **Allowable Values:** 10 char max | | funding.gateway\_log.response.data.jit\_funding.address\_verification.gateway.**response** object Conditionally returned | Response codes and memos for account name verification, address verification, card security verification, and transactions. **Allowable Values:** `additional_information`, `code`, `memo` | | funding.gateway\_log.response.data.jit\_funding.address\_verification.gateway.response.**additional\_information** string Conditionally returned | Additional information about the transaction, such as velocity control details. This field is returned in transaction response objects only. It is not returned in address verification or card security verification response objects. **Allowable Values:** 255 char max | | funding.gateway\_log.response.data.jit\_funding.address\_verification.gateway.response.**code** string Returned | Four-digit response code for address verification, card security code verification, or transactions. For account name verification, the four digits correspond with assertions that the first, middle, last, and full name of the cardholder on the Marqeta platform match the data provided by the cardholder. - `0` indicates no validation was performed - `1` indicates the match was unsuccessful (not matched) - `2` indicates the match was partial - `3` indicates the match was exact For example: Code / First Name / Middle Name / Last Name / Full Name `0000` / Not validated / Not validated / Not validated / Not validated `1111` / Not matched / Not matched / Not matched / Not matched `3333` / Exact match / Exact match / Exact match / Exact match `1232` / Not matched / Partial match / Exact match / Partial match For address verification responses, the code is an assertion by the Marqeta platform as to whether its address verification data matches that provided by the cardholder: Code / Address / Postal Code `0000` / Match / Match `0001` / Match / Not matched `0100` / Not matched / Match `0101` / Not matched / Not matched `0200` / Data not present / Match `0201` / Data not present / Not matched `0002` / Match / Data not present `0102` / Not matched / Data not present `0303` / Not validated / Not validated For card security verification, the code indicates whether the verification check passed and can have these possible values: - `0000` – Passed - `0001` – Did not pass For a transaction, the code describes the outcome of the attempted transaction. For the full list of transaction codes, see [Transaction response codes](https://www.marqeta.com/docs/developer-guides/about-transactions.md#_transaction_response_codes). **Allowable Values:** Four-digit code | | funding.gateway\_log.response.data.jit\_funding.address\_verification.gateway.response.**memo** string Returned | Additional text that describes the response. **Allowable Values:** 255 char max | | funding.gateway\_log.response.data.jit\_funding.address\_verification.**issuer** object Conditionally returned | Contains address verification data consisting of address data entered by the cardholder, address data held by the Marqeta platform, and an assertion by the Marqeta platform as to whether the two sets of data match. **Allowable Values:** `on_file`, `response` | | funding.gateway\_log.response.data.jit\_funding.address\_verification.issuer.**on\_file** object Conditionally returned | Contains address verification information. **Allowable Values:** `postal_code`, `street_address`, `zip` | | funding.gateway\_log.response.data.jit\_funding.address\_verification.issuer.on\_file.**postal\_code** string Conditionally returned | Postal code of the address. **Allowable Values:** 10 char max | | funding.gateway\_log.response.data.jit\_funding.address\_verification.issuer.on\_file.**street\_address** string Conditionally returned | Street name and number of the address. **Allowable Values:** 40 char max | | funding.gateway\_log.response.data.jit\_funding.address\_verification.issuer.on\_file.**zip** string Conditionally returned | United States ZIP code of the address. **Allowable Values:** 10 char max | | funding.gateway\_log.response.data.jit\_funding.address\_verification.issuer.**response** object Conditionally returned | Response codes and memos for account name verification, address verification, card security verification, and transactions. **Allowable Values:** `additional_information`, `code`, `memo` | | funding.gateway\_log.response.data.jit\_funding.address\_verification.issuer.response.**additional\_information** string Conditionally returned | Additional information about the transaction, such as velocity control details. This field is returned in transaction response objects only. It is not returned in address verification or card security verification response objects. **Allowable Values:** 255 char max | | funding.gateway\_log.response.data.jit\_funding.address\_verification.issuer.response.**code** string Returned | Four-digit response code for address verification, card security code verification, or transactions. For account name verification, the four digits correspond with assertions that the first, middle, last, and full name of the cardholder on the Marqeta platform match the data provided by the cardholder. - `0` indicates no validation was performed - `1` indicates the match was unsuccessful (not matched) - `2` indicates the match was partial - `3` indicates the match was exact For example: Code / First Name / Middle Name / Last Name / Full Name `0000` / Not validated / Not validated / Not validated / Not validated `1111` / Not matched / Not matched / Not matched / Not matched `3333` / Exact match / Exact match / Exact match / Exact match `1232` / Not matched / Partial match / Exact match / Partial match For address verification responses, the code is an assertion by the Marqeta platform as to whether its address verification data matches that provided by the cardholder: Code / Address / Postal Code `0000` / Match / Match `0001` / Match / Not matched `0100` / Not matched / Match `0101` / Not matched / Not matched `0200` / Data not present / Match `0201` / Data not present / Not matched `0002` / Match / Data not present `0102` / Not matched / Data not present `0303` / Not validated / Not validated For card security verification, the code indicates whether the verification check passed and can have these possible values: - `0000` – Passed - `0001` – Did not pass For a transaction, the code describes the outcome of the attempted transaction. For the full list of transaction codes, see [Transaction response codes](https://www.marqeta.com/docs/developer-guides/about-transactions.md#_transaction_response_codes). **Allowable Values:** Four-digit code | | funding.gateway\_log.response.data.jit\_funding.address\_verification.issuer.response.**memo** string Returned | Additional text that describes the response. **Allowable Values:** 255 char max | | funding.gateway\_log.response.data.jit\_funding.address\_verification.**request** object Conditionally returned | Contains address verification information. **Allowable Values:** `postal_code`, `street_address`, `zip` | | funding.gateway\_log.response.data.jit\_funding.address\_verification.request.**postal\_code** string Conditionally returned | Postal code of the address. **Allowable Values:** 10 char max | | funding.gateway\_log.response.data.jit\_funding.address\_verification.request.**street\_address** string Conditionally returned | Street name and number of the address. **Allowable Values:** 40 char max | | funding.gateway\_log.response.data.jit\_funding.address\_verification.request.**zip** string Conditionally returned | United States ZIP code of the address. **Allowable Values:** 10 char max | | funding.gateway\_log.response.data.jit\_funding.**jit\_account\_name\_verification** object Conditionally returned | Contains account name verification data used to make JIT Funding decisions from one of the following objects: - The `gateway` object, which contains account name verification data from your JIT Funding gateway. - The `issuer` object, which contains account name verification data from the Marqeta platform. - The `request` object, which contains account name verification data as it appears in a JIT Funding request. **Allowable Values:** `gateway`, `issuer`, `request` | | funding.gateway\_log.response.data.jit\_funding.jit\_account\_name\_verification.**gateway** object Conditionally returned | Contains account name verification data used to make JIT Funding decisions. **Allowable Values:** `first_name`, `last_name`, `middle_name` | | funding.gateway\_log.response.data.jit\_funding.jit\_account\_name\_verification.**issuer** object Conditionally returned | Contains account name verification data used to make JIT Funding decisions. **Allowable Values:** `first_name`, `last_name`, `middle_name` | | funding.gateway\_log.response.data.jit\_funding.jit\_account\_name\_verification.**request** object Conditionally returned | Contains account name verification data used to make JIT Funding decisions. **Allowable Values:** `first_name`, `last_name`, `middle_name` | | funding.gateway\_log.response.data.jit\_funding.**amount** decimal Returned | Requested amount of funding. **Allowable Values:** 0 min **Format:** 0.00 | | funding.gateway\_log.response.data.jit\_funding.**balances** object Conditionally returned | Contains the GPA's balance details. **Allowable Values:** `available_balance`, `balances`, `cached_balance`, `credit_balance`, `currency_code`, `impacted_amount`, `last_updated_time`, `ledger_balance`, `pending_credits` | | funding.gateway\_log.response.data.jit\_funding.**business\_token** string Conditionally returned | Holder of the business account that was funded. **Allowable Values:** 36 char max | | funding.gateway\_log.response.data.jit\_funding.**decline\_reason** string Conditionally returned | Reason why the transaction was declined. **Allowable Values:** `AMOUNT_LIMIT_EXCEEDED`, `BLOCKED_BY_CARDHOLDER`, `BLOCKED_BY_ISSUER`, `BLOCKED_MERCHANT_BY_CARDHOLDER`, `CARD_NOT_ACTIVE`, `CARDHOLDER_NOT_ACTIVE`, `CLOSED_ACCOUNT`, `DUPLICATE_TRANSACTION`, `EXPIRED_CARD`, `INSUFFICIENT_FUNDS`, `INVALID_AMOUNT`, `INVALID_CARD`, `INVALID_MERCHANT`, `NO_CHECKING_ACCOUNT`, `NO_CREDIT_ACCOUNT`, `NO_SAVINGS_ACCOUNT`, `REVOCATION_ALL_AUTHORIZATION_ORDER`, `REVOCATION_AUTHORIZATION_ORDER`, `SOFT_DECLINE_AUTHENTICATION_REQUIRED`, `SOFT_DECLINE_PIN_REQUIRED`, `STOP_PAYMENT`, `SUSPECTED_FRAUD`, `TRANSACTION_COUNT_LIMIT_EXCEEDED`, `TRANSACTION_NOT_PERMITTED` | | funding.gateway\_log.response.data.jit\_funding.**incremental\_authorization\_jit\_funding\_tokens** array of strings Conditionally returned | Array of tokens referencing the JIT Funding tokens of all previous associated incremental authorization JIT Funding requests. Useful for ascertaining the final transaction amount when the original amount was incremented. **Allowable Values:** Existing incremental authorization JIT Funding tokens | | funding.gateway\_log.response.data.jit\_funding.**memo** string Conditionally returned | Additional information that describes the JIT Funding transaction. **Allowable Values:** 99 char max | | funding.gateway\_log.response.data.jit\_funding.**method** string Returned | JIT Funding response type. See [The jit\_funding object](https://www.marqeta.com/docs/core-api/gateway-jit-funding-messages.md#_the_jit_funding_object) for the purpose, funding event type, and description of each method. **Allowable Values:** `pgfs.adjustment.credit`, `pgfs.adjustment.debit`, `pgfs.authorization`, `pgfs.authorization.account_verification`, `pgfs.authorization.capture`, `pgfs.authorization.capture.chargeback`, `pgfs.authorization.capture.chargeback.reversal`, `pgfs.authorization.incremental`, `pgfs.authorization.reversal`, `pgfs.authorization.standin`, `pgfs.auth_plus_capture`, `pgfs.auth_plus_capture.standin`, `pgfs.balanceinquiry`, `pgfs.billpayment`, `pgfs.billpayment.capture`, `pgfs.billpayment.reversal`, `pgfs.directdeposit.credit`, `pgfs.directdeposit.credit.reversal`, `pgfs.directdeposit.debit`, `pgfs.directdeposit.debit.reversal`, `pgfs.dispute.credit`, `pgfs.dispute.debit`, `pgfs.force_capture`, `pgfs.network.load`, `pgfs.original.credit.authorization`, `pgfs.original.credit.auth_plus_capture`, `pgfs.pindebit.chargeback`, `pgfs.pindebit.chargeback.reversal`, `pgfs.product.inquiry`, `pgfs.refund`, `pgfs.refund.authorization`, `pgfs.refund.authorization.reversal` | | funding.gateway\_log.response.data.jit\_funding.**original\_jit\_funding\_token** string Conditionally returned | Unique identifier of the first associated JIT Funding message. Useful for correlating related JIT Funding messages (that is, those associated with the same GPA order). Not included in the first of any set of related messages. **Allowable Values:** 36 char max | | funding.gateway\_log.response.data.jit\_funding.**tags** string Conditionally returned | Customer-defined tags related to the JIT Funding transaction. **Allowable Values:** 255 char max | | funding.gateway\_log.response.data.jit\_funding.**token** string Returned | Existing JIT Funding token matching the `funding.gateway_log.transaction_id` field of the associated GPA order. **NOTE:** The `transaction_id` field updates if a subsequent JIT Funding message associated with that GPA order is sent. If multiple JIT Funding messages are associated with the same GPA order, the `transaction_id` field matches the token of the most recent message. **Allowable Values:** 36 char max | | funding.gateway\_log.response.data.jit\_funding.**user\_token** string Returned | Holder of the user account that was funded. **Allowable Values:** 36 char max | | funding.gateway\_log.response.data.**flex** object Conditionally returned | Contains information about a Flexible Credential transaction. **Allowable Values:** `action`, `eligible`, `eligible_products`, `secondary_credential_identifier`, `selected_product` | | funding.gateway\_log.response.data.flex.**action** string Conditionally returned | Indicates whether the Flexible Credential transaction object is actionable (`inquiry`) or merely informative (`advice`). **Allowable Values:** `inquiry`, `advice` | | funding.gateway\_log.response.data.flex.**eligible** string Conditionally returned | Indicates whether or not the transaction is eligible for Flexible Credential transactions. **Allowable Values:** `true`, `false` | | funding.gateway\_log.response.data.flex.**eligible\_products** array of strings Conditionally returned | Specifies which of the payment instrument's credentials is eligible for this transaction: - A value of `DEBIT` indicates the primary credential. - A value of `LOAN` indicates the secondary credential. **Allowable Values:** `DEBIT`, `LOAN` | | funding.gateway\_log.response.data.flex.**secondary\_credential\_identifier** string Conditionally returned | Identifies the secondary credential used in the transaction, if applicable. **Allowable Values:** 255 char max | | funding.gateway\_log.response.data.flex.**selected\_product** string Conditionally returned | Indicates the eligible product that was used in the transaction. **Allowable Values:** `DEBIT`, `LOAN` | | funding.gateway\_log.**timed\_out** boolean Conditionally returned | Whether the gateway sent a response (`true`) or timed out (`false`). **Allowable Values:** `true`, `false` | | funding.gateway\_log.**transaction\_id** string Returned | Customer-defined identifier for the transaction. **Allowable Values:** 255 char max | | funding.**source** object Returned | Contains funding source information for the transaction, including the funding type and time. **Allowable Values:** `active`, `created_time`, `is_default_account`, `last_modified_time`, `token`, `type` | | funding.source.**active** boolean Returned | Whether the funding source is active. **Allowable Values:** `true`, `false` | | funding.source.**created\_time** datetime Returned | Date and time when the funding source was created, in UTC. **Allowable Values:** datetime **Format:** yyyy-MM-ddThh:mm:ssZ | | funding.source.**is\_default\_account** boolean Returned | Whether the GPA order unload's funding source is the default funding account. **Allowable Values:** `true`, `false` | | funding.source.**last\_modified\_time** datetime Returned | Date and time when the funding source was last modified, in UTC. **Allowable Values:** datetime **Format:** yyyy-MM-ddThh:mm:ssZ | | funding.source.**token** string Returned | Unique identifier of the funding source. **Allowable Values:** Format: UUID | | funding.source.**type** string Returned | Funding type of the funding source. **Allowable Values:** `ach`, `paymentcard` | | funding.**source\_address** object Conditionally returned | Contains information about the billing address of the funding source. **Allowable Values:** `active`, `address_1`, `address_2`, `business_token`, `city`, `country`, `created_time`, `first_name`, `is_default_address`, `last_modified_time`, `last_name`, `phone`, `postal_code`, `state`, `token`, `user_token`, `zip` | | funding.source\_address.**active** boolean Conditionally returned | Whether the address is active. **Allowable Values:** `true`, `false` | | funding.source\_address.**address\_1** string Returned | Street address of the funding source. **Allowable Values:** 255 char max | | funding.source\_address.**address\_2** string Conditionally returned | Additional address information for the funding source. This field is returned if it exists in the resource. **Allowable Values:** 255 char max | | funding.source\_address.**business\_token** string Conditionally returned | Unique identifier of the business account holder associated with the address. This field is returned if it exists in the resource. **Allowable Values:** 1–36 chars | | funding.source\_address.**city** string Returned | City of the funding source. **Allowable Values:** 40 char max | | funding.source\_address.**country** string Returned | Country of the funding source. **Allowable Values:** 1–40 chars | | funding.source\_address.**created\_time** datetime Returned | Date and time when the address was created, in UTC. **Allowable Values:** datetime **Format:** yyyy-MM-ddThh:mm:ssZ | | funding.source\_address.**first\_name** string Returned | First name of the account holder associated with the funding source. **Allowable Values:** 40 char max | | funding.source\_address.**is\_default\_address** boolean Conditionally returned | Whether this address is the default address used by the funding source. **Allowable Values:** `true`, `false` | | funding.source\_address.**last\_modified\_time** datetime Returned | Date and time when the address was last modified, in UTC. This field is returned if it exists in the resource. **Allowable Values:** datetime **Format:** yyyy-MM-ddThh:mm:ssZ | | funding.source\_address.**last\_name** string Returned | Last name of the account holder associated with the funding source. **Allowable Values:** 40 char max | | funding.source\_address.**phone** string Conditionally returned | Phone number of the funding source. This field is returned if it exists in the resource. **Allowable Values:** 255 char max | | funding.source\_address.**postal\_code** string Returned | Postal code of the funding source. **Allowable Values:** 10 char max | | funding.source\_address.**state** string Returned | Two-character state, provincial, or territorial abbreviation. For the complete list, see [Valid state, provincial, territorial, and federal abbreviations](https://www.marqeta.com/docs/core-api/kyc-verification/perform.md#_valid_state_provincial_territorial_and_federal_abbreviations). **Allowable Values:** 2 char max | | funding.source\_address.**token** string Returned | Unique identifier of the `funding_source_address` object. **Allowable Values:** 1–36 chars | | funding.source\_address.**user\_token** string Conditionally returned | Unique identifier of the user account holder associated with the address. This field is returned if it exists in the resource. **Allowable Values:** 1–36 chars | | funding.source\_address.**zip** string Returned | United States ZIP code of the funding source. **Allowable Values:** 10 char max | | funding\_source\_address\_token string Conditionally returned | Unique identifier of the funding source address to use for this order. **Allowable Values:** Existing `funding_source_address` token | | funding\_source\_token string Returned | Unique identifier of the funding source to use for this order. **Allowable Values:** Existing `funding_source` token | | gateway\_message string Conditionally returned | Message about the status of the funding request. Useful for determining whether it was approved and completed successfully, declined by the gateway, or timed out. This field is returned if it exists in the resource. **Allowable Values:** `Approved or completed successfully`, `Declined by gateway`, `Operation timeout` | | gateway\_token integer Conditionally returned | Unique identifier of the JIT Funding request and response. This field is returned if it exists in the resource. **Allowable Values:** Existing `gateway_token` | | jit\_funding object Conditionally returned | Contains information about the JIT Funding load event, in which funds are loaded into an account. This object is returned if your program uses JIT Funding. **Allowable Values:** `acting_user_token`, `address_verification`, `amount`, `balances`, `business_token`, `decline_reason`, `incremental_authorization_jit_funding_tokens`, `memo`, `method`, `original_jit_funding_token`, `tags`, `token`, `user_token` | | jit\_funding.**acting\_user\_token** string Conditionally returned | User who conducted the transaction. Can be a child user configured to share its parent's account balance. **Allowable Values:** 36 char max | | jit\_funding.**address\_verification** object Conditionally returned | Contains address verification data used to make JIT Funding decisions. **Allowable Values:** `gateway`, `issuer`, `request` | | jit\_funding.address\_verification.**gateway** object Conditionally returned | Contains address verification data consisting of address data entered by the cardholder, address data held by the Marqeta platform, and an assertion by the Marqeta platform as to whether the two sets of data match. **Allowable Values:** `on_file`, `response` | | jit\_funding.address\_verification.gateway.**on\_file** object Conditionally returned | Contains address verification information. **Allowable Values:** `postal_code`, `street_address`, `zip` | | jit\_funding.address\_verification.gateway.on\_file.**postal\_code** string Conditionally returned | Postal code of the address. **Allowable Values:** 10 char max | | jit\_funding.address\_verification.gateway.on\_file.**street\_address** string Conditionally returned | Street name and number of the address. **Allowable Values:** 40 char max | | jit\_funding.address\_verification.gateway.on\_file.**zip** string Conditionally returned | United States ZIP code of the address. **Allowable Values:** 10 char max | | jit\_funding.address\_verification.gateway.**response** object Conditionally returned | Response codes and memos for account name verification, address verification, card security verification, and transactions. **Allowable Values:** `additional_information`, `code`, `memo` | | jit\_funding.address\_verification.gateway.response.**additional\_information** string Conditionally returned | Additional information about the transaction, such as velocity control details. This field is returned in transaction response objects only. It is not returned in address verification or card security verification response objects. **Allowable Values:** 255 char max | | jit\_funding.address\_verification.gateway.response.**code** string Returned | Four-digit response code for address verification, card security code verification, or transactions. For account name verification, the four digits correspond with assertions that the first, middle, last, and full name of the cardholder on the Marqeta platform match the data provided by the cardholder. - `0` indicates no validation was performed - `1` indicates the match was unsuccessful (not matched) - `2` indicates the match was partial - `3` indicates the match was exact For example: Code / First Name / Middle Name / Last Name / Full Name `0000` / Not validated / Not validated / Not validated / Not validated `1111` / Not matched / Not matched / Not matched / Not matched `3333` / Exact match / Exact match / Exact match / Exact match `1232` / Not matched / Partial match / Exact match / Partial match For address verification responses, the code is an assertion by the Marqeta platform as to whether its address verification data matches that provided by the cardholder: Code / Address / Postal Code `0000` / Match / Match `0001` / Match / Not matched `0100` / Not matched / Match `0101` / Not matched / Not matched `0200` / Data not present / Match `0201` / Data not present / Not matched `0002` / Match / Data not present `0102` / Not matched / Data not present `0303` / Not validated / Not validated For card security verification, the code indicates whether the verification check passed and can have these possible values: - `0000` – Passed - `0001` – Did not pass For a transaction, the code describes the outcome of the attempted transaction. For the full list of transaction codes, see [Transaction response codes](https://www.marqeta.com/docs/developer-guides/about-transactions.md#_transaction_response_codes). **Allowable Values:** Four-digit code | | jit\_funding.address\_verification.gateway.response.**memo** string Returned | Additional text that describes the response. **Allowable Values:** 255 char max | | jit\_funding.address\_verification.**issuer** object Conditionally returned | Contains address verification data consisting of address data entered by the cardholder, address data held by the Marqeta platform, and an assertion by the Marqeta platform as to whether the two sets of data match. **Allowable Values:** `on_file`, `response` | | jit\_funding.address\_verification.issuer.**on\_file** object Conditionally returned | Contains address verification information. **Allowable Values:** `postal_code`, `street_address`, `zip` | | jit\_funding.address\_verification.issuer.on\_file.**postal\_code** string Conditionally returned | Postal code of the address. **Allowable Values:** 10 char max | | jit\_funding.address\_verification.issuer.on\_file.**street\_address** string Conditionally returned | Street name and number of the address. **Allowable Values:** 40 char max | | jit\_funding.address\_verification.issuer.on\_file.**zip** string Conditionally returned | United States ZIP code of the address. **Allowable Values:** 10 char max | | jit\_funding.address\_verification.issuer.**response** object Conditionally returned | Response codes and memos for account name verification, address verification, card security verification, and transactions. **Allowable Values:** `additional_information`, `code`, `memo` | | jit\_funding.address\_verification.issuer.response.**additional\_information** string Conditionally returned | Additional information about the transaction, such as velocity control details. This field is returned in transaction response objects only. It is not returned in address verification or card security verification response objects. **Allowable Values:** 255 char max | | jit\_funding.address\_verification.issuer.response.**code** string Returned | Four-digit response code for address verification, card security code verification, or transactions. For account name verification, the four digits correspond with assertions that the first, middle, last, and full name of the cardholder on the Marqeta platform match the data provided by the cardholder. - `0` indicates no validation was performed - `1` indicates the match was unsuccessful (not matched) - `2` indicates the match was partial - `3` indicates the match was exact For example: Code / First Name / Middle Name / Last Name / Full Name `0000` / Not validated / Not validated / Not validated / Not validated `1111` / Not matched / Not matched / Not matched / Not matched `3333` / Exact match / Exact match / Exact match / Exact match `1232` / Not matched / Partial match / Exact match / Partial match For address verification responses, the code is an assertion by the Marqeta platform as to whether its address verification data matches that provided by the cardholder: Code / Address / Postal Code `0000` / Match / Match `0001` / Match / Not matched `0100` / Not matched / Match `0101` / Not matched / Not matched `0200` / Data not present / Match `0201` / Data not present / Not matched `0002` / Match / Data not present `0102` / Not matched / Data not present `0303` / Not validated / Not validated For card security verification, the code indicates whether the verification check passed and can have these possible values: - `0000` – Passed - `0001` – Did not pass For a transaction, the code describes the outcome of the attempted transaction. For the full list of transaction codes, see [Transaction response codes](https://www.marqeta.com/docs/developer-guides/about-transactions.md#_transaction_response_codes). **Allowable Values:** Four-digit code | | jit\_funding.address\_verification.issuer.response.**memo** string Returned | Additional text that describes the response. **Allowable Values:** 255 char max | | jit\_funding.address\_verification.**request** object Conditionally returned | Contains address verification information. **Allowable Values:** `postal_code`, `street_address`, `zip` | | jit\_funding.address\_verification.request.**postal\_code** string Conditionally returned | Postal code of the address. **Allowable Values:** 10 char max | | jit\_funding.address\_verification.request.**street\_address** string Conditionally returned | Street name and number of the address. **Allowable Values:** 40 char max | | jit\_funding.address\_verification.request.**zip** string Conditionally returned | United States ZIP code of the address. **Allowable Values:** 10 char max | | jit\_funding.**jit\_account\_name\_verification** object Conditionally returned | Contains account name verification data used to make JIT Funding decisions from one of the following objects: - The `gateway` object, which contains account name verification data from your JIT Funding gateway. - The `issuer` object, which contains account name verification data from the Marqeta platform. - The `request` object, which contains account name verification data as it appears in a JIT Funding request. **Allowable Values:** `gateway`, `issuer`, `request` | | jit\_funding.jit\_account\_name\_verification.**gateway** object Conditionally returned | Contains account name verification data used to make JIT Funding decisions. **Allowable Values:** `first_name`, `last_name`, `middle_name` | | jit\_funding.jit\_account\_name\_verification.**issuer** object Conditionally returned | Contains account name verification data used to make JIT Funding decisions. **Allowable Values:** `first_name`, `last_name`, `middle_name` | | jit\_funding.jit\_account\_name\_verification.**request** object Conditionally returned | Contains account name verification data used to make JIT Funding decisions. **Allowable Values:** `first_name`, `last_name`, `middle_name` | | jit\_funding.**amount** decimal Returned | Requested amount of funding. **Allowable Values:** 0 min **Format:** 0.00 | | jit\_funding.**balances** object Conditionally returned | Contains the GPA's balance details. **Allowable Values:** `available_balance`, `balances`, `cached_balance`, `credit_balance`, `currency_code`, `impacted_amount`, `last_updated_time`, `ledger_balance`, `pending_credits` | | jit\_funding.**business\_token** string Conditionally returned | Holder of the business account that was funded. **Allowable Values:** 36 char max | | jit\_funding.**decline\_reason** string Conditionally returned | Reason why the transaction was declined. **Allowable Values:** `AMOUNT_LIMIT_EXCEEDED`, `BLOCKED_BY_CARDHOLDER`, `BLOCKED_BY_ISSUER`, `BLOCKED_MERCHANT_BY_CARDHOLDER`, `CARD_NOT_ACTIVE`, `CARDHOLDER_NOT_ACTIVE`, `CLOSED_ACCOUNT`, `DUPLICATE_TRANSACTION`, `EXPIRED_CARD`, `INSUFFICIENT_FUNDS`, `INVALID_AMOUNT`, `INVALID_CARD`, `INVALID_MERCHANT`, `NO_CHECKING_ACCOUNT`, `NO_CREDIT_ACCOUNT`, `NO_SAVINGS_ACCOUNT`, `REVOCATION_ALL_AUTHORIZATION_ORDER`, `REVOCATION_AUTHORIZATION_ORDER`, `SOFT_DECLINE_AUTHENTICATION_REQUIRED`, `SOFT_DECLINE_PIN_REQUIRED`, `STOP_PAYMENT`, `SUSPECTED_FRAUD`, `TRANSACTION_COUNT_LIMIT_EXCEEDED`, `TRANSACTION_NOT_PERMITTED` | | jit\_funding.**incremental\_authorization\_jit\_funding\_tokens** array of strings Conditionally returned | Array of tokens referencing the JIT Funding tokens of all previous associated incremental authorization JIT Funding requests. Useful for ascertaining the final transaction amount when the original amount was incremented. **Allowable Values:** Existing incremental authorization JIT Funding tokens | | jit\_funding.**memo** string Conditionally returned | Additional information that describes the JIT Funding transaction. **Allowable Values:** 99 char max | | jit\_funding.**method** string Returned | JIT Funding response type. See [The jit\_funding object](https://www.marqeta.com/docs/core-api/gateway-jit-funding-messages.md#_the_jit_funding_object) for the purpose, funding event type, and description of each method. **Allowable Values:** `pgfs.adjustment.credit`, `pgfs.adjustment.debit`, `pgfs.authorization`, `pgfs.authorization.account_verification`, `pgfs.authorization.capture`, `pgfs.authorization.capture.chargeback`, `pgfs.authorization.capture.chargeback.reversal`, `pgfs.authorization.incremental`, `pgfs.authorization.reversal`, `pgfs.authorization.standin`, `pgfs.auth_plus_capture`, `pgfs.auth_plus_capture.standin`, `pgfs.balanceinquiry`, `pgfs.billpayment`, `pgfs.billpayment.capture`, `pgfs.billpayment.reversal`, `pgfs.directdeposit.credit`, `pgfs.directdeposit.credit.reversal`, `pgfs.directdeposit.debit`, `pgfs.directdeposit.debit.reversal`, `pgfs.dispute.credit`, `pgfs.dispute.debit`, `pgfs.force_capture`, `pgfs.network.load`, `pgfs.original.credit.authorization`, `pgfs.original.credit.auth_plus_capture`, `pgfs.pindebit.chargeback`, `pgfs.pindebit.chargeback.reversal`, `pgfs.product.inquiry`, `pgfs.refund`, `pgfs.refund.authorization`, `pgfs.refund.authorization.reversal` | | jit\_funding.**original\_jit\_funding\_token** string Conditionally returned | Unique identifier of the first associated JIT Funding message. Useful for correlating related JIT Funding messages (that is, those associated with the same GPA order). Not included in the first of any set of related messages. **Allowable Values:** 36 char max | | jit\_funding.**tags** string Conditionally returned | Customer-defined tags related to the JIT Funding transaction. **Allowable Values:** 255 char max | | jit\_funding.**token** string Returned | Existing JIT Funding token matching the `funding.gateway_log.transaction_id` field of the associated GPA order. **NOTE:** The `transaction_id` field updates if a subsequent JIT Funding message associated with that GPA order is sent. If multiple JIT Funding messages are associated with the same GPA order, the `transaction_id` field matches the token of the most recent message. **Allowable Values:** 36 char max | | jit\_funding.**user\_token** string Returned | Holder of the user account that was funded. **Allowable Values:** 36 char max | | last\_modified\_time datetime Returned | Date and time when the GPA order was last modified, in UTC. **Allowable Values:** datetime **Format:** yyyy-MM-ddThh:mm:ssZ | | memo string Conditionally returned | Additional descriptive text. This field is returned if it exists in the resource. **Allowable Values:** 99 char max | | response object Returned | Response codes and memos for account name verification, address verification, card security verification, and transactions. **Allowable Values:** `additional_information`, `code`, `memo` | | response.**additional\_information** string Conditionally returned | Additional information about the transaction, such as velocity control details. This field is returned in transaction response objects only. It is not returned in address verification or card security verification response objects. **Allowable Values:** 255 char max | | response.**code** string Returned | Four-digit response code for address verification, card security code verification, or transactions. For account name verification, the four digits correspond with assertions that the first, middle, last, and full name of the cardholder on the Marqeta platform match the data provided by the cardholder. - `0` indicates no validation was performed - `1` indicates the match was unsuccessful (not matched) - `2` indicates the match was partial - `3` indicates the match was exact For example: Code / First Name / Middle Name / Last Name / Full Name `0000` / Not validated / Not validated / Not validated / Not validated `1111` / Not matched / Not matched / Not matched / Not matched `3333` / Exact match / Exact match / Exact match / Exact match `1232` / Not matched / Partial match / Exact match / Partial match For address verification responses, the code is an assertion by the Marqeta platform as to whether its address verification data matches that provided by the cardholder: Code / Address / Postal Code `0000` / Match / Match `0001` / Match / Not matched `0100` / Not matched / Match `0101` / Not matched / Not matched `0200` / Data not present / Match `0201` / Data not present / Not matched `0002` / Match / Data not present `0102` / Not matched / Data not present `0303` / Not validated / Not validated For card security verification, the code indicates whether the verification check passed and can have these possible values: - `0000` – Passed - `0001` – Did not pass For a transaction, the code describes the outcome of the attempted transaction. For the full list of transaction codes, see [Transaction response codes](https://www.marqeta.com/docs/developer-guides/about-transactions.md#_transaction_response_codes). **Allowable Values:** Four-digit code | | response.**memo** string Returned | Additional text that describes the response. **Allowable Values:** 255 char max | | state string Returned | Current status of the funding transaction. **Allowable Values:** `PENDING`, `CLEARED`, `COMPLETION`, `DECLINED`, `ERROR`, `REVERSED` | | tags string Conditionally returned | Comma-delimited list of tags describing the GPA order. This field is returned if it exists in the resource. **Allowable Values:** 255 char max | | token string Returned | Unique identifier of the GPA order. **Allowable Values:** 36 char max | | transaction\_token string Returned | Unique identifier of the transaction being funded. **Allowable Values:** Format: UUID | | user\_token string Conditionally returned | Unique identifier of the user resource. This field is returned if it exists in the resource. **Allowable Values:** Existing user resource token | ## Sample response body ```json JSON expandable lines wrap theme={null} { "token": "my_gpaorder_01", "amount": 1000, "created_time": "2024-11-30T23:00:15Z", "last_modified_time": "2024-11-30T23:10:15Z", "transaction_token": 156, "state": "COMPLETION", "response": { "code": "0000", "memo": "Approved or completed successfully" }, "funding": { "amount": 1000, "source": { "type": "program", "token": "**********e_01", "active": true, "name": "my_program_funding_source_01", "is_default_account": false, "created_time": "2025-03-31T19:13:23Z", "last_modified_time": "2025-03-31T19:13:23Z" } }, "funding_source_token": "**********e_01", "user_token": "my_user_01", "source_load_type": "ach", "currency_code": "USD" } ``` ## Related topics - [GPA Orders Overview](https://www.marqeta.com/docs/core-api/gpa-orders.md) - [List GPA unloads](https://www.marqeta.com/docs/core-api/gpa-orders/gpa-unloads/list-unloads.md) - [Create GPA order](https://www.marqeta.com/docs/core-api/gpa-orders/create-gpa-order.md) - [Retrieve GPA unload](https://www.marqeta.com/docs/core-api/gpa-orders/gpa-unloads/retrieve-unload.md) - [GPA Orders Object](https://www.marqeta.com/docs/core-api/gpa-orders/gpa-orders-object.md)