Profile GraphQL API
The Profile GraphQL API is the primary way to interact with a specific Profile's data. If you're new to GraphQL, please see our overview guide to get started.
API Endpoints
https://api.quiltt.io/v1/graphqlHeaders
Authorization: Bearer <SESSION_TOKEN>
Content-Type: application/jsonAuthorization
To access the Profile GraphQL API, you can use Basic Auth or Session Tokens, passed in via the HTTP Authorization header of your request.
Basic Auth is the best approach for server-to-server API calls, using a Base64-encoded combination of the Profile ID and API Key secret. See the Basic Auth documentation for more details.
Authorization: Basic <Base64-encoded profileId:API_KEY_SECRET>
Session tokens allow client-side access to the API, and must be generated for each Profile. See the Session Tokens guide for more information.
Authorization: Bearer <SESSION_TOKEN>
Introspection
Many popular GraphQL libraries make use of GraphQL's powerful introspection system to dynamically generate typings, access documentation and more. See the official GraphQL documentation to learn more.
The introspection system is available out of the box for all authenticated requests. If you need to access introspection outside the context of a particular Profile - say during a build task - you can provide your API Key secret as a Bearer token:
Authorization: Bearer <API_KEY_SECRET>
TypeScript
If you're using TypeScript in your project, you can leverage introspection to automatically generate typings as part of your build process. One popular approach is to use the GraphQL Codegen tool. See a tutorial on how to set up GraphQL Codegen with Quiltt here: https://www.quiltt.dev/get-started/tutorials/graphql-tooling
Queries
account
Example
Query
query account($id: ID!) {
account(id: $id) {
balance {
...BalanceFragment
}
connection {
...ConnectionFragment
}
currencyCode
holdings {
...AccountHoldingConnectionFragment
}
id
institution {
...InstitutionFragment
}
kind
mask
metadata
name
owners {
...AccountOwnerFragment
}
provider
remoteData {
...AccountRemoteDataFragment
}
state
statements {
...StatementConnectionFragment
}
taxonomy
transactedFirstOn
transactedLastOn
transactions {
...TransactionConnectionFragment
}
type
verified
}
}
Variables
{"id": "acct_12Hz9Dz7vEAuljYvhmPcvM9"}
Response
{
"data": {
"account": {
"balance": Balance,
"connection": Connection,
"currencyCode": "USD",
"holdings": AccountHoldingConnection,
"id": "acct_12Hz9Dz7vEAuljYvhmPcvM9",
"institution": Institution,
"kind": "DEPOSITORY",
"mask": "3141",
"metadata": {"accountNickname": "My favorite checking account"},
"name": "Super fancy checking",
"owners": [AccountOwner],
"provider": "MX",
"remoteData": AccountRemoteData,
"state": "OPEN",
"statements": StatementConnection,
"taxonomy": ["ASSET", "DEPOSITORY", "SPENDING"],
"transactedFirstOn": "2023-10-01",
"transactedLastOn": "2025-04-15",
"transactions": TransactionConnection,
"type": "CHECKING",
"verified": false
}
}
}
accounts
Description
Get a list of Accounts. You can apply filters, search and sort to refine the list.
See the Accounts guide for more information and examples.
Response
Returns [Account!]
Arguments
| Name | Description |
|---|---|
filter - AccountFilter | |
search - SearchQuery | |
sort - AccountSort |
Example
Query
query accounts(
$filter: AccountFilter,
$search: SearchQuery,
$sort: AccountSort
) {
accounts(
filter: $filter,
search: $search,
sort: $sort
) {
balance {
...BalanceFragment
}
connection {
...ConnectionFragment
}
currencyCode
holdings {
...AccountHoldingConnectionFragment
}
id
institution {
...InstitutionFragment
}
kind
mask
metadata
name
owners {
...AccountOwnerFragment
}
provider
remoteData {
...AccountRemoteDataFragment
}
state
statements {
...StatementConnectionFragment
}
taxonomy
transactedFirstOn
transactedLastOn
transactions {
...TransactionConnectionFragment
}
type
verified
}
}
Variables
{
"filter": AccountFilter,
"search": SearchQuery,
"sort": "LAST_TRANSACTED_ON_ASC"
}
Response
{
"data": {
"accounts": [
{
"balance": Balance,
"connection": Connection,
"currencyCode": "USD",
"holdings": AccountHoldingConnection,
"id": "acct_12Hz9Dz7vEAuljYvhmPcvM9",
"institution": Institution,
"kind": "DEPOSITORY",
"mask": "3141",
"metadata": {"accountNickname": "My favorite checking account"},
"name": "Super fancy checking",
"owners": [AccountOwner],
"provider": "MX",
"remoteData": AccountRemoteData,
"state": "OPEN",
"statements": StatementConnection,
"taxonomy": ["ASSET", "DEPOSITORY", "SPENDING"],
"transactedFirstOn": "2023-10-01",
"transactedLastOn": "2025-04-15",
"transactions": TransactionConnection,
"type": "CHECKING",
"verified": true
}
]
}
}
connection
Description
Look up a Connection by its ID.
See the Connections guide for more information and examples.
Response
Returns a Connection
Arguments
| Name | Description |
|---|---|
id - ID! | The ID of the Connection. |
Example
Query
query connection($id: ID!) {
connection(id: $id) {
accounts {
...AccountFragment
}
at
externallyManaged
features
id
institution {
...InstitutionFragment
}
metadata
oauth
products
provider
remoteData {
...ConnectionRemoteDataFragment
}
status
}
}
Variables
{"id": "conn_14TJiFDKRJlPiBHuukUIlXZ"}
Response
{
"data": {
"connection": {
"accounts": [Account],
"at": "2007-12-03T10:15:30Z",
"externallyManaged": false,
"features": ["ACCOUNT_NUMBERS"],
"id": "conn_14TJiFDKRJlPiBHuukUIlXZ",
"institution": Institution,
"metadata": {"hiddenFromUI": true},
"oauth": true,
"products": ["ACCOUNT_NUMBERS"],
"provider": "MX",
"remoteData": ConnectionRemoteData,
"status": "SYNCED"
}
}
}
connections
Description
Get a list of Connections. You can apply filters to refine the list.
See the Connections guide for more information and examples.
Response
Returns [Connection!]
Arguments
| Name | Description |
|---|---|
filter - ConnectionFilter |
Example
Query
query connections($filter: ConnectionFilter) {
connections(filter: $filter) {
accounts {
...AccountFragment
}
at
externallyManaged
features
id
institution {
...InstitutionFragment
}
metadata
oauth
products
provider
remoteData {
...ConnectionRemoteDataFragment
}
status
}
}
Variables
{"filter": ConnectionFilter}
Response
{
"data": {
"connections": [
{
"accounts": [Account],
"at": "2007-12-03T10:15:30Z",
"externallyManaged": false,
"features": ["ACCOUNT_NUMBERS"],
"id": "conn_14TJiFDKRJlPiBHuukUIlXZ",
"institution": Institution,
"metadata": {"hiddenFromUI": true},
"oauth": false,
"products": ["ACCOUNT_NUMBERS"],
"provider": "MX",
"remoteData": ConnectionRemoteData,
"status": "SYNCED"
}
]
}
}
holding
Description
Look up a Holding by its ID.
Example
Query
query holding($id: ID!) {
holding(id: $id) {
account {
...AccountFragment
}
at
id
price
quantity
remoteData {
...HoldingRemoteDataFragment
}
security {
...SecurityFragment
}
value
}
}
Variables
{"id": "hld_12Hz9Dz7vEvM9AuljYvhmPc"}
Response
{
"data": {
"holding": {
"account": Account,
"at": "2025-01-24T14:15:22Z",
"id": "hld_12Hz9Dz7vEvM9AuljYvhmPc",
"price": 987.65,
"quantity": 123.45,
"remoteData": HoldingRemoteData,
"security": Security,
"value": 123.45
}
}
}
holdings
Description
Get a paginated list of up to 100 Holdings.
Response
Returns a HoldingConnection!
Arguments
| Name | Description |
|---|---|
after - String | Returns the elements in the list that come after the specified cursor. |
before - String | Returns the elements in the list that come before the specified cursor. |
first - Int | Returns the first n elements from the list. |
last - Int | Returns the last n elements from the list. |
Example
Query
query holdings(
$after: String,
$before: String,
$first: Int,
$last: Int
) {
holdings(
after: $after,
before: $before,
first: $first,
last: $last
) {
count
edges {
...HoldingEdgeFragment
}
nodes {
...HoldingFragment
}
pageInfo {
...PageInfoFragment
}
}
}
Variables
{
"after": "xyz789",
"before": "xyz789",
"first": 987,
"last": 123
}
Response
{
"data": {
"holdings": {
"count": 987,
"edges": [HoldingEdge],
"nodes": [Holding],
"pageInfo": PageInfo
}
}
}
profile
Description
Access information about the authenticated Profile.
Response
Returns a Profile!
Example
Query
query profile {
profile {
address {
...ProfileAddressFragment
}
dateOfBirth
email
id
metadata
name
names {
...ProfileNameFragment
}
phone
remoteData {
...ProfileRemoteDataFragment
}
uuid
}
}
Response
{
"data": {
"profile": {
"address": ProfileAddress,
"dateOfBirth": "2007-12-03",
"email": "[email protected]",
"id": "p_1hyoxpVVFib1HngGwKAzIr",
"metadata": {
"firebaseId": "4Wz7x0QkPdNNzgRgjZ4iIzMKjXo2",
"avatar": "https://www.gravatar.com/avatar/5658ffccee7f0ebfda2b226238b1eb6e",
"favoriteColor": "Purple"
},
"name": "Quiltty",
"names": ProfileName,
"phone": "+14155552671",
"remoteData": ProfileRemoteData,
"uuid": "174ec567-2492-4498-a706-504a79437235"
}
}
}
statement
Description
Look up a Statement by its ID.
Example
Query
query statement($id: ID!) {
statement(id: $id) {
account {
...AccountFragment
}
endOn
id
startOn
url
}
}
Variables
{"id": "stmt_11zBVgTOO9DR1vbAZxb6Ldb"}
Response
{
"data": {
"statement": {
"account": Account,
"endOn": "2007-12-03",
"id": "stmt_11zBVgTOO9DR1vbAZxb6Ldb",
"startOn": "2007-12-03",
"url": "http://www.test.com/"
}
}
}
statements
Description
Get a paginated list of up to 100 Statements.
Response
Returns a StatementConnection!
Arguments
| Name | Description |
|---|---|
after - String | Returns the elements in the list that come after the specified cursor. |
before - String | Returns the elements in the list that come before the specified cursor. |
filter - StatementFilter | |
first - Int | Returns the first n elements from the list. |
sort - StatementSort | Default = DATE_DESC |
Example
Query
query statements(
$after: String,
$before: String,
$filter: StatementFilter,
$first: Int,
$sort: StatementSort
) {
statements(
after: $after,
before: $before,
filter: $filter,
first: $first,
sort: $sort
) {
count
edges {
...StatementEdgeFragment
}
nodes {
...StatementFragment
}
pageInfo {
...PageInfoFragment
}
}
}
Variables
{
"after": "abc123",
"before": "xyz789",
"filter": StatementFilter,
"first": 987,
"sort": "DATE_DESC"
}
Response
{
"data": {
"statements": {
"count": 123,
"edges": [StatementEdge],
"nodes": [Statement],
"pageInfo": PageInfo
}
}
}
transaction
Description
Look up a Transaction by its ID.
See the Transactions guide for more information and examples.
Response
Returns a Transaction
Arguments
| Name | Description |
|---|---|
id - ID! | The ID of the Transaction. |
Example
Query
query transaction($id: ID!) {
transaction(id: $id) {
account {
...AccountFragment
}
amount
currencyCode
date
description
entryType
fees
id
kind
logo {
...ImageFragment
}
metadata
price
provider
quantity
remoteData {
...TransactionRemoteDataFragment
}
security {
...SecurityFragment
}
status
}
}
Variables
{"id": "txn_11VgTOO9DR1vbAZxb6zBLdb"}
Response
{
"data": {
"transaction": {
"account": Account,
"amount": 987.65,
"currencyCode": "USD",
"date": "2007-12-03",
"description": "Chipotle Mexican Grill",
"entryType": "CREDIT",
"fees": 987.65,
"id": "txn_11VgTOO9DR1vbAZxb6zBLdb",
"kind": "DEPOSITORY",
"logo": Image,
"metadata": {"userDefinedName": "My favorite transaction"},
"price": 987.65,
"provider": "AKOYA",
"quantity": 987.65,
"remoteData": TransactionRemoteData,
"security": Security,
"status": "POSTED"
}
}
}
transactions
Description
Get a paginated list of up to 100 Transactions. You can apply filters, search and sort to refine the list.
See the Transactions guide and the Pagination guide for more information and examples.
Response
Returns a TransactionConnection!
Arguments
| Name | Description |
|---|---|
after - String | Returns the elements in the list that come after the specified cursor. |
before - String | Returns the elements in the list that come before the specified cursor. |
filter - TransactionFilter | |
first - Int | Returns the first n elements from the list. |
last - Int | Returns the last n elements from the list. |
search - SearchQuery | |
sort - TransactionSort | Default = DATE_DESC |
Example
Query
query transactions(
$after: String,
$before: String,
$filter: TransactionFilter,
$first: Int,
$last: Int,
$search: SearchQuery,
$sort: TransactionSort
) {
transactions(
after: $after,
before: $before,
filter: $filter,
first: $first,
last: $last,
search: $search,
sort: $sort
) {
count
edges {
...TransactionEdgeFragment
}
nodes {
...TransactionFragment
}
pageInfo {
...PageInfoFragment
}
}
}
Variables
{
"after": "xyz789",
"before": "abc123",
"filter": TransactionFilter,
"first": 123,
"last": 987,
"search": SearchQuery,
"sort": "DATE_DESC"
}
Response
{
"data": {
"transactions": {
"count": 987,
"edges": [TransactionEdge],
"nodes": [Transaction],
"pageInfo": PageInfo
}
}
}
Mutations
accountUpdate
Response
Returns an AccountUpdatePayload
Arguments
| Name | Description |
|---|---|
input - AccountUpdateInput! | Parameters for AccountUpdate |
Example
Query
mutation accountUpdate($input: AccountUpdateInput!) {
accountUpdate(input: $input) {
clientMutationId
errors {
...ErrorFragment
}
record {
...AccountFragment
}
success
}
}
Variables
{"input": AccountUpdateInput}
Response
{
"data": {
"accountUpdate": {
"clientMutationId": "xyz789",
"errors": [Error],
"record": Account,
"success": true
}
}
}
connectionDisconnect
Description
Enqueue a Connection to be disconnected. This will begin the process of disconnecting the Connection from the upstream provider and change the Connection's status. to DISCONNECTED.
See the Connections guide for more information and examples.
Response
Returns a ConnectionDisconnectPayload
Arguments
| Name | Description |
|---|---|
input - ConnectionDisconnectInput! | Parameters for ConnectionDisconnect |
Example
Query
mutation connectionDisconnect($input: ConnectionDisconnectInput!) {
connectionDisconnect(input: $input) {
clientMutationId
errors {
...ErrorFragment
}
record {
...ConnectionFragment
}
success
}
}
Variables
{"input": ConnectionDisconnectInput}
Response
{
"data": {
"connectionDisconnect": {
"clientMutationId": "abc123",
"errors": [Error],
"record": Connection,
"success": false
}
}
}
connectionSimulateError
Description
Put an active Connection into a user-repairable error state. This allows you to simulate repairing Connection errors by passing the Connection ID to the Quiltt Connector. Note that this mutation is not available in PRODUCTION environments.
See the Reconnect guide for more information and examples.
Response
Returns a ConnectionSimulateErrorPayload
Arguments
| Name | Description |
|---|---|
input - ConnectionSimulateErrorInput! | Parameters for ConnectionSimulateError |
Example
Query
mutation connectionSimulateError($input: ConnectionSimulateErrorInput!) {
connectionSimulateError(input: $input) {
clientMutationId
errors {
...ErrorFragment
}
record {
...ConnectionFragment
}
success
}
}
Variables
{"input": ConnectionSimulateErrorInput}
Response
{
"data": {
"connectionSimulateError": {
"clientMutationId": "abc123",
"errors": [Error],
"record": Connection,
"success": false
}
}
}
connectionUpdate
Description
Update a Connection's metadata.
See the Connections guide for more information and examples.
Note that updating a Connection's products requires the end-user going through the Connector Reconnect flow.
Response
Returns a ConnectionUpdatePayload
Arguments
| Name | Description |
|---|---|
input - ConnectionUpdateInput! | Parameters for ConnectionUpdate |
Example
Query
mutation connectionUpdate($input: ConnectionUpdateInput!) {
connectionUpdate(input: $input) {
clientMutationId
errors {
...ErrorFragment
}
record {
...ConnectionFragment
}
success
}
}
Variables
{"input": ConnectionUpdateInput}
Response
{
"data": {
"connectionUpdate": {
"clientMutationId": "abc123",
"errors": [Error],
"record": Connection,
"success": true
}
}
}
profileUpdate
Description
Update Profile information like the name, email or metadata.
See the Profiles guide for more information and examples.
Response
Returns a ProfileUpdatePayload
Arguments
| Name | Description |
|---|---|
input - ProfileUpdateInput! | Parameters for ProfileUpdate |
Example
Query
mutation profileUpdate($input: ProfileUpdateInput!) {
profileUpdate(input: $input) {
clientMutationId
errors {
...ErrorFragment
}
record {
...ProfileFragment
}
success
}
}
Variables
{"input": ProfileUpdateInput}
Response
{
"data": {
"profileUpdate": {
"clientMutationId": "abc123",
"errors": [Error],
"record": Profile,
"success": false
}
}
}
transactionUpdate
Description
Update a transaction's metadata.
Response
Returns a TransactionUpdatePayload
Arguments
| Name | Description |
|---|---|
input - TransactionUpdateInput! | Parameters for TransactionUpdate |
Example
Query
mutation transactionUpdate($input: TransactionUpdateInput!) {
transactionUpdate(input: $input) {
clientMutationId
errors {
...ErrorFragment
}
record {
...TransactionFragment
}
success
}
}
Variables
{"input": TransactionUpdateInput}
Response
{
"data": {
"transactionUpdate": {
"clientMutationId": "xyz789",
"errors": [Error],
"record": Transaction,
"success": true
}
}
}
Subscriptions
accountVerified
Description
An Account was verified for money movement.
Response
Returns an AccountVerifiedPayload!
Arguments
| Name | Description |
|---|---|
accountId - ID | The ID of the Account. |
Example
Query
subscription accountVerified($accountId: ID) {
accountVerified(accountId: $accountId) {
account {
...AccountFragment
}
}
}
Variables
{"accountId": "4"}
Response
{"data": {"accountVerified": {"account": Account}}}
connectionCreated
Description
A Connection was created.
Response
Returns a ConnectionCreatedPayload!
Example
Query
subscription connectionCreated {
connectionCreated {
connection {
...ConnectionFragment
}
}
}
Response
{
"data": {
"connectionCreated": {"connection": Connection}
}
}
connectionSynced
Description
A Connection was synced.
Response
Returns a ConnectionSyncedPayload!
Arguments
| Name | Description |
|---|---|
connectionId - ID | The ID of the Connection. |
Example
Query
subscription connectionSynced($connectionId: ID) {
connectionSynced(connectionId: $connectionId) {
connection {
...ConnectionFragment
}
}
}
Variables
{"connectionId": 4}
Response
{"data": {"connectionSynced": {"connection": Connection}}}
Types
Account
Description
An Account represents the accounting of a banking relationship.
Fields
| Field Name | Description |
|---|---|
balance - Balance | The most recent Balance for the Account. |
connection - Connection | The primary Connection for this Account. |
currencyCode - CurrencyCode | The ISO-4217 currency code of the Account |
holdings - AccountHoldingConnection | The Account's list of Investment Holdings. |
id - ID! | The ID of the Account. |
institution - Institution! | The Institution where the Account is held. |
kind - AccountKind | Represents the classification of an Account. |
mask - String | A mostly unique identifier, typically the last 4 numbers of the Account. |
metadata - JSON | Custom metadata about the Account, stored in a 'key-value' format. See the Custom Metadata guide for more information and examples. |
name - String! | The Name of the Account |
owners - [AccountOwner!] | The Account's list of Account Owners. |
provider - ConnectionProvider! | The original provider of the Account. |
remoteData - AccountRemoteData | The Remote Data associated with the Account. See the Remote Data guide for more information. |
state - AccountState! | Represents the current state of an Account. Accounts that are marked as |
statements - StatementConnection | The Account's list of Statements. |
Arguments
| |
taxonomy - [AccountTaxonomyMember!]! | Represents the taxonomic hierarchy of an Account, as an array of Taxonomy Members.
|
transactedFirstOn - Date | The date of the earliest known Transaction. |
transactedLastOn - Date | The date of the most recent known Transaction. |
transactions - TransactionConnection! | A paginated list of Transactions. |
Arguments
| |
type - AccountType! | Represents the classification of an Account. Use kind or taxonomy |
verified - Boolean! | Specifies whether the Account has been verified for money movement. |
Example
{
"balance": Balance,
"connection": Connection,
"currencyCode": "USD",
"holdings": AccountHoldingConnection,
"id": "acct_12Hz9Dz7vEAuljYvhmPcvM9",
"institution": Institution,
"kind": "DEPOSITORY",
"mask": "3141",
"metadata": {"accountNickname": "My favorite checking account"},
"name": "Super fancy checking",
"owners": [AccountOwner],
"provider": "MX",
"remoteData": AccountRemoteData,
"state": "OPEN",
"statements": StatementConnection,
"taxonomy": ["ASSET", "DEPOSITORY", "SPENDING"],
"transactedFirstOn": "2023-10-01",
"transactedLastOn": "2025-04-15",
"transactions": TransactionConnection,
"type": "CHECKING",
"verified": true
}
AccountFilter
Description
Options for filtering Accounts.
Fields
| Input Field | Description |
|---|---|
connection_status - [ConnectionStatus!] | Filter accounts by the status of its Connection. Examples:
|
connection_status_not - [ConnectionStatus!] | Exclude accounts by the status of its Connection. Examples:
|
kind - [AccountKind!] | The Account classifications to include, supplied as an array or a single value. |
kind_not - [AccountKind!] | The Account classifications to exclude, supplied as an array or a single value. |
metadata - JSON | Filter by the contents of Account Examples:
|
state - [AccountState!] | The Account states to include, supplied as an array or a single value. |
transactedFirstOn - Date | The date of the earliest known Transaction. |
transactedFirstOn_gt - Date | Greater than the date of the earliest known Transaction. |
transactedFirstOn_gte - Date | Greater than or equal to the date of the earliest known Transaction. |
transactedFirstOn_lt - Date | Less than the date of the earliest known Transaction. |
transactedFirstOn_lte - Date | Less than or equal to the date of the earliest known Transaction. |
transactedLastOn - Date | The date of the most recent known Transaction. |
transactedLastOn_gt - Date | Greater than the date of the most recent known Transaction. |
transactedLastOn_gte - Date | Greater than or equal to the date of the most recent known Transaction. |
transactedLastOn_lt - Date | Less than the date of the most recent known Transaction. |
transactedLastOn_lte - Date | Less than or equal to the date of the most recent known Transaction. |
verified - Boolean | Filter by whether Accounts have been verified for money movement. |
Example
{
"connection_status": ["SYNCED"],
"connection_status_not": ["INITIALIZING", "SYNCING"],
"kind": ["DEPOSITORY"],
"kind_not": ["LOAN"],
"metadata": {},
"state": ["OPEN"],
"transactedFirstOn": "2007-12-03",
"transactedFirstOn_gt": "2007-12-03",
"transactedFirstOn_gte": "2007-12-03",
"transactedFirstOn_lt": "2007-12-03",
"transactedFirstOn_lte": "2007-12-03",
"transactedLastOn": "2007-12-03",
"transactedLastOn_gt": "2007-12-03",
"transactedLastOn_gte": "2007-12-03",
"transactedLastOn_lt": "2007-12-03",
"transactedLastOn_lte": "2007-12-03",
"verified": false
}
AccountHolding
Description
Represents an Account Investment Holding.
Fields
| Field Name | Description |
|---|---|
account - Account! | The Account that is holding the securities. |
at - DateTime! | The timestamp of the Holding record. |
id - ID! | The ID of the Account Holding. |
price - Float | The latest price for the holding |
quantity - Float | The number of shares being held |
remoteData - HoldingRemoteData | The Remote Data associated with the Account Holding. See the Remote Data guide for more information. |
security - Security | The Security associated with the Investment Holding. |
value - Float | The value of the holding |
Example
{
"account": Account,
"at": "2025-01-24T14:15:22Z",
"id": "hld_12Hz9Dz7vEvM9AuljYvhmPc",
"price": 987.65,
"quantity": 123.45,
"remoteData": HoldingRemoteData,
"security": Security,
"value": 987.65
}
AccountHoldingConnection
Description
The connection type for AccountHolding.
Fields
| Field Name | Description |
|---|---|
count - Int! | The total number of records. |
edges - [AccountHoldingEdge] | A list of edges. |
nodes - [AccountHolding] | A list of nodes. |
pageInfo - PageInfo! | Information to aid in pagination. |
Example
{
"count": 123,
"edges": [AccountHoldingEdge],
"nodes": [AccountHolding],
"pageInfo": PageInfo
}
AccountHoldingEdge
Description
An edge in a connection.
Fields
| Field Name | Description |
|---|---|
cursor - String! | A cursor for use in pagination. |
node - AccountHolding | The item at the end of the edge. |
Example
{
"cursor": "xyz789",
"node": AccountHolding
}
AccountKind
Description
Represents the classification of an Account.
Values
| Enum Value | Description |
|---|---|
|
| Checking, Savings and cash management. |
|
| Brokerage, retirement and other investments. |
|
| Credit cards, and Lines of Credit. |
|
| Mortgage, student and installment loans. |
Example
"DEPOSITORY"
AccountOwner
Description
Represents the registered details of an Account Owner.
Fields
| Field Name | Description |
|---|---|
addresses - [Address!] | The registered addresses of the Account Owner. |
emails - [Email!] | The registered email addresses of the Account Owner. |
id - ID! | The ID of the Account Owner. |
names - [Name!] | The registered legal names of the Account Owner. |
phones - [Phone!] | The registered phone numbers of the Account Owner. |
remoteData - AccountOwnerRemoteData | The Remote Data associated with an Account Owner. |
Example
{
"addresses": [Address],
"emails": [Email],
"id": "12Hz9Dz7vEAuljYvhmPcvM9",
"names": [Name],
"phones": [Phone],
"remoteData": AccountOwnerRemoteData
}
AccountOwnerRemoteData
Description
Remote data associated with an Account Owner.
Fields
| Field Name | Description |
|---|---|
akoya - AccountOwnerRemoteDataAkoya | The Akoya Remote Data associated with the Account Owner. |
finicity - AccountOwnerRemoteDataFinicity | The Finicity Remote Data associated with the Account Owner. |
mock - AccountOwnerRemoteDataMock | The Mock Remote Data associated with the Account Owner. |
mx - AccountOwnerRemoteDataMx | The MX Remote Data associated with the Account Owner. |
plaid - AccountOwnerRemoteDataPlaid | The Plaid Remote Data associated with the Account Owner. |
Example
{
"akoya": AccountOwnerRemoteDataAkoya,
"finicity": AccountOwnerRemoteDataFinicity,
"mock": AccountOwnerRemoteDataMock,
"mx": AccountOwnerRemoteDataMx,
"plaid": AccountOwnerRemoteDataPlaid
}
AccountOwnerRemoteDataAkoya
Description
The Akoya Remote Data associated with the Account Owner.
Fields
| Field Name | Description |
|---|---|
owner - AccountRemoteDataAkoyaOwner | Akoya Account Owner Remote Data |
Example
{"owner": AccountRemoteDataAkoyaOwner}
AccountOwnerRemoteDataFinicity
Description
The Finicity Remote Data associated with the Account Owner.
Fields
| Field Name | Description |
|---|---|
owner - AccountRemoteDataFinicityOwner | Finicity Account Owner Remote Data |
Example
{"owner": AccountRemoteDataFinicityOwner}
AccountOwnerRemoteDataMock
Description
The Mock Remote Data associated with the Account Owner.
Fields
| Field Name | Description |
|---|---|
owner - AccountRemoteDataMockOwner | Mock Account Owner Remote Data |
Example
{"owner": AccountRemoteDataMockOwner}
AccountOwnerRemoteDataMx
Description
The MX Remote Data associated with the Account Owner.
Fields
| Field Name | Description |
|---|---|
owner - AccountRemoteDataMxOwner | MX Account Owner Remote Data |
Example
{"owner": AccountRemoteDataMxOwner}
AccountOwnerRemoteDataPlaid
Description
The Plaid Remote Data associated with the Account Owner.
Fields
| Field Name | Description |
|---|---|
owner - AccountRemoteDataPlaidOwner | Plaid Account Owner Remote Data |
Example
{"owner": AccountRemoteDataPlaidOwner}
AccountRemoteData
Description
Remote data associated with an Account.
Fields
| Field Name | Description |
|---|---|
akoya - AccountRemoteDataAkoya | The Akoya remote data associated with the Account. |
finicity - AccountRemoteDataFinicity | The Finicity remote data associated with the Account. |
mock - AccountRemoteDataMock | The Mock remote data associated with the Account. |
mx - AccountRemoteDataMx | The MX remote data associated with the Account. |
plaid - AccountRemoteDataPlaid | The Plaid remote data associated with the Account. |
Example
{
"akoya": AccountRemoteDataAkoya,
"finicity": AccountRemoteDataFinicity,
"mock": AccountRemoteDataMock,
"mx": AccountRemoteDataMx,
"plaid": AccountRemoteDataPlaid
}
AccountRemoteDataAkoya
Description
Account-level data from Akoya.
Fields
| Field Name | Description |
|---|---|
account - AccountRemoteDataAkoyaAccount | The base Account data from Akoya. |
Example
{"account": AccountRemoteDataAkoyaAccount}
AccountRemoteDataAkoyaAccount
Description
The Account data from Akoya.
Fields
| Field Name | Description |
|---|---|
id - String! | The record's Akoya ID. |
response - RemoteDataAkoyaAccount | The response body. |
timestamp - DateTime! | The date and time when the data was fetched. |
Example
{
"id": "xyz789",
"response": RemoteDataAkoyaAccount,
"timestamp": "2025-03-24T12:25:12Z"
}
AccountRemoteDataAkoyaOwner
Description
The Owner data from Akoya.
Fields
| Field Name | Description |
|---|---|
id - String! | The record's Akoya ID. |
response - RemoteDataAkoyaAccountHolder | The response body. |
timestamp - DateTime! | The date and time when the data was fetched. |
Example
{
"id": "abc123",
"response": RemoteDataAkoyaAccountHolder,
"timestamp": "2025-03-24T12:25:12Z"
}
AccountRemoteDataFinicity
Description
Account-level data from Finicity.
Fields
| Field Name | Description |
|---|---|
account - AccountRemoteDataFinicityAccount | The base Account data from Finicity. |
Example
{"account": AccountRemoteDataFinicityAccount}
AccountRemoteDataFinicityAccount
Description
The Account data from Finicity.
Fields
| Field Name | Description |
|---|---|
id - String! | The record's Finicity ID. |
response - RemoteDataFinicityCustomerAccount | The response body. |
timestamp - DateTime! | The date and time when the data was fetched. |
Example
{
"id": "abc123",
"response": RemoteDataFinicityCustomerAccount,
"timestamp": "2025-03-24T12:25:12Z"
}
AccountRemoteDataFinicityOwner
Description
The Owner data from Finicity.
Fields
| Field Name | Description |
|---|---|
id - String! | The record's Finicity ID. |
response - RemoteDataFinicityAccountOwnerDetails | The response body. |
timestamp - DateTime! | The date and time when the data was fetched. |
Example
{
"id": "abc123",
"response": RemoteDataFinicityAccountOwnerDetails,
"timestamp": "2025-03-24T12:25:12Z"
}
AccountRemoteDataMock
Description
Account-level data from Mock.
Fields
| Field Name | Description |
|---|---|
account - AccountRemoteDataMockAccount | The base Account data from Mock. |
Example
{"account": AccountRemoteDataMockAccount}
AccountRemoteDataMockAccount
Description
The Account data from Mock.
Fields
| Field Name | Description |
|---|---|
id - String! | The record's Mock ID. |
response - RemoteDataMockAccount | The response body. |
timestamp - DateTime! | The date and time when the data was fetched. |
Example
{
"id": "abc123",
"response": RemoteDataMockAccount,
"timestamp": "2025-03-24T12:25:12Z"
}
AccountRemoteDataMockOwner
Description
The Owner data from Mock.
Fields
| Field Name | Description |
|---|---|
id - String! | The record's Mock ID. |
response - RemoteDataMockOwner | The response body. |
timestamp - DateTime! | The date and time when the data was fetched. |
Example
{
"id": "xyz789",
"response": RemoteDataMockOwner,
"timestamp": "2025-03-24T12:25:12Z"
}
AccountRemoteDataMx
Description
Account-level data from MX.
Fields
| Field Name | Description |
|---|---|
account - AccountRemoteDataMxAccount | The base Account data from MX. |
Example
{"account": AccountRemoteDataMxAccount}
AccountRemoteDataMxAccount
Description
The Account data from Mx.
Fields
| Field Name | Description |
|---|---|
id - String! | The record's Mx ID. |
response - RemoteDataMxAccount | The response body. |
timestamp - DateTime! | The date and time when the data was fetched. |
Example
{
"id": "abc123",
"response": RemoteDataMxAccount,
"timestamp": "2025-03-24T12:25:12Z"
}
AccountRemoteDataMxOwner
Description
The Owner data from Mx.
Fields
| Field Name | Description |
|---|---|
id - String! | The record's Mx ID. |
response - RemoteDataMxAccountOwner | The response body. |
timestamp - DateTime! | The date and time when the data was fetched. |
Example
{
"id": "xyz789",
"response": RemoteDataMxAccountOwner,
"timestamp": "2025-03-24T12:25:12Z"
}
AccountRemoteDataPlaid
Description
Account-level data from Plaid.
Fields
| Field Name | Description |
|---|---|
account - AccountRemoteDataPlaidAccount | The base Account data from Plaid. |
Example
{"account": AccountRemoteDataPlaidAccount}
AccountRemoteDataPlaidAccount
Description
The Account data from Plaid.
Fields
| Field Name | Description |
|---|---|
id - String! | The record's Plaid ID. |
response - RemoteDataPlaidAccount | The response body. |
timestamp - DateTime! | The date and time when the data was fetched. |
Example
{
"id": "abc123",
"response": RemoteDataPlaidAccount,
"timestamp": "2025-03-24T12:25:12Z"
}
AccountRemoteDataPlaidOwner
Description
The Owner data from Plaid.
Fields
| Field Name | Description |
|---|---|
id - String! | The record's Plaid ID. |
response - RemoteDataPlaidOwner | The response body. |
timestamp - DateTime! | The date and time when the data was fetched. |
Example
{
"id": "xyz789",
"response": RemoteDataPlaidOwner,
"timestamp": "2025-03-24T12:25:12Z"
}
AccountSort
Description
Options for sorting Accounts.
Values
| Enum Value | Description |
|---|---|
|
| Least-recently used first, most-recently used last |
|
| Most-recently used first, least-recently used last |
Example
"LAST_TRANSACTED_ON_ASC"
AccountState
Description
Represents the current state of an Account.
Values
| Enum Value | Description |
|---|---|
|
| Open |
|
| Terminated |
Example
"OPEN"
AccountTaxonomyMember
Description
Represents a member of the Account classification taxonomy
Values
| Enum Value | Description |
|---|---|
|
| Level 1: A financial resource expected to provide future benefits. This typically includes cash and investments, but can also include credit accounts with positive balances. |
|
| Level 1: A financial obligation or debt owed to another party. This typically includes loan and credit accounts, but can also include depository accounts with overdrafts or negative balances. |
|
| Level 1: The balance sheet classification is unknown. This typically includes accounts that have not been fully synced or are missing balance information. |
|
| Level 2: Checking, Savings and cash management. |
|
| Level 2: Brokerage, retirement and other investments. |
|
| Level 2: Credit cards, and Lines of Credit. |
|
| Level 2: Mortgage, student and installment loans. |
|
| Level 3+: Auto Account |
|
| Level 3+: Card Account |
|
| Level 3+: Cash Management Account |
|
| Level 3+: Certificate Of Deposit Account |
|
| Level 3+: Electronic Benefit Transfer Account |
|
| Level 3+: Health Savings Account |
|
| Level 3+: Home Equity Account |
|
| Level 3+: Line Of Credit Account |
|
| Level 3+: Money Market Account |
|
| Level 3+: Mortgage Account |
|
| Level 3+: Prepaid Account |
|
| Level 3+: Retirement Account |
|
| Level 3+: Savings Account |
|
| Level 3+: Spending Account |
|
| Level 3+: Student Account |
Example
"ASSET"
AccountType
Description
Represents the classification of an Account.
Values
| Enum Value | Description |
|---|---|
|
| Checking and cash management. |
|
| Savings and money market. |
|
| Credit cards. |
|
| Lines of credit, mortgage, student and installment loans. |
|
| Brokerage, retirement and other investments. |
|
| All other Account types. |
Example
"CHECKING"
AccountUpdateInput
Description
Autogenerated input type of AccountUpdate
Example
{
"clientMutationId": "xyz789",
"id": "acct_12Hz9Dz7vEAuljYvhmPcvM9",
"metadata": {}
}
AccountUpdatePayload
Description
Autogenerated return type of AccountUpdate.
Example
{
"clientMutationId": "xyz789",
"errors": [Error],
"record": Account,
"success": false
}
AccountVerifiedPayload
Description
Autogenerated return type of AccountVerified.
Fields
| Field Name | Description |
|---|---|
account - Account | The verified Account |
Example
{"account": Account}
Address
Description
The legal address associated with the Profile.
Fields
| Field Name | Description |
|---|---|
city - String | The city. |
country - String | The short name of the country. |
countryCode - AddressCountryCode | ISO 3166-1 alpha-3 country code. |
line1 - String | The first line of the address. |
line2 - String | The second line of the address. |
line3 - String | The third line of the address. |
postalCode - String | The postal code or zip code. |
region - String | The state or province. |
regionCode - String | The two letter state or province code if available |
Example
{
"city": "Dallas",
"country": "USA",
"countryCode": "USA",
"line1": "1412 Main St",
"line2": "Suite 100",
"line3": "xyz789",
"postalCode": "75202",
"region": "Texas",
"regionCode": "TX"
}
AddressCountryCode
Description
ISO 3166-1 alpha-3 country code.
Values
| Enum Value | Description |
|---|---|
|
| Andorra |
|
| United Arab Emirates |
|
| Afghanistan |
|
| Antigua and Barbuda |
|
| Anguilla |
|
| Albania |
|
| Armenia |
|
| Angola |
|
| Antarctica |
|
| Argentina |
|
| American Samoa |
|
| Austria |
|
| Australia |
|
| Aruba |
|
| Åland Islands |
|
| Azerbaijan |
|
| Bosnia and Herzegovina |
|
| Barbados |
|
| Bangladesh |
|
| Belgium |
|
| Burkina Faso |
|
| Bulgaria |
|
| Bahrain |
|
| Burundi |
|
| Benin |
|
| Saint Barthélemy |
|
| Bermuda |
|
| Brunei Darussalam |
|
| Bolivia (Plurinational State of) |
|
| Bonaire, Sint Eustatius and Saba |
|
| Brazil |
|
| Bahamas |
|
| Bhutan |
|
| Bouvet Island |
|
| Botswana |
|
| Belarus |
|
| Belize |
|
| Canada |
|
| Cocos (Keeling) Islands |
|
| Congo (Democratic Republic of the) |
|
| Central African Republic |
|
| Congo |
|
| Switzerland |
|
| Côte d'Ivoire |
|
| Cook Islands |
|
| Chile |
|
| Cameroon |
|
| China |
|
| Colombia |
|
| Costa Rica |
|
| Cuba |
|
| Cabo Verde |
|
| Curaçao |
|
| Christmas Island |
|
| Cyprus |
|
| Czechia |
|
| Germany |
|
| Djibouti |
|
| Denmark |
|
| Dominica |
|
| Dominican Republic |
|
| Algeria |
|
| Ecuador |
|
| Estonia |
|
| Egypt |
|
| Western Sahara |
|
| Eritrea |
|
| Spain |
|
| Ethiopia |
|
| Finland |
|
| Fiji |
|
| Falkland Islands (Malvinas) |
|
| Micronesia (Federated States of) |
|
| Faroe Islands |
|
| France |
|
| Gabon |
|
| United Kingdom of Great Britain and Northern Ireland |
|
| Grenada |
|
| Georgia |
|
| French Guiana |
|
| Guernsey |
|
| Ghana |
|
| Gibraltar |
|
| Greenland |
|
| Gambia |
|
| Guinea |
|
| Guadeloupe |
|
| Equatorial Guinea |
|
| Greece |
|
| South Georgia and the South Sandwich Islands |
|
| Guatemala |
|
| Guam |
|
| Guinea-Bissau |
|
| Guyana |
|
| Hong Kong |
|
| Heard Island and McDonald Islands |
|
| Honduras |
|
| Croatia |
|
| Haiti |
|
| Hungary |
|
| Indonesia |
|
| Ireland |
|
| Israel |
|
| Isle of Man |
|
| India |
|
| British Indian Ocean Territory |
|
| Iraq |
|
| Iran (Islamic Republic of) |
|
| Iceland |
|
| Italy |
|
| Jersey |
|
| Jamaica |
|
| Jordan |
|
| Japan |
|
| Kenya |
|
| Kyrgyzstan |
|
| Cambodia |
|
| Kiribati |
|
| Comoros |
|
| Saint Kitts and Nevis |
|
| Korea (Democratic People's Republic of) |
|
| Korea (Republic of) |
|
| Kuwait |
|
| Cayman Islands |
|
| Kazakhstan |
|
| Lao People's Democratic Republic |
|
| Lebanon |
|
| Saint Lucia |
|
| Liechtenstein |
|
| Sri Lanka |
|
| Liberia |
|
| Lesotho |
|
| Lithuania |
|
| Luxembourg |
|
| Latvia |
|
| Libya |
|
| Morocco |
|
| Monaco |
|
| Moldova (Republic of) |
|
| Montenegro |
|
| Saint Martin (French part) |
|
| Madagascar |
|
| Marshall Islands |
|
| North Macedonia |
|
| Mali |
|
| Myanmar |
|
| Mongolia |
|
| Macao |
|
| Northern Mariana Islands |
|
| Martinique |
|
| Mauritania |
|
| Montserrat |
|
| Malta |
|
| Mauritius |
|
| Maldives |
|
| Malawi |
|
| Mexico |
|
| Malaysia |
|
| Mozambique |
|
| Namibia |
|
| New Caledonia |
|
| Niger |
|
| Norfolk Island |
|
| Nigeria |
|
| Nicaragua |
|
| Netherlands |
|
| Norway |
|
| Nepal |
|
| Nauru |
|
| Niue |
|
| New Zealand |
|
| Oman |
|
| Panama |
|
| Peru |
|
| French Polynesia |
|
| Papua New Guinea |
|
| Philippines |
|
| Pakistan |
|
| Poland |
|
| Saint Pierre and Miquelon |
|
| Pitcairn |
|
| Puerto Rico |
|
| Palestine, State of |
|
| Portugal |
|
| Palau |
|
| Paraguay |
|
| Qatar |
|
| Réunion |
|
| Romania |
|
| Serbia |
|
| Russian Federation |
|
| Rwanda |
|
| Saudi Arabia |
|
| Solomon Islands |
|
| Seychelles |
|
| Sudan |
|
| Sweden |
|
| Singapore |
|
| Saint Helena, Ascension and Tristan da Cunha |
|
| Slovenia |
|
| Svalbard and Jan Mayen |
|
| Slovakia |
|
| Sierra Leone |
|
| San Marino |
|
| Senegal |
|
| Somalia |
|
| Suriname |
|
| South Sudan |
|
| Sao Tome and Principe |
|
| El Salvador |
|
| Sint Maarten (Dutch part) |
|
| Syrian Arab Republic |
|
| Eswatini |
|
| Turks and Caicos Islands |
|
| Chad |
|
| French Southern Territories |
|
| Togo |
|
| Thailand |
|
| Tajikistan |
|
| Tokelau |
|
| Timor-Leste |
|
| Turkmenistan |
|
| Tunisia |
|
| Tonga |
|
| Türkiye |
|
| Trinidad and Tobago |
|
| Tuvalu |
|
| Taiwan, Province of China |
|
| Tanzania, United Republic of |
|
| Ukraine |
|
| Uganda |
|
| United States Minor Outlying Islands |
|
| United States of America |
|
| Uruguay |
|
| Uzbekistan |
|
| Holy See |
|
| Saint Vincent and the Grenadines |
|
| Venezuela (Bolivarian Republic of) |
|
| Virgin Islands (British) |
|
| Virgin Islands (U.S.) |
|
| Viet Nam |
|
| Vanuatu |
|
| Wallis and Futuna |
|
| Samoa |
|
| Yemen |
|
| Mayotte |
|
| South Africa |
|
| Zambia |
|
| Zimbabwe |
Example
"AND"
Balance
Description
Represents an Account Balance.
Fields
| Field Name | Description |
|---|---|
at - DateTime! | The timestamp of the Account Balance record. |
available - Float | The amount of funds accounting for pending Transactions. |
current - Float | The amount of funds based on posted Transactions. |
id - ID! | The ID of the Balance. |
limit - Float | The amount of funds that may be overdraft or spent on credit. |
source - BalanceSource! | The source of the Balance data. |
Example
{
"at": "2025-01-24T14:15:22Z",
"available": 31.41,
"current": 314.15,
"id": "bal_12vXOdjpsZIgB3Ae80Y7Pl",
"limit": 3141.59,
"source": "REFRESH"
}
BalanceSource
Description
Represents the source of the Balance data.
Values
| Enum Value | Description |
|---|---|
|
| Initial value from the provider. |
|
| Regular sync with the provider. |
|
| Provider response from a triggered Refresh Balance call. |
Example
"INITIAL"
BigInt
Description
Represents non-fractional signed whole numeric values. Since the value may exceed the size of a 32-bit integer, it's encoded as a string.
Example
{}
Boolean
Description
The Boolean scalar type represents true or false.
Example
true
Connection
Description
A Connection represents the data source for a Profile's accounts and transactions, such as a Plaid Item or MX member.
The easiest way to register connections is with the Quiltt Connector, which handles the configuration for Plaid Link and MX Connect.
Fields
| Field Name | Description |
|---|---|
accounts - [Account!]! | A list of Accounts. |
Arguments
| |
at - DateTime | Represents the most recent point at which data was synced with the underlying provider. It does not guarantee success of any particular sync operation - only that the current data represents the known upstream state as of this point in time. This is the timestamp you should use when deciding how much to trust the data. |
externallyManaged - Boolean! | Specifies whether this Connection is managed by an external system. When a Connection is imported as externally-managed, Quiltt will sync it, but disconnecting it will not revoke access from the upstream provider. |
features - [ConnectionFeature!]! | The products currently enabled on the Connection. Use products instead. |
id - ID! | The ID of the Connection. |
institution - Institution! | The Institution of the Connection. |
metadata - JSON | Custom metadata about the Connection, stored in a 'key-value' format. See the Custom Metadata guide for more information and examples. |
oauth - Boolean | Whether the Connection is established via OAuth. |
products - [ConnectionProduct!]! | The products currently enabled on the Connection. |
provider - ConnectionProvider! | Represents the data provider for the Connection. |
remoteData - ConnectionRemoteData | The Remote Data associated with the Connection. See the Remote Data guide for more information. |
status - ConnectionStatus! | Represents the current state of a Connection. |
Example
{
"accounts": [Account],
"at": "2007-12-03T10:15:30Z",
"externallyManaged": false,
"features": ["ACCOUNT_NUMBERS"],
"id": "conn_14TJiFDKRJlPiBHuukUIlXZ",
"institution": Institution,
"metadata": {"hiddenFromUI": true},
"oauth": true,
"products": ["ACCOUNT_NUMBERS"],
"provider": "MX",
"remoteData": ConnectionRemoteData,
"status": "SYNCED"
}
ConnectionCreatedPayload
Description
Autogenerated return type of ConnectionCreated.
Fields
| Field Name | Description |
|---|---|
connection - Connection | The newly created Connection. |
Example
{"connection": Connection}
ConnectionDisconnectInput
Description
Autogenerated input type of ConnectionDisconnect
Example
{
"clientMutationId": "abc123",
"id": "conn_14TJiFDKRJlPiBHuukUIlXZ"
}
ConnectionDisconnectPayload
Description
Autogenerated return type of ConnectionDisconnect.
Fields
| Field Name | Description |
|---|---|
clientMutationId - String | A unique identifier for the client performing the mutation. |
errors - [Error!] | List of errors from an unsuccessful mutation. |
record - Connection | The Connection to be disconnected. |
success - Boolean! | Specifies whether the mutation was successful. |
Example
{
"clientMutationId": "abc123",
"errors": [Error],
"record": Connection,
"success": false
}
ConnectionFeature
Description
Represents a product of a Connection.
Values
| Enum Value | Description |
|---|---|
|
| Access to verified account numbers to support money movement operations. When this product is provisioned, eligible accounts will be enabled for the Account Numbers and Processor Tokens endpoints. |
|
| Access to account-holder information to validate identity and account ownership. When this product is provisioned, account-holder information will become available via Remote Data. |
|
| Access to account investments holdings and transactions. Note that for some providers like MX, this product may be provisioned automatically. |
|
| Access to detailed account liabilities data. Note that for some providers like MX, this product may be provisioned automatically. |
|
| The ability to trigger live refreshes of account balances. |
|
| Access to Account Balances and Transaction with up to 24 months of history, depending on the provider. Note that MX typically provides 3-4 months of history and accessing 24 months of history is a "premium" product that incurs a one-time per-Connection fee. You can configure whether Quiltt should attempt to sync full history on the MX Integration page in the Dashboard |
|
| Access to historical account statements in PDF format. |
Example
"ACCOUNT_NUMBERS"
ConnectionFilter
Description
Options for filtering Connections.
Fields
| Input Field | Description |
|---|---|
metadata - JSON | Filter by the contents of Connection Examples:
|
provider - [ConnectionProvider!] | Filter Connections by provider. |
status - [ConnectionStatus!] | Filter Connections by one or more statuses. Examples:
|
status_not - [ConnectionStatus!] | Filter out Connections by one or more statuses. Examples:
|
Example
{
"metadata": {},
"provider": ["MX", "FINICITY"],
"status": ["ERROR_REPAIRABLE"],
"status_not": ["INITIALIZING", "SYNCING"]
}
ConnectionProduct
Description
Represents a product of a Connection.
Values
| Enum Value | Description |
|---|---|
|
| Access to verified account numbers to support money movement operations. When this product is provisioned, eligible accounts will be enabled for the Account Numbers and Processor Tokens endpoints. |
|
| Access to account-holder information to validate identity and account ownership. When this product is provisioned, account-holder information will become available via Remote Data. |
|
| Access to account investments holdings and transactions. Note that for some providers like MX, this product may be provisioned automatically. |
|
| Access to detailed account liabilities data. Note that for some providers like MX, this product may be provisioned automatically. |
|
| The ability to trigger live refreshes of account balances. |
|
| Access to Account Balances and Transaction with up to 24 months of history, depending on the provider. Note that MX typically provides 3-4 months of history and accessing 24 months of history is a "premium" product that incurs a one-time per-Connection fee. You can configure whether Quiltt should attempt to sync full history on the MX Integration page in the Dashboard |
|
| Access to historical account statements in PDF format. |
Example
"ACCOUNT_NUMBERS"
ConnectionProvider
Description
Represents the data provider for the Connection.
Values
| Enum Value | Description |
|---|---|
|
| Akoya |
|
| Finicity |
|
| Mock data |
|
| MX |
|
| Plaid |
|
| Disconnected |
Example
"AKOYA"
ConnectionRemoteData
Description
Remote data associated with a Connection.
Fields
| Field Name | Description |
|---|---|
akoya - ConnectionRemoteDataAkoya | The Akoya remote data associated with the Connection. |
finicity - ConnectionRemoteDataFinicity | The Finicity remote data associated with the Connection. |
mock - ConnectionRemoteDataMock | The Mock remote data associated with the Connection. |
mx - ConnectionRemoteDataMx | The MX remote data associated with the Connection. |
plaid - ConnectionRemoteDataPlaid | The Plaid remote data associated with the Connection. |
Example
{
"akoya": ConnectionRemoteDataAkoya,
"finicity": ConnectionRemoteDataFinicity,
"mock": ConnectionRemoteDataMock,
"mx": ConnectionRemoteDataMx,
"plaid": ConnectionRemoteDataPlaid
}
ConnectionRemoteDataAkoya
Description
Connection-level data from Akoya.
Fields
| Field Name | Description |
|---|---|
connection - ConnectionRemoteDataAkoyaConnection | The Connection data from Akoya. |
Example
{"connection": ConnectionRemoteDataAkoyaConnection}
ConnectionRemoteDataAkoyaConnection
Description
The Connection data from Akoya.
Fields
| Field Name | Description |
|---|---|
id - String! | The record's Akoya ID. |
response - RemoteDataAkoyaToken | The response body. |
timestamp - DateTime! | The date and time when the data was fetched. |
Example
{
"id": "xyz789",
"response": RemoteDataAkoyaToken,
"timestamp": "2025-03-24T12:25:12Z"
}
ConnectionRemoteDataFinicity
Description
Connection-level data from Finicity.
Fields
| Field Name | Description |
|---|---|
connection - ConnectionRemoteDataFinicityConnection | The Connection data from Finicity. |
Example
{"connection": ConnectionRemoteDataFinicityConnection}
ConnectionRemoteDataFinicityConnection
Description
The Connection data from Finicity.
Fields
| Field Name | Description |
|---|---|
id - String! | The record's Finicity ID. |
response - RemoteDataFinicityConnectionDetails | The response body. |
timestamp - DateTime! | The date and time when the data was fetched. |
Example
{
"id": "abc123",
"response": RemoteDataFinicityConnectionDetails,
"timestamp": "2025-03-24T12:25:12Z"
}
ConnectionRemoteDataMock
Description
Connection-level data from Mock.
Fields
| Field Name | Description |
|---|---|
connection - ConnectionRemoteDataMockConnection | The Connection data from Mock. |
Example
{"connection": ConnectionRemoteDataMockConnection}
ConnectionRemoteDataMockConnection
Description
The Connection data from Mock.
Fields
| Field Name | Description |
|---|---|
id - String! | The record's Mock ID. |
response - RemoteDataMockConnection | The response body. |
timestamp - DateTime! | The date and time when the data was fetched. |
Example
{
"id": "abc123",
"response": RemoteDataMockConnection,
"timestamp": "2025-03-24T12:25:12Z"
}
ConnectionRemoteDataMx
Description
Connection-level data from MX.
Fields
| Field Name | Description |
|---|---|
connection - ConnectionRemoteDataMxConnection | The base Connection data from MX. |
Example
{"connection": ConnectionRemoteDataMxConnection}
ConnectionRemoteDataMxConnection
Description
The Connection data from Mx.
Fields
| Field Name | Description |
|---|---|
id - String! | The record's Mx ID. |
response - RemoteDataMxMember | The response body. |
timestamp - DateTime! | The date and time when the data was fetched. |
Example
{
"id": "xyz789",
"response": RemoteDataMxMember,
"timestamp": "2025-03-24T12:25:12Z"
}
ConnectionRemoteDataPlaid
Description
Connection-level data from Plaid.
Fields
| Field Name | Description |
|---|---|
connection - ConnectionRemoteDataPlaidConnection | The base Connection data from Plaid. |
liabilities - ConnectionRemoteDataPlaidLiabilities | The Liabilities data from Plaid. |
Example
{
"connection": ConnectionRemoteDataPlaidConnection,
"liabilities": ConnectionRemoteDataPlaidLiabilities
}
ConnectionRemoteDataPlaidConnection
Description
The Connection data from Plaid.
Fields
| Field Name | Description |
|---|---|
id - String! | The record's Plaid ID. |
response - RemoteDataPlaidItem | The response body. |
timestamp - DateTime! | The date and time when the data was fetched. |
Example
{
"id": "abc123",
"response": RemoteDataPlaidItem,
"timestamp": "2025-03-24T12:25:12Z"
}
ConnectionRemoteDataPlaidLiabilities
Description
The Liabilities data from Plaid.
Fields
| Field Name | Description |
|---|---|
id - String! | The record's Plaid ID. |
response - RemoteDataPlaidLiabilitiesObject | The response body. |
timestamp - DateTime! | The date and time when the data was fetched. |
Example
{
"id": "xyz789",
"response": RemoteDataPlaidLiabilitiesObject,
"timestamp": "2025-03-24T12:25:12Z"
}
ConnectionSimulateErrorInput
Description
Autogenerated input type of ConnectionSimulateError
Example
{
"clientMutationId": "abc123",
"id": "conn_14TJiFDKRJlPiBHuukUIlXZ"
}
ConnectionSimulateErrorPayload
Description
Autogenerated return type of ConnectionSimulateError.
Fields
| Field Name | Description |
|---|---|
clientMutationId - String | A unique identifier for the client performing the mutation. |
errors - [Error!] | List of errors from an unsuccessful mutation. |
record - Connection | The Connection put in a repairable state. |
success - Boolean! | Specifies whether the mutation was successful. |
Example
{
"clientMutationId": "xyz789",
"errors": [Error],
"record": Connection,
"success": false
}
ConnectionStatus
Description
Represents the current state of a Connection.
Values
| Enum Value | Description |
|---|---|
|
| The Connection is being initialized and will begin syncing soon. |
|
| The Connection is currently syncing with the provider. |
|
| The Connection is synced and up to date with the provider. |
|
| The Connection must be re-authenticated to resume syncing. Have the user complete the Connector Reconnect flow to resolve this error. |
|
| Quiltt is experiencing an unexpected error attempting to sync this Connection. Visit our Status page or contact Quiltt Support for more information. |
|
| The Connection provider is reporting an error with the Connection. Inspect the Connection's Remote Data for more information. |
|
| The Connection provider is reporting an error from the user's Institution. Ask the user to successfully log into their Institution's website and accept any terms or conditions For certain providers and products, the user may need to explicitly enroll into Online Banking or Electronic Statement delivery. |
|
| The Connection is in the process of being disconnected from its provider. |
|
| The Connection has been fully disconnected from the provider. Accounts and associated data will remain on the Profile, but no new data will be synced until another Connection is established to the same Institution. You can leverage the Connector Reconnect flow to prompt the user to re-establish the Connection. |
Example
"INITIALIZING"
ConnectionSyncedPayload
Description
Autogenerated return type of ConnectionSynced.
Fields
| Field Name | Description |
|---|---|
connection - Connection | The synced Connection |
Example
{"connection": Connection}
ConnectionUpdateInput
Description
Autogenerated input type of ConnectionUpdate
Example
{
"clientMutationId": "abc123",
"id": "conn_14TJiFDKRJlPiBHuukUIlXZ",
"metadata": {}
}
ConnectionUpdatePayload
Description
Autogenerated return type of ConnectionUpdate.
Fields
| Field Name | Description |
|---|---|
clientMutationId - String | A unique identifier for the client performing the mutation. |
errors - [Error!] | List of errors from an unsuccessful mutation. |
record - Connection | The updated Connection. |
success - Boolean! | Specifies whether the mutation was successful. |
Example
{
"clientMutationId": "abc123",
"errors": [Error],
"record": Connection,
"success": true
}
CurrencyCode
Description
Represents a supported ISO-4217 currency code.
Values
| Enum Value | Description |
|---|---|
|
| United States Dollar |
|
| Euro |
|
| British Pound |
|
| Australian Dollar |
|
| Canadian Dollar |
|
| Japanese Yen |
|
| Belarusian Ruble |
|
| Botswana Pula |
|
| Qatari Riyal |
|
| Romanian Leu |
|
| Serbian Dinar |
|
| Russian Ruble |
|
| Rwandan Franc |
|
| Saudi Riyal |
|
| Solomon Islands Dollar |
|
| Seychellois Rupee |
|
| Sudanese Pound |
|
| Swedish Krona |
|
| Singapore Dollar |
|
| Saint Helenian Pound |
|
| Slovak Koruna |
|
| New Leone |
|
| Sierra Leonean Leone |
|
| Somali Shilling |
|
| Surinamese Dollar |
|
| South Sudanese Pound |
|
| Macanese Pataca |
|
| Mauritanian Ouguiya |
|
| Mauritian Rupee |
|
| Maldivian Rufiyaa |
|
| Malawian Kwacha |
|
| Mexican Peso |
|
| Malaysian Ringgit |
|
| Mozambican Metical |
|
| Namibian Dollar |
|
| Nigerian Naira |
|
| Nicaraguan Córdoba |
|
| Norwegian Krone |
|
| Nepalese Rupee |
|
| New Zealand Dollar |
|
| Omani Rial |
|
| Panamanian Balboa |
|
| Peruvian Sol |
|
| Papua New Guinean Kina |
|
| Philippine Peso |
|
| Pakistani Rupee |
|
| Polish Złoty |
|
| Paraguayan Guaraní |
|
| Samoan Tala |
|
| Central African Cfa Franc |
|
| Silver (Troy Ounce) |
|
| Gold (Troy Ounce) |
|
| European Composite Unit |
|
| European Monetary Unit |
|
| European Unit of Account 9 |
|
| European Unit of Account 17 |
|
| East Caribbean Dollar |
|
| Caribbean Guilder |
|
| Special Drawing Rights |
|
| West African Cfa Franc |
|
| Palladium |
|
| Cfp Franc |
|
| Platinum |
|
| Codes specifically reserved for testing purposes |
|
| Yemeni Rial |
|
| South African Rand |
|
| Zambian Kwacha |
|
| Zambian Kwacha |
|
| Zimbabwean Dollar |
|
| São Tomé and Príncipe Dobra |
|
| São Tomé and Príncipe Second Dobra |
|
| Salvadoran Colón |
|
| Syrian Pound |
|
| Swazi Lilangeni |
|
| Thai Baht |
|
| Tajikistani Somoni |
|
| Turkmenistani Manat |
|
| Tunisian Dinar |
|
| Tongan Paʻanga |
|
| Turkish Lira |
|
| Trinidad and Tobago Dollar |
|
| New Taiwan Dollar |
|
| Tanzanian Shilling |
|
| Ukrainian Hryvnia |
|
| Ugandan Shilling |
|
| Uruguayan Peso |
|
| Uzbekistan Som |
|
| Venezuelan Bolívar Soberano |
|
| Vietnamese Đồng |
|
| Vanuatu Vatu |
|
| Belarusian Ruble |
|
| Belize Dollar |
|
| Congolese Franc |
|
| Swiss Franc |
|
| Unidad de Fomento |
|
| Chilean Peso |
|
| Chinese Renminbi Yuan |
|
| Colombian Peso |
|
| Costa Rican Colón |
|
| Cuban Convertible Peso |
|
| Cuban Peso |
|
| Cape Verdean Escudo |
|
| Czech Koruna |
|
| Djiboutian Franc |
|
| Danish Krone |
|
| Dominican Peso |
|
| Algerian Dinar |
|
| Egyptian Pound |
|
| Eritrean Nakfa |
|
| Ethiopian Birr |
|
| United Arab Emirates Dirham |
|
| Afghan Afghani |
|
| Albanian Lek |
|
| Armenian Dram |
|
| Netherlands Antillean Gulden |
|
| Angolan Kwanza |
|
| Argentine Peso |
|
| Aruban Florin |
|
| Azerbaijani Manat |
|
| Bosnia and Herzegovina Convertible Mark |
|
| Barbadian Dollar |
|
| Bangladeshi Taka |
|
| Bulgarian Lev |
|
| Bahraini Dinar |
|
| Burundian Franc |
|
| Bermudian Dollar |
|
| Brunei Dollar |
|
| Bolivian Boliviano |
|
| Brazilian Real |
|
| Bahamian Dollar |
|
| Bhutanese Ngultrum |
|
| Kenyan Shilling |
|
| Kyrgyzstani Som |
|
| Cambodian Riel |
|
| Comorian Franc |
|
| North Korean Won |
|
| South Korean Won |
|
| Kuwaiti Dinar |
|
| Cayman Islands Dollar |
|
| Kazakhstani Tenge |
|
| Lao Kip |
|
| Lebanese Pound |
|
| Sri Lankan Rupee |
|
| Liberian Dollar |
|
| Lesotho Loti |
|
| Libyan Dinar |
|
| Moroccan Dirham |
|
| Moldovan Leu |
|
| Malagasy Ariary |
|
| Macedonian Denar |
|
| Myanmar Kyat |
|
| Mongolian Tögrög |
|
| Fijian Dollar |
|
| Falkland Pound |
|
| Georgian Lari |
|
| Ghanaian Cedi |
|
| Gibraltar Pound |
|
| Gambian Dalasi |
|
| Guinean Franc |
|
| Guatemalan Quetzal |
|
| Guyanese Dollar |
|
| Hong Kong Dollar |
|
| Honduran Lempira |
|
| Haitian Gourde |
|
| Hungarian Forint |
|
| Indonesian Rupiah |
|
| Israeli New Shekel |
|
| Indian Rupee |
|
| Iraqi Dinar |
|
| Iranian Rial |
|
| Icelandic Króna |
|
| Jamaican Dollar |
|
| Jordanian Dinar |
Example
"USD"
Date
Description
Represents an ISO 8601-encoded date.
Example
"2007-12-03"
DateMonth
DateRange
DateTime
Description
Represents an ISO 8601-encoded datetime.
Example
"2007-12-03T10:15:30Z"
Description
The details of an email address
Fields
| Field Name | Description |
|---|---|
address - String | The email address |
Example
{"address": "[email protected]"}
Error
Float
Description
The Float scalar type represents signed double-precision fractional values as specified by IEEE 754.
Example
987.65
Holding
Description
Represents an Investment Holding.
Fields
| Field Name | Description |
|---|---|
account - Account! | Use Account.holdings to see account |
at - DateTime! | The timestamp of the Holding record. |
id - ID! | The ID of the Holding. |
price - Float | The latest price for the holding |
quantity - Float | The number of shares being held |
remoteData - HoldingRemoteData | Use Account.remoteData to see the Remote Data |
security - Security | The Security associated with the Investment Holding. |
value - Float | The value of the holding |
Example
{
"account": Account,
"at": "2025-01-24T14:15:22Z",
"id": "hld_12Hz9Dz7vEvM9AuljYvhmPc",
"price": 987.65,
"quantity": 123.45,
"remoteData": HoldingRemoteData,
"security": Security,
"value": 123.45
}
HoldingConnection
Description
The connection type for Holding.
Fields
| Field Name | Description |
|---|---|
count - Int! | The total number of records. |
edges - [HoldingEdge] | A list of edges. |
nodes - [Holding] | A list of nodes. |
pageInfo - PageInfo! | Information to aid in pagination. |
Example
{
"count": 987,
"edges": [HoldingEdge],
"nodes": [Holding],
"pageInfo": PageInfo
}
HoldingEdge
HoldingRemoteData
Description
Remote data associated with a Investment Holding.
Fields
| Field Name | Description |
|---|---|
akoya - HoldingRemoteDataAkoya | The Akoya remote data associated with the Investment Holding. |
finicity - HoldingRemoteDataFinicity | The Finicity remote data associated with the Investment Holding. |
plaid - HoldingRemoteDataPlaid | The Plaid remote data associated with the Investment Holding. |
Example
{
"akoya": HoldingRemoteDataAkoya,
"finicity": HoldingRemoteDataFinicity,
"plaid": HoldingRemoteDataPlaid
}
HoldingRemoteDataAkoya
Description
Remote Data from Akoya
Fields
| Field Name | Description |
|---|---|
holding - HoldingRemoteDataAkoyaHolding | Akoya's Holding Remote Data |
Example
{"holding": HoldingRemoteDataAkoyaHolding}
HoldingRemoteDataAkoyaHolding
Description
The Holding data from Akoya.
Fields
| Field Name | Description |
|---|---|
id - String! | The record's Akoya ID. |
response - RemoteDataAkoyaHolding | The response body. |
timestamp - DateTime! | The date and time when the data was fetched. |
Example
{
"id": "abc123",
"response": RemoteDataAkoyaHolding,
"timestamp": "2025-03-24T12:25:12Z"
}
HoldingRemoteDataFinicity
Description
Remote Data from Finicity
Fields
| Field Name | Description |
|---|---|
holding - HoldingRemoteDataFinicityHolding | Finicity's Holding Remote Data |
Example
{"holding": HoldingRemoteDataFinicityHolding}
HoldingRemoteDataFinicityHolding
Description
The Holding data from Finicity.
Fields
| Field Name | Description |
|---|---|
id - String! | The record's Finicity ID. |
response - RemoteDataFinicityCustomerAccountPosition | The response body. |
timestamp - DateTime! | The date and time when the data was fetched. |
Example
{
"id": "xyz789",
"response": RemoteDataFinicityCustomerAccountPosition,
"timestamp": "2025-03-24T12:25:12Z"
}
HoldingRemoteDataPlaid
Description
Remote Data from Plaid
Fields
| Field Name | Description |
|---|---|
holding - HoldingRemoteDataPlaidHolding | Plaids's Investments Holding Remote Data |
security - HoldingRemoteDataPlaidSecurity | Plaids's Investments Security Remote Data |
Example
{
"holding": HoldingRemoteDataPlaidHolding,
"security": HoldingRemoteDataPlaidSecurity
}
HoldingRemoteDataPlaidHolding
Description
The Holding data from Plaid.
Fields
| Field Name | Description |
|---|---|
id - String! | The record's Plaid ID. |
response - RemoteDataPlaidHolding | The response body. |
timestamp - DateTime! | The date and time when the data was fetched. |
Example
{
"id": "abc123",
"response": RemoteDataPlaidHolding,
"timestamp": "2025-03-24T12:25:12Z"
}
HoldingRemoteDataPlaidSecurity
Description
The Security data from Plaid.
Fields
| Field Name | Description |
|---|---|
id - String! | The record's Plaid ID. |
response - RemoteDataPlaidSecurity | The response body. |
timestamp - DateTime! | The date and time when the data was fetched. |
Example
{
"id": "abc123",
"response": RemoteDataPlaidSecurity,
"timestamp": "2025-03-24T12:25:12Z"
}
ID
Description
The ID scalar type represents a unique identifier, often used to refetch an object or as key for a cache. The ID type appears in a JSON response as a String; however, it is not intended to be human-readable. When expected as an input type, any string (such as "4") or integer (such as 4) input value will be accepted as an ID.
Example
4
Image
Description
Represents an Image.
Fields
| Field Name | Description |
|---|---|
url - URL | The URL for the Image. |
Example
{"url": "https://upload.wikimedia.org/wikipedia/commons/a/ab/Logo_TV_2015.png"}
Institution
Int
Description
The Int scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1.
Example
987
JSON
Description
Represents untyped JSON
Example
{}
Name
Description
The details of a name
Example
{
"first": "John",
"full": "John Quincy Doe Jr.",
"last": "Doe",
"middle": "Quincy",
"prefix": "Mr.",
"suffix": "Jr."
}
PageInfo
Description
Information about pagination in a connection.
Fields
| Field Name | Description |
|---|---|
endCursor - String | When paginating forwards, the cursor to continue. |
hasNextPage - Boolean! | When paginating forwards, are there more items? |
hasPreviousPage - Boolean! | When paginating backwards, are there more items? |
startCursor - String | When paginating backwards, the cursor to continue. |
Example
{
"endCursor": "xyz789",
"hasNextPage": false,
"hasPreviousPage": false,
"startCursor": "xyz789"
}
Phone
Description
The details of a phone number
Fields
| Field Name | Description |
|---|---|
number - String | The phone number |
Example
{"number": "+14155552671"}
Profile
Description
A Profile represents an entity with data in a Quiltt Environment, typically a physical person or company end-user of your application.
Fields
| Field Name | Description |
|---|---|
address - ProfileAddress | The legal address associated with the Profile. |
dateOfBirth - Date | A physical person's date of birth. |
email - String | The email associated with the Profile. This field can be used to power passwordless authentication in the Connector. |
id - ID! | The ID of the Profile. |
metadata - JSON | Custom metadata about the Profile, stored in a 'key-value' format. See the Custom Metadata guide for more information and examples. |
name - String | A common name or nickname for the Profile. |
names - ProfileName | A physical person's legal name. |
phone - String | The phone number associated with the Profile, in E164 Format. This field can be used to power passwordless authentication in the Connector. |
remoteData - ProfileRemoteData | The Remote Data associated with the Profile. See the Remote Data guide for more information. |
uuid - ID! | The UUID of the Profile. |
Example
{
"address": ProfileAddress,
"dateOfBirth": "2007-12-03",
"email": "[email protected]",
"id": "p_1hyoxpVVFib1HngGwKAzIr",
"metadata": {
"firebaseId": "4Wz7x0QkPdNNzgRgjZ4iIzMKjXo2",
"avatar": "https://www.gravatar.com/avatar/5658ffccee7f0ebfda2b226238b1eb6e",
"favoriteColor": "Purple"
},
"name": "Quiltty",
"names": ProfileName,
"phone": "+14155552671",
"remoteData": ProfileRemoteData,
"uuid": "174ec567-2492-4498-a706-504a79437235"
}
ProfileAddress
Description
The legal address associated with the Profile.
Example
{
"city": "abc123",
"countryCode": "AND",
"line1": "xyz789",
"line2": "abc123",
"postalCode": "abc123",
"state": "xyz789"
}
ProfileAddressInput
Description
Attributes for setting an address.
Example
{
"city": "abc123",
"countryCode": "AND",
"line1": "abc123",
"line2": "xyz789",
"postalCode": "abc123",
"state": "abc123"
}
ProfileName
Description
A physical person's legal name.
Example
{"first": "Quiltty", "full": "Quiltty McQuilttface", "last": "McQuilttface"}
ProfileNameInput
ProfileRemoteData
Description
Remote data associated with a Profile.
Fields
| Field Name | Description |
|---|---|
fingoal - ProfileRemoteDataFingoal | The FinGoal remote data associated with the Profile. |
Example
{"fingoal": ProfileRemoteDataFingoal}
ProfileRemoteDataFingoal
Description
Profile-level data from FinGoal.
Fields
| Field Name | Description |
|---|---|
insights - ProfileRemoteDataFingoalInsights | The Insights data from FinGoal. |
Example
{"insights": ProfileRemoteDataFingoalInsights}
ProfileRemoteDataFingoalInsights
Description
The Insights data from Fingoal.
Fields
| Field Name | Description |
|---|---|
id - String! | The record's Fingoal ID. |
response - RemoteDataFingoalUser | The response body. |
timestamp - DateTime! | The date and time when the data was fetched. |
Example
{
"id": "abc123",
"response": RemoteDataFingoalUser,
"timestamp": "2025-03-24T12:25:12Z"
}
ProfileUpdateInput
Description
Autogenerated input type of ProfileUpdate
Fields
| Input Field | Description |
|---|---|
address - ProfileAddressInput | Mailing address. |
clientMutationId - String | A unique identifier for the client performing the mutation. |
dateOfBirth - Date | Birthday. |
email - String | Email. |
metadata - JSON | Customizable metadata. |
name - String | Common or nickname. |
names - ProfileNameInput | Legal name. |
phone - String | Cellphone in E164 Format. |
Example
{
"address": ProfileAddressInput,
"clientMutationId": "xyz789",
"dateOfBirth": "2007-12-03",
"email": "abc123",
"metadata": {},
"name": "xyz789",
"names": ProfileNameInput,
"phone": "xyz789"
}
ProfileUpdatePayload
Description
Autogenerated return type of ProfileUpdate.
Example
{
"clientMutationId": "abc123",
"errors": [Error],
"record": Profile,
"success": false
}
RemoteDataAkoyaAccount
Description
Akoya Account data.
Fields
| Field Name | Description |
|---|---|
annuityAccount - RemoteDataAkoyaAnnuityAccount | Annuity Account |
depositAccount - RemoteDataAkoyaDepositAccount | Deposit Account |
insuranceAccount - RemoteDataAkoyaInsuranceAccount | Insurance Account |
investmentAccount - RemoteDataAkoyaInvestmentAccount | Investment Account |
loanAccount - RemoteDataAkoyaLoanAccount | Loan Account |
locAccount - RemoteDataAkoyaLocAccount | Line of Credit Account |
Example
{
"annuityAccount": RemoteDataAkoyaAnnuityAccount,
"depositAccount": RemoteDataAkoyaDepositAccount,
"insuranceAccount": RemoteDataAkoyaInsuranceAccount,
"investmentAccount": RemoteDataAkoyaInvestmentAccount,
"loanAccount": RemoteDataAkoyaLoanAccount,
"locAccount": RemoteDataAkoyaLocAccount
}
RemoteDataAkoyaAccountHolder
Description
Akoya Owner data.
Extends Customer and adds a relationship field to define the customer's relationship with an account
Fields
| Field Name | Description |
|---|---|
accounts - [RemoteDataAkoyaAccounts!] | List of accounts related to this end-user |
addresses - [RemoteDataAkoyaAddress!] | An array of the customer's physical mail addresses |
businessCustomer - RemoteDataAkoyaBusinessCustomerentity | Customers that are commercial in nature are affiliated with a business entity |
customerId - String | Long-term persistent identity of the end-user. This identity must be unique to the owning institution |
email - [String!] | An array of the end-user's electronic mail addresses |
name - RemoteDataAkoyaCustomerName | customerName |
relationship - String | Types of relationships between accounts and holders. Suggested values |
telephones - [RemoteDataAkoyaTelephones!] |
Example
{
"accounts": [RemoteDataAkoyaAccounts],
"addresses": [RemoteDataAkoyaAddress],
"businessCustomer": RemoteDataAkoyaBusinessCustomerentity,
"customerId": "xyz789",
"email": ["xyz789"],
"name": RemoteDataAkoyaCustomerName,
"relationship": "abc123",
"telephones": [RemoteDataAkoyaTelephones]
}
RemoteDataAkoyaAccounts
RemoteDataAkoyaAddress
Description
Postal address
Fields
| Field Name | Description |
|---|---|
city - String | City |
country - String | ISO 3166 Country Code |
line1 - String | Address line 1. May contain full address if not separated |
line2 - String | Address line 2 |
line3 - String | Address line 3 |
postalCode - String | Postal code |
region - String | State or province or territory. Replaces "state" property |
state - String | State or province. Deprecated, will remove in FDX V6.0 |
type - String | Type of address location. One of BUSINESS, HOME, MAILING |
Example
{
"city": "abc123",
"country": "xyz789",
"line1": "xyz789",
"line2": "xyz789",
"line3": "abc123",
"postalCode": "abc123",
"region": "xyz789",
"state": "abc123",
"type": "xyz789"
}
RemoteDataAkoyaAnnuityAccount
Description
Annuity Account
Fields
| Field Name | Description |
|---|---|
accountId - String | Long-term persistent identity of the account. Not an account number. This identity must be unique to the owning institution. |
accountNumberDisplay - String | Account display number for the end user’s handle at owning institution. This is to be displayed by the Interface Provider. |
accountType - String | The type of an account. For instance, CHECKING, SAVINGS, 401K, etc. |
annuityProductType - String | |
annuityValueBasis - String | |
balanceType - String | ASSET (positive transaction amount increases balance), LIABILITY (positive transaction amount decreases balance) |
currency - RemoteDataAkoyaCurrencyEntity | Indicates the currency code used by the account. May also include currency rate. |
description - String | |
error - RemoteDataAkoyaErrorEntity | An error entity which can be used at the API level for error responses or at the account level to indicate a problem specific to a particular account. |
fiAttributes - [RemoteDataAkoyaFiAttributeEntity!] | |
interestRate - Float | Interest Rate of Account |
interestRateAsOf - DateTime | Date of account’s interest rate |
interestRateType - String | The type of interest rate. FIXED or VARIABLE. |
lastActivityDate - DateTime | Date that last transaction occurred on account |
lineOfBusiness - String | The line of business, such as consumer, consumer joint, small business, corporate, etc. |
micrNumber - String | MICR Number |
nickname - String | Name given by the user. Used in UIs to assist in account selection |
parentAccountId - String | Long-term persistent identity of the parent account. This is used to group accounts. |
paymentFrequency - String | |
priorInterestRate - Float | Previous Interest Rate of Account |
productName - String | Marketed product name for this account. Used in UIs to assist in account selection |
status - String | The status of an account. |
transferIn - Boolean | Account is eligible for incoming transfers |
transferOut - Boolean | Account is eligible for outgoing transfers |
Example
{
"accountId": "abc123",
"accountNumberDisplay": "abc123",
"accountType": "abc123",
"annuityProductType": "abc123",
"annuityValueBasis": "xyz789",
"balanceType": "xyz789",
"currency": RemoteDataAkoyaCurrencyEntity,
"description": "xyz789",
"error": RemoteDataAkoyaErrorEntity,
"fiAttributes": [RemoteDataAkoyaFiAttributeEntity],
"interestRate": 123.45,
"interestRateAsOf": "2007-12-03T10:15:30Z",
"interestRateType": "xyz789",
"lastActivityDate": "2007-12-03T10:15:30Z",
"lineOfBusiness": "xyz789",
"micrNumber": "abc123",
"nickname": "xyz789",
"parentAccountId": "xyz789",
"paymentFrequency": "abc123",
"priorInterestRate": 123.45,
"productName": "xyz789",
"status": "xyz789",
"transferIn": true,
"transferOut": false
}
RemoteDataAkoyaAssetClasses
RemoteDataAkoyaBusinessCustomerentity
Description
Customers that are commercial in nature are affiliated with a business entity
Fields
| Field Name | Description |
|---|---|
domicile - RemoteDataAkoyaDomicile | The country and region of the business customer's location |
industryCode - RemoteDataAkoyaIndustryCode | Industry code and type |
name - String | Name of business customer |
registeredAgents - [RemoteDataAkoyaCustomerName!] | A list of registered agents who act on behalf of the business customer |
registeredId - String | The registered tax identification number (TIN) or other identifier of business customer |
Example
{
"domicile": RemoteDataAkoyaDomicile,
"industryCode": RemoteDataAkoyaIndustryCode,
"name": "abc123",
"registeredAgents": [RemoteDataAkoyaCustomerName],
"registeredId": "xyz789"
}
RemoteDataAkoyaCurrencyEntity
Description
Indicates the currency code used by the account. May also include currency rate.
Example
{
"currencyCode": "abc123",
"currencyRate": 987.65,
"originalCurrencyCode": "abc123"
}
RemoteDataAkoyaCustomerName
Description
RemoteData Akoya CustomerName
Example
{
"company": "xyz789",
"first": "abc123",
"last": "xyz789",
"middle": "xyz789",
"prefix": "xyz789",
"suffix": "abc123"
}
RemoteDataAkoyaDebtSecurityEntity
Description
Information about the debt security specific to the type of security
Fields
| Field Name | Description |
|---|---|
bondMaturityDate - DateTime | Bond Maturity date |
callDate - DateTime | Next call date |
callPrice - Float | Bond call price |
callType - String | Type of next call |
couponDate - DateTime | Maturity date for next coupon |
couponMatureFrequency - String | When coupons mature |
couponRate - Float | Bond coupon rate for next closest call date |
debtClass - String | Classification of debt |
debtType - String | Debt type |
parValue - Float | Par value amount |
yieldToCall - Float | Yield to next call |
yieldToMaturity - Float | Yield to maturity |
Example
{
"bondMaturityDate": "2007-12-03T10:15:30Z",
"callDate": "2007-12-03T10:15:30Z",
"callPrice": 123.45,
"callType": "abc123",
"couponDate": "2007-12-03T10:15:30Z",
"couponMatureFrequency": "abc123",
"couponRate": 987.65,
"debtClass": "abc123",
"debtType": "abc123",
"parValue": 123.45,
"yieldToCall": 987.65,
"yieldToMaturity": 987.65
}
RemoteDataAkoyaDepositAccount
Description
Deposit Account
Fields
| Field Name | Description |
|---|---|
accountId - String | Long-term persistent identity of the account. Not an account number. This identity must be unique to the owning institution. |
accountNumberDisplay - String | Account display number for the end user’s handle at owning institution. This is to be displayed by the Interface Provider. |
accountType - String | The type of an account. For instance, CHECKING, SAVINGS, 401K, etc. |
annualPercentageYield - Float | Annual Percentage Yield. If account type = CD, required. |
balanceType - String | ASSET (positive transaction amount increases balance), LIABILITY (positive transaction amount decreases balance) |
currency - RemoteDataAkoyaCurrencyEntity | Indicates the currency code used by the account. May also include currency rate. |
description - String | |
error - RemoteDataAkoyaErrorEntity | An error entity which can be used at the API level for error responses or at the account level to indicate a problem specific to a particular account. |
fiAttributes - [RemoteDataAkoyaFiAttributeEntity!] | |
interestRate - Float | Interest Rate of Account |
interestRateAsOf - DateTime | Date of account’s interest rate |
interestRateType - String | The type of interest rate. FIXED or VARIABLE. |
lastActivityDate - DateTime | Date that last transaction occurred on account |
lineOfBusiness - String | The line of business, such as consumer, consumer joint, small business, corporate, etc. |
maturityDate - DateTime | Maturity date for CDs. If account type = CD, required. |
micrNumber - String | MICR Number |
nickname - String | Name given by the user. Used in UIs to assist in account selection |
parentAccountId - String | Long-term persistent identity of the parent account. This is used to group accounts. |
priorInterestRate - Float | Previous Interest Rate of Account |
productName - String | Marketed product name for this account. Used in UIs to assist in account selection |
status - String | The status of an account. |
term - Int | Term of CD in months |
transferIn - Boolean | Account is eligible for incoming transfers |
transferOut - Boolean | Account is eligible for outgoing transfers |
Example
{
"accountId": "abc123",
"accountNumberDisplay": "xyz789",
"accountType": "xyz789",
"annualPercentageYield": 987.65,
"balanceType": "xyz789",
"currency": RemoteDataAkoyaCurrencyEntity,
"description": "abc123",
"error": RemoteDataAkoyaErrorEntity,
"fiAttributes": [RemoteDataAkoyaFiAttributeEntity],
"interestRate": 123.45,
"interestRateAsOf": "2007-12-03T10:15:30Z",
"interestRateType": "xyz789",
"lastActivityDate": "2007-12-03T10:15:30Z",
"lineOfBusiness": "xyz789",
"maturityDate": "2007-12-03T10:15:30Z",
"micrNumber": "xyz789",
"nickname": "abc123",
"parentAccountId": "xyz789",
"priorInterestRate": 123.45,
"productName": "abc123",
"status": "abc123",
"term": 123,
"transferIn": false,
"transferOut": false
}
RemoteDataAkoyaDepositTransaction
Description
Deposit transaction
Fields
| Field Name | Description |
|---|---|
accountId - String | Corresponds to AccountId in Account |
amount - Float | The amount of money in the account currency. If balanceType is
If balanceType is
|
category - String | Transaction category, preferably MCC or SIC. |
checkNumber - Int | Check Number |
debitCreditMemo - String | Akoya will ensure that this is correctly populated with one of DEBIT or CREDIT and matches the sign of the status field. |
description - String | The description of the transaction |
fiAttributes - [RemoteDataAkoyaFiAttributeEntity!] | Array of FI-specific attributes |
foreignAmount - Float | The amount of money in the foreign currency |
foreignCurrency - String | The ISO 4217 code of the foreign currency |
imageIds - [String!] | Array of image identifiers (unique to transaction) used to retrieve images of check or transaction receipt. |
lineItem - [RemoteDataAkoyaLineItem!] | Breakdown of the transaction details |
links - [RemoteDataAkoyaHATEOASLink!] | Links (unique to this Transaction) used to retrieve images of checks or transaction receipts, or invoke other APIs |
memo - String | Secondary transaction description |
payee - String | Payee name |
postedTimestamp - DateTime | The date and time that the transaction was posted to the account. If not provided then TransactionTimestamp can be used as PostedTimeStamp. |
reference - String | A tracking reference identifier |
referenceTransactionId - String | Akoya ensures that this field is populated for all transactions which are reversals, otherwise it is null. Either way it is always present. For reverse postings, the identity of the transaction being reversed. For the correction transaction, the identity of the reversing post. For credit card posting transactions, the identity of the authorization transaction. |
status - String | AUTHORIZATION, MEMO, PENDING, or POSTED |
subCategory - String | Transaction category detail |
transactionId - String | Long term persistent identity of the transaction (unique to account). Transaction IDs should:
|
transactionTimestamp - DateTime | The date and time that the transaction was added to the server backend systems. Akoya ensures that this field is populated for all transactions to which it applies, otherwise it is null. Either way it is always present. |
transactionType - String | DepositTransaction Type |
Example
{
"accountId": "abc123",
"amount": 123.45,
"category": "xyz789",
"checkNumber": 987,
"debitCreditMemo": "abc123",
"description": "abc123",
"fiAttributes": [RemoteDataAkoyaFiAttributeEntity],
"foreignAmount": 987.65,
"foreignCurrency": "xyz789",
"imageIds": ["xyz789"],
"lineItem": [RemoteDataAkoyaLineItem],
"links": [RemoteDataAkoyaHATEOASLink],
"memo": "xyz789",
"payee": "xyz789",
"postedTimestamp": "2007-12-03T10:15:30Z",
"reference": "abc123",
"referenceTransactionId": "xyz789",
"status": "xyz789",
"subCategory": "xyz789",
"transactionId": "xyz789",
"transactionTimestamp": "2007-12-03T10:15:30Z",
"transactionType": "abc123"
}
RemoteDataAkoyaDomicile
RemoteDataAkoyaErrorEntity
Description
An error entity which can be used at the API level for error responses or at the account level to indicate a problem specific to a particular account.
Example
{"code": 123, "message": "xyz789"}
RemoteDataAkoyaFiAssetClasses
RemoteDataAkoyaFiAttributeEntity
RemoteDataAkoyaHATEOASLink
Description
REST application constraint (Hypermedia As The Engine Of Application State)
Example
{
"action": "abc123",
"href": "abc123",
"types": ["xyz789"]
}
RemoteDataAkoyaHolding
Description
Akoya Holding data.
Fields
| Field Name | Description |
|---|---|
assetClasses - [RemoteDataAkoyaAssetClasses!] | Percent breakdown by asset class. |
averageCost - Boolean | Cost is average of all purchases for holding. |
cashAccount - Boolean | If true, indicates that this holding is used to maintain proceeds from sales, dividends, and other cash postings to the investment account. |
changeInPrice - Float | Change in current price compared to previous day's close |
currency - RemoteDataAkoyaCurrencyEntity | Indicates the currency code used by the account. May also include currency rate. |
currentUnitPrice - Float | |
currentUnitPriceDate - DateTime | Current unit price as of date |
debtSecurity - RemoteDataAkoyaDebtSecurityEntity | Information about the debt security specific to the type of security |
description - String | Description of the holding |
expirationDate - DateTime | For CDs, bonds, and other time-based holdings. |
faceValue - Float | Required for bonds. Face value at the time of data retrieved. |
fiAssetClasses - [RemoteDataAkoyaFiAssetClasses!] | Percent breakdown by FI-specific asset class percentage breakdown |
fiAttributes - [RemoteDataAkoyaFiAttributeEntity!] | |
heldInAccount - String | Sub-account |
holdingId - String | Long term persistent identity of the holding |
holdingName - String | Holding name or security name |
holdingSubType - String | |
holdingType - String | |
inv401kSurce - String | Source for money for this security. |
marketValue - Float | Market value at the time of data retrieved |
mutualFundSecurity - RemoteDataAkoyaMutualFundSecurityEntity | Information about the mutual fund security specific to the type of security |
optionSecurity - RemoteDataAkoyaOptionSecurityEntity | Information about the option security specific to the type of security |
originalPurchaseDate - DateTime | Date of original purchase |
otherSecurity - RemoteDataAkoyaOtherSecurityEntity | Information about the security specific to the type of security |
positionType - String | |
purchasedPrice - Float | Price of holding at the time of purchase |
rate - Float | For CDs, bonds, and other rate based holdings. |
securityId - String | Unique identifier of security |
securityIdType - String | Security identifier type |
stockSecurity - RemoteDataAkoyaStockSecurityEntity | Information about the stock security specific to the type of security |
sweepSecurity - RemoteDataAkoyaSweepSecurityEntity | Information about the sweep security specific to the type of security |
symbol - String | Ticker / Market symbol |
taxLots - [RemoteDataAkoyaTaxLots!] | Breakdown by tax lot. |
units - Float | Required for stock, mutual funds. Number of shares (with decimals). |
Example
{
"assetClasses": [RemoteDataAkoyaAssetClasses],
"averageCost": false,
"cashAccount": true,
"changeInPrice": 987.65,
"currency": RemoteDataAkoyaCurrencyEntity,
"currentUnitPrice": 987.65,
"currentUnitPriceDate": "2007-12-03T10:15:30Z",
"debtSecurity": RemoteDataAkoyaDebtSecurityEntity,
"description": "xyz789",
"expirationDate": "2007-12-03T10:15:30Z",
"faceValue": 123.45,
"fiAssetClasses": [RemoteDataAkoyaFiAssetClasses],
"fiAttributes": [RemoteDataAkoyaFiAttributeEntity],
"heldInAccount": "abc123",
"holdingId": "abc123",
"holdingName": "xyz789",
"holdingSubType": "abc123",
"holdingType": "abc123",
"inv401kSurce": "abc123",
"marketValue": 123.45,
"mutualFundSecurity": RemoteDataAkoyaMutualFundSecurityEntity,
"optionSecurity": RemoteDataAkoyaOptionSecurityEntity,
"originalPurchaseDate": "2007-12-03T10:15:30Z",
"otherSecurity": RemoteDataAkoyaOtherSecurityEntity,
"positionType": "abc123",
"purchasedPrice": 987.65,
"rate": 123.45,
"securityId": "xyz789",
"securityIdType": "abc123",
"stockSecurity": RemoteDataAkoyaStockSecurityEntity,
"sweepSecurity": RemoteDataAkoyaSweepSecurityEntity,
"symbol": "xyz789",
"taxLots": [RemoteDataAkoyaTaxLots],
"units": 987.65
}
RemoteDataAkoyaIndustryCode
RemoteDataAkoyaInsuranceAccount
Description
Insurance Account
Fields
| Field Name | Description |
|---|---|
accountCategory - String | The account category of the insurance account. Possible enums: DEPOSIT_ACCOUNT, INVESTMENT_ACCOUNT, LOAN_ACCOUNT, LOC_ACCOUNT, INSURANCE_ACCOUNT |
accountId - String | Long-term persistent identity of the account. Not an account number. This identity must be unique to the owning institution. |
accountNumberDisplay - String | Account display number for the end user’s handle at owning institution. This is to be displayed by the Interface Provider. |
accountType - String | The type of an account. For instance, CHECKING, SAVINGS, 401K, etc. |
balanceType - String | ASSET (positive transaction amount increases balance), LIABILITY (positive transaction amount decreases balance) |
currency - RemoteDataAkoyaCurrencyEntity | Indicates the currency code used by the account. May also include currency rate. |
description - String | |
error - RemoteDataAkoyaErrorEntity | An error entity which can be used at the API level for error responses or at the account level to indicate a problem specific to a particular account. |
fiAttributes - [RemoteDataAkoyaFiAttributeEntity!] | |
interestRate - Float | Interest Rate of Account |
interestRateAsOf - DateTime | Date of account’s interest rate |
interestRateType - String | The type of interest rate. FIXED or VARIABLE. |
lastActivityDate - DateTime | Date that last transaction occurred on account |
lineOfBusiness - String | The line of business, such as consumer, consumer joint, small business, corporate, etc. |
micrNumber - String | MICR Number |
nickname - String | Name given by the user. Used in UIs to assist in account selection |
parentAccountId - String | Long-term persistent identity of the parent account. This is used to group accounts. |
priorInterestRate - Float | Previous Interest Rate of Account |
productName - String | Marketed product name for this account. Used in UIs to assist in account selection |
status - String | The status of an account. |
transferIn - Boolean | Account is eligible for incoming transfers |
transferOut - Boolean | Account is eligible for outgoing transfers |
Example
{
"accountCategory": "abc123",
"accountId": "abc123",
"accountNumberDisplay": "xyz789",
"accountType": "abc123",
"balanceType": "xyz789",
"currency": RemoteDataAkoyaCurrencyEntity,
"description": "xyz789",
"error": RemoteDataAkoyaErrorEntity,
"fiAttributes": [RemoteDataAkoyaFiAttributeEntity],
"interestRate": 987.65,
"interestRateAsOf": "2007-12-03T10:15:30Z",
"interestRateType": "abc123",
"lastActivityDate": "2007-12-03T10:15:30Z",
"lineOfBusiness": "abc123",
"micrNumber": "xyz789",
"nickname": "xyz789",
"parentAccountId": "abc123",
"priorInterestRate": 123.45,
"productName": "abc123",
"status": "xyz789",
"transferIn": false,
"transferOut": false
}
RemoteDataAkoyaInsuranceTransaction
Description
Insurance transactions
Fields
| Field Name | Description |
|---|---|
accountId - String | Corresponds to AccountId in Account |
amount - Float | The amount of money in the account currency. If balanceType is
If balanceType is
|
category - String | Transaction category, preferably MCC or SIC. |
debitCreditMemo - String | Akoya will ensure that this is correctly populated with one of DEBIT or CREDIT and matches the sign of the status field. |
description - String | The description of the transaction |
fiAttributes - [RemoteDataAkoyaFiAttributeEntity!] | Array of FI-specific attributes |
foreignAmount - Float | The amount of money in the foreign currency |
foreignCurrency - String | The ISO 4217 code of the foreign currency |
imageIds - [String!] | Array of image identifiers (unique to transaction) used to retrieve images of check or transaction receipt. |
lineItem - [RemoteDataAkoyaLineItem!] | Breakdown of the transaction details |
links - [RemoteDataAkoyaHATEOASLink!] | Links (unique to this Transaction) used to retrieve images of checks or transaction receipts, or invoke other APIs |
memo - String | Secondary transaction description |
postedTimestamp - DateTime | The date and time that the transaction was posted to the account. If not provided then TransactionTimestamp can be used as PostedTimeStamp. |
reference - String | A tracking reference identifier |
referenceTransactionId - String | Akoya ensures that this field is populated for all transactions which are reversals, otherwise it is null. Either way it is always present. For reverse postings, the identity of the transaction being reversed. For the correction transaction, the identity of the reversing post. For credit card posting transactions, the identity of the authorization transaction. |
status - String | AUTHORIZATION, MEMO, PENDING, or POSTED |
subCategory - String | Transaction category detail |
transactionId - String | Long term persistent identity of the transaction (unique to account). Transaction IDs should:
|
transactionTimestamp - DateTime | The date and time that the transaction was added to the server backend systems. Akoya ensures that this field is populated for all transactions to which it applies, otherwise it is null. Either way it is always present. |
transactionType - String | InsuranceTransaction Type |
Example
{
"accountId": "xyz789",
"amount": 123.45,
"category": "abc123",
"debitCreditMemo": "abc123",
"description": "xyz789",
"fiAttributes": [RemoteDataAkoyaFiAttributeEntity],
"foreignAmount": 987.65,
"foreignCurrency": "abc123",
"imageIds": ["xyz789"],
"lineItem": [RemoteDataAkoyaLineItem],
"links": [RemoteDataAkoyaHATEOASLink],
"memo": "abc123",
"postedTimestamp": "2007-12-03T10:15:30Z",
"reference": "xyz789",
"referenceTransactionId": "abc123",
"status": "abc123",
"subCategory": "abc123",
"transactionId": "xyz789",
"transactionTimestamp": "2007-12-03T10:15:30Z",
"transactionType": "abc123"
}
RemoteDataAkoyaInvestmentAccount
Description
Investment Account
Fields
| Field Name | Description |
|---|---|
accountId - String | Long-term persistent identity of the account. Not an account number. This identity must be unique to the owning institution. |
accountNumberDisplay - String | Account display number for the end user’s handle at owning institution. This is to be displayed by the Interface Provider. |
accountType - String | The type of an account. For instance, CHECKING, SAVINGS, 401K, etc. |
allowedCheckWriting - Boolean | Check writing privileges |
allowedOptionTrade - Boolean | Allowed to trade options |
balanceType - String | ASSET (positive transaction amount increases balance), LIABILITY (positive transaction amount decreases balance) |
brokerId - String | Unique identifier FI |
calendarYearFor401K - String | Date for this calendar year for 401K account |
currency - RemoteDataAkoyaCurrencyEntity | Indicates the currency code used by the account. May also include currency rate. |
description - String | |
employerName - String | Name of the employer in investment 401k Plan |
error - RemoteDataAkoyaErrorEntity | An error entity which can be used at the API level for error responses or at the account level to indicate a problem specific to a particular account. |
fiAttributes - [RemoteDataAkoyaFiAttributeEntity!] | |
interestRate - Float | Interest Rate of Account |
interestRateAsOf - DateTime | Date of account’s interest rate |
interestRateType - String | The type of interest rate. FIXED or VARIABLE. |
lastActivityDate - DateTime | Date that last transaction occurred on account |
lineOfBusiness - String | The line of business, such as consumer, consumer joint, small business, corporate, etc. |
margin - Boolean | Margin trading is allowed |
micrNumber - String | MICR Number |
nickname - String | Name given by the user. Used in UIs to assist in account selection |
parentAccountId - String | Long-term persistent identity of the parent account. This is used to group accounts. |
planId - String | Plan number for Investment 401k plan |
priorInterestRate - Float | Previous Interest Rate of Account |
productName - String | Marketed product name for this account. Used in UIs to assist in account selection |
status - String | The status of an account. |
transferIn - Boolean | Account is eligible for incoming transfers |
transferOut - Boolean | Account is eligible for outgoing transfers |
Example
{
"accountId": "xyz789",
"accountNumberDisplay": "abc123",
"accountType": "abc123",
"allowedCheckWriting": true,
"allowedOptionTrade": true,
"balanceType": "xyz789",
"brokerId": "xyz789",
"calendarYearFor401K": "abc123",
"currency": RemoteDataAkoyaCurrencyEntity,
"description": "xyz789",
"employerName": "xyz789",
"error": RemoteDataAkoyaErrorEntity,
"fiAttributes": [RemoteDataAkoyaFiAttributeEntity],
"interestRate": 987.65,
"interestRateAsOf": "2007-12-03T10:15:30Z",
"interestRateType": "abc123",
"lastActivityDate": "2007-12-03T10:15:30Z",
"lineOfBusiness": "abc123",
"margin": true,
"micrNumber": "abc123",
"nickname": "xyz789",
"parentAccountId": "xyz789",
"planId": "abc123",
"priorInterestRate": 123.45,
"productName": "xyz789",
"status": "xyz789",
"transferIn": true,
"transferOut": true
}
RemoteDataAkoyaInvestmentTransaction
Description
Investment Transactions
Fields
| Field Name | Description |
|---|---|
accountId - String | Corresponds to AccountId in Account |
accruedInterest - Float | Accrued Interest. |
amount - Float | The amount of money in the account currency. If balanceType is
If balanceType is
|
category - String | Transaction category, preferably MCC or SIC. |
commission - Float | Transaction commission. |
confirmationNumber - String | Confirmation number of the transaction. |
debitCreditMemo - String | Akoya will ensure that this is correctly populated with one of DEBIT or CREDIT and matches the sign of the status field. |
description - String | The description of the transaction |
faceValue - Float | Cash value for bonds. |
fees - Float | Fees applied to the trade. |
fiAttributes - [RemoteDataAkoyaFiAttributeEntity!] | Array of FI-specific attributes |
foreignAmount - Float | The amount of money in the foreign currency |
foreignCurrency - String | The ISO 4217 code of the foreign currency |
fractionalCash - Float | Cash for fractional units (used for stock splits). |
gain - Float | For sales. |
imageIds - [String!] | Array of image identifiers (unique to transaction) used to retrieve images of check or transaction receipt. |
incomeType - String | Type of investment income. CGLONG (capital gains-long term), CGSHORT (capital gains-short term), MISC. |
inv401kSource - String | Source of money. |
lineItem - [RemoteDataAkoyaLineItem!] | Breakdown of the transaction details |
links - [RemoteDataAkoyaHATEOASLink!] | Links (unique to this Transaction) used to retrieve images of checks or transaction receipts, or invoke other APIs |
load - Float | Load on the transaction. |
loanId - String | For 401k accounts only. This indicates the transaction was due to a loan or a loan repayment. |
loanInterest - Float | How much loan pre-payment is interest. |
loanPrincipal - Float | How much loan pre-payment is principal. |
markup - Float | Portion of unit price that is attributed to the dealer markup. |
memo - String | Secondary transaction description |
newUnits - Float | Number of shares after split. |
oldUnits - Float | Number of shares before split. |
payrollDate - String | The date for the 401k transaction was obtained in payroll. |
penalty - Float | Indicates amount withheld due to a penalty. |
positionType - String | |
postedTimestamp - DateTime | The date and time that the transaction was posted to the account. If not provided then TransactionTimestamp can be used as PostedTimeStamp. |
price - Float | Unit purchase price. |
priorYearContrib - Boolean | Indicates this buy was made using prior years contribution. TRUE or FALSE. |
reference - String | A tracking reference identifier |
referenceTransactionId - String | Akoya ensures that this field is populated for all transactions which are reversals, otherwise it is null. Either way it is always present. For reverse postings, the identity of the transaction being reversed. For the correction transaction, the identity of the reversing post. For credit card posting transactions, the identity of the authorization transaction. |
runningBalance - Float | Running balance of the position. |
securityId - String | Unique identifier of security. |
securityIdType - String | Security identifier type. |
securityType - String | |
shares - Float | Required for stock, mutual funds. Number of shares (with decimals). Negative numbers indicate securities are being removed from the account. |
splitRatioDenominator - Float | Split ratio denominator. |
splitRatioNumerator - Float | Split ratio numerator. |
stateWithholding - Float | State tax withholding. |
status - String | AUTHORIZATION, MEMO, PENDING, or POSTED |
subAccountFund - String | From which account money came in. |
subAccountSec - String | Sub-account security type. |
subCategory - String | Transaction category detail |
symbol - String | Ticker symbol. |
taxExempt - Boolean | Tax-exempt transaction TRUE or FALSE. |
taxes - Float | Taxes on the trade. |
transactionId - String | Long term persistent identity of the transaction (unique to account). Transaction IDs should:
|
transactionReason - String | Reason for this transaction; CALL (the debt was called), SELL (the debt was sold), MATURITY (the debt reached maturity) |
transactionTimestamp - DateTime | The date and time that the transaction was added to the server backend systems. Akoya ensures that this field is populated for all transactions to which it applies, otherwise it is null. Either way it is always present. |
transactionType - String | InvestmentTransaction Type |
transferAction - String | Transfer direction. |
unitPrice - Float | Price per commonly-quoted unit. Does not include markup/markdown, unitprice. Share price for stocks, mutual funds, and others. Percentage of par for bonds. Per share (not contract) for options. |
unitType - String | |
units - Float | For security-based actions other than stock splits, quantity. Shares for stocks, mutual funds, and others. Face value for bonds. Contracts for options. |
withholding - Float | Federal tax withholding. |
Example
{
"accountId": "xyz789",
"accruedInterest": 123.45,
"amount": 987.65,
"category": "xyz789",
"commission": 987.65,
"confirmationNumber": "xyz789",
"debitCreditMemo": "xyz789",
"description": "xyz789",
"faceValue": 987.65,
"fees": 123.45,
"fiAttributes": [RemoteDataAkoyaFiAttributeEntity],
"foreignAmount": 987.65,
"foreignCurrency": "xyz789",
"fractionalCash": 987.65,
"gain": 123.45,
"imageIds": ["abc123"],
"incomeType": "abc123",
"inv401kSource": "xyz789",
"lineItem": [RemoteDataAkoyaLineItem],
"links": [RemoteDataAkoyaHATEOASLink],
"load": 123.45,
"loanId": "abc123",
"loanInterest": 123.45,
"loanPrincipal": 987.65,
"markup": 987.65,
"memo": "abc123",
"newUnits": 123.45,
"oldUnits": 987.65,
"payrollDate": "xyz789",
"penalty": 123.45,
"positionType": "abc123",
"postedTimestamp": "2007-12-03T10:15:30Z",
"price": 123.45,
"priorYearContrib": true,
"reference": "abc123",
"referenceTransactionId": "xyz789",
"runningBalance": 123.45,
"securityId": "abc123",
"securityIdType": "abc123",
"securityType": "abc123",
"shares": 123.45,
"splitRatioDenominator": 987.65,
"splitRatioNumerator": 123.45,
"stateWithholding": 123.45,
"status": "abc123",
"subAccountFund": "abc123",
"subAccountSec": "abc123",
"subCategory": "abc123",
"symbol": "xyz789",
"taxExempt": false,
"taxes": 123.45,
"transactionId": "xyz789",
"transactionReason": "abc123",
"transactionTimestamp": "2007-12-03T10:15:30Z",
"transactionType": "abc123",
"transferAction": "xyz789",
"unitPrice": 987.65,
"unitType": "abc123",
"units": 987.65,
"withholding": 987.65
}
RemoteDataAkoyaLineItem
Description
RemoteData Akoya LineItem
Fields
| Field Name | Description |
|---|---|
amount - Float | The amount of money attributable to this line item |
checkNumber - Float | Check number |
description - String | The description of the line item |
imageIds - [String!] | Array of image identifiers (unique to transaction) used to retrieve images of check or transaction receipt |
links - [RemoteDataAkoyaHATEOASLink!] | Links (unique to this Transaction) used to retrieve images of checks or transaction receipts, or invoke other APIs |
memo - String | Secondary item description |
reference - String | A reference number |
Example
{
"amount": 123.45,
"checkNumber": 123.45,
"description": "xyz789",
"imageIds": ["abc123"],
"links": [RemoteDataAkoyaHATEOASLink],
"memo": "abc123",
"reference": "abc123"
}
RemoteDataAkoyaLoanAccount
Description
Loan Account
Fields
| Field Name | Description |
|---|---|
accountId - String | Long-term persistent identity of the account. Not an account number. This identity must be unique to the owning institution. |
accountNumberDisplay - String | Account display number for the end user’s handle at owning institution. This is to be displayed by the Interface Provider. |
accountType - String | The type of an account. For instance, CHECKING, SAVINGS, 401K, etc. |
balanceType - String | ASSET (positive transaction amount increases balance), LIABILITY (positive transaction amount decreases balance) |
compoundingPeriod - String | |
currency - RemoteDataAkoyaCurrencyEntity | Indicates the currency code used by the account. May also include currency rate. |
description - String | |
error - RemoteDataAkoyaErrorEntity | An error entity which can be used at the API level for error responses or at the account level to indicate a problem specific to a particular account. |
fiAttributes - [RemoteDataAkoyaFiAttributeEntity!] | |
interestRate - Float | Interest Rate of Account |
interestRateAsOf - DateTime | Date of account’s interest rate |
interestRateType - String | The type of interest rate. FIXED or VARIABLE. |
lastActivityDate - DateTime | Date that last transaction occurred on account |
lineOfBusiness - String | The line of business, such as consumer, consumer joint, small business, corporate, etc. |
loanTerm - Int | Term of loan in months |
maturityDate - DateTime | Maturity date is required for CDs |
micrNumber - String | MICR Number |
nickname - String | Name given by the user. Used in UIs to assist in account selection |
originatingDate - DateTime | Loan origination date |
parentAccountId - String | Long-term persistent identity of the parent account. This is used to group accounts. |
paymentFrequency - String | |
priorInterestRate - Float | Previous Interest Rate of Account |
productName - String | Marketed product name for this account. Used in UIs to assist in account selection |
status - String | The status of an account. |
totalNumberOfPayments - Int | Total number of payments |
transferIn - Boolean | Account is eligible for incoming transfers |
transferOut - Boolean | Account is eligible for outgoing transfers |
Example
{
"accountId": "xyz789",
"accountNumberDisplay": "xyz789",
"accountType": "xyz789",
"balanceType": "xyz789",
"compoundingPeriod": "xyz789",
"currency": RemoteDataAkoyaCurrencyEntity,
"description": "xyz789",
"error": RemoteDataAkoyaErrorEntity,
"fiAttributes": [RemoteDataAkoyaFiAttributeEntity],
"interestRate": 123.45,
"interestRateAsOf": "2007-12-03T10:15:30Z",
"interestRateType": "abc123",
"lastActivityDate": "2007-12-03T10:15:30Z",
"lineOfBusiness": "xyz789",
"loanTerm": 987,
"maturityDate": "2007-12-03T10:15:30Z",
"micrNumber": "abc123",
"nickname": "abc123",
"originatingDate": "2007-12-03T10:15:30Z",
"parentAccountId": "xyz789",
"paymentFrequency": "xyz789",
"priorInterestRate": 123.45,
"productName": "abc123",
"status": "xyz789",
"totalNumberOfPayments": 123,
"transferIn": true,
"transferOut": true
}
RemoteDataAkoyaLoanTransaction
Description
Loan Transaction
Fields
| Field Name | Description |
|---|---|
accountId - String | Corresponds to AccountId in Account |
amount - Float | The amount of money in the account currency. If balanceType is
If balanceType is
|
category - String | Transaction category, preferably MCC or SIC. |
debitCreditMemo - String | Akoya will ensure that this is correctly populated with one of DEBIT or CREDIT and matches the sign of the status field. |
description - String | The description of the transaction |
fiAttributes - [RemoteDataAkoyaFiAttributeEntity!] | Array of FI-specific attributes |
foreignAmount - Float | The amount of money in the foreign currency |
foreignCurrency - String | The ISO 4217 code of the foreign currency |
imageIds - [String!] | Array of image identifiers (unique to transaction) used to retrieve images of check or transaction receipt. |
lineItem - [RemoteDataAkoyaLineItem!] | Breakdown of the transaction details |
links - [RemoteDataAkoyaHATEOASLink!] | Links (unique to this Transaction) used to retrieve images of checks or transaction receipts, or invoke other APIs |
memo - String | Secondary transaction description |
paymentDetails - RemoteDataAkoyaPaymentDetails | Payment details for some transactions |
postedTimestamp - DateTime | The date and time that the transaction was posted to the account. If not provided then TransactionTimestamp can be used as PostedTimeStamp. |
reference - String | A tracking reference identifier |
referenceTransactionId - String | Akoya ensures that this field is populated for all transactions which are reversals, otherwise it is null. Either way it is always present. For reverse postings, the identity of the transaction being reversed. For the correction transaction, the identity of the reversing post. For credit card posting transactions, the identity of the authorization transaction. |
status - String | AUTHORIZATION, MEMO, PENDING, or POSTED |
subCategory - String | Transaction category detail |
transactionId - String | Long term persistent identity of the transaction (unique to account). Transaction IDs should:
|
transactionTimestamp - DateTime | The date and time that the transaction was added to the server backend systems. Akoya ensures that this field is populated for all transactions to which it applies, otherwise it is null. Either way it is always present. |
transactionType - String | LoanTransaction Type |
Example
{
"accountId": "xyz789",
"amount": 987.65,
"category": "abc123",
"debitCreditMemo": "abc123",
"description": "abc123",
"fiAttributes": [RemoteDataAkoyaFiAttributeEntity],
"foreignAmount": 987.65,
"foreignCurrency": "abc123",
"imageIds": ["abc123"],
"lineItem": [RemoteDataAkoyaLineItem],
"links": [RemoteDataAkoyaHATEOASLink],
"memo": "abc123",
"paymentDetails": RemoteDataAkoyaPaymentDetails,
"postedTimestamp": "2007-12-03T10:15:30Z",
"reference": "xyz789",
"referenceTransactionId": "xyz789",
"status": "abc123",
"subCategory": "xyz789",
"transactionId": "abc123",
"transactionTimestamp": "2007-12-03T10:15:30Z",
"transactionType": "abc123"
}
RemoteDataAkoyaLocAccount
Description
Line of Credit Account
Fields
| Field Name | Description |
|---|---|
accountId - String | Long-term persistent identity of the account. Not an account number. This identity must be unique to the owning institution. |
accountNumberDisplay - String | Account display number for the end user’s handle at owning institution. This is to be displayed by the Interface Provider. |
accountType - String | The type of an account. For instance, CHECKING, SAVINGS, 401K, etc. |
balanceType - String | ASSET (positive transaction amount increases balance), LIABILITY (positive transaction amount decreases balance) |
currency - RemoteDataAkoyaCurrencyEntity | Indicates the currency code used by the account. May also include currency rate. |
description - String | |
error - RemoteDataAkoyaErrorEntity | An error entity which can be used at the API level for error responses or at the account level to indicate a problem specific to a particular account. |
fiAttributes - [RemoteDataAkoyaFiAttributeEntity!] | |
interestRate - Float | Interest Rate of Account |
interestRateAsOf - DateTime | Date of account’s interest rate |
interestRateType - String | The type of interest rate. FIXED or VARIABLE. |
lastActivityDate - DateTime | Date that last transaction occurred on account |
lineOfBusiness - String | The line of business, such as consumer, consumer joint, small business, corporate, etc. |
micrNumber - String | MICR Number |
nickname - String | Name given by the user. Used in UIs to assist in account selection |
parentAccountId - String | Long-term persistent identity of the parent account. This is used to group accounts. |
priorInterestRate - Float | Previous Interest Rate of Account |
productName - String | Marketed product name for this account. Used in UIs to assist in account selection |
status - String | The status of an account. |
transferIn - Boolean | Account is eligible for incoming transfers |
transferOut - Boolean | Account is eligible for outgoing transfers |
Example
{
"accountId": "xyz789",
"accountNumberDisplay": "xyz789",
"accountType": "abc123",
"balanceType": "xyz789",
"currency": RemoteDataAkoyaCurrencyEntity,
"description": "xyz789",
"error": RemoteDataAkoyaErrorEntity,
"fiAttributes": [RemoteDataAkoyaFiAttributeEntity],
"interestRate": 123.45,
"interestRateAsOf": "2007-12-03T10:15:30Z",
"interestRateType": "abc123",
"lastActivityDate": "2007-12-03T10:15:30Z",
"lineOfBusiness": "abc123",
"micrNumber": "xyz789",
"nickname": "abc123",
"parentAccountId": "abc123",
"priorInterestRate": 987.65,
"productName": "abc123",
"status": "xyz789",
"transferIn": true,
"transferOut": false
}
RemoteDataAkoyaLocTransaction
Description
A line of credit transaction of type
Fields
| Field Name | Description |
|---|---|
accountId - String | Corresponds to AccountId in Account |
amount - Float | The amount of money in the account currency. If balanceType is
If balanceType is
|
category - String | Transaction category, preferably MCC or SIC. |
checkNumber - Int | Check number |
debitCreditMemo - String | Akoya will ensure that this is correctly populated with one of DEBIT or CREDIT and matches the sign of the status field. |
description - String | The description of the transaction |
fiAttributes - [RemoteDataAkoyaFiAttributeEntity!] | Array of FI-specific attributes |
foreignAmount - Float | The amount of money in the foreign currency |
foreignCurrency - String | The ISO 4217 code of the foreign currency |
imageIds - [String!] | Array of image identifiers (unique to transaction) used to retrieve images of check or transaction receipt. |
lineItem - [RemoteDataAkoyaLineItem!] | Breakdown of the transaction details |
links - [RemoteDataAkoyaHATEOASLink!] | Links (unique to this Transaction) used to retrieve images of checks or transaction receipts, or invoke other APIs |
memo - String | Secondary transaction description |
paymentDetails - RemoteDataAkoyaPaymentDetails | Payment details for some transactions |
postedTimestamp - DateTime | The date and time that the transaction was posted to the account. If not provided then TransactionTimestamp can be used as PostedTimeStamp. |
reference - String | A tracking reference identifier |
referenceTransactionId - String | Akoya ensures that this field is populated for all transactions which are reversals, otherwise it is null. Either way it is always present. For reverse postings, the identity of the transaction being reversed. For the correction transaction, the identity of the reversing post. For credit card posting transactions, the identity of the authorization transaction. |
status - String | AUTHORIZATION, MEMO, PENDING, or POSTED |
subCategory - String | Transaction category detail |
transactionId - String | Long term persistent identity of the transaction (unique to account). Transaction IDs should:
|
transactionTimestamp - DateTime | The date and time that the transaction was added to the server backend systems. Akoya ensures that this field is populated for all transactions to which it applies, otherwise it is null. Either way it is always present. |
transactionType - String | LocTransaction Type |
Example
{
"accountId": "xyz789",
"amount": 987.65,
"category": "abc123",
"checkNumber": 123,
"debitCreditMemo": "abc123",
"description": "abc123",
"fiAttributes": [RemoteDataAkoyaFiAttributeEntity],
"foreignAmount": 987.65,
"foreignCurrency": "abc123",
"imageIds": ["abc123"],
"lineItem": [RemoteDataAkoyaLineItem],
"links": [RemoteDataAkoyaHATEOASLink],
"memo": "abc123",
"paymentDetails": RemoteDataAkoyaPaymentDetails,
"postedTimestamp": "2007-12-03T10:15:30Z",
"reference": "xyz789",
"referenceTransactionId": "xyz789",
"status": "abc123",
"subCategory": "abc123",
"transactionId": "xyz789",
"transactionTimestamp": "2007-12-03T10:15:30Z",
"transactionType": "abc123"
}
RemoteDataAkoyaMutualFundSecurityEntity
Description
Information about the mutual fund security specific to the type of security
Fields
| Field Name | Description |
|---|---|
mutualFundType - String | Mutual fund type |
reinvestCapitalGains - Boolean | Reinvest capital gains |
reinvestDividends - Boolean | Reinvest dividends |
unitsStreet - Float | Units in the FI's street name, positive quantity |
unitsUser - Float | Units in user's name directly, positive quantity |
yield - Float | Current yield reported as portion of the fund's assets |
yieldAsOfDate - DateTime | As-of date for yield value |
Example
{
"mutualFundType": "xyz789",
"reinvestCapitalGains": true,
"reinvestDividends": true,
"unitsStreet": 123.45,
"unitsUser": 987.65,
"yield": 123.45,
"yieldAsOfDate": "2007-12-03T10:15:30Z"
}
RemoteDataAkoyaOptionSecurityEntity
Description
Information about the option security specific to the type of security
Example
{
"expireDate": "2007-12-03T10:15:30Z",
"optionType": "xyz789",
"secured": "xyz789",
"sharesPerContract": 987.65,
"strikePrice": 123.45
}
RemoteDataAkoyaOtherSecurityEntity
Description
Information about the security specific to the type of security
Fields
| Field Name | Description |
|---|---|
typeDescription - String | Description of Other Security |
Example
{"typeDescription": "xyz789"}
RemoteDataAkoyaPaymentDetails
Description
Payment details for some transactions
Fields
| Field Name | Description |
|---|---|
escrowAmount - Float | The amount of payment applied to escrow |
feesAmount - Float | The amount of payment applied to fees |
insuranceAmount - Float | The amount of payment applied to life/health/accident insurance on the loan |
interestAmount - Float | The amount of payment applied to interest |
pmiAmount - Float | The amount of payment applied to PMI |
principalAmount - Float | The amount of payment applied to principal |
Example
{
"escrowAmount": 123.45,
"feesAmount": 987.65,
"insuranceAmount": 123.45,
"interestAmount": 123.45,
"pmiAmount": 987.65,
"principalAmount": 123.45
}
RemoteDataAkoyaStockSecurityEntity
Description
Information about the stock security specific to the type of security
Fields
| Field Name | Description |
|---|---|
reinvestDividends - Boolean | Reinvest dividends |
stockType - String | |
unitsStreet - Float | Units in the FI's street name, positive quantity |
unitsUser - Float | Units in user's name directly, positive quantity |
yield - Float | Current yield |
yieldAsOfDate - DateTime | Yield as-of date |
Example
{
"reinvestDividends": true,
"stockType": "abc123",
"unitsStreet": 123.45,
"unitsUser": 123.45,
"yield": 123.45,
"yieldAsOfDate": "2007-12-03T10:15:30Z"
}
RemoteDataAkoyaSweepSecurityEntity
Description
Information about the sweep security specific to the type of security
Example
{
"availableBalance": 987.65,
"balanceAsOf": "2007-12-03T10:15:30Z",
"checks": true,
"currentBalance": 123.45
}
RemoteDataAkoyaTaxLots
Description
RemoteData Akoya TaxLots
Fields
| Field Name | Description |
|---|---|
costBasis - Float | Total amount of money spent acquiring this lot including any fees or commission expenses incurred. |
currentValue - Float | Lot market value |
originalPurchaseDate - DateTime | Lot acquired date. |
postionType - String | LONG, SHORT. |
purchasedPrice - Float | Original purchase price. |
quantity - Float | Lot quantity. |
Example
{
"costBasis": 123.45,
"currentValue": 987.65,
"originalPurchaseDate": "2007-12-03T10:15:30Z",
"postionType": "xyz789",
"purchasedPrice": 987.65,
"quantity": 987.65
}
RemoteDataAkoyaTelephones
RemoteDataAkoyaToken
Description
Akoya Connection data.
Fields
| Field Name | Description |
|---|---|
accounts - [String!] | Array of Account Ids |
atHash - String | Access token hash value |
aud - [String!] | Data recipient |
authTime - Float | Auth Time |
connectorId - String | ID of Akoya Provider |
email - String | End-user's email address |
emailVerified - Boolean | True if end-user's email is verified, otherwise false |
exp - Float | Time token will expire in Unix Epoch format |
iat - Float | The time the token was issued in Unix Epoch format |
iss - String | Issuer of the JWT, Akoya |
jti - String | Id of Token |
locale - String | End-user's locale |
name - String | End-user's name in displayable form |
products - [String!] | Array of Enabled Akoya Products |
rat - Float | Timestamp |
recipientId - String | recipient Id |
sid - String | Session ID |
sub - String | Unique value to identify the end-user with the scope specific to the data provider |
Example
{
"accounts": ["abc123"],
"atHash": "abc123",
"aud": ["abc123"],
"authTime": 987.65,
"connectorId": "xyz789",
"email": "xyz789",
"emailVerified": true,
"exp": 987.65,
"iat": 987.65,
"iss": "abc123",
"jti": "xyz789",
"locale": "abc123",
"name": "xyz789",
"products": ["abc123"],
"rat": 123.45,
"recipientId": "abc123",
"sid": "xyz789",
"sub": "xyz789"
}
RemoteDataAkoyaTransaction
Description
Akoya Transaction data.
Fields
| Field Name | Description |
|---|---|
depositTransaction - RemoteDataAkoyaDepositTransaction | Deposit transaction |
insuranceTransaction - RemoteDataAkoyaInsuranceTransaction | Insurance transactions |
investmentTransaction - RemoteDataAkoyaInvestmentTransaction | Investment Transactions |
loanTransaction - RemoteDataAkoyaLoanTransaction | Loan Transaction |
locTransaction - RemoteDataAkoyaLocTransaction | A line of credit transaction of type |
Example
{
"depositTransaction": RemoteDataAkoyaDepositTransaction,
"insuranceTransaction": RemoteDataAkoyaInsuranceTransaction,
"investmentTransaction": RemoteDataAkoyaInvestmentTransaction,
"loanTransaction": RemoteDataAkoyaLoanTransaction,
"locTransaction": RemoteDataAkoyaLocTransaction
}
RemoteDataFingoalEnrichedTransaction
Description
Fingoal Enrichment data.
Fields
| Field Name | Description |
|---|---|
accountid - String | The ID of the account associated with the transaction |
amountnum - Float | The transaction's USD amount |
category - String | The most applicable categorization for the transaction |
categoryId - Float | The numeric ID of the transaction's category |
categoryLabel - [String!] | A cascading hierarchy of the transaction's categories, from high-level to detail-level categorization. This field is deprecated and not recommended for use, as it may not reflect more correct information available in other 'category' fields. Deprecated by Fingoal |
clientId - String | Your FinGoal client ID |
container - String | A high-level categorization of the account type. Eg, 'bank' |
date - DateTime | The date on which the transaction took place |
detailCategoryId - Float | The numeric ID of the transaction's detail category |
guid - String | The transaction's globally unique FinSight API issued ID |
highLevelCategoryId - Float | The numeric ID of the transaction's high level category |
isPhysical - Boolean | Whether the transaction was made at a physical location, or online |
isRecurring - Boolean | Whether the transaction is set to recur on a fixed interval |
merchantAddress1 - String | The street address of the merchant associated with the transaction |
merchantCity - String | The name of the city where the merchant is located |
merchantCountry - String | The name of the country where the merchant is located |
merchantLatitude - String | The latitude of the merchant |
merchantLogoUrl - String | The URL resource for the merchant's logo |
merchantLongitude - String | The longitude of the merchant |
merchantName - String | The name of the merchant associated with the transaction |
merchantPhoneNumber - String | The phone number of the merchant associated with the transaction |
merchantState - String | The name of the state where the merchant is located |
merchantType - String | The merchant's type |
merchantZip - String | The ZIP code where the merchant is located |
originalDescription - String | The transaction description as received. This will not change |
receiptDate - DateTime | The date on which FinSight API first received the transaction |
requestId - String | A unique ID for the request the transaction came in with, for debugging purposes |
simpleDescription - String | An easy-to-understand, plain-language transaction description |
sourceId - String | The source of the transaction |
subType - String | A more detailed classification that provides further information on the type of transaction. |
transactionTags - [String!] | The FinSight API issued tags for the transaction |
transactionid - String | The ID of the transaction as it was originally submitted |
type - String | An attribute describing the nature of the intent behind the transaction. |
uid - String | The ID of the user associated with the transaction, as originally submitted |
Example
{
"accountid": "abc123",
"amountnum": 123.45,
"category": "abc123",
"categoryId": 987.65,
"categoryLabel": ["xyz789"],
"clientId": "abc123",
"container": "abc123",
"date": "2007-12-03T10:15:30Z",
"detailCategoryId": 987.65,
"guid": "abc123",
"highLevelCategoryId": 987.65,
"isPhysical": false,
"isRecurring": true,
"merchantAddress1": "abc123",
"merchantCity": "xyz789",
"merchantCountry": "xyz789",
"merchantLatitude": "abc123",
"merchantLogoUrl": "xyz789",
"merchantLongitude": "xyz789",
"merchantName": "xyz789",
"merchantPhoneNumber": "xyz789",
"merchantState": "abc123",
"merchantType": "abc123",
"merchantZip": "abc123",
"originalDescription": "xyz789",
"receiptDate": "2007-12-03T10:15:30Z",
"requestId": "abc123",
"simpleDescription": "abc123",
"sourceId": "xyz789",
"subType": "abc123",
"transactionTags": ["xyz789"],
"transactionid": "abc123",
"type": "abc123",
"uid": "abc123"
}
RemoteDataFingoalUser
Description
Fingoal Insights data.
Fields
| Field Name | Description |
|---|---|
clientId - String | Your client ID. |
id - String | The user ID. |
tags - [String!] | The FinSight API tags that were applied to the user. |
totaltransactions - Float | The total number of transactions the user has in FinSight API. |
transactionsSinceLastUpdate - Float | The number of transactions since the last time insights were run for the user. |
uid - String | The user's ID. |
uniqueId - String | The user's unique ID in the format of client_id:uid. |
Example
{
"clientId": "xyz789",
"id": "abc123",
"tags": ["xyz789"],
"totaltransactions": 987.65,
"transactionsSinceLastUpdate": 123.45,
"uid": "abc123",
"uniqueId": "abc123"
}
RemoteDataFinicityAccountOwnerDetails
Description
Finicity Owner data.
Owner of a customer account
Fields
| Field Name | Description |
|---|---|
addresses - [RemoteDataFinicityAddresses!] | List of addresses |
documentations - [RemoteDataFinicityDocumentations!] | List of account owner documentation |
emails - [RemoteDataFinicityEmails!] | List of emails |
firstName - String | The first name of the account holder |
identityInsights - RemoteDataFinicityIdentityInsights | List of account owner Identity Insights |
lastName - String | The last name of the account holder |
middleName - String | The middle name of the account holder |
nameClassification - String | The classification of the account holder:
|
nameClassificationconfidencescore - Float | The confidence score 0 – 1.0 of the name classification. |
ownerName - String | The full name of the account owner. Multiple account owners are returned in one string per the source data from the institution. |
phones - [RemoteDataFinicityPhones!] | List of phones |
relationship - String | The type of relationship to the account:
|
suffix - String | A generational or academic suffix |
Example
{
"addresses": [RemoteDataFinicityAddresses],
"documentations": [RemoteDataFinicityDocumentations],
"emails": [RemoteDataFinicityEmails],
"firstName": "xyz789",
"identityInsights": RemoteDataFinicityIdentityInsights,
"lastName": "abc123",
"middleName": "xyz789",
"nameClassification": "abc123",
"nameClassificationconfidencescore": 123.45,
"ownerName": "abc123",
"phones": [RemoteDataFinicityPhones],
"relationship": "xyz789",
"suffix": "abc123"
}
RemoteDataFinicityAddresses
Description
Account owner address
Fields
| Field Name | Description |
|---|---|
city - String | City |
country - String | Country code is Iso3166-1 Alpha-2 code and Alpha 3 standard (max length 3). |
line1 - String | Address line 1 |
line2 - String | Address line 2 |
line3 - String | Address line 3 |
ownerAddress - String | A street address |
postalCode - String | A ZIP code |
state - String | State |
type - String | The type of address location:
|
Example
{
"city": "abc123",
"country": "abc123",
"line1": "xyz789",
"line2": "xyz789",
"line3": "abc123",
"ownerAddress": "xyz789",
"postalCode": "xyz789",
"state": "abc123",
"type": "abc123"
}
RemoteDataFinicityCategorization
Description
Categorization Record
Fields
| Field Name | Description |
|---|---|
bestRepresentation - String | Combines the description and memo data together, removing duplicated information and numbers and special characters |
category - String | The different categories for transactions.
|
city - String | City |
country - String | Country code is Iso3166-1 Alpha-2 code and Alpha 3 standard (max length 3). |
normalizedPayeeName - String | A normalized payee, derived from the transaction's description and memo fields |
postalCode - String | A ZIP code |
state - String | State |
Example
{
"bestRepresentation": "abc123",
"category": "abc123",
"city": "abc123",
"country": "xyz789",
"normalizedPayeeName": "abc123",
"postalCode": "xyz789",
"state": "abc123"
}
RemoteDataFinicityConnectionDetails
Description
Finicity Connection data.
Example
{
"aggregationStatusCode": "abc123",
"customerId": "abc123",
"institutionLoginId": "xyz789"
}
RemoteDataFinicityCustomerAccount
Description
Finicity Account data.
An account represents a bank account such as a checking or savings that the customer has added via the Connect interface.
Fields
| Field Name | Description |
|---|---|
accountNumberDisplay - String | The account number from a financial institution in truncated format:
|
aggregationAttemptDate - BigInt | A timestamp showing the last aggregation attempt, whether successful or not. This will not be present until you have run your first aggregation for the account. A date in Unix epoch time (in seconds). See: Handling Epoch Dates and Times. |
aggregationStatusCode - Int | The status of the most recent aggregation attempt (see Aggregation Status Codes). Won't be present until you have run your first aggregation for the account. |
aggregationSuccessDate - BigInt | A timestamp showing the last successful aggregation of the account. This will not be present until you have run your first aggregation for the account. A date in Unix epoch time (in seconds). See: Handling Epoch Dates and Times. |
balance - Float | The cleared balance of the account as of balanceDate |
balanceDate - BigInt | A timestamp showing when the balance was captured. A date in Unix epoch time (in seconds). See: Handling Epoch Dates and Times. |
createdDate - BigInt | A timestamp showing when the account was added to the system. A date in Unix epoch time (in seconds). See: Handling Epoch Dates and Times. |
currency - String | A currency code |
customerId - String | A customer ID. See Add Customer API for how to create a customer ID. |
detail - RemoteDataFinicityDetail | Additional customer account details. Not all data points will return for each account type. You can see the account type that each data point will return for in descriptions. The data point are also subject to availability by the institution. |
displayPosition - Int | Display position of the account at the financial institution, "1" being the top listed account |
id - String | An account ID |
institutionId - String | The ID of a financial institution |
institutionLoginId - BigInt | An institution login ID (from the account record), represented as a number |
lastTransactionDate - BigInt | The date of the latest transaction on the account. This will not be present until you have run your first aggregation for the account. A date in Unix epoch time (in seconds). See: Handling Epoch Dates and Times. |
lastUpdatedDate - BigInt | A timestamp showing when the account was last modified to the system. A date in Unix epoch time (in seconds). See: Handling Epoch Dates and Times. |
marketSegment - String | The market segment of the account. Possible values: personal, business |
name - String | The account name from the institution |
number - String | The account number from the institution Deprecated by Finicity |
oldestTransactionDate - BigInt | The date of the oldest transaction in the transactions for the account. A date in Unix epoch time (in seconds). See: Handling Epoch Dates and Times. |
parentAccount - String | The assigned account ID for the account one level higher in the student loan account hierarchy |
position - [RemoteDataFinicityPosition!] | Investment holdings |
realAccountNumberLast4 - String | The last 4 digits of the ACH account number |
status - String | "pending" during account discovery, always "active" following successful account activation |
type - String | The list of supported account types.
|
Example
{
"accountNumberDisplay": "xyz789",
"aggregationAttemptDate": {},
"aggregationStatusCode": 987,
"aggregationSuccessDate": {},
"balance": 123.45,
"balanceDate": {},
"createdDate": {},
"currency": "abc123",
"customerId": "abc123",
"detail": RemoteDataFinicityDetail,
"displayPosition": 987,
"id": "xyz789",
"institutionId": "xyz789",
"institutionLoginId": {},
"lastTransactionDate": {},
"lastUpdatedDate": {},
"marketSegment": "xyz789",
"name": "xyz789",
"number": "abc123",
"oldestTransactionDate": {},
"parentAccount": "xyz789",
"position": [RemoteDataFinicityPosition],
"realAccountNumberLast4": "xyz789",
"status": "abc123",
"type": "xyz789"
}
RemoteDataFinicityCustomerAccountPosition
Description
Finicity Holding data.
Details for investment account holdings
Fields
| Field Name | Description |
|---|---|
assetClass - String | An asset class is a grouping of comparable financial securities. These include equities (stocks), fixed income (bonds), and cash equivalent or money market instruments. (DOMESTICBOND, LARGESTOCK, INTLSTOCK, MONEYMRKT, OTHER) |
changePercent - Float | The percent change in value since the previous day |
costBasis - Float | The total cost of acquiring the security |
costBasisPerShare - Float | The per share cost of acquiring the security |
currencyRate - Float | Currency rate, ratio of currency to original currency |
currentPrice - Float | The current price of the investment holding |
currentPriceDate - BigInt | A date in Unix epoch time (in seconds). See: Handling Epoch Dates and Times. |
dailyChange - Float | The value amount change since the previous day |
description - String | The description of the holding |
fiAssetClass - String | Financial Institution (FI) defined asset class (COMMON STOCK, COMNEQTY, EQUITY/STOCK, CMA-ISA, CONVERTIBLE PREFERREDS, CORPORATE BONDS, OTHER MONEY FUNDS, ALLOCATION FUNDS, CMA-TAXABLE, FOREIGNEQUITYADRS, COMMONSTOCK, PREFERRED STOCKS, STABLE VALUE, FOREIGN EQUITY ADRS) |
holdType - String | The type of the holding |
id - BigInt | The ID of the investment position |
invSecurityType - String | The security type for the investment holding |
marketValue - Float | Market value of an investment position at the time of retrieval |
mfType - String | Type of mutual fund, such as open ended |
optionExpireDate - Date | Expiration date of option |
optionSharesPerContract - Float | The number of shares per option contract |
optionStrikePrice - Float | The strike price of the option contract |
optionType - String | The type of option contract (PUT or CALL) |
posType - String | Fund type assigned by the FI (long or short) |
securityCurrency - String | Symbol for the currency that the account is being converted into |
securityId - String | The security ID of the transaction |
securityIdType - String | The security type. This field is related to the
|
securityName - String | The security name for the investment holding |
securityType - String | Type of security for the investment position |
status - String | The status of the holding |
subAccountType - String | The subaccount's type, such as cash |
symbol - String | The investment position's market ticker symbol |
todayGlDollar - Float | The current day's gain and loss of the position at the time of aggregation in dollars |
todayGlPercent - Float | The current day's gain and loss of the position at the time of aggregation in percentage |
totalGlDollar - Float | Total gain and loss of the position at the time of aggregation in dollars |
totalGlPercent - Float | Total gain and loss of the position at the time of aggregation in percentage |
transactionType - String | The transaction type of the holding, such as cash, margin, and more |
units - Float | The number of units of the holding |
Example
{
"assetClass": "xyz789",
"changePercent": 987.65,
"costBasis": 123.45,
"costBasisPerShare": 987.65,
"currencyRate": 123.45,
"currentPrice": 987.65,
"currentPriceDate": {},
"dailyChange": 123.45,
"description": "xyz789",
"fiAssetClass": "abc123",
"holdType": "abc123",
"id": {},
"invSecurityType": "xyz789",
"marketValue": 987.65,
"mfType": "xyz789",
"optionExpireDate": "2007-12-03",
"optionSharesPerContract": 123.45,
"optionStrikePrice": 123.45,
"optionType": "abc123",
"posType": "xyz789",
"securityCurrency": "abc123",
"securityId": "xyz789",
"securityIdType": "xyz789",
"securityName": "abc123",
"securityType": "abc123",
"status": "xyz789",
"subAccountType": "xyz789",
"symbol": "xyz789",
"todayGlDollar": 987.65,
"todayGlPercent": 987.65,
"totalGlDollar": 987.65,
"totalGlPercent": 987.65,
"transactionType": "xyz789",
"units": 123.45
}
RemoteDataFinicityDetail
Description
Additional customer account details. Not all data points will return for each account type. You can see the account type that each data point will return for in descriptions. The data point are also subject to availability by the institution.
Fields
| Field Name | Description |
|---|---|
afterTaxAmount - Float | (Investment) After-tax amount of total balance |
autoPayEnrolled - Boolean | (Mortgage/Loan) Enrolled in autopay (F/Y) |
availableBalanceAmount - Float | (Checking/Savings/CD/MoneyMarket) and (Mortgage/Loan) The available balance (typically the current balance with adjustments for any pending transactions) |
availableCashBalance - Float | (Investment) Amount available for cash withdrawal |
balloonAmount - Float | (Mortgage/Loan) Balloon payment amount |
buyPower - Float | (Investment) Money available to buy securities |
cashAccountAllowed - Boolean | Cash account allowed indicator (true / false) |
cashAdvanceAvailableAmount - Float | (Credit Card/Line Of Credit) Currently available cash advance |
cashAdvanceBalance - Float | (Credit Card/Line Of Credit) Balance of current cash advance |
cashAdvanceInterestRate - Float | (Credit Card/Line Of Credit) Interest rate for cash advances |
cashAdvanceMaxAmount - Float | (Credit Card/Line Of Credit) Maximum cash advance amount |
cashBalanceAmount - Float | (Investment) Cash balance of account |
collateral - String | (Mortgage/Loan) Collateral on loan |
contribTotalYtd - Float | (Investment) Total year to date contributions |
convertToRepayment - BigInt | (Student Loan) The date the loan enters into repayment. A date in Unix epoch time (in seconds). See: Handling Epoch Dates and Times. |
creditAvailableAmount - Float | (Credit Card/Line Of Credit) The available credit (typically the credit limit minus the current balance) |
creditMaxAmount - Float | (Credit Card/Line Of Credit) The account's credit limit |
currentBalance - Float | (Credit Card/Line Of Credit) and (Investment) Current balance |
currentLoanBalance - Float | (Investment) Current loan balance |
currentSchool - String | (Mortgage/Loan) Current school |
dateAsOf - BigInt | (All Account Types) Most recent date of the following information. A date in Unix epoch time (in seconds). See: Handling Epoch Dates and Times. |
daysDelinquent - Int | (Student Loan) The number of days past a due date that a payment should have been made |
description - String | (Mortgage/Loan) Description of loan |
empMatchAmount - Float | (Investment) Employer matched contributions |
empPretaxContribAmount - Float | (Investment) Employer pretax contribution amount |
empPretaxContribAmountYtd - Float | (Investment) Employer pretax contribution amount year to date |
endingBalanceAmount - Float | (Mortgage/Loan) Ending balance |
escrowBalance - Float | (Mortgage/Loan) The escrow balance |
expectedPayoffDate - BigInt | (Student Loan) The expected date of the payoff date. A date in Unix epoch time (in seconds). See: Handling Epoch Dates and Times. |
feesBalance - Float | (Student Loan) The total outstanding fees balance |
firstMortgage - Boolean | (Mortgage/Loan) First mortgage (F/Y) |
firstPaymentDate - BigInt | (Mortgage/Loan) First payment due date. A date in Unix epoch time (in seconds). See: Handling Epoch Dates and Times. |
guarantor - String | (Student Loan) The financial institution guarantor of the loan (who will pay the loan amount to the owner if the borrower defaults) |
initialInterestRate - Float | (Student Loan) Initial interest rate of loan |
initialMlAmount - Float | (Mortgage/Loan) Original loan amount |
initialMlDate - BigInt | (Mortgage/Loan) Original date of loan. A date in Unix epoch time (in seconds). See: Handling Epoch Dates and Times. |
interestBalance - Float | (Student Loan) The total outstanding interest balance |
interestPaidLtd - Float | (Mortgage/Loan) Interest paid since inception of loan (life to date) |
interestPeriod - String | (Mortgage/Loan) Period of interest |
interestPriorYtdAmount - Float | (Checking/Savings/CD/MoneyMarket) Interest earned in prior year |
interestRate - String | (Credit Card/Line Of Credit) and (Mortgage/Loan) The account's current interest rate |
interestRateType - String | (Mortgage/Loan) Type of interest rate |
interestSubsidyType - String | (Student Loan) The indication of the presence of an interest subsidy (i.e. subsidized) |
interestYtdAmount - Float | (Checking/Savings/CD/MoneyMarket) Interest accrued year-to-date |
lastPaymentAmount - Float | (Credit Card/Line Of Credit) and (Mortgage/Loan) The amount received in the last payment |
lastPaymentDate - BigInt | (Credit Card/Line Of Credit) The date of the last payment. A date in Unix epoch time (in seconds). See: Handling Epoch Dates and Times. |
lastPaymentDueDate - BigInt | (Mortgage/Loan) Due date of last payment. A date in Unix epoch time (in seconds). See: Handling Epoch Dates and Times. |
lastPaymentEscrowAmount - Float | (Mortgage/Loan) Amount towards escrow in last payment |
lastPaymentInterestAmount - Float | (Mortgage/Loan) Amount of interest in last payment |
lastPaymentLastFeeAmount - Float | (Mortgage/Loan) Amount of last fee in last payment |
lastPaymentLateCharge - Float | (Mortgage/Loan) Amount of late charge in last payment |
lastPaymentPrincipalAmount - Float | (Mortgage/Loan) Amount towards principal in last payment |
lastPaymentReceiveDate - BigInt | (Mortgage/Loan) The date of the last payment. A date in Unix epoch time (in seconds). See: Handling Epoch Dates and Times. |
lateFeeAmount - Float | (Mortgage/Loan) Late fee charged |
lender - String | (Mortgage/Loan) Owner of loan |
loanAwardId - String | (Student Loan) The federal unique loan identifying number |
loanPaymentFreq - String | (Mortgage/Loan) Frequency of payments (monthly, etc.) |
loanPaymentType - String | (Mortgage/Loan) Type of loan payment |
loanRate - Float | (Investment) Interest rate of loan |
loanStatus - String | (Student Loan) The repayment status phase (i.e. In School, Grace, Repayment, Deferment, Forbearance) |
loanStatusEndDate - BigInt | (Student Loan) The end date of the current status. A date in Unix epoch time (in seconds). See: Handling Epoch Dates and Times. |
loanStatusStartDate - BigInt | (Student Loan) The start date of the current status. A date in Unix epoch time (in seconds). See: Handling Epoch Dates and Times. |
loanTermType - String | (Mortgage/Loan) Type of loan term |
loanYtdFeesPaid - Float | (Student Loan) Loan fees paid year-to-date |
loanYtdInterestPaid - Float | (Student Loan) Loan interest paid year-to-date |
loanYtdPrincipalPaid - Float | (Student Loan) Loan principal paid year-to-date |
marginAllowed - Boolean | Margin trading indicator (true / false) |
marginBalance - Float | (Investment) Net interest earned after deducting interest paid out |
matchAmount - Float | (Investment) Amount matched |
maturityDate - BigInt | (Checking/Savings/CD/MoneyMarket) Maturity date of account type. A date in Unix epoch time (in seconds). See: Handling Epoch Dates and Times. |
maturityValueAmount - Float | (Investment) amount payable to an investor at maturity |
mlHolderName - String | (Mortgage/Loan) Holder of the mortgage or loan |
nextPayment - Float | (Mortgage/Loan) Minimum payment due |
nextPaymentDate - BigInt | (Mortgage/Loan) Due date for the next payment. A date in Unix epoch time (in seconds). See: Handling Epoch Dates and Times. |
nextPaymentInterestAmount - Float | (Mortgage/Loan) Amount of interest in next payment |
nextPaymentPrincipalAmount - Float | (Mortgage/Loan) Amount towards principal in next payment |
openDate - BigInt | (Checking/Savings/CD/MoneyMarket) Date when account was opened. A date in Unix epoch time (in seconds). See: Handling Epoch Dates and Times. |
originalInterestRate - Float | (Student Loan) The original interest rate to which the loan was disbursed, in APY |
originalMaturityDate - BigInt | (Mortgage/Loan) Original date of loan maturity. A date in Unix epoch time (in seconds). See: Handling Epoch Dates and Times. |
originalSchool - String | (Mortgage/Loan) Original school |
otherNonvestAmount - Float | (Investment) Other nonvested amount |
otherVestAmount - Float | (Investment) Other vested amount |
outOfSchoolDate - BigInt | (Student Loan) The date the borrower graduated or dropped below half-time enrollment in school. A date in Unix epoch time (in seconds). See: Handling Epoch Dates and Times. |
owner - String | (Student Loan) Owner of the loan |
pastDueAmount - Float | (Credit Card/Line Of Credit) Balance past due |
paymentDueDate - BigInt | (Credit Card/Line Of Credit) Due date for the next payment. A date in Unix epoch time (in seconds). See: Handling Epoch Dates and Times. |
paymentMinAmount - Float | (Credit Card/Line Of Credit) and (Mortgage/Loan) Minimum payment due |
paymentsMade - Int | (Mortgage/Loan) Number of payments made |
paymentsRemaining - Int | (Mortgage/Loan) Number of payments remaining before loan is paid off |
payoffAmount - Float | (Mortgage/Loan) The amount required to payoff the loan |
payoffAmountDate - BigInt | (Mortgage/Loan) Date of final payment. A date in Unix epoch time (in seconds). See: Handling Epoch Dates and Times. |
periodDepositAmount - Float | (Checking/Savings/CD/MoneyMarket) Amount deposited in period |
periodEndDate - BigInt | End date of period. A date in Unix epoch time (in seconds). See: Handling Epoch Dates and Times. |
periodInterestAmount - Float | (Checking/Savings/CD/MoneyMarket) Interest accrued during the current period |
periodInterestRate - Float | (Checking/Savings/CD/MoneyMarket) The APY for the current period interest rate |
periodStartDate - BigInt | (Checking/Savings/CD/MoneyMarket) Start date of period. A date in Unix epoch time (in seconds). See: Handling Epoch Dates and Times. |
preTaxAmount - Float | (Investment) Pre-tax amount of total balance |
previousBalance - Float | (Credit Card/Line Of Credit) Prior balance in last statement |
principalBalance - Float | (Mortgage/Loan) The principal balance |
profitSharingAmount - Float | (Investment) Amount of balance for profit sharing |
projectedInterest - Float | (Mortgage/Loan) Projected interest on the loan |
recurringPaymentAmount - Float | (Mortgage/Loan) Recurring payment amount |
remainingTermOfMl - Float | (Student Loan) The number of months still outstanding on a loan |
repaymentPlan - String | (Mortgage/Loan) Type of repayment plan for the student loan |
repaymentPlanEndDate - BigInt | (Student Loan) The end date of the current repayment plan. A date in Unix epoch time (in seconds). See: Handling Epoch Dates and Times. |
repaymentPlanStartDate - BigInt | (Student Loan) The start date of the current repayment plan. A date in Unix epoch time (in seconds). See: Handling Epoch Dates and Times. |
rewardEarnedBalance - Int | (Credit Card/Line Of Credit) Earned reward balance |
rolloverAmount - Float | (Investment) Amount of balance rolled over from original account (401k, etc.) |
rolloverLtd - Float | (Investment) Life to date of money rolled over |
shortBalance - Float | (Investment) Sum of short balance |
statementCloseBalance - Float | (Credit Card/Line Of Credit) Balance of statement at close |
statementCreditAmount - Float | (Credit Card/Line Of Credit) Credit amount applied in statement period |
statementEndDate - BigInt | (Credit Card/Line Of Credit) End date of statement period. A date in Unix epoch time (in seconds). See: Handling Epoch Dates and Times. |
statementFinanceAmount - Float | (Credit Card/Line Of Credit) Finance amount of statement period |
statementPurchaseAmount - Float | (Credit Card/Line Of Credit) Purchase amount of statement period |
statementStartDate - BigInt | (Credit Card/Line Of Credit) Start date of statement period. A date in Unix epoch time (in seconds). See: Handling Epoch Dates and Times. |
termOfMl - String | (Mortgage/Loan) Length of loan in months |
totalAmountPaid - Float | (Student Loan) The total amount paid |
totalInterestPaid - Float | (Student Loan) The total amount paid towards interest |
totalPrincipalPaid - Float | (Student Loan) The total amount paid towards the principal balance |
vestedBalance - Float | (Investment) Vested amount in account |
weightedInterestRate - Float | (Student Loan) The interest rate of multiple interest rates and balances at the group level, in APY |
ytdInsurancePaid - Float | (Mortgage/Loan) Insurance paid year-to-date |
ytdInterestPaid - Float | (Mortgage/Loan) Interest paid year-to-date |
ytdPrincipalPaid - Float | (Mortgage/Loan) Principal paid year-to-date |
ytdTaxPaid - Float | (Mortgage/Loan) Tax paid year-to-date |
Example
{
"afterTaxAmount": 987.65,
"autoPayEnrolled": false,
"availableBalanceAmount": 987.65,
"availableCashBalance": 987.65,
"balloonAmount": 987.65,
"buyPower": 123.45,
"cashAccountAllowed": false,
"cashAdvanceAvailableAmount": 987.65,
"cashAdvanceBalance": 987.65,
"cashAdvanceInterestRate": 987.65,
"cashAdvanceMaxAmount": 987.65,
"cashBalanceAmount": 123.45,
"collateral": "abc123",
"contribTotalYtd": 987.65,
"convertToRepayment": {},
"creditAvailableAmount": 987.65,
"creditMaxAmount": 987.65,
"currentBalance": 987.65,
"currentLoanBalance": 987.65,
"currentSchool": "xyz789",
"dateAsOf": {},
"daysDelinquent": 123,
"description": "abc123",
"empMatchAmount": 123.45,
"empPretaxContribAmount": 123.45,
"empPretaxContribAmountYtd": 123.45,
"endingBalanceAmount": 123.45,
"escrowBalance": 123.45,
"expectedPayoffDate": {},
"feesBalance": 123.45,
"firstMortgage": true,
"firstPaymentDate": {},
"guarantor": "xyz789",
"initialInterestRate": 987.65,
"initialMlAmount": 123.45,
"initialMlDate": {},
"interestBalance": 987.65,
"interestPaidLtd": 123.45,
"interestPeriod": "abc123",
"interestPriorYtdAmount": 123.45,
"interestRate": "abc123",
"interestRateType": "abc123",
"interestSubsidyType": "xyz789",
"interestYtdAmount": 123.45,
"lastPaymentAmount": 123.45,
"lastPaymentDate": {},
"lastPaymentDueDate": {},
"lastPaymentEscrowAmount": 123.45,
"lastPaymentInterestAmount": 123.45,
"lastPaymentLastFeeAmount": 987.65,
"lastPaymentLateCharge": 987.65,
"lastPaymentPrincipalAmount": 987.65,
"lastPaymentReceiveDate": {},
"lateFeeAmount": 123.45,
"lender": "abc123",
"loanAwardId": "abc123",
"loanPaymentFreq": "xyz789",
"loanPaymentType": "xyz789",
"loanRate": 987.65,
"loanStatus": "xyz789",
"loanStatusEndDate": {},
"loanStatusStartDate": {},
"loanTermType": "xyz789",
"loanYtdFeesPaid": 987.65,
"loanYtdInterestPaid": 123.45,
"loanYtdPrincipalPaid": 987.65,
"marginAllowed": false,
"marginBalance": 123.45,
"matchAmount": 987.65,
"maturityDate": {},
"maturityValueAmount": 123.45,
"mlHolderName": "xyz789",
"nextPayment": 987.65,
"nextPaymentDate": {},
"nextPaymentInterestAmount": 123.45,
"nextPaymentPrincipalAmount": 123.45,
"openDate": {},
"originalInterestRate": 123.45,
"originalMaturityDate": {},
"originalSchool": "xyz789",
"otherNonvestAmount": 123.45,
"otherVestAmount": 987.65,
"outOfSchoolDate": {},
"owner": "xyz789",
"pastDueAmount": 987.65,
"paymentDueDate": {},
"paymentMinAmount": 123.45,
"paymentsMade": 987,
"paymentsRemaining": 123,
"payoffAmount": 987.65,
"payoffAmountDate": {},
"periodDepositAmount": 987.65,
"periodEndDate": {},
"periodInterestAmount": 123.45,
"periodInterestRate": 123.45,
"periodStartDate": {},
"preTaxAmount": 123.45,
"previousBalance": 987.65,
"principalBalance": 123.45,
"profitSharingAmount": 123.45,
"projectedInterest": 987.65,
"recurringPaymentAmount": 123.45,
"remainingTermOfMl": 123.45,
"repaymentPlan": "xyz789",
"repaymentPlanEndDate": {},
"repaymentPlanStartDate": {},
"rewardEarnedBalance": 123,
"rolloverAmount": 123.45,
"rolloverLtd": 987.65,
"shortBalance": 987.65,
"statementCloseBalance": 987.65,
"statementCreditAmount": 123.45,
"statementEndDate": {},
"statementFinanceAmount": 123.45,
"statementPurchaseAmount": 123.45,
"statementStartDate": {},
"termOfMl": "xyz789",
"totalAmountPaid": 123.45,
"totalInterestPaid": 987.65,
"totalPrincipalPaid": 123.45,
"vestedBalance": 987.65,
"weightedInterestRate": 123.45,
"ytdInsurancePaid": 987.65,
"ytdInterestPaid": 987.65,
"ytdPrincipalPaid": 123.45,
"ytdTaxPaid": 987.65
}
RemoteDataFinicityDocumentations
Description
Account owner documentation
Fields
| Field Name | Description |
|---|---|
governmentId - String | A federal or state issued identification number in alphanumeric characters.
|
taxId - String | Country specific tax ID associated with the customer.
|
taxIdCountry - String | Country code is Iso3166-1 Alpha-2 code and Alpha 3 standard (max length 3). |
Example
{
"governmentId": "abc123",
"taxId": "xyz789",
"taxIdCountry": "xyz789"
}
RemoteDataFinicityEmails
RemoteDataFinicityIdentityInsights
Description
List of account owner Identity Insights
Fields
| Field Name | Description |
|---|---|
addressToName - String | The match status between the input name and the queried entity.
|
addressValidityLevel - Float | The most granular level to which the address could be validated. Ex. If the address was only valid to the city level (but not to the house level), it would return “valid_to_city”.
street and house number level. This means the country, state, city, postal code, street, and house number of the input address are valid, but the subpremise of the input address was unable to be confirmed as valid or invalid. validated to the street and house number level. This means the country, state, city, postal code, street, and house number of the input address are valid, but the subpremise of the input address was missing and thus unable to be confirmed as valid or invalid. |
emailDomainCreationDate - String | Returns a date that the email domain was created. |
emailFirstSeenDays - Float | Count of days since the email was first observed in Ekata's Identity Network. If the email has not been observed before, first_seen_days will be 0. |
emailToName - String | The match status between the input name and the queried entity.
|
identityNetworkScore - Float | Comprehensive network score built on behavioral insights such as velocity, popularity, volatility, and age of an attribute, with a higher score indicating a riskier account sign-up. A number between 0 and 1 rounded to three decimal places. |
identityRiskScore - Float | Comprehensive identity risk score with a higher score indicating a riskier account sign-up. |
ipAddressDistance - Float | The distance (in miles) between the IP address and the physical address. |
ipGeolocationCountryCode - String | The ISO-3166 alpha-2 country code associated with the geolocation of the IP address. |
ipGeolocationSubdivision - String | More granular detail about the IP address location. |
ipLastSeenDays - Float | Count of days since the IP address was last observed in Ekata's Identity Network. If the IP address has not been observed before, IpLastSeenDays will be 0. |
ipPhoneDistance - Float | The distance (in miles) between the IP address and the closest physical address associated with the phone number. |
ipRisk - Float | True if the IP address is considered risky, based on multiple IP data points and velocity calculations. |
ipRiskScore - Float | Comprehensive risk score associated with an IP address, with a higher score indicating a riskier IP address. A number between 0 and 1 rounded to three decimal places. |
isEmailValid - Boolean | True if the email address is valid. |
isPhoneValid - Boolean | True if the phone number is valid. |
phoneCarrier - String | The company that provides voice and/or data services for the phone number. Carriers are returned at the MVNO level. |
phoneCountryCode - String | The ISO-3166 alpha-2 country code associated with the phone number. |
phoneEmailFirstSeenDays - Float | Count of days since the combination of phone and email was first observed in Ekata's Identity Network. If that combination has not been observed before, phoneEmailFirstSeenDays will be 0. |
phoneLastSeenDays - Float | Count of days since the phone was last observed in Ekata's Identity Network. If the phone has not been observed before, phoneLastSeenDays will be 0. |
phoneLineType - String | The line type of the phone number.
|
phoneToAddress - String | The match status between the input phone and the queried entity.
|
phoneToName - String | The match status between the input name and the queried entity.
|
warnings - [String!] |
Example
{
"addressToName": "abc123",
"addressValidityLevel": 123.45,
"emailDomainCreationDate": "abc123",
"emailFirstSeenDays": 987.65,
"emailToName": "abc123",
"identityNetworkScore": 987.65,
"identityRiskScore": 987.65,
"ipAddressDistance": 987.65,
"ipGeolocationCountryCode": "abc123",
"ipGeolocationSubdivision": "abc123",
"ipLastSeenDays": 123.45,
"ipPhoneDistance": 987.65,
"ipRisk": 123.45,
"ipRiskScore": 987.65,
"isEmailValid": true,
"isPhoneValid": true,
"phoneCarrier": "abc123",
"phoneCountryCode": "xyz789",
"phoneEmailFirstSeenDays": 123.45,
"phoneLastSeenDays": 123.45,
"phoneLineType": "xyz789",
"phoneToAddress": "abc123",
"phoneToName": "abc123",
"warnings": ["xyz789"]
}
RemoteDataFinicityPhones
Description
Consumer phone
Example
{
"country": "abc123",
"phone": "xyz789",
"type": "xyz789"
}
RemoteDataFinicityPosition
Description
Details for investment account holdings
Fields
| Field Name | Description |
|---|---|
assetClass - String | An asset class is a grouping of comparable financial securities. These include equities (stocks), fixed income (bonds), and cash equivalent or money market instruments. (DOMESTICBOND, LARGESTOCK, INTLSTOCK, MONEYMRKT, OTHER) |
changePercent - Float | The percent change in value since the previous day |
costBasis - Float | The total cost of acquiring the security |
costBasisPerShare - Float | The per share cost of acquiring the security |
currencyRate - Float | Currency rate, ratio of currency to original currency |
currentPrice - Float | The current price of the investment holding |
currentPriceDate - BigInt | A date in Unix epoch time (in seconds). See: Handling Epoch Dates and Times. |
dailyChange - Float | The value amount change since the previous day |
description - String | The description of the holding |
fiAssetClass - String | Financial Institution (FI) defined asset class (COMMON STOCK, COMNEQTY, EQUITY/STOCK, CMA-ISA, CONVERTIBLE PREFERREDS, CORPORATE BONDS, OTHER MONEY FUNDS, ALLOCATION FUNDS, CMA-TAXABLE, FOREIGNEQUITYADRS, COMMONSTOCK, PREFERRED STOCKS, STABLE VALUE, FOREIGN EQUITY ADRS) |
holdType - String | The type of the holding |
id - BigInt | The ID of the investment position |
invSecurityType - String | The security type for the investment holding |
marketValue - Float | Market value of an investment position at the time of retrieval |
mfType - String | Type of mutual fund, such as open ended |
optionExpireDate - Date | Expiration date of option |
optionSharesPerContract - Float | The number of shares per option contract |
optionStrikePrice - Float | The strike price of the option contract |
optionType - String | The type of option contract (PUT or CALL) |
posType - String | Fund type assigned by the FI (long or short) |
securityCurrency - String | Symbol for the currency that the account is being converted into |
securityId - String | The security ID of the transaction |
securityIdType - String | The security type. This field is related to the
|
securityName - String | The security name for the investment holding |
securityType - String | Type of security for the investment position |
status - String | The status of the holding |
subAccountType - String | The subaccount's type, such as cash |
symbol - String | The investment position's market ticker symbol |
todayGlDollar - Float | The current day's gain and loss of the position at the time of aggregation in dollars |
todayGlPercent - Float | The current day's gain and loss of the position at the time of aggregation in percentage |
totalGlDollar - Float | Total gain and loss of the position at the time of aggregation in dollars |
totalGlPercent - Float | Total gain and loss of the position at the time of aggregation in percentage |
transactionType - String | The transaction type of the holding, such as cash, margin, and more |
units - Float | The number of units of the holding |
Example
{
"assetClass": "xyz789",
"changePercent": 123.45,
"costBasis": 987.65,
"costBasisPerShare": 123.45,
"currencyRate": 987.65,
"currentPrice": 123.45,
"currentPriceDate": {},
"dailyChange": 123.45,
"description": "xyz789",
"fiAssetClass": "xyz789",
"holdType": "xyz789",
"id": {},
"invSecurityType": "abc123",
"marketValue": 123.45,
"mfType": "abc123",
"optionExpireDate": "2007-12-03",
"optionSharesPerContract": 987.65,
"optionStrikePrice": 987.65,
"optionType": "abc123",
"posType": "xyz789",
"securityCurrency": "abc123",
"securityId": "abc123",
"securityIdType": "xyz789",
"securityName": "abc123",
"securityType": "xyz789",
"status": "xyz789",
"subAccountType": "abc123",
"symbol": "abc123",
"todayGlDollar": 123.45,
"todayGlPercent": 123.45,
"totalGlDollar": 987.65,
"totalGlPercent": 987.65,
"transactionType": "abc123",
"units": 987.65
}
RemoteDataFinicityTransaction
Description
Finicity Transaction data.
Fields
| Field Name | Description |
|---|---|
accountId - BigInt | An account ID represented as a number |
amount - Float | The total amount of the transaction. Transactions for deposits are positive values, withdrawals and debits are negative values. |
categorization - RemoteDataFinicityCategorization | Categorization Record |
checkNum - String | The check number of the transaction |
commissionAmount - Int | Transaction commission |
createdDate - BigInt | A date in Unix epoch time (in seconds). Represents the timestamp of the transaction when it was added to our platform. See: Handling Epoch Dates and Times. |
currencySymbol - String | If the foreign amount value is present then this is the currency code of that foreign amount |
customerId - BigInt | A customer ID represented as a number. See Add Customer API for how to create a customer ID. |
description - String | The description value is from the financial institution (FI), often known as the payee. The value "No description provided by institution" is returned when the FI doesn't provide one |
effectiveDate - BigInt | A date in Unix epoch time (in seconds). Represents the timestamp of the transaction when it became effective on an account by an institution. See: Handling Epoch Dates and Times. |
escrowAmount - Float | The portion of the transaction allocated to escrow |
feeAmount - Float | The portion of the overall transaction amount applied to fees |
firstEffectiveDate - BigInt | A date in Unix epoch time (in seconds). Represents the first timestamp of the transaction recorded in the effectiveDate field. See: Handling Epoch Dates and Times. |
id - BigInt | A transaction ID |
incomeType - String | Capital gains applied in short, long, or miscellaneous terms for tax purposes |
interestAmount - Float | The portion of the transaction allocated to interest |
investmentTransactionType - String | Keywords in the Possible values:
|
memo - String | The institution must provide either a description, a memo, or both. We recommended concatenating the two fields into a single value. |
optionExpireDate - BigInt | A date in Unix epoch time (in seconds). Represents the timestamp of the transaction expiration date when it became expires on an account by an institution. See: Handling Epoch Dates and Times. |
optionStrikePrice - Float | The strike price of the option contract |
postedDate - BigInt | A date in Unix epoch time (in seconds). Represents the timestamp of the transaction when it was posted or cleared by the institution. This value isn't required for student loan transaction data. See: Handling Epoch Dates and Times. |
principalAmount - Float | The portion of the transaction allocated to principal |
runningBalanceAmount - Float | The ending balance after the transaction was posted |
securityId - String | The security ID of the transaction |
securityIdType - String | The security type. This field is related to the
|
sharesPerContract - Float | Shares per contract of the underlying stock option |
splitDenominator - Float | Denominator of the stock split for the transaction |
splitNumerator - Float | Numerator of the stock split for the transaction |
status - String | One of "active", "pending", or "shadow" (see Transaction Status) |
subAccountFund - String | The sub account where the funds came from |
subaccountSecurityType - String | The type of sub account the funds came from |
suspenseAmount - Float | Temporarily hold funds if you overpay or underpay your monthly payment |
taxesAmount - Int | Taxes applicable to the investment trade |
ticker - String | Ticker symbol for the investment related to the transaction |
transactionDate - BigInt | A date in Unix epoch time (in seconds). Represents the timestamp of the transaction when it occurred. See: Handling Epoch Dates and Times. |
type - String | If provided by the institution, the following values may be returned in the field of a record:
|
unitPrice - Float | Share price for the investment unit: stocks, mutual funds, ETFs |
unitQuantity - Int | The number of units (individual shares) in the transaction |
Example
{
"accountId": {},
"amount": 987.65,
"categorization": RemoteDataFinicityCategorization,
"checkNum": "xyz789",
"commissionAmount": 987,
"createdDate": {},
"currencySymbol": "xyz789",
"customerId": {},
"description": "abc123",
"effectiveDate": {},
"escrowAmount": 123.45,
"feeAmount": 123.45,
"firstEffectiveDate": {},
"id": {},
"incomeType": "xyz789",
"interestAmount": 987.65,
"investmentTransactionType": "abc123",
"memo": "abc123",
"optionExpireDate": {},
"optionStrikePrice": 987.65,
"postedDate": {},
"principalAmount": 123.45,
"runningBalanceAmount": 123.45,
"securityId": "abc123",
"securityIdType": "abc123",
"sharesPerContract": 987.65,
"splitDenominator": 987.65,
"splitNumerator": 123.45,
"status": "abc123",
"subAccountFund": "xyz789",
"subaccountSecurityType": "xyz789",
"suspenseAmount": 123.45,
"taxesAmount": 987,
"ticker": "xyz789",
"transactionDate": {},
"type": "xyz789",
"unitPrice": 987.65,
"unitQuantity": 123
}
RemoteDataMockAccount
Description
Mock Account data.
Example
{
"balance": "abc123",
"balanceSheetClass": "xyz789",
"currency": "xyz789",
"id": "abc123",
"mask": "abc123",
"name": "xyz789",
"type": "abc123"
}
RemoteDataMockAddress
RemoteDataMockConnection
RemoteDataMockOwner
Description
Mock Owner data.
Fields
| Field Name | Description |
|---|---|
address - RemoteDataMockAddress | Address |
email - String | |
name - String | Name |
phone - String | Phone |
Example
{
"address": RemoteDataMockAddress,
"email": "xyz789",
"name": "xyz789",
"phone": "xyz789"
}
RemoteDataMockTransaction
Description
Mock Transaction data.
Fields
| Field Name | Description |
|---|---|
accountId - String | Account ID |
amount - String | Amount |
category - String | Category |
currencyCode - String | ISO Currency Code |
date - String | Date |
description - String | Description |
id - String | ID |
isoCurrencyCode - String | ISO Currency Code Deprecated by Mock |
status - String | Status |
Example
{
"accountId": "xyz789",
"amount": "abc123",
"category": "abc123",
"currencyCode": "abc123",
"date": "xyz789",
"description": "abc123",
"id": "abc123",
"isoCurrencyCode": "abc123",
"status": "xyz789"
}
RemoteDataMxAccount
Description
Mx Account data.
Fields
| Field Name | Description |
|---|---|
accountNumber - String | The account number associated with the account. This will typically be a masked or partial account number. |
accountOwnership - String | |
annuityPolicyToDate - String | |
annuityProvider - String | |
annuityTermYear - Float | |
apr - Float | The annual percentage rate associated with the account. |
apy - Float | The annual percentage yield associated with the account. |
availableBalance - Float | The balance that is available for use in asset accounts like checking and savings. PENDING transactions are typically taken into account with the available balance, but this may not always be the case. available_balance will usually be a positive value for all account types, determined in the same way as the balance field. |
availableCredit - Float | The amount of credit available for use in liability accounts like credit cards and lines of credit. PENDING transactions are typically taken into account with available credit, but this may not always be the case. available_credit will usually be a positive value for all account types, determined in the same way as the balance field. |
balance - Float | The current balance of the account. PENDING transactions are typically not taken into account with the current balance, but this may not always be the case. This is the value used for the account balance displayed in MX UIs. The balance will usually be a positive value for all account types. Asset-type accounts (CHECKING, SAVINGS, INVESTMENT) may have a negative balance if they are in overdraft. Debt-type accounts (CREDIT_CARD, LOAN, LINE_OF_CREDIT, MORTGAGE) may have a negative balance if they are overpaid. |
cashBalance - Float | The cash balance of the account. |
cashSurrenderValue - Float | The sum of money paid to the policyholder or annuity holder in the event the policy is voluntarily terminated before it matures, or the insured event occurs. |
createdAt - String | The date and time at which the account was created on the MX Platform. |
creditLimit - Float | The credit limit associated with the account. |
currencyCode - String | The three-character ISO 4217 currency code. |
dayPaymentIsDue - Int | The day of the month the payment is due. For example, the 14th is passed as 14. |
deathBenefit - Int | The amount paid to the beneficiary of the account upon death of the account owner. |
guid - String | The unique identifier for the account. Defined by MX. |
holdingsValue - Float | The sum of all long holdings within this account, not including any that are shorted and not including cash. |
id - String | The unique partner-defined identifier for the account |
importedAt - String | The date and time at which the account was last successfully aggregated and received data. |
institutionCode - String | A unique identifier for the institution associated with this account. Defined by MX. |
insuredName - String | The name of the insured individual. |
interestRate - Float | The interest rate associated with the account. |
isClosed - Boolean | This indicates whether an account has been closed. |
isHidden - Boolean | This indicates whether the account is hidden. Defaults to false. |
isManual - Boolean | |
lastPayment - Float | The date and time of the most recent payment on the account. |
lastPaymentAt - String | The amount of the most recent payment on the account. |
loanAmount - Float | The amount of the loan associated with the account. |
marginBalance - Float | |
maturesOn - String | The date on which the account matures. |
memberGuid - String | The unique identifier for the member associated with the account. Defined by MX. |
memberId - String | The unique, partner-defined, identifier for the member associated with this account. |
memberIsManagedByUser - Boolean | This indicates whether the associated member is managed by the user or the MX partner. Members created with the managed member feature will have this field set to false. |
metadata - String | Additional information a partner can store on the account. |
minimumBalance - Float | The minimum balance associated with the account. |
minimumPayment - Float | The minimum payment required for an account. This can apply to any debt account. |
name - String | The human-readable name for the account. |
nickname - String | An alternate name for the account. |
originalBalance - Float | The original balance associated with the account. This will always be positive. |
payOutAmount - Float | The amount paid out to the insured individual or beneficiary under the conditions of the insurance policy. |
paymentDueAt - String | The date and time at which the next payment is due on the account. |
payoffBalance - Float | The payoff balance for a debt account. This will normally be a positive number. |
premiumAmount - Float | The insurance policy’s premium amount. |
propertyType - String | |
routingNumber - String | The routing number for the account. |
startedOn - String | The date on which a debt account was started. |
subtype - String | The account’s subtype, e.g., PLAN_401_K, MONEY_MARKET, or HOME_EQUITY. |
todayUglAmount - Float | |
todayUglPercentage - Float | |
totalAccountValue - Float | The total value of the account. |
type - String | The general or parent type of the account. |
updatedAt - String | The date and time at which the account was most recently updated. |
userGuid - String | The unique identifier for the user associated with the account. Defined by MX. |
userId - String | The unique, partner-defined, identifier for the user associated with this account. |
Example
{
"accountNumber": "xyz789",
"accountOwnership": "abc123",
"annuityPolicyToDate": "xyz789",
"annuityProvider": "xyz789",
"annuityTermYear": 123.45,
"apr": 123.45,
"apy": 987.65,
"availableBalance": 123.45,
"availableCredit": 987.65,
"balance": 987.65,
"cashBalance": 123.45,
"cashSurrenderValue": 987.65,
"createdAt": "xyz789",
"creditLimit": 987.65,
"currencyCode": "abc123",
"dayPaymentIsDue": 987,
"deathBenefit": 987,
"guid": "xyz789",
"holdingsValue": 123.45,
"id": "xyz789",
"importedAt": "abc123",
"institutionCode": "abc123",
"insuredName": "abc123",
"interestRate": 123.45,
"isClosed": false,
"isHidden": true,
"isManual": true,
"lastPayment": 123.45,
"lastPaymentAt": "abc123",
"loanAmount": 987.65,
"marginBalance": 987.65,
"maturesOn": "abc123",
"memberGuid": "abc123",
"memberId": "xyz789",
"memberIsManagedByUser": true,
"metadata": "abc123",
"minimumBalance": 987.65,
"minimumPayment": 123.45,
"name": "xyz789",
"nickname": "abc123",
"originalBalance": 123.45,
"payOutAmount": 987.65,
"paymentDueAt": "abc123",
"payoffBalance": 987.65,
"premiumAmount": 987.65,
"propertyType": "abc123",
"routingNumber": "abc123",
"startedOn": "abc123",
"subtype": "xyz789",
"todayUglAmount": 987.65,
"todayUglPercentage": 123.45,
"totalAccountValue": 987.65,
"type": "abc123",
"updatedAt": "abc123",
"userGuid": "abc123",
"userId": "abc123"
}
RemoteDataMxAccountOwner
Description
Mx Owner data.
Fields
| Field Name | Description |
|---|---|
accountGuid - String | The unique identifier for the account associated with the account owner. Defined by MX. |
address - String | The account owner's street address. |
city - String | The account owner's city. |
country - String | The account owner's country. |
email - String | The account owner's email address. |
firstName - String | The account owner's first name. This may also include a middle name. This field will be null unless name splitting has been enabled. Contact MX to have this feature enabled. |
guid - String | The unique identifier for the account owner. Defined by MX. |
lastName - String | The account owner's last name. This field will be null unless name splitting has been enabled. Contact MX to have this feature enabled. |
memberGuid - String | The unique identifier for the member associated with the account owner. Defined by MX. |
ownerName - String | The account owner's name. |
phone - String | The account owner's phone number. |
postalCode - String | The account owner's postal code. |
state - String | The account owner's state. |
userGuid - String | The unique identifier for the user associated with the account owner. Defined by MX. |
Example
{
"accountGuid": "abc123",
"address": "abc123",
"city": "abc123",
"country": "xyz789",
"email": "abc123",
"firstName": "abc123",
"guid": "abc123",
"lastName": "abc123",
"memberGuid": "xyz789",
"ownerName": "abc123",
"phone": "xyz789",
"postalCode": "xyz789",
"state": "xyz789",
"userGuid": "xyz789"
}
RemoteDataMxEnhanceTransaction
Description
Mx Enrichment data.
Fields
| Field Name | Description |
|---|---|
amount - Float | The monetary amount of the transaction. |
categorizedBy - Int | The method used to determine the category assigned to the transaction |
category - String | The category of the transaction. |
categoryGuid - String | The unique identifier for the category assigned to the transaction. |
describedBy - Int | The method used to describe the transaction |
description - String | A human-readable version of the original_description field described below, e.g., “Sam’s Club,” “Johnny’s Tavern.” This is provided by the MX Platform. |
extendedTransactionType - String | The transaction type assigned by the partner. |
id - String | The unique partner-defined identifier for the transaction. This can only be set for partner-managed transactions. It should be ignored for user-managed transactions, even in occasional cases where it may return with a value. |
isBillPay - Boolean | This indicates whether the transaction represents a bill pay. |
isDirectDeposit - Boolean | This indicates whether the transaction represents a direct deposit. |
isExpense - Boolean | This indicates whether the transaction represents an expense. |
isFee - Boolean | This indicates whether the transaction represents a fee. |
isIncome - Boolean | This indicates whether the transaction represents income. |
isInternational - Boolean | If the transaction is international as defined by the data provider, this field will be true. If the data provider determines it is not international then it will be false. It will be null if the data provider does not have this information. |
isOverdraftFee - Boolean | This indicates whether the transaction represents an overdraft fee. |
isPayrollAdvance - Boolean | This indicates whether the transaction represents a payroll advance. |
isSubscription - Boolean | This indicates whether the transaction represents a payment for a subscription service such as Netflix or Audible. |
memo - String | This field contains additional descriptive information about the transaction. |
merchantCategoryCode - Int | The ISO 18245 category code for the transaction. |
merchantGuid - String | The unique identifier for the merchant associated with this transaction. Defined by MX. |
merchantLocationGuid - String | The unique identifier for the merchant_location associated with this transaction. Defined by MX. |
originalDescription - String | The original description of the transaction as provided by our data feed. See description above for more information. |
type - String | The type of transaction. This will be either CREDIT or DEBIT. |
Example
{
"amount": 987.65,
"categorizedBy": 123,
"category": "xyz789",
"categoryGuid": "xyz789",
"describedBy": 987,
"description": "abc123",
"extendedTransactionType": "xyz789",
"id": "abc123",
"isBillPay": true,
"isDirectDeposit": true,
"isExpense": false,
"isFee": true,
"isIncome": false,
"isInternational": false,
"isOverdraftFee": false,
"isPayrollAdvance": false,
"isSubscription": true,
"memo": "abc123",
"merchantCategoryCode": 123,
"merchantGuid": "abc123",
"merchantLocationGuid": "xyz789",
"originalDescription": "abc123",
"type": "xyz789"
}
RemoteDataMxMember
Description
Mx Connection data.
Fields
| Field Name | Description |
|---|---|
aggregatedAt - String | The date and time the most recent aggregation-type job was started, given in ISO 8601 format with a time component. A job will automatically be started when a member is created or its credentials are updated, unless the skip_aggregation parameter is used. Jobs can also be started via manual aggregations, background aggregations, API endpoints, or when opening an MX widget. A job can be a normal aggregation, or a premium job such as identification, verification, fetching statements, or fetching an extended transaction history. |
backgroundAggregationIsDisabled - Boolean | This indicates whether background aggregation is disabled for the member. |
connectionStatus - String | This indicates the state of a member’s aggregation. See member connection statuses for more information. |
guid - String | The unique identifier for the member. Defined by MX. |
id - String | The partner-defined unique identifier for the member. |
institutionCode - String | The unique identifier for the institution associated with the member. Defined by MX. |
isBeingAggregated - Boolean | This indicates whether the member was being aggregated at the time of the request. |
isManagedByUser - Boolean | This indicates whether the member is managed by the user or the MX partner. Members created with the managed member feature will have this field set to false. |
isOauth - Boolean | This indicates whether the member uses OAuth to authenticate. Defaults to false. |
metadata - String | Additional information you can store on this member. |
name - String | The name of the member. |
oauthWindowUri - String | |
successfullyAggregatedAt - String | The date and time the member was last successfully aggregated. |
userGuid - String | The unique identifier for the user associated with the member. Defined by MX. |
userId - String | The unique partner-defined identifier for the user associated with the member. |
Example
{
"aggregatedAt": "xyz789",
"backgroundAggregationIsDisabled": true,
"connectionStatus": "xyz789",
"guid": "abc123",
"id": "abc123",
"institutionCode": "abc123",
"isBeingAggregated": true,
"isManagedByUser": false,
"isOauth": false,
"metadata": "abc123",
"name": "abc123",
"oauthWindowUri": "xyz789",
"successfullyAggregatedAt": "xyz789",
"userGuid": "xyz789",
"userId": "xyz789"
}
RemoteDataMxTransaction
Description
Mx Transaction data.
Fields
| Field Name | Description |
|---|---|
accountGuid - String | The unique identifier for the account associated with the transaction. Defined by MX. |
accountId - String | The unique partner-defined identifier for the account associated with the transaction. This can only be set for partner-managed accounts. It should be ignored for user-managed transactions, even in occasional cases where it may return with a value. |
amount - Float | The monetary amount of the transaction. |
category - String | The category of the transaction. |
categoryGuid - String | The unique identifier for the category assigned to the transaction. |
checkNumberString - String | The check number for the transaction. |
createdAt - String | The date and time the transaction was created. |
currencyCode - String | The three-character ISO 4217 currency code, e.g. USD. |
date - String | The date on which the transaction took place. This is the field used when searching for transactions by date. This field is generally the same as transacted_at, but uses posted_at as a fallback. |
description - String | A human-readable version of the original_description field described below, e.g., “Sam’s Club,” “Johnny’s Tavern.” This is provided by the MX Platform. |
extendedTransactionType - String | The transaction type assigned by the partner. |
guid - String | The unique identifier for the transaction. Defined by MX. |
id - String | The unique partner-defined identifier for the transaction. This can only be set for partner-managed transactions. It should be ignored for user-managed transactions, even in occasional cases where it may return with a value. |
isBillPay - Boolean | This indicates whether the transaction represents a bill pay. |
isDirectDeposit - Boolean | This indicates whether the transaction represents a direct deposit. |
isExpense - Boolean | This indicates whether the transaction represents an expense. |
isFee - Boolean | This indicates whether the transaction represents a fee. |
isIncome - Boolean | This indicates whether the transaction represents income. |
isInternational - Boolean | If the transaction is international as defined by the data provider, this field will be true. If the data provider determines it is not international then it will be false. It will be null if the data provider does not have this information. |
isOverdraftFee - Boolean | This indicates whether the transaction represents an overdraft fee. |
isPayrollAdvance - Boolean | This indicates whether the transaction represents a payroll advance. |
isRecurring - Boolean | This indicates whether a transaction is a recurring credit or debit. |
isSubscription - Boolean | This indicates whether the transaction represents a payment for a subscription service such as Netflix or Audible. |
latitude - Float | The latitude of the location where the transaction occurred. The number is a signed decimal (e.g. Rio de Janeiro’s latitude is -22.9027800 and Tokyo’s latitude is 35.689488). |
localizedDescription - String | A human-readable description of the transaction, provided in a local language. |
localizedMemo - String | Additional descriptive information about the transaction, provided in a local language. |
longitude - Float | The longitude of the location where the transaction occurred. The number is a signed decimal (e.g. Rio de Janeiro’s longitude is -43.2075000 and Tokyo’s longitude is 139.691706). |
memberGuid - String | The unique identifier for the member associated with the transaction Defined by MX. |
memberIsManagedByUser - Boolean | This indicates whether the associated member is managed by the user or the MX partner. Members created with the managed member feature will have this field set to false. |
memo - String | This field contains additional descriptive information about the transaction. |
merchantCategoryCode - Int | The ISO 18245 category code for the transaction. |
merchantGuid - String | The unique identifier for the merchant associated with this transaction. Defined by MX. |
merchantLocationGuid - String | The unique identifier for the merchant_location associated with this transaction. Defined by MX. |
metadata - String | Custom data |
originalDescription - String | The original description of the transaction as provided by our data feed. See description above for more information. |
postedAt - String | The date and time the transaction was posted to the account. |
status - String | The status of the transaction. This will be either POSTED or PENDING. |
topLevelCategory - String | The parent category assigned to this transaction’s category. |
transactedAt - String | The date and time the transaction took place. |
type - String | The type of transaction. This will be either CREDIT or DEBIT. |
updatedAt - String | The date and time the transaction was last updated. |
userGuid - String | The unique identifier for the user associated with this transaction. Defined by MX. |
userId - String | The unique partner-defined identifier for the user associated with the transaction. |
Example
{
"accountGuid": "abc123",
"accountId": "xyz789",
"amount": 987.65,
"category": "abc123",
"categoryGuid": "abc123",
"checkNumberString": "abc123",
"createdAt": "abc123",
"currencyCode": "xyz789",
"date": "abc123",
"description": "abc123",
"extendedTransactionType": "xyz789",
"guid": "abc123",
"id": "xyz789",
"isBillPay": false,
"isDirectDeposit": true,
"isExpense": true,
"isFee": false,
"isIncome": true,
"isInternational": false,
"isOverdraftFee": true,
"isPayrollAdvance": false,
"isRecurring": false,
"isSubscription": false,
"latitude": 987.65,
"localizedDescription": "abc123",
"localizedMemo": "xyz789",
"longitude": 123.45,
"memberGuid": "xyz789",
"memberIsManagedByUser": true,
"memo": "abc123",
"merchantCategoryCode": 987,
"merchantGuid": "xyz789",
"merchantLocationGuid": "abc123",
"metadata": "xyz789",
"originalDescription": "abc123",
"postedAt": "abc123",
"status": "xyz789",
"topLevelCategory": "xyz789",
"transactedAt": "xyz789",
"type": "xyz789",
"updatedAt": "abc123",
"userGuid": "abc123",
"userId": "xyz789"
}
RemoteDataNtropyEnrichedTransaction
Description
Ntropy Enrichment data.
Fields
| Field Name | Description |
|---|---|
labels - [String!] | Labels |
location - String | Location |
locationStructured - RemoteDataNtropyLocationStructuredPublic | LocationStructuredPublic |
logo - String | Logo |
mcc - [Int!] | Mcc |
merchant - String | Merchant |
merchantId - String | Merchant Id |
person - String | Person |
recurrence - String | An enumeration. |
recurrenceGroup - RemoteDataNtropyRecurrenceGroup | RecurrenceGroup |
recurrenceGroupId - String | Recurrence Group Id |
transactionId - String | Transaction Id |
transactionType - String | An enumeration. |
website - String | Website |
Example
{
"labels": ["abc123"],
"location": "abc123",
"locationStructured": RemoteDataNtropyLocationStructuredPublic,
"logo": "abc123",
"mcc": [123],
"merchant": "xyz789",
"merchantId": "xyz789",
"person": "abc123",
"recurrence": "abc123",
"recurrenceGroup": RemoteDataNtropyRecurrenceGroup,
"recurrenceGroupId": "abc123",
"transactionId": "abc123",
"transactionType": "xyz789",
"website": "xyz789"
}
RemoteDataNtropyLocationStructuredPublic
Description
RemoteData Ntropy LocationStructuredPublic
Fields
| Field Name | Description |
|---|---|
address - String | Address |
appleMapsUrl - String | Apple Maps Url |
city - String | City |
country - String | Country |
googleMapsUrl - String | Google Maps Url |
latitude - Float | Latitude |
longitude - Float | Longitude |
postcode - String | Postcode |
state - String | State |
storeNumber - String | Store Number |
Example
{
"address": "abc123",
"appleMapsUrl": "xyz789",
"city": "xyz789",
"country": "xyz789",
"googleMapsUrl": "abc123",
"latitude": 987.65,
"longitude": 123.45,
"postcode": "abc123",
"state": "xyz789",
"storeNumber": "abc123"
}
RemoteDataNtropyRecurrenceGroup
Description
RemoteData Ntropy RecurrenceGroup
Example
{
"averageAmount": 123.45,
"firstPaymentDate": "2007-12-03",
"id": "xyz789",
"latestPaymentDate": "2007-12-03",
"periodicity": "abc123",
"periodicityInDays": 987.65,
"totalAmount": 987.65
}
RemoteDataPlaidAPR
Description
Information about the APR on the account.
Fields
| Field Name | Description |
|---|---|
aprPercentage - Float | Annual Percentage Rate applied. |
aprType - String | The type of balance to which the APR applies. |
balanceSubjectToApr - Float | Amount of money that is subjected to the APR if a balance was carried beyond payment due date. How it is calculated can vary by card issuer. It is often calculated as an average daily balance. |
interestChargeAmount - Float | Amount of money charged due to interest from last statement. |
Example
{
"aprPercentage": 123.45,
"aprType": "abc123",
"balanceSubjectToApr": 123.45,
"interestChargeAmount": 123.45
}
RemoteDataPlaidAccount
Description
Plaid Account data.
A single account at a financial institution.
Fields
| Field Name | Description |
|---|---|
accountId - String | Plaid’s unique identifier for the account. This value will not change unless Plaid can't reconcile the account with the data returned by the financial institution. This may occur, for example, when the name of the account changes. If this happens a new The If an account with a specific Like all Plaid identifiers, the |
balances - RemoteDataPlaidAccountBalance | A set of fields describing the balance for an account. Balance information may be cached unless the balance object was returned by /accounts/balance/get. |
holderCategory - String | Indicates the account's categorization as either a personal or a business account. This field is currently in beta; to request access, contact your account manager. |
mask - String | The last 2-4 alphanumeric characters of either the account’s displayed mask or the account’s official account number. Note that the mask may be non-unique between an Item’s accounts. |
name - String | The name of the account, either assigned by the user or by the financial institution itself |
officialName - String | The official name of the account as given by the financial institution |
persistentAccountId - String | A unique and persistent identifier for accounts that can be used to trace multiple instances of the same account across different Items for depository accounts. This field is currently supported only for Items at institutions that use Tokenized Account Numbers (i.e., Chase and PNC, and in May 2025 US Bank). Because these accounts have a different account number each time they are linked, this field may be used instead of the account number to uniquely identify an account across multiple Items for payments use cases, helping to reduce duplicate Items or attempted fraud. In Sandbox, this field is populated for TAN-based institutions (ins_56, ins_13) as well as the OAuth Sandbox institution (ins_127287); in Production, it will only be populated for accounts at applicable institutions. |
subtype - String | See the Account type schema for a full listing of account types and corresponding subtypes. |
type - String |
See the Account type schema for a full listing of account types and corresponding subtypes. |
verificationInsights - RemoteDataPlaidVerificationInsights | Insights from performing database verification for the account. Only returned for Auth Items using Database Auth. |
verificationName - String | The account holder name that was used for micro-deposit and/or database verification. Only returned for Auth Items created via micro-deposit or database verification. This name was manually-entered by the user during Link, unless it was otherwise provided via the user.legal_name request field in /link/token/create for the Link session that created the Item. |
verificationStatus - String | The current verification status of an Auth Item initiated through micro-deposits or database verification. Returned for Auth Items only.
|
Example
{
"accountId": "abc123",
"balances": RemoteDataPlaidAccountBalance,
"holderCategory": "xyz789",
"mask": "xyz789",
"name": "abc123",
"officialName": "abc123",
"persistentAccountId": "xyz789",
"subtype": "xyz789",
"type": "xyz789",
"verificationInsights": RemoteDataPlaidVerificationInsights,
"verificationName": "xyz789",
"verificationStatus": "xyz789"
}
RemoteDataPlaidAccountBalance
Description
A set of fields describing the balance for an account. Balance information may be cached unless the balance object was returned by /accounts/balance/get.
Fields
| Field Name | Description |
|---|---|
available - Float | The amount of funds available to be withdrawn from the account, as determined by the financial institution. For For For Note that not all institutions calculate the Available balance may be cached and is not guaranteed to be up-to-date in realtime unless the value was returned by If |
current - Float | The total amount of funds in or owed by the account. For For For Note that balance information may be cached unless the value was returned by When returned by |
isoCurrencyCode - String | The ISO-4217 currency code of the balance. Always null if unofficial_currency_code is non-null. |
lastUpdatedDatetime - DateTime | Timestamp in ISO 8601 format ( This field is returned only when the institution is |
limit - Float | For For In North America, this field is typically only available for |
unofficialCurrencyCode - String | The unofficial currency code associated with the balance. Always null if See the currency code schema for a full listing of supported |
Example
{
"available": 123.45,
"current": 987.65,
"isoCurrencyCode": "xyz789",
"lastUpdatedDatetime": "2007-12-03T10:15:30Z",
"limit": 123.45,
"unofficialCurrencyCode": "xyz789"
}
RemoteDataPlaidAddress
Description
A physical mailing address.
Fields
| Field Name | Description |
|---|---|
data - RemoteDataPlaidAddressData | Data about the components comprising an address. |
primary - Boolean | When true, identifies the address as the primary address on an account. |
Example
{"data": RemoteDataPlaidAddressData, "primary": false}
RemoteDataPlaidAddressData
Description
Data about the components comprising an address.
Fields
| Field Name | Description |
|---|---|
city - String | The full city name |
country - String | The ISO 3166-1 alpha-2 country code |
postalCode - String | The postal code. In API versions 2018-05-22 and earlier, this field is called zip. |
region - String | The region or state. In API versions 2018-05-22 and earlier, this field is called state. Example: "NC" |
street - String | The full street address Example: "564 Main Street, APT 15" |
Example
{
"city": "abc123",
"country": "abc123",
"postalCode": "xyz789",
"region": "xyz789",
"street": "abc123"
}
RemoteDataPlaidCounterparty
Description
The counterparty, such as the merchant or financial institution, is extracted by Plaid from the raw description.
Fields
| Field Name | Description |
|---|---|
confidenceLevel - String | A description of how confident we are that the provided counterparty is involved in the transaction.
|
entityId - String | A unique, stable, Plaid-generated ID that maps to the counterparty. |
logoUrl - String | The URL of a logo associated with the counterparty, if available. The logo will always be 100×100 pixel PNG file. |
name - String | The name of the counterparty, such as the merchant or the financial institution, as extracted by Plaid from the raw description. |
type - String | The counterparty type.
|
website - String | The website associated with the counterparty. |
Example
{
"confidenceLevel": "xyz789",
"entityId": "xyz789",
"logoUrl": "xyz789",
"name": "abc123",
"type": "abc123",
"website": "xyz789"
}
RemoteDataPlaidCreditCardLiability
Description
An object representing a credit card account.
Fields
| Field Name | Description |
|---|---|
accountId - String | The ID of the account that this liability belongs to. |
aprs - [RemoteDataPlaidAPR!] | The various interest rates that apply to the account. APR information is not provided by all card issuers; if APR data is not available, this array will be empty. |
isOverdue - Boolean | true if a payment is currently overdue. Availability for this field is limited. |
lastPaymentAmount - Float | The amount of the last payment. |
lastPaymentDate - Date | The date of the last payment. Dates are returned in an ISO 8601 format (YYYY-MM-DD). Availability for this field is limited. |
lastStatementBalance - Float | The total amount owed as of the last statement issued |
lastStatementIssueDate - Date | The date of the last statement. Dates are returned in an ISO 8601 format (YYYY-MM-DD). |
minimumPaymentAmount - Float | The minimum payment due for the next billing cycle. |
nextPaymentDueDate - Date | The due date for the next payment. The due date is null if a payment is not expected. Dates are returned in an ISO 8601 format (YYYY-MM-DD). |
Example
{
"accountId": "abc123",
"aprs": [RemoteDataPlaidAPR],
"isOverdue": false,
"lastPaymentAmount": 123.45,
"lastPaymentDate": "2007-12-03",
"lastStatementBalance": 987.65,
"lastStatementIssueDate": "2007-12-03",
"minimumPaymentAmount": 123.45,
"nextPaymentDueDate": "2007-12-03"
}
RemoteDataPlaidEmail
Description
An object representing an email address
Example
{
"data": "abc123",
"primary": true,
"type": "xyz789"
}
RemoteDataPlaidError
Description
Errors are identified by error_code and categorized by error_type. Use these in preference to HTTP status codes to identify and handle specific errors. HTTP status codes are set and provide the broadest categorization of errors: 4xx codes are for developer- or user-related errors, and 5xx codes are for Plaid-related errors, and the status will be 2xx in non-error cases. An Item with a non-null error object will only be part of an API response when calling /item/get to view Item status. Otherwise, error fields will be null if no error has occurred; if an error has occurred, an error code will be returned instead.
Fields
| Field Name | Description |
|---|---|
causes - [String!] | In this product, a request can pertain to more than one Item. If an error is returned for such a request,
|
displayMessage - String | A user-friendly representation of the error code. This may change over time and is not safe for programmatic use. |
documentationUrl - String | The URL of a Plaid documentation page with more information about the error |
errorCode - String | The particular error code. Safe for programmatic use. |
errorCodeReason - String | The specific reason for the error code. Currently, reasons are only supported OAuth-based item errors; Possible values:
|
errorMessage - String | A developer-friendly representation of the error code. This may change over time and is not safe for programmatic use. |
errorType - String | A broad categorization of the error. Safe for programmatic use. |
requestId - String | A unique ID identifying the request, to be used for troubleshooting purposes. This field will be omitted in errors provided by webhooks. |
status - Int | The HTTP status code associated with the error. This will only be returned in the response body when the error information is provided via a webhook. |
suggestedAction - String | Suggested steps for resolving the error |
Example
{
"causes": ["xyz789"],
"displayMessage": "abc123",
"documentationUrl": "abc123",
"errorCode": "xyz789",
"errorCodeReason": "xyz789",
"errorMessage": "abc123",
"errorType": "abc123",
"requestId": "xyz789",
"status": 987,
"suggestedAction": "xyz789"
}
RemoteDataPlaidFixedIncome
Description
Details about the fixed income security.
Fields
| Field Name | Description |
|---|---|
faceValue - Float | The face value that is paid upon maturity of the fixed income security, per unit of security. |
issueDate - Date | The issue date for this fixed income security, in ISO 8601 format. |
maturityDate - Date | The maturity date for this fixed income security, in ISO 8601 format. |
yieldRate - RemoteDataPlaidYieldRate | Details about a fixed income security's expected rate of return. |
Example
{
"faceValue": 987.65,
"issueDate": "2007-12-03",
"maturityDate": "2007-12-03",
"yieldRate": RemoteDataPlaidYieldRate
}
RemoteDataPlaidHolding
Description
Plaid Holding data.
A securities holding at an institution.
Fields
| Field Name | Description |
|---|---|
accountId - String | The Plaid account_id associated with the holding. |
costBasis - Float | The total cost basis of the holding (e.g., the total amount spent to acquire all assets currently in the holding). |
institutionPrice - Float | The last price given by the institution for this security. |
institutionPriceAsOf - Date | The date at which institution_price was current. |
institutionPriceDatetime - DateTime | Date and time at which This field is returned for select financial institutions and comes as provided by the institution. It may contain default time values (such as 00:00:00). |
institutionValue - Float | The value of the holding, as reported by the institution. |
isoCurrencyCode - String | The ISO-4217 currency code of the holding. Always null if unofficial_currency_code is non-null. |
quantity - Float | The total quantity of the asset held, as reported by the financial institution. If the security is an option, quantity will reflect the total number of options (typically the number of contracts multiplied by 100), not the number of contracts. |
securityId - String | The Plaid security_id associated with the holding. Security data is not specific to a user's account; any user who held the same security at the same financial institution at the same time would have identical security data. The security_id for the same security will typically be the same across different institutions, but this is not guaranteed. The security_id does not typically change, but may change if inherent details of the security change due to a corporate action, for example, in the event of a ticker symbol change or CUSIP change. |
unofficialCurrencyCode - String | The unofficial currency code associated with the holding. Always See the currency code schema for a full listing of supported |
vestedQuantity - Float | The total quantity of vested assets held, as reported by the financial institution. Vested assets are only associated with equities. |
vestedValue - Float | The value of the vested holdings as reported by the institution. |
Example
{
"accountId": "xyz789",
"costBasis": 987.65,
"institutionPrice": 987.65,
"institutionPriceAsOf": "2007-12-03",
"institutionPriceDatetime": "2007-12-03T10:15:30Z",
"institutionValue": 123.45,
"isoCurrencyCode": "abc123",
"quantity": 987.65,
"securityId": "xyz789",
"unofficialCurrencyCode": "xyz789",
"vestedQuantity": 987.65,
"vestedValue": 123.45
}
RemoteDataPlaidInvestmentTransaction
Description
Plaid Investment Transaction data.
A transaction within an investment account.
Fields
| Field Name | Description |
|---|---|
accountId - String | The account_id of the account against which this transaction posted. |
amount - Float | The complete value of the transaction. Positive values when cash is debited, e.g. purchases of stock; negative values when cash is credited, e.g. sales of stock. Treatment remains the same for cash-only movements unassociated with securities. |
date - Date | The ISO 8601 posting date for the transaction. |
fees - Float | The combined value of all fees applied to this transaction |
investmentTransactionId - String | The ID of the Investment transaction, unique across all Plaid transactions. Like all Plaid identifiers, the investment_transaction_id is case sensitive. |
isoCurrencyCode - String | The ISO-4217 currency code of the transaction. Always null if unofficial_currency_code is non-null. |
name - String | The institution’s description of the transaction. |
price - Float | The price of the security at which this transaction occurred. |
quantity - Float | The number of units of the security involved in this transaction. Positive for buy transactions; negative for sell transactions. |
securityId - String | The security_id to which this transaction is related. |
subtype - String | For descriptions of possible transaction types and subtypes, see the Investment transaction types schema. |
type - String | Value is one of the following: For descriptions of possible transaction types and subtypes, see the Investment transaction types schema. |
unofficialCurrencyCode - String | The unofficial currency code associated with the holding. Always See the currency code schema for a full listing of supported |
Example
{
"accountId": "abc123",
"amount": 987.65,
"date": "2007-12-03",
"fees": 123.45,
"investmentTransactionId": "xyz789",
"isoCurrencyCode": "abc123",
"name": "xyz789",
"price": 123.45,
"quantity": 123.45,
"securityId": "xyz789",
"subtype": "xyz789",
"type": "xyz789",
"unofficialCurrencyCode": "xyz789"
}
RemoteDataPlaidItem
Description
Plaid Connection data.
Metadata about the Item.
Fields
| Field Name | Description |
|---|---|
authMethod - String | The method used to populate Auth data for the Item. This field is only populated for Items that have had Auth numbers data set on at least one of its accounts, and will be
|
availableProducts - [String!] | A list of products available for the Item that have not yet been accessed. The contents of this array will be mutually exclusive with billed_products. |
billedProducts - [String!] | A list of products that have been billed for the Item. The contents of this array will be mutually exclusive with available_products. Note - billed_products is populated in all environments but only requests in Production are billed. Also note that products that are billed on a pay-per-call basis rather than a pay-per-Item basis, such as balance, will not appear here. |
consentExpirationTime - DateTime | The date and time at which the Item's access consent will expire, in ISO 8601 format. If the Item does not have consent expiration scheduled, this field will be null. Currently, only institutions in Europe and a small number of institutions in the US have expiring consent. Closer to the 1033 compliance deadline of April 1, 2026, expiration times will be populated more widely. For more details, see Data Transparency Messaging consent expiration. |
consentedProducts - [String!] | A list of products that the user has consented to for the Item via Data Transparency Messaging. This will consist of all products where both of the following are true: the user has consented to the required data scopes for that product and you have Production access for that product. |
error - RemoteDataPlaidError | Errors are identified by error_code and categorized by error_type. Use these in preference to HTTP status codes to identify and handle specific errors. HTTP status codes are set and provide the broadest categorization of errors: 4xx codes are for developer- or user-related errors, and 5xx codes are for Plaid-related errors, and the status will be 2xx in non-error cases. An Item with a non-null error object will only be part of an API response when calling /item/get to view Item status. Otherwise, error fields will be null if no error has occurred; if an error has occurred, an error code will be returned instead. |
institutionId - String | The Plaid Institution ID associated with the Item. Field is null for Items created without an institution connection, such as Items created via Same Day Micro-deposits. |
institutionName - String | The name of the institution associated with the Item. Field is null for Items created without an institution connection, such as Items created via Same Day Micro-deposits. |
itemId - String | The Plaid Item ID. The item_id is always unique; linking the same account at the same institution twice will result in two Items with different item_id values. Like all Plaid identifiers, the item_id is case-sensitive. |
products - [String!] | A list of products added to the Item. In almost all cases, this will be the same as the billed_products field. For some products, it is possible for the product to be added to an Item but not yet billed (e.g. Assets, before /asset_report/create has been called, or Auth or Identity when added as Optional Products but before their endpoints have been called), in which case the product may appear in products but not in billed_products. |
updateType - String | Indicates whether an Item requires user interaction to be updated, which can be the case for Items with some forms of two-factor authentication.
|
webhook - String | The URL registered to receive webhooks for the Item. |
Example
{
"authMethod": "xyz789",
"availableProducts": ["abc123"],
"billedProducts": ["abc123"],
"consentExpirationTime": "2007-12-03T10:15:30Z",
"consentedProducts": ["xyz789"],
"error": RemoteDataPlaidError,
"institutionId": "abc123",
"institutionName": "xyz789",
"itemId": "xyz789",
"products": ["xyz789"],
"updateType": "abc123",
"webhook": "xyz789"
}
RemoteDataPlaidLiabilitiesObject
Description
Plaid Liabilities data.
An object containing liability accounts
Fields
| Field Name | Description |
|---|---|
credit - [RemoteDataPlaidCreditCardLiability!] | The credit accounts returned. |
mortgage - [RemoteDataPlaidMortgageLiability!] | The mortgage accounts returned. |
student - [RemoteDataPlaidStudentLoan!] | The student loan accounts returned. |
Example
{
"credit": [RemoteDataPlaidCreditCardLiability],
"mortgage": [RemoteDataPlaidMortgageLiability],
"student": [RemoteDataPlaidStudentLoan]
}
RemoteDataPlaidMortgageInterestRate
Description
Object containing metadata about the interest rate for the mortgage.
Example
{"percentage": 987.65, "type": "abc123"}
RemoteDataPlaidMortgageLiability
Description
Contains details about a mortgage account.
Fields
| Field Name | Description |
|---|---|
accountId - String | The ID of the account that this liability belongs to. |
accountNumber - String | The account number of the loan. |
currentLateFee - Float | The current outstanding amount charged for late payment. |
escrowBalance - Float | Total amount held in escrow to pay taxes and insurance on behalf of the borrower. |
hasPmi - Boolean | Indicates whether the borrower has private mortgage insurance in effect. |
hasPrepaymentPenalty - Boolean | Indicates whether the borrower will pay a penalty for early payoff of mortgage. |
interestRate - RemoteDataPlaidMortgageInterestRate | Object containing metadata about the interest rate for the mortgage. |
lastPaymentAmount - Float | The amount of the last payment. |
lastPaymentDate - Date | The date of the last payment. Dates are returned in an ISO 8601 format (YYYY-MM-DD). |
loanTerm - String | Full duration of mortgage as at origination (e.g. 10 year). |
loanTypeDescription - String | Description of the type of loan, for example conventional, fixed, or variable. This field is provided directly from the loan servicer and does not have an enumerated set of possible values. |
maturityDate - Date | Original date on which mortgage is due in full. Dates are returned in an ISO 8601 format (YYYY-MM-DD). |
nextMonthlyPayment - Float | The amount of the next payment. |
nextPaymentDueDate - Date | The due date for the next payment. Dates are returned in an ISO 8601 format (YYYY-MM-DD). |
originationDate - Date | The date on which the loan was initially lent. Dates are returned in an ISO 8601 format (YYYY-MM-DD). |
originationPrincipalAmount - Float | The original principal balance of the mortgage. |
pastDueAmount - Float | Amount of loan (principal + interest) past due for payment. |
propertyAddress - RemoteDataPlaidMortgagePropertyAddress | Object containing fields describing property address. |
ytdInterestPaid - Float | The year to date (YTD) interest paid. |
ytdPrincipalPaid - Float | The YTD principal paid. |
Example
{
"accountId": "abc123",
"accountNumber": "xyz789",
"currentLateFee": 123.45,
"escrowBalance": 987.65,
"hasPmi": true,
"hasPrepaymentPenalty": true,
"interestRate": RemoteDataPlaidMortgageInterestRate,
"lastPaymentAmount": 987.65,
"lastPaymentDate": "2007-12-03",
"loanTerm": "abc123",
"loanTypeDescription": "abc123",
"maturityDate": "2007-12-03",
"nextMonthlyPayment": 123.45,
"nextPaymentDueDate": "2007-12-03",
"originationDate": "2007-12-03",
"originationPrincipalAmount": 123.45,
"pastDueAmount": 987.65,
"propertyAddress": RemoteDataPlaidMortgagePropertyAddress,
"ytdInterestPaid": 123.45,
"ytdPrincipalPaid": 123.45
}
RemoteDataPlaidMortgagePropertyAddress
Description
Object containing fields describing property address.
Example
{
"city": "abc123",
"country": "xyz789",
"postalCode": "abc123",
"region": "abc123",
"street": "xyz789"
}
RemoteDataPlaidOptionContract
Description
Details about the option security.
For the Sandbox environment, this data is currently only available if the Item is using a custom Sandbox user and the ticker field of the custom security follows the OCC Option Symbol standard with no spaces. For an example of simulating this in Sandbox, see the custom Sandbox GitHub.
Fields
| Field Name | Description |
|---|---|
contractType - String | The type of this option contract. It is one of:
|
expirationDate - Date | The expiration date for this option contract, in ISO 8601 format. |
strikePrice - Float | The strike price for this option contract, per share of security. |
underlyingSecurityTicker - String | The ticker of the underlying security for this option contract. |
Example
{
"contractType": "xyz789",
"expirationDate": "2007-12-03",
"strikePrice": 987.65,
"underlyingSecurityTicker": "xyz789"
}
RemoteDataPlaidOwner
Description
Plaid Owner data.
Data returned from the financial institution about the owner or owners of an account. Only the names array must be non-empty.
Fields
| Field Name | Description |
|---|---|
addresses - [RemoteDataPlaidAddress!] | Data about the various addresses associated with the account by the financial institution. May be an empty array if no relevant information is returned from the financial institution. |
emails - [RemoteDataPlaidEmail!] | A list of email addresses associated with the account by the financial institution. May be an empty array if no relevant information is returned from the financial institution. |
names - [String!] | A list of names associated with the account by the financial institution. In the case of a joint account, Plaid will make a best effort to report the names of all account holders. If an Item contains multiple accounts with different owner names, some institutions will report all names associated with the Item in each account's |
phoneNumbers - [RemoteDataPlaidPhoneNumber!] | A list of phone numbers associated with the account by the financial institution. May be an empty array if no relevant information is returned from the financial institution. |
Example
{
"addresses": [RemoteDataPlaidAddress],
"emails": [RemoteDataPlaidEmail],
"names": ["abc123"],
"phoneNumbers": [RemoteDataPlaidPhoneNumber]
}
RemoteDataPlaidPSLFStatus
Description
Information about the student's eligibility in the Public Service Loan Forgiveness program. This is only returned if the institution is FedLoan (ins_116527). Since FedLoan no longer services student loans, this field is no longer returned.
Fields
| Field Name | Description |
|---|---|
estimatedEligibilityDate - Date | The estimated date borrower will have completed 120 qualifying monthly payments. Returned in ISO 8601 format (YYYY-MM-DD). |
paymentsMade - Int | The number of qualifying payments that have been made. |
paymentsRemaining - Int | The number of qualifying payments remaining. |
Example
{
"estimatedEligibilityDate": "2007-12-03",
"paymentsMade": 987,
"paymentsRemaining": 123
}
RemoteDataPlaidPaymentMeta
Description
Transaction information specific to inter-bank transfers. If the transaction was not an inter-bank transfer, all fields will be null.
If the transactions object was returned by a Transactions endpoint such as /transactions/sync or /transactions/get, the payment_meta key will always appear, but no data elements are guaranteed. If the transactions object was returned by an Assets endpoint such as /asset_report/get/ or /asset_report/pdf/get, this field will only appear in an Asset Report with Insights.
Fields
| Field Name | Description |
|---|---|
byOrderOf - String | The party initiating a wire transfer. Will be null if the transaction is not a wire transfer. |
payee - String | For transfers, the party that is receiving the transaction. |
payer - String | For transfers, the party that is paying the transaction. |
paymentMethod - String | The type of transfer, e.g. 'ACH' |
paymentProcessor - String | The name of the payment processor |
ppdId - String | The ACH PPD ID for the payer. |
reason - String | The payer-supplied description of the transfer. |
referenceNumber - String | The transaction reference number supplied by the financial institution. |
Example
{
"byOrderOf": "xyz789",
"payee": "xyz789",
"payer": "abc123",
"paymentMethod": "abc123",
"paymentProcessor": "abc123",
"ppdId": "xyz789",
"reason": "abc123",
"referenceNumber": "abc123"
}
RemoteDataPlaidPersonalFinanceCategory
Description
Information describing the intent of the transaction. Most relevant for personal finance use cases, but not limited to such use cases.
See the taxonomy CSV file for a full list of personal finance categories. If you are migrating to personal finance categories from the legacy categories, also refer to the migration guide.
Fields
| Field Name | Description |
|---|---|
confidenceLevel - String | A description of how confident we are that the provided categories accurately describe the transaction intent.
|
detailed - String | A granular category conveying the transaction's intent. This field can also be used as a unique identifier for the category. |
primary - String | A high level category that communicates the broad category of the transaction. |
Example
{
"confidenceLevel": "xyz789",
"detailed": "xyz789",
"primary": "xyz789"
}
RemoteDataPlaidPhoneNumber
RemoteDataPlaidSecurity
Description
Plaid Security data.
Contains details about a security
Fields
| Field Name | Description |
|---|---|
closePrice - Float | Price of the security at the close of the previous trading session. Null for non-public securities. If the security is a foreign currency this field will be updated daily and will be priced in USD. If the security is a cryptocurrency, this field will be updated multiple times a day. As crypto prices can fluctuate quickly and data may become stale sooner than other asset classes, refer to |
closePriceAsOf - Date | Date for which close_price is accurate. Always null if close_price is null. |
cusip - String | 9-character CUSIP, an identifier assigned to North American securities. A verified CUSIP Global Services license is required to receive this data. This field will be null by default for new customers, and null for existing customers starting March 12, 2024. If you would like access to this field, please start the verification process here. |
fixedIncome - RemoteDataPlaidFixedIncome | Details about the fixed income security. |
industry - String | The industry classification of the security, such as Biotechnology, Airlines, etc. For a complete list of possible values, please refer to the "Sectors and Industries" spreadsheet. |
institutionId - String | If institution_security_id is present, this field indicates the Plaid institution_id of the institution to whom the identifier belongs. |
institutionSecurityId - String | An identifier given to the security by the institution |
isCashEquivalent - Boolean | Indicates that a security is a highly liquid asset and can be treated like cash. |
isin - String | 12-character ISIN, a globally unique securities identifier. A verified CUSIP Global Services license is required to receive this data. This field will be null by default for new customers, and null for existing customers starting March 12, 2024. If you would like access to this field, please start the verification process here. |
isoCurrencyCode - String | The ISO-4217 currency code of the price given. Always null if unofficial_currency_code is non-null. |
marketIdentifierCode - String | The ISO-10383 Market Identifier Code of the exchange or market in which the security is being traded. |
name - String | A descriptive name for the security, suitable for display. |
optionContract - RemoteDataPlaidOptionContract | Details about the option security. For the Sandbox environment, this data is currently only available if the Item is using a custom Sandbox user and the |
proxySecurityId - String | In certain cases, Plaid will provide the ID of another security whose performance resembles this security, typically when the original security has low volume, or when a private security can be modeled with a publicly traded security. |
sector - String | The sector classification of the security, such as Finance, Health Technology, etc. For a complete list of possible values, please refer to the "Sectors and Industries" spreadsheet. |
securityId - String | A unique, Plaid-specific identifier for the security, used to associate securities with holdings. Like all Plaid identifiers, the security_id is case sensitive. The security_id may change if inherent details of the security change due to a corporate action, for example, in the event of a ticker symbol change or CUSIP change. |
sedol - String | 7-character SEDOL, an identifier assigned to securities in the UK. |
tickerSymbol - String | The security’s trading symbol for publicly traded securities, and otherwise a short identifier if available. |
type - String | The security type of the holding. In rare instances, a null value is returned when institutional data is insufficient to determine the security type. Valid security types are:
|
unofficialCurrencyCode - String | The unofficial currency code associated with the security. Always See the currency code schema for a full listing of supported |
updateDatetime - DateTime | Date and time at which close_price is accurate, in ISO 8601 format (YYYY-MM-DDTHH:mm:ssZ). Always null if close_price is null. |
Example
{
"closePrice": 987.65,
"closePriceAsOf": "2007-12-03",
"cusip": "xyz789",
"fixedIncome": RemoteDataPlaidFixedIncome,
"industry": "xyz789",
"institutionId": "xyz789",
"institutionSecurityId": "abc123",
"isCashEquivalent": false,
"isin": "abc123",
"isoCurrencyCode": "abc123",
"marketIdentifierCode": "xyz789",
"name": "abc123",
"optionContract": RemoteDataPlaidOptionContract,
"proxySecurityId": "abc123",
"sector": "abc123",
"securityId": "xyz789",
"sedol": "xyz789",
"tickerSymbol": "abc123",
"type": "xyz789",
"unofficialCurrencyCode": "abc123",
"updateDatetime": "2007-12-03T10:15:30Z"
}
RemoteDataPlaidServicerAddressData
Description
The address of the student loan servicer. This is generally the remittance address to which payments should be sent.
Example
{
"city": "xyz789",
"country": "xyz789",
"postalCode": "abc123",
"region": "xyz789",
"street": "xyz789"
}
RemoteDataPlaidStudentLoan
Description
Contains details about a student loan account
Fields
| Field Name | Description |
|---|---|
accountId - String | The ID of the account that this liability belongs to. Each account can only contain one liability. |
accountNumber - String | The account number of the loan. For some institutions, this may be a masked version of the number (e.g., the last 4 digits instead of the entire number). |
disbursementDates - [Date!] | The dates on which loaned funds were disbursed or will be disbursed. These are often in the past. Dates are returned in an ISO 8601 format (YYYY-MM-DD). |
expectedPayoffDate - Date | The date when the student loan is expected to be paid off. Availability for this field is limited. Dates are returned in an ISO 8601 format (YYYY-MM-DD). |
guarantor - String | The guarantor of the student loan. |
interestRatePercentage - Float | The interest rate on the loan as a percentage. |
isOverdue - Boolean | true if a payment is currently overdue. Availability for this field is limited. |
lastPaymentAmount - Float | The amount of the last payment. |
lastPaymentDate - Date | The date of the last payment. Dates are returned in an ISO 8601 format (YYYY-MM-DD). |
lastStatementBalance - Float | The total amount owed as of the last statement issued |
lastStatementIssueDate - Date | The date of the last statement. Dates are returned in an ISO 8601 format (YYYY-MM-DD). |
loanName - String | The type of loan, e.g., "Consolidation Loans". |
loanStatus - RemoteDataPlaidStudentLoanStatus | An object representing the status of the student loan |
minimumPaymentAmount - Float | The minimum payment due for the next billing cycle. There are some exceptions: Some institutions require a minimum payment across all loans associated with an account number. Our API presents that same minimum payment amount on each loan. The institutions that do this are: Great Lakes ( ins_116861), Firstmark (ins_116295), Commonbond Firstmark Services (ins_116950), Granite State (ins_116308), and Oklahoma Student Loan Authority (ins_116945). Firstmark (ins_116295 ) and Navient (ins_116248) will display as $0 if there is an autopay program in effect. |
nextPaymentDueDate - Date | The due date for the next payment. The due date is null if a payment is not expected. A payment is not expected if loan_status.type is deferment, in_school, consolidated, paid in full, or transferred. Dates are returned in an ISO 8601 format (YYYY-MM-DD). |
originationDate - Date | The date on which the loan was initially lent. Dates are returned in an ISO 8601 format (YYYY-MM-DD). |
originationPrincipalAmount - Float | The original principal balance of the loan. |
outstandingInterestAmount - Float | The total dollar amount of the accrued interest balance. For Sallie Mae ( ins_116944), this amount is included in the current balance of the loan, so this field will return as null. |
paymentReferenceNumber - String | The relevant account number that should be used to reference this loan for payments. In the majority of cases, payment_reference_number will match account_number, but in some institutions, such as Great Lakes (ins_116861), it will be different. |
pslfStatus - RemoteDataPlaidPSLFStatus | Information about the student's eligibility in the Public Service Loan Forgiveness program. This is only returned if the institution is FedLoan (ins_116527). Since FedLoan no longer services student loans, this field is no longer returned. Deprecated by Plaid |
repaymentPlan - RemoteDataPlaidStudentRepaymentPlan | An object representing the repayment plan for the student loan |
sequenceNumber - String | The sequence number of the student loan. Heartland ECSI (ins_116948) does not make this field available. |
servicerAddress - RemoteDataPlaidServicerAddressData | The address of the student loan servicer. This is generally the remittance address to which payments should be sent. |
ytdInterestPaid - Float | The year to date (YTD) interest paid. Availability for this field is limited. |
ytdPrincipalPaid - Float | The year to date (YTD) principal paid. Availability for this field is limited. |
Example
{
"accountId": "abc123",
"accountNumber": "abc123",
"disbursementDates": ["2007-12-03"],
"expectedPayoffDate": "2007-12-03",
"guarantor": "xyz789",
"interestRatePercentage": 123.45,
"isOverdue": false,
"lastPaymentAmount": 987.65,
"lastPaymentDate": "2007-12-03",
"lastStatementBalance": 987.65,
"lastStatementIssueDate": "2007-12-03",
"loanName": "abc123",
"loanStatus": RemoteDataPlaidStudentLoanStatus,
"minimumPaymentAmount": 123.45,
"nextPaymentDueDate": "2007-12-03",
"originationDate": "2007-12-03",
"originationPrincipalAmount": 123.45,
"outstandingInterestAmount": 123.45,
"paymentReferenceNumber": "abc123",
"pslfStatus": RemoteDataPlaidPSLFStatus,
"repaymentPlan": RemoteDataPlaidStudentRepaymentPlan,
"sequenceNumber": "xyz789",
"servicerAddress": RemoteDataPlaidServicerAddressData,
"ytdInterestPaid": 987.65,
"ytdPrincipalPaid": 987.65
}
RemoteDataPlaidStudentLoanStatus
Description
An object representing the status of the student loan
Example
{
"endDate": "2007-12-03",
"type": "abc123"
}
RemoteDataPlaidStudentRepaymentPlan
RemoteDataPlaidTransaction
Description
Plaid Transaction data.
A representation of a transaction
Fields
| Field Name | Description |
|---|---|
accountId - String | The ID of the account in which this transaction occurred. |
accountOwner - String | This field is not typically populated and only relevant when dealing with sub-accounts. A sub-account most commonly exists in cases where a single account is linked to multiple cards, each with its own card number and card holder name; each card will be considered a sub-account. If the account does have sub-accounts, this field will typically be some combination of the sub-account owner's name and/or the sub-account mask. The format of this field is not standardized and will vary based on institution. |
amount - Float | The settled value of the transaction, denominated in the transactions's currency, as stated in iso_currency_code or unofficial_currency_code. For all products except Income: Positive values when money moves out of the account; negative values when money moves in. For example, debit card purchases are positive; credit card payments, direct deposits, and refunds are negative. For Income endpoints, values are positive when representing income. |
authorizedDate - Date | The date that the transaction was authorized. For posted transactions, the date field will indicate the posted date, but authorized_date will indicate the day the transaction was authorized by the financial institution. If presenting transactions to the user in a UI, the authorized_date, when available, is generally preferable to use over the date field for posted transactions, as it will generally represent the date the user actually made the transaction. Dates are returned in an ISO 8601 format ( YYYY-MM-DD ). |
authorizedDatetime - DateTime | Date and time when a transaction was authorized in ISO 8601 format ( This field is returned for select financial institutions and comes as provided by the institution. It may contain default time values (such as 00:00:00). This field is only populated in API version 2019-05-29 and later. |
checkNumber - String | The check number of the transaction. This field is only populated for check transactions. |
counterparties - [RemoteDataPlaidCounterparty!] | The counterparties present in the transaction. Counterparties, such as the merchant or the financial institution, are extracted by Plaid from the raw description. |
date - Date | For pending transactions, the date that the transaction occurred; for posted transactions, the date that the transaction posted. Both dates are returned in an ISO 8601 format ( YYYY-MM-DD ). To receive information about the date that a posted transaction was initiated, see the authorized_date field. |
datetime - DateTime | Date and time when a transaction was posted in ISO 8601 format ( This field is returned for select financial institutions and comes as provided by the institution. It may contain default time values (such as 00:00:00). This field is only populated in API version 2019-05-29 and later. |
isoCurrencyCode - String | The ISO-4217 currency code of the transaction. Always null if unofficial_currency_code is non-null. |
location - RemoteDataPlaidTransactionLocation | A representation of where a transaction took place |
logoUrl - String | The URL of a logo associated with this transaction, if available. The logo will always be 100×100 pixel PNG file. |
merchantEntityId - String | A unique, stable, Plaid-generated ID that maps to the merchant. In the case of a merchant with multiple retail locations, this field will map to the broader merchant, not a specific location or store. |
merchantName - String | The merchant name, as enriched by Plaid from the name field. This is typically a more human-readable version of the merchant counterparty in the transaction. For some bank transactions (such as checks or account transfers) where there is no meaningful merchant name, this value will be null. |
name - String | The merchant name or transaction description. Note: This is a legacy field that is not actively maintained. Use If the |
originalDescription - String | The string returned by the financial institution to describe the transaction. For transactions returned by /transactions/sync or /transactions/get, this field will only be included if the client has set options.include_original_description to true. |
paymentChannel - String | The channel used to make a payment.
This field replaces the |
paymentMeta - RemoteDataPlaidPaymentMeta | Transaction information specific to inter-bank transfers. If the transaction was not an inter-bank transfer, all fields will be If the |
pending - Boolean | When true, identifies the transaction as pending or unsettled. Pending transaction details (name, type, amount, category ID) may change before they are settled. Not all institutions provide pending transactions. |
pendingTransactionId - String | The ID of a posted transaction's associated pending transaction, where applicable. Not all institutions provide pending transactions. |
personalFinanceCategory - RemoteDataPlaidPersonalFinanceCategory | Information describing the intent of the transaction. Most relevant for personal finance use cases, but not limited to such use cases. See the |
personalFinanceCategoryIconUrl - String | The URL of an icon associated with the primary personal finance category. The icon will always be 100×100 pixel PNG file. |
transactionCode - String | An identifier classifying the transaction type. This field is only populated for European institutions. For institutions in the US and Canada, this field is set to
|
transactionId - String | The unique ID of the transaction. Like all Plaid identifiers, the transaction_id is case sensitive. |
transactionType - String | Please use the
|
unofficialCurrencyCode - String | The unofficial currency code associated with the transaction. Always See the currency code schema for a full listing of supported |
website - String | The website associated with this transaction, if available. |
Example
{
"accountId": "abc123",
"accountOwner": "xyz789",
"amount": 987.65,
"authorizedDate": "2007-12-03",
"authorizedDatetime": "2007-12-03T10:15:30Z",
"checkNumber": "xyz789",
"counterparties": [RemoteDataPlaidCounterparty],
"date": "2007-12-03",
"datetime": "2007-12-03T10:15:30Z",
"isoCurrencyCode": "xyz789",
"location": RemoteDataPlaidTransactionLocation,
"logoUrl": "xyz789",
"merchantEntityId": "abc123",
"merchantName": "abc123",
"name": "xyz789",
"originalDescription": "xyz789",
"paymentChannel": "abc123",
"paymentMeta": RemoteDataPlaidPaymentMeta,
"pending": false,
"pendingTransactionId": "abc123",
"personalFinanceCategory": RemoteDataPlaidPersonalFinanceCategory,
"personalFinanceCategoryIconUrl": "abc123",
"transactionCode": "xyz789",
"transactionId": "xyz789",
"transactionType": "xyz789",
"unofficialCurrencyCode": "xyz789",
"website": "xyz789"
}
RemoteDataPlaidTransactionLocation
Description
A representation of where a transaction took place
Fields
| Field Name | Description |
|---|---|
address - String | The street address where the transaction occurred. |
city - String | The city where the transaction occurred. |
country - String | The ISO 3166-1 alpha-2 country code where the transaction occurred. |
lat - Float | The latitude where the transaction occurred. |
lon - Float | The longitude where the transaction occurred. |
postalCode - String | The postal code where the transaction occurred. In API versions 2018-05-22 and earlier, this field is called zip. |
region - String | The region or state where the transaction occurred. In API versions 2018-05-22 and earlier, this field is called state. |
storeNumber - String | The merchant defined store number where the transaction occurred. |
Example
{
"address": "abc123",
"city": "xyz789",
"country": "xyz789",
"lat": 123.45,
"lon": 123.45,
"postalCode": "abc123",
"region": "xyz789",
"storeNumber": "xyz789"
}
RemoteDataPlaidVerificationInsights
Description
Insights from performing database verification for the account. Only returned for Auth Items using Database Auth.
Fields
| Field Name | Description |
|---|---|
accountNumberFormat - String | Indicator of account number format validity for institution.
|
nameMatchScore - Int | Indicates the score of the name match between the given name provided during database verification (available in the verification_name field) and matched Plaid network accounts. If defined, will be a value between 0 and 100. Will be undefined if name matching was not enabled for the database verification session or if there were no eligible Plaid network matches to compare the given name with. |
networkStatus - RemoteDataPlaidVerificationInsightsNetworkStatus | Status information about the account and routing number in the Plaid network. |
previousReturns - RemoteDataPlaidVerificationInsightsNetworkStatus | Information about known ACH returns for the account and routing number. |
Example
{
"accountNumberFormat": "xyz789",
"nameMatchScore": 123,
"networkStatus": RemoteDataPlaidVerificationInsightsNetworkStatus,
"previousReturns": RemoteDataPlaidVerificationInsightsNetworkStatus
}
RemoteDataPlaidVerificationInsightsNetworkStatus
Description
Status information about the account and routing number in the Plaid network.
Example
{"hasNumbersMatch": false, "isNumbersMatchVerified": true}
RemoteDataPlaidYieldRate
Description
Details about a fixed income security's expected rate of return.
Fields
| Field Name | Description |
|---|---|
percentage - Float | The fixed income security's expected rate of return. |
type - String | The type of rate which indicates how the predicted yield was calculated. It is one of:
|
Example
{"percentage": 987.65, "type": "abc123"}
SearchQuery
Description
Options for searching through a list.
Fields
| Input Field | Description |
|---|---|
term - String | Query for searching. |
Example
{"term": "abc123"}
Security
Statement
Description
Represents a Statement.
Example
{
"account": Account,
"endOn": "2007-12-03",
"id": "stmt_11zBVgTOO9DR1vbAZxb6Ldb",
"startOn": "2007-12-03",
"url": "http://www.test.com/"
}
StatementConnection
Description
The connection type for Statement.
Fields
| Field Name | Description |
|---|---|
count - Int! | The total number of records. |
edges - [StatementEdge] | A list of edges. |
nodes - [Statement] | A list of nodes. |
pageInfo - PageInfo! | Information to aid in pagination. |
Example
{
"count": 987,
"edges": [StatementEdge],
"nodes": [Statement],
"pageInfo": PageInfo
}
StatementEdge
StatementFilter
Description
Options for filtering Statements.
Fields
| Input Field | Description |
|---|---|
accountIds - [ID!] | Filter for Statements by one or more supplied Account IDs. Examples:
|
for - DateRange | Filter for Statements by overlap with the supplied data range. Examples:
|
issuedFor - DateMonth | Filter for Statements issued on the supplied month. Examples:
|
on - Date | Filter for Statements covered by the supplied date. Examples:
|
Example
{
"accountIds": ["acct_12Hz9Dz7vEAuljYvhmPcvM9"],
"for": DateRange,
"issuedFor": DateMonth,
"on": "2025-01-24T14:15:22Z"
}
StatementSort
Description
Options for sorting statements.
Values
| Enum Value | Description |
|---|---|
|
| Oldest First, Unknown Periods Last |
|
| Newest First, Unknown Periods First |
Example
"DATE_ASC"
String
Description
The String scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.
Example
"abc123"
Transaction
Description
A Transaction represents financial activity associated with an Account.
Fields
| Field Name | Description |
|---|---|
account - Account! | The Account of the Transaction. |
amount - Float! | The amount of the Transaction. Positive for CREDIT inflows and negative for DEBIT outflows. |
currencyCode - CurrencyCode! | The ISO-4217 currency code of the Transaction |
date - Date! | The date. |
description - String! | The description or line item name. |
entryType - TransactionEntryType! | Whether the transaction represents an inflow (CREDIT) or an outflow (DEBIT). |
fees - Float | For Investments: The total amount of all fees applied to this transaction. |
id - ID! | The ID of the Transaction. |
kind - AccountKind! | Represents the classification of a Transaction. |
logo - Image | A single Transaction Logo. |
metadata - JSON | Custom metadata about the Transaction, stored in a 'key-value' format. See the Custom Metadata guide for more information and examples. |
price - Float | For Investments: The price of the security at the time of this transaction. |
provider - ConnectionProvider | The original provider of the Transaction. |
quantity - Float | For Investments: The quantity of security units involved in this transaction: positive for purchases and negative for sales. |
remoteData - TransactionRemoteData | The Remote Data associated with the Transaction. See the Remote Data guide for more information. |
security - Security | The Security associated with the Investment Transaction. |
status - TransactionStatus! | Represents the status for a Transaction. |
Example
{
"account": Account,
"amount": 987.65,
"currencyCode": "USD",
"date": "2007-12-03",
"description": "Chipotle Mexican Grill",
"entryType": "CREDIT",
"fees": 123.45,
"id": "txn_11VgTOO9DR1vbAZxb6zBLdb",
"kind": "DEPOSITORY",
"logo": Image,
"metadata": {"userDefinedName": "My favorite transaction"},
"price": 987.65,
"provider": "AKOYA",
"quantity": 123.45,
"remoteData": TransactionRemoteData,
"security": Security,
"status": "POSTED"
}
TransactionConnection
Description
The connection type for Transaction.
Fields
| Field Name | Description |
|---|---|
count - Int! | The total number of records. |
edges - [TransactionEdge] | A list of edges. |
nodes - [Transaction] | A list of nodes. |
pageInfo - PageInfo! | Information to aid in pagination. |
Example
{
"count": 987,
"edges": [TransactionEdge],
"nodes": [Transaction],
"pageInfo": PageInfo
}
TransactionEdge
Description
An edge in a connection.
Fields
| Field Name | Description |
|---|---|
cursor - String! | A cursor for use in pagination. |
node - Transaction | The item at the end of the edge. |
Example
{
"cursor": "xyz789",
"node": Transaction
}
TransactionEntryType
Description
Whether the transaction represents an inflow (CREDIT) or an outflow (DEBIT).
Values
| Enum Value | Description |
|---|---|
|
| An entry recording money being advanced into the account. |
|
| An entry recording money being withdrawn from the account. |
Example
"CREDIT"
TransactionFilter
Description
Options for filtering Transactions.
Fields
| Input Field | Description |
|---|---|
accountIds - [ID!] | Filter Transactions by one or more supplied Account IDs. Examples:
|
amount - Float | The amount of the Transaction |
amount_abs - Float | Absolute value of the amount of the Transaction |
amount_abs_gt - Float | Greater than the absolute value of the amount of the Transaction |
amount_abs_gte - Float | Greater than or equal to the absolute value of the amount of the Transaction |
amount_abs_lt - Float | Less than the absolute value of the amount of the Transaction |
amount_abs_lte - Float | Less than or equal to the absolute value of the amount of the Transaction |
amount_gt - Float | Greater than the amount of the Transaction |
amount_gte - Float | Greater than or equal to the amount of the Transaction |
amount_lt - Float | Less than the amount of the Transaction |
amount_lte - Float | Less than or equal to the amount of the Transaction |
date - Date | The date of the Transaction. |
date_gt - Date | Greater than the date of the Transaction. |
date_gte - Date | Greater than or equal to the date of the Transaction. |
date_lt - Date | Less than the date of the Transaction. |
date_lte - Date | Less than or equal to the date of the Transaction. |
entryType - TransactionEntryType | Filter Transactions by debit/credit status. Examples:
|
kind - [AccountKind!] | Filter Transactions by one of more classifications. Examples:
|
kind_not - [AccountKind!] | Filter out Transactions by one or more classification. Examples:
|
metadata - JSON | Filter by the contents of Transaction Examples:
|
status - [TransactionStatus!] | Filter Transactions by Transaction status. Examples:
|
Example
{
"accountIds": ["acct_12Hz9Dz7vEAuljYvhmPcvM9"],
"amount": 123.45,
"amount_abs": 123.45,
"amount_abs_gt": 987.65,
"amount_abs_gte": 987.65,
"amount_abs_lt": 123.45,
"amount_abs_lte": 987.65,
"amount_gt": 987.65,
"amount_gte": 123.45,
"amount_lt": 987.65,
"amount_lte": 987.65,
"date": "2007-12-03",
"date_gt": "2007-12-03",
"date_gte": "2007-12-03",
"date_lt": "2007-12-03",
"date_lte": "2007-12-03",
"entryType": "CREDIT",
"kind": ["DEPOSITORY"],
"kind_not": ["DEPOSITORY"],
"metadata": {},
"status": ["PROJECTED"]
}
TransactionRemoteData
Description
Remote data associated with a Transaction.
Fields
| Field Name | Description |
|---|---|
akoya - TransactionRemoteDataAkoya | The Akoya remote data associated with the Transaction. |
fingoal - TransactionRemoteDataFingoal | The FinGoal remote data associated with the Transaction. |
finicity - TransactionRemoteDataFinicity | The Finicity remote data associated with the Transaction. |
mock - TransactionRemoteDataMock | The Mock remote data associated with the Transaction. |
mx - TransactionRemoteDataMx | The MX remote data associated with the Transaction. |
ntropy - TransactionRemoteDataNtropy | The Ntropy remote data associated with the Transaction. |
plaid - TransactionRemoteDataPlaid | The Plaid remote data associated with the Transaction. |
Example
{
"akoya": TransactionRemoteDataAkoya,
"fingoal": TransactionRemoteDataFingoal,
"finicity": TransactionRemoteDataFinicity,
"mock": TransactionRemoteDataMock,
"mx": TransactionRemoteDataMx,
"ntropy": TransactionRemoteDataNtropy,
"plaid": TransactionRemoteDataPlaid
}
TransactionRemoteDataAkoya
Description
Transaction-level data from Akoya.
Fields
| Field Name | Description |
|---|---|
transaction - TransactionRemoteDataAkoyaTransaction | The Transaction data from Akoya. |
Example
{"transaction": TransactionRemoteDataAkoyaTransaction}
TransactionRemoteDataAkoyaTransaction
Description
The Transaction data from Akoya.
Fields
| Field Name | Description |
|---|---|
id - String! | The record's Akoya ID. |
response - RemoteDataAkoyaTransaction | The response body. |
timestamp - DateTime! | The date and time when the data was fetched. |
Example
{
"id": "xyz789",
"response": RemoteDataAkoyaTransaction,
"timestamp": "2025-03-24T12:25:12Z"
}
TransactionRemoteDataFingoal
Description
Transaction-level data from FinGoal.
Fields
| Field Name | Description |
|---|---|
enrichment - TransactionRemoteDataFingoalEnrichment | The Enrichment data from FinGoal. |
Example
{"enrichment": TransactionRemoteDataFingoalEnrichment}
TransactionRemoteDataFingoalEnrichment
Description
The Enrichment data from Fingoal.
Fields
| Field Name | Description |
|---|---|
id - String! | The record's Fingoal ID. |
response - RemoteDataFingoalEnrichedTransaction | The response body. |
timestamp - DateTime! | The date and time when the data was fetched. |
Example
{
"id": "abc123",
"response": RemoteDataFingoalEnrichedTransaction,
"timestamp": "2025-03-24T12:25:12Z"
}
TransactionRemoteDataFinicity
Description
Transaction-level data from Finicity.
Fields
| Field Name | Description |
|---|---|
transaction - TransactionRemoteDataFinicityTransaction | The Transaction data from Finicity. |
Example
{"transaction": TransactionRemoteDataFinicityTransaction}
TransactionRemoteDataFinicityTransaction
Description
The Transaction data from Finicity.
Fields
| Field Name | Description |
|---|---|
id - String! | The record's Finicity ID. |
response - RemoteDataFinicityTransaction | The response body. |
timestamp - DateTime! | The date and time when the data was fetched. |
Example
{
"id": "abc123",
"response": RemoteDataFinicityTransaction,
"timestamp": "2025-03-24T12:25:12Z"
}
TransactionRemoteDataMock
Description
Transaction-level data from Mock.
Fields
| Field Name | Description |
|---|---|
transaction - TransactionRemoteDataMockTransaction | The Transaction data from Mock. |
Example
{"transaction": TransactionRemoteDataMockTransaction}
TransactionRemoteDataMockTransaction
Description
The Transaction data from Mock.
Fields
| Field Name | Description |
|---|---|
id - String! | The record's Mock ID. |
response - RemoteDataMockTransaction | The response body. |
timestamp - DateTime! | The date and time when the data was fetched. |
Example
{
"id": "abc123",
"response": RemoteDataMockTransaction,
"timestamp": "2025-03-24T12:25:12Z"
}
TransactionRemoteDataMx
Description
Transaction-level data from MX.
Fields
| Field Name | Description |
|---|---|
enrichment - TransactionRemoteDataMxEnrichment | The Enrichment data from MX. |
transaction - TransactionRemoteDataMxTransaction | The base Transaction data from MX. |
Example
{
"enrichment": TransactionRemoteDataMxEnrichment,
"transaction": TransactionRemoteDataMxTransaction
}
TransactionRemoteDataMxEnrichment
Description
The Enrichment data from Mx.
Fields
| Field Name | Description |
|---|---|
id - String! | The record's Mx ID. |
response - RemoteDataMxEnhanceTransaction | The response body. |
timestamp - DateTime! | The date and time when the data was fetched. |
Example
{
"id": "abc123",
"response": RemoteDataMxEnhanceTransaction,
"timestamp": "2025-03-24T12:25:12Z"
}
TransactionRemoteDataMxTransaction
Description
The Transaction data from Mx.
Fields
| Field Name | Description |
|---|---|
id - String! | The record's Mx ID. |
response - RemoteDataMxTransaction | The response body. |
timestamp - DateTime! | The date and time when the data was fetched. |
Example
{
"id": "xyz789",
"response": RemoteDataMxTransaction,
"timestamp": "2025-03-24T12:25:12Z"
}
TransactionRemoteDataNtropy
Description
Transaction-level data from Ntropy.
Fields
| Field Name | Description |
|---|---|
enrichment - TransactionRemoteDataNtropyEnrichment | The Enrichment data from Ntropy. |
Example
{"enrichment": TransactionRemoteDataNtropyEnrichment}
TransactionRemoteDataNtropyEnrichment
Description
The Enrichment data from Ntropy.
Fields
| Field Name | Description |
|---|---|
id - String! | The record's Ntropy ID. |
response - RemoteDataNtropyEnrichedTransaction | The response body. |
timestamp - DateTime! | The date and time when the data was fetched. |
Example
{
"id": "xyz789",
"response": RemoteDataNtropyEnrichedTransaction,
"timestamp": "2025-03-24T12:25:12Z"
}
TransactionRemoteDataPlaid
Description
Transaction-level data from Plaid.
Fields
| Field Name | Description |
|---|---|
investmentTransaction - TransactionRemoteDataPlaidInvestmentTransaction | The Investment Transaction data from Plaid. |
security - TransactionRemoteDataPlaidSecurity | The Security data from Plaid. |
transaction - TransactionRemoteDataPlaidTransaction | The base Transaction data from Plaid. |
Example
{
"investmentTransaction": TransactionRemoteDataPlaidInvestmentTransaction,
"security": TransactionRemoteDataPlaidSecurity,
"transaction": TransactionRemoteDataPlaidTransaction
}
TransactionRemoteDataPlaidInvestmentTransaction
Description
The Investment Transaction data from Plaid.
Fields
| Field Name | Description |
|---|---|
id - String! | The record's Plaid ID. |
response - RemoteDataPlaidInvestmentTransaction | The response body. |
timestamp - DateTime! | The date and time when the data was fetched. |
Example
{
"id": "abc123",
"response": RemoteDataPlaidInvestmentTransaction,
"timestamp": "2025-03-24T12:25:12Z"
}
TransactionRemoteDataPlaidSecurity
Description
The Security data from Plaid.
Fields
| Field Name | Description |
|---|---|
id - String! | The record's Plaid ID. |
response - RemoteDataPlaidSecurity | The response body. |
timestamp - DateTime! | The date and time when the data was fetched. |
Example
{
"id": "xyz789",
"response": RemoteDataPlaidSecurity,
"timestamp": "2025-03-24T12:25:12Z"
}
TransactionRemoteDataPlaidTransaction
Description
The Transaction data from Plaid.
Fields
| Field Name | Description |
|---|---|
id - String! | The record's Plaid ID. |
response - RemoteDataPlaidTransaction | The response body. |
timestamp - DateTime! | The date and time when the data was fetched. |
Example
{
"id": "abc123",
"response": RemoteDataPlaidTransaction,
"timestamp": "2025-03-24T12:25:12Z"
}
TransactionSort
Description
Options for sorting transactions.
Values
| Enum Value | Description |
|---|---|
|
| Oldest First, Pending Last |
|
| Newest First, Pending First |
Example
"DATE_ASC"
TransactionStatus
Description
Represents the status for a Transaction.
Values
| Enum Value | Description |
|---|---|
|
| Estimated or forecast on the basis of current trends or data. This value will be removed in a future version. |
|
| Awaiting decision or settlement, and may be replaced, updated, or removed. |
|
| Announced or published as conclusive. |
Example
"PROJECTED"
TransactionUpdateInput
Description
Autogenerated input type of TransactionUpdate
Example
{
"clientMutationId": "abc123",
"id": "txn_11VgTOO9DR1vbAZxb6zBLdb",
"metadata": {}
}
TransactionUpdatePayload
Description
Autogenerated return type of TransactionUpdate.
Fields
| Field Name | Description |
|---|---|
clientMutationId - String | A unique identifier for the client performing the mutation. |
errors - [Error!] | List of errors from an unsuccessful mutation. |
record - Transaction | The updated transaction. |
success - Boolean! | Specifies whether the mutation was successful. |
Example
{
"clientMutationId": "xyz789",
"errors": [Error],
"record": Transaction,
"success": false
}
URL
Description
Represents a valid URL, transported as a string.
Example
"http://www.test.com/"