openapi: 3.2.0 info: title: Plaid API version: 2020-09-14_1.517.0 contact: name: Plaid Developer Team url: https://plaid.com termsOfService: https://plaid.com/legal/ description: 'Operations tagged Plaid across 68 of this provider''s published API definitions: plaid-accounts--openapi-original.yml, plaid-accounts--openapi.yml, plaid-application--openapi-original.yml, plaid-asset-report--openapi-original.yml, plaid-asset-report--openapi.yml, plaid-auth--openapi-original.yml, plaid-auth--openapi.yml, plaid-bank-transfer--openapi-original.yml, plaid-bank-transfer--openapi.yml, plaid-beacon--openapi-original.yml, plaid-beacon--openapi.yml, plaid-beta--openapi-original.yml, plaid-categories--openapi-original.yml, plaid-categories--openapi.yml, plaid-cra--openapi-original.yml, plaid-cra--openapi.yml, plaid-credit--openapi-original.yml, plaid-credit--openapi.yml, plaid-dashboard-user--openapi-original.yml, plaid-deposit-switch--openapi-original.yml, plaid-deposit-switch--openapi.yml, plaid-employers--openapi-original.yml, plaid-employers--openapi.yml, plaid-fdx--openapi-original.yml, plaid-fdx--openapi.yml, plaid-identity--openapi-original.yml, plaid-identity--openapi.yml, plaid-identity-verification--openapi-original.yml, plaid-identity-verification--openapi.yml, plaid-income--openapi-original.yml, plaid-income--openapi.yml, plaid-institutions--openapi-original.yml, plaid-institutions--openapi.yml, plaid-investments--openapi-original.yml, plaid-investments--openapi.yml, plaid-item--openapi-original.yml, plaid-item--openapi.yml, plaid-liabilities--openapi-original.yml, plaid-liabilities--openapi.yml, plaid-link--openapi-original.yml, plaid-link--openapi.yml, plaid-link-delivery--openapi-original.yml, plaid-link-delivery--openapi.yml, plaid-openapi-original.yml, plaid-partner--openapi-original.yml, plaid-partner--openapi.yml, plaid-payment-initiation--openapi-original.yml, plaid-payment-initiation--openapi.yml, plaid-payment-profile--openapi-original.yml, plaid-payment-profile--openapi.yml, plaid-processor--openapi-original.yml, plaid-processor--openapi.yml, plaid-profile--openapi-original.yml, plaid-sandbox--openapi-original.yml, plaid-sandbox--openapi.yml, plaid-signal--openapi-original.yml, plaid-signal--openapi.yml, plaid-statements--openapi-original.yml, plaid-statements--openapi.yml, plaid-transactions--openapi-original.yml, plaid-transactions--openapi.yml, plaid-transfer--openapi-original.yml, plaid-transfer--openapi.yml, plaid-user--openapi-original.yml, plaid-wallet--openapi-original.yml, plaid-wallet--openapi.yml, plaid-watchlist-screening--openapi-original.yml, plaid-watchlist-screening--openapi.yml. Each path carries the servers of the definition it was published in.' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com security: - clientId: [] secret: [] plaidVersion: [] tags: - name: Plaid paths: /accounts/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Retrieve accounts externalDocs: url: /api/accounts/#accountsget operationId: accountsGet description: 'The `/accounts/get` endpoint can be used to retrieve a list of accounts associated with any linked Item. Plaid will only return active bank accounts — that is, accounts that are not closed and are capable of carrying a balance. For items that went through the updated account selection pane, this endpoint only returns accounts that were permissioned by the user when they initially created the Item. If a user creates a new account after the initial link, you can capture this event through the [`NEW_ACCOUNTS_AVAILABLE`](https://plaid.com/docs/api/items/#new_accounts_available) webhook and then use Link''s [update mode](https://plaid.com/docs/link/update-mode/) to request that the user share this new account with you. `/accounts/get` is free to use and retrieves cached information, rather than extracting fresh information from the institution. The balance returned will reflect the balance at the time of the last successful Item update. If the Item is enabled for a regularly updating product, such as Transactions, Investments, or Liabilities, the balance will typically update about once a day, as long as the Item is healthy. If the Item is enabled only for products that do not frequently update, such as Auth or Identity, balance data may be much older. For realtime balance information, use the paid endpoint `/accounts/balance/get` instead.' responses: '200': description: success content: application/json: schema: $ref: '#/components/schemas/AccountsGetResponse' examples: example-1: value: accounts: - account_id: blgvvBlXw3cq5GMPwqB6s6q4dLKB9WcVqGDGo balances: available: 100 current: 110 iso_currency_code: USD limit: null unofficial_currency_code: null mask: '0000' name: Plaid Checking official_name: Plaid Gold Standard 0% Interest Checking persistent_account_id: 8cfb8beb89b774ee43b090625f0d61d0814322b43bff984eaf60386e subtype: checking type: depository - account_id: 6PdjjRP6LmugpBy5NgQvUqpRXMWxzktg3rwrk balances: available: null current: 23631.9805 iso_currency_code: USD limit: null unofficial_currency_code: null mask: '6666' name: Plaid 401k official_name: null subtype: 401k type: investment - account_id: XMBvvyMGQ1UoLbKByoMqH3nXMj84ALSdE5B58 balances: available: null current: 65262 iso_currency_code: USD limit: null unofficial_currency_code: null mask: '7777' name: Plaid Student Loan official_name: null subtype: student type: loan item: available_products: - balance - identity - payment_initiation - transactions billed_products: - assets - auth consent_expiration_time: null error: null institution_id: ins_117650 item_id: DWVAAPWq4RHGlEaNyGKRTAnPLaEmo8Cvq7na6 update_type: background webhook: https://www.genericwebhookurl.com/webhook request_id: bkVE1BHWMAZ9Rnr default: description: Error response. content: application/json: schema: $ref: '#/components/schemas/PlaidError' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/AccountsGetRequest' examples: example-1: value: client_id: string secret: string access_token: string options: account_ids: - string servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /accounts/balance/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Retrieve real-time balance data externalDocs: url: /api/products/balance/#accountsbalanceget operationId: accountsBalanceGet responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AccountsGetResponse' examples: example-1: value: accounts: - account_id: BxBXxLj1m4HMXBm9WZZmCWVbPjX16EHwv99vp balances: available: 100 current: 110 iso_currency_code: USD limit: null unofficial_currency_code: null mask: '0000' name: Plaid Checking official_name: Plaid Gold Standard 0% Interest Checking persistent_account_id: 8cfb8beb89b774ee43b090625f0d61d0814322b43bff984eaf60386e subtype: checking type: depository - account_id: dVzbVMLjrxTnLjX4G66XUp5GLklm4oiZy88yK balances: available: null current: 410 iso_currency_code: USD limit: 2000 unofficial_currency_code: null mask: '3333' name: Plaid Credit Card official_name: Plaid Diamond 12.5% APR Interest Credit Card subtype: credit card type: credit - account_id: Pp1Vpkl9w8sajvK6oEEKtr7vZxBnGpf7LxxLE balances: available: null current: 65262 iso_currency_code: USD limit: null unofficial_currency_code: null mask: '7777' name: Plaid Student Loan official_name: null subtype: student type: loan item: available_products: - balance - identity - investments billed_products: - assets - auth - liabilities - transactions consent_expiration_time: null error: null institution_id: ins_3 item_id: eVBnVMp7zdTJLkRNr33Rs6zr7KNJqBFL9DrE6 update_type: background webhook: https://www.genericwebhookurl.com/webhook request_id: qk5Bxes3gDfv4F2 description: The `/accounts/balance/get` endpoint returns the real-time balance for each of an Item's accounts. While other endpoints, such as `/accounts/get`, return a balance object, only `/accounts/balance/get` forces the available and current balance fields to be refreshed rather than cached. This endpoint can be used for existing Items that were added via any of Plaid’s other products. This endpoint can be used as long as Link has been initialized with any other product, `balance` itself is not a product that can be used to initialize Link. As this endpoint triggers a synchronous request for fresh data, latency may be higher than for other Plaid endpoints (typically less than 10 seconds, but occasionally up to 30 seconds or more); if you encounter errors, you may find it necessary to adjust your timeout period when making requests. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/AccountsBalanceGetRequest' examples: example-1: value: access_token: string secret: string client_id: string options: account_ids: - string servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /item/application/list: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid List a user’s connected applications operationId: itemApplicationList description: List a user’s connected applications responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ItemApplicationListResponse' default: description: Error response. content: application/json: schema: $ref: '#/components/schemas/PlaidError' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ItemApplicationListRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /item/application/unlink: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Unlink a user’s connected application externalDocs: url: none operationId: itemApplicationUnlink description: 'Unlink a user’s connected application. On an unlink request, Plaid will immediately revoke the Application’s access to the User’s data. The User will have to redo the OAuth authentication process in order to restore functionality. This endpoint only removes ongoing data access permissions, therefore the User will need to reach out to the Application itself in order to disable and delete their account and delete any data that the Application already received (if the Application does not do so by default). This endpoint should be called in real time as the User is unlinking an Application, and should not be batched in order to ensure that the change is reflected as soon as possible.' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ItemApplicationUnlinkResponse' examples: example-1: value: request_id: m8MDnv9okwxFNBV default: description: Error response. content: application/json: schema: $ref: '#/components/schemas/PlaidError' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ItemApplicationUnlinkRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /item/application/scopes/update: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Update the scopes of access for a particular application operationId: itemApplicationScopesUpdate description: Enable consumers to update product access on selected accounts for an application. responses: '200': description: success content: application/json: schema: $ref: '#/components/schemas/ItemApplicationScopesUpdateResponse' default: description: Error response. content: application/json: schema: $ref: '#/components/schemas/PlaidError' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ItemApplicationScopesUpdateRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /application/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Retrieve information about a Plaid application operationId: applicationGet description: Allows financial institutions to retrieve information about Plaid clients for the purpose of building control-tower experiences responses: '200': description: success content: application/json: schema: $ref: '#/components/schemas/ApplicationGetResponse' default: description: Error response. content: application/json: schema: $ref: '#/components/schemas/PlaidError' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ApplicationGetRequest' description: '' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /asset_report/create: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Create an Asset Report externalDocs: url: /api/products/assets/#asset_reportcreate responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AssetReportCreateResponse' examples: example-1: value: asset_report_token: assets-sandbox-6f12f5bb-22dd-4855-b918-f47ec439198a asset_report_id: 1f414183-220c-44f5-b0c8-bc0e6d4053bb request_id: Iam3b operationId: assetReportCreate description: 'The `/asset_report/create` endpoint initiates the process of creating an Asset Report, which can then be retrieved by passing the `asset_report_token` return value to the `/asset_report/get` or `/asset_report/pdf/get` endpoints. The Asset Report takes some time to be created and is not available immediately after calling `/asset_report/create`. The exact amount of time to create the report will vary depending on how many days of history are requested and will typically range from a few seconds to about one minute. When the Asset Report is ready to be retrieved using `/asset_report/get` or `/asset_report/pdf/get`, Plaid will fire a `PRODUCT_READY` webhook. For full details of the webhook schema, see [Asset Report webhooks](https://plaid.com/docs/api/products/assets/#webhooks). The `/asset_report/create` endpoint creates an Asset Report at a moment in time. Asset Reports are immutable. To get an updated Asset Report, use the `/asset_report/refresh` endpoint.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/AssetReportCreateRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /asset_report/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Retrieve an Asset Report externalDocs: url: /api/products/assets/#asset_reportget responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AssetReportGetResponse' examples: example-1: value: report: asset_report_id: 028e8404-a013-4a45-ac9e-002482f9cafc client_report_id: client_report_id_1221 date_generated: '2023-03-30T18:27:37Z' days_requested: 5 items: - accounts: - account_id: 1qKRXQjk8xUWDJojNwPXTj8gEmR48piqRNye8 balances: available: 43200 current: 43200 limit: null margin_loan_amount: null iso_currency_code: USD unofficial_currency_code: null days_available: 5 historical_balances: - current: 49050 date: '2023-03-29' iso_currency_code: USD unofficial_currency_code: null - current: 49050 date: '2023-03-28' iso_currency_code: USD unofficial_currency_code: null - current: 49050 date: '2023-03-27' iso_currency_code: USD unofficial_currency_code: null - current: 49050 date: '2023-03-26' iso_currency_code: USD unofficial_currency_code: null - current: 49050 date: '2023-03-25' iso_currency_code: USD unofficial_currency_code: null mask: '4444' name: Plaid Money Market official_name: Plaid Platinum Standard 1.85% Interest Money Market owners: - addresses: - data: city: Malakoff country: US region: NY street: 2992 Cameron Road postal_code: '14236' primary: true - data: city: San Matias country: US region: CA street: 2493 Leisure Lane postal_code: 93405-2255 primary: false emails: - data: accountholder0@example.com primary: true type: primary - data: accountholder1@example.com primary: false type: secondary - data: extraordinarily.long.email.username.123456@reallylonghostname.com primary: false type: other names: - Alberta Bobbeth Charleson phone_numbers: - data: '1112223333' primary: false type: home - data: '1112224444' primary: false type: work - data: '1112225555' primary: false type: mobile ownership_type: null subtype: money market transactions: - account_id: 1qKRXQjk8xUWDJojNwPXTj8gEmR48piqRNye8 amount: 5850 date: '2023-03-30' iso_currency_code: USD original_description: ACH Electronic CreditGUSTO PAY 123456 pending: false transaction_id: gGQgjoeyqBF89PND6K14Sow1wddZBmtLomJ78 unofficial_currency_code: null type: depository - account_id: eG7pNLjknrFpWvP7Dkbdf3Pq6GVBPKTaQJK5v balances: available: 100 current: 110 limit: null margin_loan_amount: null iso_currency_code: USD unofficial_currency_code: null days_available: 5 historical_balances: - current: 110 date: '2023-03-29' iso_currency_code: USD unofficial_currency_code: null - current: -390 date: '2023-03-28' iso_currency_code: USD unofficial_currency_code: null - current: -373.67 date: '2023-03-27' iso_currency_code: USD unofficial_currency_code: null - current: -284.27 date: '2023-03-26' iso_currency_code: USD unofficial_currency_code: null - current: -284.27 date: '2023-03-25' iso_currency_code: USD unofficial_currency_code: null mask: '0000' name: Plaid Checking official_name: Plaid Gold Standard 0% Interest Checking owners: - addresses: - data: city: Malakoff country: US region: NY street: 2992 Cameron Road postal_code: '14236' primary: true - data: city: San Matias country: US region: CA street: 2493 Leisure Lane postal_code: 93405-2255 primary: false emails: - data: accountholder0@example.com primary: true type: primary - data: accountholder1@example.com primary: false type: secondary - data: extraordinarily.long.email.username.123456@reallylonghostname.com primary: false type: other names: - Alberta Bobbeth Charleson phone_numbers: - data: '1112223333' primary: false type: home - data: '1112224444' primary: false type: work - data: '1112225555' primary: false type: mobile ownership_type: null subtype: checking transactions: - account_id: eG7pNLjknrFpWvP7Dkbdf3Pq6GVBPKTaQJK5v amount: 89.4 date: '2023-03-27' iso_currency_code: USD original_description: SparkFun pending: false transaction_id: 4zBRq1Qem4uAPnoyKjJNTRQpQddM4ztlo1PLD unofficial_currency_code: null - account_id: eG7pNLjknrFpWvP7Dkbdf3Pq6GVBPKTaQJK5v amount: 12 date: '2023-03-28' iso_currency_code: USD original_description: 'McDonalds #3322' pending: false transaction_id: dkjL41PnbKsPral79jpxhMWdW55gkPfBkWpRL unofficial_currency_code: null - account_id: eG7pNLjknrFpWvP7Dkbdf3Pq6GVBPKTaQJK5v amount: 4.33 date: '2023-03-28' iso_currency_code: USD original_description: Starbucks pending: false transaction_id: a84ZxQaWDAtDL3dRgmazT57K7jjN3WFkNWMDy unofficial_currency_code: null - account_id: eG7pNLjknrFpWvP7Dkbdf3Pq6GVBPKTaQJK5v amount: -500 date: '2023-03-29' iso_currency_code: USD original_description: United Airlines **** REFUND **** pending: false transaction_id: xG9jbv3eMoFWepzB7wQLT3LoLggX5Duy1Gbe5 unofficial_currency_code: null type: depository date_last_updated: '2023-03-30T18:25:26Z' institution_id: ins_109508 institution_name: First Platypus Bank item_id: AZMP7JrGXgtPd3AQMeg7hwMKgk5E8qU1V5ME7 user: client_user_id: uid_40332 email: abcharleston@example.com first_name: Anna last_name: Charleston middle_name: B phone_number: 1-415-867-5309 ssn: 111-22-1234 request_id: GVzMdiDd8DDAQK4 warnings: [] operationId: assetReportGet description: 'The `/asset_report/get` endpoint retrieves the Asset Report in JSON format. Before calling `/asset_report/get`, you must first create the Asset Report using `/asset_report/create` (or filter an Asset Report using `/asset_report/filter`) and then wait for the [`PRODUCT_READY`](https://plaid.com/docs/api/products/assets/#product_ready) webhook to fire, indicating that the Report is ready to be retrieved. By default, an Asset Report includes transaction descriptions as returned by the bank, as opposed to parsed and categorized by Plaid. You can also receive cleaned and categorized transactions, as well as additional insights like merchant name or location information. We call this an Asset Report with Insights. An Asset Report with Insights provides transaction category, location, and merchant information in addition to the transaction strings provided in a standard Asset Report. To retrieve an Asset Report with Insights, call `/asset_report/get` endpoint with `include_insights` set to `true`. For latency-sensitive applications, you can optionally call `/asset_report/create` with `options.add_ons` set to `["fast_assets"]`. This will cause Plaid to create two versions of the Asset Report: one with only current and available balance and identity information, and then later on the complete Asset Report. You will receive separate webhooks for each version of the Asset Report.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/AssetReportGetRequest' description: '' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /asset_report/pdf/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Retrieve a PDF Asset Report externalDocs: url: /api/products/assets/#asset_reportpdfget responses: '200': description: A PDF of the Asset Report content: application/pdf: schema: $ref: '#/components/schemas/AssetReportPDFGetResponse' operationId: assetReportPdfGet description: 'The `/asset_report/pdf/get` endpoint retrieves the Asset Report in PDF format. Before calling `/asset_report/pdf/get`, you must first create the Asset Report using `/asset_report/create` (or filter an Asset Report using `/asset_report/filter`) and then wait for the [`PRODUCT_READY`](https://plaid.com/docs/api/products/assets/#product_ready) webhook to fire, indicating that the Report is ready to be retrieved. The response to `/asset_report/pdf/get` is the PDF binary data. The `request_id` is returned in the `Plaid-Request-ID` header. [View a sample PDF Asset Report](https://plaid.com/documents/sample-asset-report.pdf).' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/AssetReportPDFGetRequest' description: '' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /asset_report/refresh: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Refresh an Asset Report externalDocs: url: /api/products/assets/#asset_reportrefresh responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AssetReportRefreshResponse' examples: example-1: value: asset_report_id: c33ebe8b-6a63-4d74-a83d-d39791231ac0 asset_report_token: assets-sandbox-8218d5f8-6d6d-403d-92f5-13a9afaa4398 request_id: NBZaq operationId: assetReportRefresh description: 'An Asset Report is an immutable snapshot of a user''s assets. In order to "refresh" an Asset Report you created previously, you can use the `/asset_report/refresh` endpoint to create a new Asset Report based on the old one, but with the most recent data available. The new Asset Report will contain the same Items as the original Report, as well as the same filters applied by any call to `/asset_report/filter`. By default, the new Asset Report will also use the same parameters you submitted with your original `/asset_report/create` request, but the original `days_requested` value and the values of any parameters in the `options` object can be overridden with new values. To change these arguments, simply supply new values for them in your request to `/asset_report/refresh`. Submit an empty string ("") for any previously-populated fields you would like set as empty.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/AssetReportRefreshRequest' description: '' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /asset_report/filter: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Filter Asset Report externalDocs: url: /api/products/assets/#asset_reportfilter responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AssetReportFilterResponse' examples: example-1: value: asset_report_token: assets-sandbox-bc410c6a-4653-4c75-985c-e757c3497c5c asset_report_id: fdc09207-0cef-4d88-b5eb-0d970758ebd9 request_id: qEg07 operationId: assetReportFilter description: 'By default, an Asset Report will contain all of the accounts on a given Item. In some cases, you may not want the Asset Report to contain all accounts. For example, you might have the end user choose which accounts are relevant in Link using the Account Select view, which you can enable in the dashboard. Or, you might always exclude certain account types or subtypes, which you can identify by using the `/accounts/get` endpoint. To narrow an Asset Report to only a subset of accounts, use the `/asset_report/filter` endpoint. To exclude certain Accounts from an Asset Report, first use the `/asset_report/create` endpoint to create the report, then send the `asset_report_token` along with a list of `account_ids` to exclude to the `/asset_report/filter` endpoint, to create a new Asset Report which contains only a subset of the original Asset Report''s data. Because Asset Reports are immutable, calling `/asset_report/filter` does not alter the original Asset Report in any way; rather, `/asset_report/filter` creates a new Asset Report with a new token and id. Asset Reports created via `/asset_report/filter` do not contain new Asset data, and are not billed. Plaid will fire a [`PRODUCT_READY`](https://plaid.com/docs/api/products/assets/#product_ready) webhook once generation of the filtered Asset Report has completed.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/AssetReportFilterRequest' description: '' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /asset_report/remove: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Delete an Asset Report externalDocs: url: /api/products/assets/#asset_reportremove responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AssetReportRemoveResponse' examples: example-1: value: removed: true request_id: I6zHN operationId: assetReportRemove description: 'The `/item/remove` endpoint allows you to invalidate an `access_token`, meaning you will not be able to create new Asset Reports with it. Removing an Item does not affect any Asset Reports or Audit Copies you have already created, which will remain accessible until you remove them specifically. The `/asset_report/remove` endpoint allows you to remove access to an Asset Report. Removing an Asset Report invalidates its `asset_report_token`, meaning you will no longer be able to use it to access Report data or create new Audit Copies. Removing an Asset Report does not affect the underlying Items, but does invalidate any `audit_copy_tokens` associated with the Asset Report.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/AssetReportRemoveRequest' description: '' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /asset_report/audit_copy/create: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Create Asset Report Audit Copy externalDocs: url: /api/products/assets/#asset_reportaudit_copycreate responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AssetReportAuditCopyCreateResponse' examples: example-1: value: audit_copy_token: a-sandbox-3TAU2CWVYBDVRHUCAAAI27ULU4 request_id: Iam3b operationId: assetReportAuditCopyCreate description: 'Plaid can provide an Audit Copy of any Asset Report directly to a participating third party on your behalf. For example, Plaid can supply an Audit Copy directly to Fannie Mae on your behalf if you participate in the Day 1 Certainty™ program. An Audit Copy contains the same underlying data as the Asset Report. To grant access to an Audit Copy, use the `/asset_report/audit_copy/create` endpoint to create an `audit_copy_token` and then pass that token to the third party who needs access. Each third party has its own `auditor_id`, for example `fannie_mae`. You’ll need to create a separate Audit Copy for each third party to whom you want to grant access to the Report.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/AssetReportAuditCopyCreateRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /asset_report/audit_copy/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Retrieve an Asset Report Audit Copy tags: - Plaid operationId: assetReportAuditCopyGet externalDocs: url: /none/ requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/AssetReportAuditCopyGetRequest' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AssetReportGetResponse' description: '`/asset_report/audit_copy/get` allows auditors to get a copy of an Asset Report that was previously shared via the `/asset_report/audit_copy/create` endpoint. The caller of `/asset_report/audit_copy/create` must provide the `audit_copy_token` to the auditor. This token can then be used to call `/asset_report/audit_copy/create`.' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /asset_report/audit_copy/remove: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Remove Asset Report Audit Copy externalDocs: url: /api/products/assets/#asset_reportaudit_copyremove responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AssetReportAuditCopyRemoveResponse' examples: example-1: value: removed: true request_id: m8MDnv9okwxFNBV operationId: assetReportAuditCopyRemove requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/AssetReportAuditCopyRemoveRequest' description: '' description: The `/asset_report/audit_copy/remove` endpoint allows you to remove an Audit Copy. Removing an Audit Copy invalidates the `audit_copy_token` associated with it, meaning both you and any third parties holding the token will no longer be able to use it to access Report data. Items associated with the Asset Report, the Asset Report itself and other Audit Copies of it are not affected and will remain accessible after removing the given Audit Copy. servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /credit/asset_report/freddie_mac/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Retrieve an Asset Report with Freddie Mac format. Only Freddie Mac can use this endpoint. externalDocs: url: /none/ responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AssetReportFreddieGetResponse' examples: example-1: value: SchemaVersion: 1 DEAL: LOANS: LOAN: LOAN_IDENTIFIERS: LOAN_IDENTIFIER: LoanIdentifier: '100016746' LoanIdentifierType: LenderLoan PARTIES: PARTY: - INDIVIDUAL: NAME: FirstName: John LastName: Deere ROLES: ROLE: ROLE_DETAIL: PartyRoleType: Borrower TAXPAYER_IDENTIFIERS: TAXPAYER_IDENTIFIER: TaxpayerIdentifierType: SocialSecurityNumber TaxpayerIdentifierValue: 123-45-6789 SERVICES: SERVICE: VERIFICATION_OF_ASSET: REPORTING_INFORMATION: ReportingInformationIdentifier: a-prod-kol4xb5y4nf2zecqalb2d55mze SERVICE_PRODUCT_FULFILLMENT: SERVICE_PRODUCT_FULFILLMENT_DETAIL: VendorOrderIdentifier: PLAID ServiceProductFulfillmentIdentifier: VOA VERIFICATION_OF_ASSET_RESPONSE: ASSETS: ASSET: - ASSET_DETAIL: AssetAccountIdentifier: '3847' AssetUniqueIdentifier: c251a55e-c503-471b-a3b1-11a9243bc189 AssetAsOfDate: '2022-07-27' AssetDescription: Unlimited Cash Rewards Visa Signature AssetAvailableBalanceAmount: 2073.99 AssetCurrentBalanceAmount: 2007.09 AssetType: Other AssetTypeAdditionalDescription: credit card AssetDaysRequestedCount: 61 AssetOwnershipType: null ASSET_OWNERS: ASSET_OWNER: - AssetOwnerText: Alberta Bobbeth Charleson ASSET_HOLDER: NAME: FullName: Wells Fargo ASSET_TRANSACTIONS: ASSET_TRANSACTION: - ASSET_TRANSACTION_DETAIL: AssetTransactionUniqueIdentifier: 7jagxo9Eq6cXPKM8eMNJUgeeNnbgQdSDw6zgN AssetTransactionAmount: 34.43 AssetTransactionDate: '2022-07-19' AssetTransactionPostDate: '2022-07-19' AssetTransactionType: Debit AssetTransactionPaidByName: null AssetTransactionTypeAdditionalDescription: null AssetTransactionCategoryType: FoodDining FinancialInstitutionTransactionIdentifier: null ASSET_TRANSACTION_DESCRIPTON: - AssetTransactionDescription: TONYS PIZZA NAPOLETANA SAN FRANCISCOCA VALIDATION_SOURCES: VALIDATION_SOURCE: - ValidationSourceName: '' ValidationSourceReferenceIdentifier: '' STATUSES: STATUS: StatusCode: success StatusDescription: null request_id: eYupqX1mZkEuQRx operationId: creditAssetReportFreddieMacGet description: The `credit/asset_report/freddie_mac/get` endpoint retrieves the Asset Report in Freddie Mac's JSON format. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/AssetReportFreddieGetRequest' description: '' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /auth/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Retrieve auth data externalDocs: url: /api/products/auth/#authget operationId: authGet description: 'The `/auth/get` endpoint returns the bank account and bank identification numbers (such as routing numbers, for US accounts) associated with an Item''s checking and savings accounts, along with high-level account data and balances when available. Note: This request may take some time to complete if `auth` was not specified as an initial product when creating the Item. This is because Plaid must communicate directly with the institution to retrieve the data. Versioning note: In API version 2017-03-08, the schema of the `numbers` object returned by this endpoint is substantially different. For details, see [Plaid API versioning](https://plaid.com/docs/api/versioning/#version-2018-05-22).' responses: '200': description: success content: application/json: schema: $ref: '#/components/schemas/AuthGetResponse' examples: example-1: value: accounts: - account_id: vzeNDwK7KQIm4yEog683uElbp9GRLEFXGK98D balances: available: 100 current: 110 limit: null iso_currency_code: USD unofficial_currency_code: null mask: '9606' name: Plaid Checking official_name: Plaid Gold Checking subtype: checking type: depository numbers: ach: - account: '9900009606' account_id: vzeNDwK7KQIm4yEog683uElbp9GRLEFXGK98D routing: '011401533' wire_routing: '021000021' eft: - account: '111122223333' account_id: vzeNDwK7KQIm4yEog683uElbp9GRLEFXGK98D institution: '021' branch: '01140' international: - account_id: vzeNDwK7KQIm4yEog683uElbp9GRLEFXGK98D bic: NWBKGB21 iban: GB29NWBK60161331926819 bacs: - account: '31926819' account_id: vzeNDwK7KQIm4yEog683uElbp9GRLEFXGK98D sort_code: '601613' item: available_products: - balance - identity - payment_initiation - transactions billed_products: - assets - auth consent_expiration_time: null error: null institution_id: ins_117650 item_id: DWVAAPWq4RHGlEaNyGKRTAnPLaEmo8Cvq7na6 update_type: background webhook: https://www.genericwebhookurl.com/webhook request_id: m8MDnv9okwxFNBV default: content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Default error requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/AuthGetRequest' examples: {} description: '' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /processor/auth/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Retrieve Auth data externalDocs: url: /api/processor-partners/#processorauthget operationId: processorAuthGet responses: '200': description: success content: application/json: schema: $ref: '#/components/schemas/ProcessorAuthGetResponse' examples: example-1: value: account: account_id: vzeNDwK7KQIm4yEog683uElbp9GRLEFXGK98D balances: available: 100 current: 110 iso_currency_code: USD limit: null unofficial_currency_code: null mask: '0000' name: Plaid Checking official_name: Plaid Gold Checking subtype: checking type: depository numbers: ach: account: '9900009606' account_id: vzeNDwK7KQIm4yEog683uElbp9GRLEFXGK98D routing: '011401533' wire_routing: '021000021' eft: account: '111122223333' account_id: vzeNDwK7KQIm4yEog683uElbp9GRLEFXGK98D institution: '021' branch: '01140' international: account_id: vzeNDwK7KQIm4yEog683uElbp9GRLEFXGK98D bic: NWBKGB21 iban: GB29NWBK60161331926819 bacs: account: '31926819' account_id: vzeNDwK7KQIm4yEog683uElbp9GRLEFXGK98D sort_code: '601613' request_id: 1zlMf description: 'The `/processor/auth/get` endpoint returns the bank account and bank identification number (such as the routing number, for US accounts), for a checking or savings account that''''s associated with a given `processor_token`. The endpoint also returns high-level account data and balances when available. Versioning note: API versions 2019-05-29 and earlier use a different schema for the `numbers` object returned by this endpoint. For details, see [Plaid API versioning](https://plaid.com/docs/api/versioning/#version-2020-09-14). ' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ProcessorAuthGetRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /investments/auth/get: x-hidden-from-docs: true x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Get data needed to authorize an investments transfer externalDocs: url: /api/products/investments/#investmentsauth responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/InvestmentsAuthGetResponse' examples: example-1: value: accounts: - account_id: 5Bvpj4QknlhVWk7GygpwfVKdd133GoCxB814g balances: available: 43200 current: 43200 iso_currency_code: USD limit: null unofficial_currency_code: null mask: '4444' name: Plaid Money Market official_name: Plaid Platinum Standard 1.85% Interest Money Market subtype: money market type: depository - account_id: JqMLm4rJwpF6gMPJwBqdh9ZjjPvvpDcb7kDK1 balances: available: null current: 110.01 iso_currency_code: USD limit: null unofficial_currency_code: null mask: '5555' name: Plaid IRA official_name: null subtype: ira type: investment - account_id: k67E4xKvMlhmleEa4pg9hlwGGNnnEeixPolGm balances: available: null current: 23631.9805 iso_currency_code: USD limit: null unofficial_currency_code: null mask: '6666' name: Plaid Roth IRA official_name: null subtype: roth type: investment holdings: - account_id: JqMLm4rJwpF6gMPJwBqdh9ZjjPvvpDcb7kDK1 cost_basis: 1 institution_price: 1 institution_price_as_of: '2021-04-13' institution_price_datetime: null institution_value: 0.01 iso_currency_code: USD quantity: 0.01 security_id: d6ePmbPxgWCWmMVv66q9iPV94n91vMtov5Are unofficial_currency_code: null - account_id: k67E4xKvMlhmleEa4pg9hlwGGNnnEeixPolGm cost_basis: 1.5 institution_price: 2.11 institution_price_as_of: '2021-04-13' institution_price_datetime: null institution_value: 2.11 iso_currency_code: USD quantity: 1 security_id: KDwjlXj1Rqt58dVvmzRguxJybmyQL8FgeWWAy unofficial_currency_code: null - account_id: k67E4xKvMlhmleEa4pg9hlwGGNnnEeixPolGm cost_basis: 10 institution_price: 10.42 institution_price_as_of: '2021-04-13' institution_price_datetime: null institution_value: 20.84 iso_currency_code: USD quantity: 2 security_id: NDVQrXQoqzt5v3bAe8qRt4A7mK7wvZCLEBBJk unofficial_currency_code: null - account_id: JqMLm4rJwpF6gMPJwBqdh9ZjjPvvpDcb7kDK1 cost_basis: 0.01 institution_price: 0.011 institution_price_as_of: '2021-04-13' institution_price_datetime: null institution_value: 110 iso_currency_code: USD quantity: 10000 security_id: 8E4L9XLl6MudjEpwPAAgivmdZRdBPJuvMPlPb unofficial_currency_code: null - account_id: k67E4xKvMlhmleEa4pg9hlwGGNnnEeixPolGm cost_basis: 23 institution_price: 27 institution_price_as_of: '2021-04-13' institution_price_datetime: null institution_value: 636.309 iso_currency_code: USD quantity: 23.567 security_id: JDdP7XPMklt5vwPmDN45t3KAoWAPmjtpaW7DP unofficial_currency_code: null - account_id: k67E4xKvMlhmleEa4pg9hlwGGNnnEeixPolGm cost_basis: 15 institution_price: 13.73 institution_price_as_of: '2021-04-13' institution_price_datetime: null institution_value: 1373.6865 iso_currency_code: USD quantity: 100.05 security_id: nnmo8doZ4lfKNEDe3mPJipLGkaGw3jfPrpxoN unofficial_currency_code: null - account_id: k67E4xKvMlhmleEa4pg9hlwGGNnnEeixPolGm cost_basis: 1 institution_price: 1 institution_price_as_of: '2021-04-13' institution_price_datetime: null institution_value: 12345.67 iso_currency_code: USD quantity: 12345.67 security_id: d6ePmbPxgWCWmMVv66q9iPV94n91vMtov5Are unofficial_currency_code: null item: available_products: - balance - identity - liabilities - transactions billed_products: - assets - auth - investments_auth consent_expiration_time: null error: null institution_id: ins_3 item_id: 4z9LPae1nRHWy8pvg9jrsgbRP4ZNQvIdbLq7g update_type: background webhook: https://www.genericwebhookurl.com/webhook numbers: acats: - account: TR4444 account_id: 5Bvpj4QknlhVWk7GygpwfVKdd133GoCxB814g dtc_numbers: [] - account: TR5555 account_id: JqMLm4rJwpF6gMPJwBqdh9ZjjPvvpDcb7kDK1 dtc_numbers: [] - account: TR6666 account_id: k67E4xKvMlhmleEa4pg9hlwGGNnnEeixPolGm dtc_numbers: [] aton: [] request_id: l68wb8zpS0hqmsJ owners: - account_id: 5Bvpj4QknlhVWk7GygpwfVKdd133GoCxB814g names: - Alberta Bobbeth Charleson - account_id: JqMLm4rJwpF6gMPJwBqdh9ZjjPvvpDcb7kDK1 names: - Alberta Bobbeth Charleson - account_id: k67E4xKvMlhmleEa4pg9hlwGGNnnEeixPolGm names: - Alberta Bobbeth Charleson securities: - close_price: 0.011 close_price_as_of: '2021-04-13' cusip: null institution_id: null institution_security_id: null is_cash_equivalent: false isin: null iso_currency_code: USD name: Nflx Feb 01'18 $355 Call proxy_security_id: null security_id: 8E4L9XLl6MudjEpwPAAgivmdZRdBPJuvMPlPb sedol: null ticker_symbol: NFLX180201C00355000 type: derivative unofficial_currency_code: null update_datetime: null market_identifier_code: XNAS option_contract: contract_type: call expiration_date: '2018-02-01' strike_price: 355 underlying_security_ticker: NFLX - close_price: 27 close_price_as_of: null cusip: '577130834' institution_id: null institution_security_id: null is_cash_equivalent: false isin: US5771308344 iso_currency_code: USD name: Matthews Pacific Tiger Fund Insti Class proxy_security_id: null security_id: JDdP7XPMklt5vwPmDN45t3KAoWAPmjtpaW7DP sedol: null ticker_symbol: MIPTX type: mutual fund unofficial_currency_code: null update_datetime: null market_identifier_code: XNAS option_contract: null - close_price: 2.11 close_price_as_of: null cusip: 00448Q201 institution_id: null institution_security_id: null is_cash_equivalent: false isin: US00448Q2012 iso_currency_code: USD name: Achillion Pharmaceuticals Inc. proxy_security_id: null security_id: KDwjlXj1Rqt58dVvmzRguxJybmyQL8FgeWWAy sedol: null ticker_symbol: ACHN type: equity unofficial_currency_code: null update_datetime: null market_identifier_code: XNAS option_contract: null - close_price: 10.42 close_price_as_of: null cusip: '258620103' institution_id: null institution_security_id: null is_cash_equivalent: false isin: US2586201038 iso_currency_code: USD name: DoubleLine Total Return Bond Fund proxy_security_id: null security_id: NDVQrXQoqzt5v3bAe8qRt4A7mK7wvZCLEBBJk sedol: null ticker_symbol: DBLTX type: mutual fund unofficial_currency_code: null update_datetime: null market_identifier_code: XNAS option_contract: null - close_price: 1 close_price_as_of: null cusip: null institution_id: null institution_security_id: null is_cash_equivalent: true isin: null iso_currency_code: USD name: U S Dollar proxy_security_id: null security_id: d6ePmbPxgWCWmMVv66q9iPV94n91vMtov5Are sedol: null ticker_symbol: USD type: cash unofficial_currency_code: null update_datetime: null market_identifier_code: null option_contract: null - close_price: 13.73 close_price_as_of: null cusip: null institution_id: ins_3 institution_security_id: NHX105509 is_cash_equivalent: false isin: null iso_currency_code: USD name: NH PORTFOLIO 1055 (FIDELITY INDEX) proxy_security_id: null security_id: nnmo8doZ4lfKNEDe3mPJipLGkaGw3jfPrpxoN sedol: null ticker_symbol: NHX105509 type: etf unofficial_currency_code: null update_datetime: null market_identifier_code: XNAS option_contract: null operationId: investmentsAuthGet description: The `/investments/auth/get` endpoint allows developers to receive user-authorized data to facilitate the transfer of holdings requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/InvestmentsAuthGetRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /processor/bank_transfer/create: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Create a bank transfer as a processor externalDocs: url: /api/processor-partners/#bank_transfercreate operationId: processorBankTransferCreate responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ProcessorBankTransferCreateResponse' examples: example-1: value: bank_transfer: account_id: 6qL6lWoQkAfNE3mB8Kk5tAnvpX81qefrvvl7B ach_class: ppd amount: '12.34' cancellable: true created: '2020-08-06T17:27:15Z' custom_tag: my tag description: Testing2 direction: outbound failure_reason: null id: 460cbe92-2dcc-8eae-5ad6-b37d0ec90fd9 iso_currency_code: USD metadata: key1: value1 key2: value2 network: ach origination_account_id: 11111111-1111-1111-1111-111111111111 status: pending type: credit user: email_address: plaid@plaid.com legal_name: John Smith routing_number: '111111111' request_id: saKrIBuEB9qJZno default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Use the `/processor/bank_transfer/create` endpoint to initiate a new bank transfer as a processor requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ProcessorBankTransferCreateRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /bank_transfer/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Retrieve a bank transfer tags: - Plaid externalDocs: url: /bank-transfers/reference#bank_transferget operationId: bankTransferGet responses: '200': description: OK headers: {} content: application/json: schema: $ref: '#/components/schemas/BankTransferGetResponse' examples: example-1: value: bank_transfer: account_id: 6qL6lWoQkAfNE3mB8Kk5tAnvpX81qefrvvl7B ach_class: ppd amount: '12.34' cancellable: true created: '2020-08-06T17:27:15Z' custom_tag: my tag description: Testing2 direction: outbound failure_reason: ach_return_code: R13 description: Invalid ACH routing number id: 460cbe92-2dcc-8eae-5ad6-b37d0ec90fd9 iso_currency_code: USD metadata: key1: value1 key2: value2 network: ach origination_account_id: 8945fedc-e703-463d-86b1-dc0607b55460 status: pending type: credit user: email_address: plaid@plaid.com legal_name: John Smith routing_number: '111111111' request_id: saKrIBuEB9qJZno default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: The `/bank_transfer/get` fetches information about the bank transfer corresponding to the given `bank_transfer_id`. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/BankTransferGetRequest' examples: {} parameters: [] servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /bank_transfer/create: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Create a bank transfer tags: - Plaid externalDocs: url: /bank-transfers/reference#bank_transfercreate operationId: bankTransferCreate responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/BankTransferCreateResponse' examples: example-1: value: bank_transfer: account_id: 6qL6lWoQkAfNE3mB8Kk5tAnvpX81qefrvvl7B ach_class: ppd amount: '12.34' cancellable: true created: '2020-08-06T17:27:15Z' custom_tag: my tag description: Testing2 direction: outbound failure_reason: null id: 460cbe92-2dcc-8eae-5ad6-b37d0ec90fd9 iso_currency_code: USD metadata: key1: value1 key2: value2 network: ach origination_account_id: 8945fedc-e703-463d-86b1-dc0607b55460 status: pending type: credit user: email_address: plaid@plaid.com legal_name: John Smith routing_number: '111111111' request_id: saKrIBuEB9qJZno default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Use the `/bank_transfer/create` endpoint to initiate a new bank transfer. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/BankTransferCreateRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /bank_transfer/list: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid List bank transfers tags: - Plaid externalDocs: url: /bank-transfers/reference#bank_transferlist operationId: bankTransferList responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/BankTransferListResponse' examples: example-1: value: bank_transfers: - account_id: 6qL6lWoQkAfNE3mB8Kk5tAnvpX81qefrvvl7B ach_class: ppd amount: '12.34' cancellable: true created: '2020-08-06T17:27:15Z' custom_tag: my tag description: Testing2 direction: outbound failure_reason: ach_return_code: R13 description: Invalid ACH routing number id: 460cbe92-2dcc-8eae-5ad6-b37d0ec90fd9 iso_currency_code: USD metadata: key1: value1 key2: value2 network: ach origination_account_id: 8945fedc-e703-463d-86b1-dc0607b55460 originator_client_id: 569ed2f36b3a3a021713abc1 status: pending type: credit user: email_address: plaid@plaid.com legal_name: John Smith routing_number: '111111111' request_id: saKrIBuEB9qJZno default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: 'Use the `/bank_transfer/list` endpoint to see a list of all your bank transfers and their statuses. Results are paginated; use the `count` and `offset` query parameters to retrieve the desired bank transfers. ' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/BankTransferListRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /bank_transfer/cancel: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Cancel a bank transfer tags: - Plaid externalDocs: url: /bank-transfers/reference#bank_transfercancel operationId: bankTransferCancel responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/BankTransferCancelResponse' examples: example-1: value: request_id: saKrIBuEB9qJZno default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Use the `/bank_transfer/cancel` endpoint to cancel a bank transfer. A transfer is eligible for cancelation if the `cancellable` property returned by `/bank_transfer/get` is `true`. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/BankTransferCancelRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /bank_transfer/event/list: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid List bank transfer events tags: - Plaid externalDocs: url: /api/products/auth#bank_transfereventlist operationId: bankTransferEventList responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/BankTransferEventListResponse' examples: example-1: value: bank_transfer_events: - account_id: 6qL6lWoQkAfNE3mB8Kk5tAnvpX81qefrvvl7B bank_transfer_amount: '12.34' bank_transfer_id: 460cbe92-2dcc-8eae-5ad6-b37d0ec90fd9 bank_transfer_iso_currency_code: USD bank_transfer_type: credit direction: outbound event_id: 1 event_type: pending failure_reason: null origination_account_id: '' timestamp: '2020-08-06T17:27:15Z' request_id: mdqfuVxeoza6mhu default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Use the `/bank_transfer/event/list` endpoint to get a list of Plaid-initiated ACH or bank transfer events based on specified filter criteria. When using Auth with micro-deposit verification enabled, this endpoint can be used to fetch status updates on ACH micro-deposits. For more details, see [micro-deposit events](https://plaid.com/docs/auth/coverage/microdeposit-events/). requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/BankTransferEventListRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /bank_transfer/event/sync: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Sync bank transfer events tags: - Plaid externalDocs: url: /api/products/auth/#bank_transfereventsync operationId: bankTransferEventSync responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/BankTransferEventSyncResponse' examples: example-1: value: bank_transfer_events: - account_id: 6qL6lWoQkAfNE3mB8Kk5tAnvpX81qefrvvl7B bank_transfer_amount: '12.34' bank_transfer_id: 460cbe92-2dcc-8eae-5ad6-b37d0ec90fd9 bank_transfer_iso_currency_code: USD bank_transfer_type: credit direction: outbound event_id: 1 event_type: pending failure_reason: null origination_account_id: '' timestamp: '2020-08-06T17:27:15Z' request_id: mdqfuVxeoza6mhu default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/BankTransferEventSyncRequest' description: '`/bank_transfer/event/sync` allows you to request up to the next 25 Plaid-initiated bank transfer events that happened after a specific `event_id`. When using Auth with micro-deposit verification enabled, this endpoint can be used to fetch status updates on ACH micro-deposits. For more details, see [micro-deposit events](https://www.plaid.com/docs/auth/coverage/microdeposit-events/).' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /bank_transfer/sweep/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Retrieve a sweep tags: - Plaid externalDocs: url: /api/products/transfer/#bank_transfersweepget operationId: bankTransferSweepGet responses: '200': description: OK headers: {} content: application/json: schema: $ref: '#/components/schemas/BankTransferSweepGetResponse' examples: example-1: value: sweep: id: d5394a4d-0b04-4a02-9f4a-7ca5c0f52f9d created_at: '2020-08-06T17:27:15Z' amount: '12.34' iso_currency_code: USD request_id: saKrIBuEB9qJZno default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: The `/bank_transfer/sweep/get` endpoint fetches information about the sweep corresponding to the given `sweep_id`. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/BankTransferSweepGetRequest' examples: {} parameters: [] servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /bank_transfer/sweep/list: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid List sweeps tags: - Plaid externalDocs: url: /api/products/transfer/#bank_transfersweeplist operationId: bankTransferSweepList responses: '200': description: OK headers: {} content: application/json: schema: $ref: '#/components/schemas/BankTransferSweepListResponse' examples: example-1: value: sweeps: - id: d5394a4d-0b04-4a02-9f4a-7ca5c0f52f9d created_at: '2020-08-06T17:27:15Z' amount: '12.34' iso_currency_code: USD request_id: saKrIBuEB9qJZno default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: The `/bank_transfer/sweep/list` endpoint fetches information about the sweeps matching the given filters. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/BankTransferSweepListRequest' examples: {} parameters: [] servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /bank_transfer/balance/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Get balance of your Bank Transfer account tags: - Plaid externalDocs: url: /bank-transfers/reference#bank_transferbalanceget operationId: bankTransferBalanceGet responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/BankTransferBalanceGetResponse' examples: example-1: value: balance: available: '1721.70' transactable: '721.70' origination_account_id: 8945fedc-e703-463d-86b1-dc0607b55460 request_id: mdqfuVxeoza6mhu default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: 'Use the `/bank_transfer/balance/get` endpoint to see the available balance in your bank transfer account. Debit transfers increase this balance once their status is posted. Credit transfers decrease this balance when they are created. The transactable balance shows the amount in your account that you are able to use for transfers, and is essentially your available balance minus your minimum balance. Note that this endpoint can only be used with FBO accounts, when using Bank Transfers in the Full Service configuration. It cannot be used on your own account when using Bank Transfers in the BTS Platform configuration.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/BankTransferBalanceGetRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /bank_transfer/migrate_account: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Migrate account into Bank Transfers tags: - Plaid externalDocs: url: /bank-transfers/reference#bank_transfermigrate_account operationId: bankTransferMigrateAccount responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/BankTransferMigrateAccountResponse' examples: example-1: value: access_token: access-sandbox-435beced-94e8-4df3-a181-1dde1cfa19f0 account_id: zvyDgbeeDluZ43AJP6m5fAxDlgoZXDuoy5gjN request_id: mdqfuVxeoza6mhu default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: As an alternative to adding Items via Link, you can also use the `/bank_transfer/migrate_account` endpoint to migrate known account and routing numbers to Plaid Items. Note that Items created in this way are not compatible with endpoints for other products, such as `/accounts/balance/get`, and can only be used with Bank Transfer endpoints. If you require access to other endpoints, create the Item through Link instead. Access to `/bank_transfer/migrate_account` is not enabled by default; to obtain access, contact your Plaid Account Manager. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/BankTransferMigrateAccountRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /sandbox/bank_transfer/simulate: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Simulate a bank transfer event in Sandbox tags: - Plaid externalDocs: url: /bank-transfers/reference/#sandboxbank_transfersimulate operationId: sandboxBankTransferSimulate responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/SandboxBankTransferSimulateResponse' examples: example-1: value: request_id: LmHYMwBhZUvsM03 default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Use the `/sandbox/bank_transfer/simulate` endpoint to simulate a bank transfer event in the Sandbox environment. Note that while an event will be simulated and will appear when using endpoints such as `/bank_transfer/event/sync` or `/bank_transfer/event/list`, no transactions will actually take place and funds will not move between accounts, even within the Sandbox. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SandboxBankTransferSimulateRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /sandbox/bank_transfer/fire_webhook: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Manually fire a Bank Transfer webhook tags: - Plaid externalDocs: url: /bank-transfers/reference/#sandboxbank_transferfire_webhook operationId: sandboxBankTransferFireWebhook responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/SandboxBankTransferFireWebhookResponse' examples: example-1: value: request_id: mdqfuVxeoza6mhu default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Use the `/sandbox/bank_transfer/fire_webhook` endpoint to manually trigger a Bank Transfers webhook in the Sandbox environment. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SandboxBankTransferFireWebhookRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /beacon/account_risk/v1/evaluate: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID x-hidden-from-docs: true post: tags: - Plaid summary: Plaid Evaluate risk of a bank account externalDocs: url: none operationId: beaconAccountRiskEvaluate description: Use `/beacon/account_risk/v1/evaluate` to get risk insights for a linked account. responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/BeaconAccountRiskEvaluateResponse' examples: example-1: value: accounts: - account_id: mbVr0axYMECQ07NJ5gXnHRM9DeD2RJCxm9roR attributes: days_since_first_plaid_connection: 510 plaid_connections_count_7d: 6 plaid_connections_count_30d: 7 total_plaid_connections_count: 15 subtype: checking type: depository request_id: mdqfuVxeoza6mhu default: description: Error response. content: application/json: schema: $ref: '#/components/schemas/PlaidError' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/BeaconAccountRiskEvaluateRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /beacon/user/create: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Create a Beacon User requestBody: content: application/json: schema: $ref: '#/components/schemas/BeaconUserCreateRequest' required: true tags: - Plaid responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/BeaconUserCreateResponse' examples: example-1: value: id: becusr_42cF1MNo42r9Xj version: 1 created_at: '2020-07-24T03:26:02Z' updated_at: '2020-07-24T03:26:02Z' status: cleared program_id: becprg_11111111111111 client_user_id: your-db-id-3b24110 user: date_of_birth: '1990-05-29' name: given_name: Leslie family_name: Knope address: street: 123 Main St. street2: Unit 42 city: Pawnee region: IN postal_code: '46001' country: US email_address: user@example.com phone_number: '+19876543212' id_number: value: '123456789' type: us_ssn ip_address: 192.0.2.42 audit_trail: source: dashboard dashboard_user_id: 54350110fedcbaf01234ffee timestamp: '2020-07-24T03:26:02Z' request_id: saKrIBuEB9qJZng operationId: beaconUserCreate description: "Create and scan a Beacon User against your Beacon Program, according to your program's settings.\n\nWhen you submit a new user to `/beacon/user/create`, several checks are performed immediately:\n\n - The user's PII (provided within the `user` object) is searched against all other users within the Beacon Program you specified. If a match is found that violates your program's \"Duplicate Information Filtering\" settings, the user will be returned with a status of `pending_review`.\n\n - The user's PII is also searched against all fraud reports created by your organization across all of your Beacon Programs. If the user's data matches a fraud report that your team created, the user will be returned with a status of `rejected`.\n\n - Finally, the user's PII is searched against all fraud report shared with the Beacon Network by other companies. If a matching fraud report is found, the user will be returned with a `pending_review` status if your program has enabled automatic flagging based on network fraud." externalDocs: url: /api/products/beacon/#beaconusercreate servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /beacon/user/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Get a Beacon User requestBody: content: application/json: schema: $ref: '#/components/schemas/BeaconUserGetRequest' required: true tags: - Plaid responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/BeaconUserGetResponse' examples: example-1: value: id: becusr_42cF1MNo42r9Xj version: 1 created_at: '2020-07-24T03:26:02Z' updated_at: '2020-07-24T03:26:02Z' status: cleared program_id: becprg_11111111111111 client_user_id: your-db-id-3b24110 user: date_of_birth: '1990-05-29' name: given_name: Leslie family_name: Knope address: street: 123 Main St. street2: Unit 42 city: Pawnee region: IN postal_code: '46001' country: US email_address: user@example.com phone_number: '+19876543212' id_number: value: '123456789' type: us_ssn ip_address: 192.0.2.42 audit_trail: source: dashboard dashboard_user_id: 54350110fedcbaf01234ffee timestamp: '2020-07-24T03:26:02Z' request_id: saKrIBuEB9qJZng operationId: beaconUserGet description: 'Fetch a Beacon User. The Beacon User is returned with all of their associated information and a `status` based on the Beacon Network duplicate record and fraud checks. ' externalDocs: url: /api/products/beacon/#beaconuserget servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /beacon/user/review: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Review a Beacon User requestBody: content: application/json: schema: $ref: '#/components/schemas/BeaconUserReviewRequest' required: true tags: - Plaid responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/BeaconUserGetResponse' examples: example-1: value: id: becusr_42cF1MNo42r9Xj version: 1 created_at: '2020-07-24T03:26:02Z' updated_at: '2020-07-24T03:26:02Z' status: cleared program_id: becprg_11111111111111 client_user_id: your-db-id-3b24110 user: date_of_birth: '1990-05-29' name: given_name: Leslie family_name: Knope address: street: 123 Main St. street2: Unit 42 city: Pawnee region: IN postal_code: '46001' country: US email_address: user@example.com phone_number: '+19876543212' id_number: value: '123456789' type: us_ssn ip_address: 192.0.2.42 audit_trail: source: dashboard dashboard_user_id: 54350110fedcbaf01234ffee timestamp: '2020-07-24T03:26:02Z' request_id: saKrIBuEB9qJZng operationId: beaconUserReview description: 'Update the status of a Beacon User. When updating a Beacon User''s status via this endpoint, Plaid validates that the status change is consistent with the related state for this Beacon User. Specifically, we will check: 1. Whether there are any associated Beacon Reports connected to the Beacon User, and 2. Whether there are any confirmed Beacon Report Syndications connected to the Beacon User. When updating a Beacon User''s status to "rejected", we enforce that either a Beacon Report has been created for the Beacon User or a Beacon Report Syndication has been confirmed. When updating a Beacon User''s status to "cleared", we enforce that there are no active Beacon Reports or confirmed Beacon Report Syndications associated with the user. If you previously created a Beacon Report for this user, you must delete it before updating the Beacon User''s status to "cleared". There are no restrictions on updating a Beacon User''s status to "pending_review". If these conditions are not met, the request will be rejected with an error explaining the issue.' externalDocs: url: /api/products/beacon/#beaconuserreview servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /beacon/report/create: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Create a Beacon Report requestBody: content: application/json: schema: $ref: '#/components/schemas/BeaconReportCreateRequest' required: true tags: - Plaid responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/BeaconReportCreateResponse' examples: example-1: value: id: becrpt_11111111111111 beacon_user_id: becusr_42cF1MNo42r9Xj created_at: '2020-07-24T03:26:02Z' type: first_party fraud_date: '1990-05-29' fraud_amount: iso_currency_code: USD value: 100 audit_trail: source: dashboard dashboard_user_id: 54350110fedcbaf01234ffee timestamp: '2020-07-24T03:26:02Z' request_id: saKrIBuEB9qJZng operationId: beaconReportCreate description: Create a fraud report for a given Beacon User. externalDocs: url: /api/products/beacon/#beaconreportcreate servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /beacon/report/list: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid List Beacon Reports for a Beacon User requestBody: content: application/json: schema: $ref: '#/components/schemas/BeaconReportListRequest' required: true tags: - Plaid responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/BeaconReportListResponse' examples: example-1: value: beacon_reports: - id: becrpt_11111111111111 beacon_user_id: becusr_42cF1MNo42r9Xj created_at: '2020-07-24T03:26:02Z' type: first_party fraud_date: '1990-05-29' fraud_amount: iso_currency_code: USD value: 100 audit_trail: source: dashboard dashboard_user_id: 54350110fedcbaf01234ffee timestamp: '2020-07-24T03:26:02Z' next_cursor: eyJkaXJlY3Rpb24iOiJuZXh0Iiwib2Zmc2V0IjoiMTU5NDM request_id: saKrIBuEB9qJZng operationId: beaconReportList description: Use the `/beacon/report/list` endpoint to view all Beacon Reports you created for a specific Beacon User. The reports returned by this endpoint are exclusively reports you created for a specific user. A Beacon User can only have one active report at a time, but a new report can be created if a previous report has been deleted. The results from this endpoint are paginated; the `next_cursor` field will be populated if there is another page of results that can be retrieved. To fetch the next page, pass the `next_cursor` value as the `cursor` parameter in the next request. externalDocs: url: /api/products/beacon/#beaconreportlist servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /beacon/report_syndication/list: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid List Beacon Report Syndications for a Beacon User requestBody: content: application/json: schema: $ref: '#/components/schemas/BeaconReportSyndicationListRequest' required: true tags: - Plaid responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/BeaconReportSyndicationListResponse' examples: example-1: value: beacon_report_syndications: - id: becrsn_11111111111111 report: id: becrpt_11111111111111 created_at: '2020-07-24T03:26:02Z' type: first_party fraud_date: '1990-05-29' analysis: address: match date_of_birth: match email_address: match name: match id_number: match ip_address: match phone_number: match next_cursor: eyJkaXJlY3Rpb24iOiJuZXh0Iiwib2Zmc2V0IjoiMTU5NDM request_id: saKrIBuEB9qJZng operationId: beaconReportSyndicationList description: Use the `/beacon/report_syndication/list` endpoint to view all Beacon Reports that have been syndicated to a specific Beacon User. This endpoint returns Beacon Report Syndications which are references to Beacon Reports created either by you, or another Beacon customer, that matched the specified Beacon User. A Beacon User can have multiple active Beacon Report Syndications at once. The results from this endpoint are paginated; the `next_cursor` field will be populated if there is another page of results that can be retrieved. To fetch the next page, pass the `next_cursor` value as the `cursor` parameter in the next request. externalDocs: url: /api/products/beacon/#beaconreportsyndicationlist servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /beacon/report/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Get a Beacon Report requestBody: content: application/json: schema: $ref: '#/components/schemas/BeaconReportGetRequest' required: true tags: - Plaid responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/BeaconReportGetResponse' examples: example-1: value: id: becrpt_11111111111111 beacon_user_id: becusr_42cF1MNo42r9Xj created_at: '2020-07-24T03:26:02Z' type: first_party fraud_date: '1990-05-29' fraud_amount: iso_currency_code: USD value: 100 audit_trail: source: dashboard dashboard_user_id: 54350110fedcbaf01234ffee timestamp: '2020-07-24T03:26:02Z' request_id: saKrIBuEB9qJZng operationId: beaconReportGet description: Returns a Beacon report for a given Beacon report id. externalDocs: url: /api/products/beacon/#beaconreportget servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /beacon/report_syndication/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Get a Beacon Report Syndication requestBody: content: application/json: schema: $ref: '#/components/schemas/BeaconReportSyndicationGetRequest' required: true tags: - Plaid responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/BeaconReportSyndicationGetResponse' examples: example-1: value: id: becrsn_11111111111111 report: id: becrpt_11111111111111 created_at: '2020-07-24T03:26:02Z' type: first_party fraud_date: '1990-05-29' analysis: address: match date_of_birth: match email_address: match name: match id_number: match ip_address: match phone_number: match request_id: saKrIBuEB9qJZng operationId: beaconReportSyndicationGet description: Returns a Beacon Report Syndication for a given Beacon Report Syndication id. externalDocs: url: /api/products/beacon/#beaconreportsyndicationget servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /beacon/user/update: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Update the identity data of a Beacon User requestBody: content: application/json: schema: $ref: '#/components/schemas/BeaconUserUpdateRequest' required: true tags: - Plaid responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/BeaconUserUpdateResponse' examples: example-1: value: id: becusr_42cF1MNo42r9Xj version: 1 created_at: '2020-07-24T03:26:02Z' updated_at: '2020-07-24T03:26:02Z' status: cleared program_id: becprg_11111111111111 client_user_id: your-db-id-3b24110 user: date_of_birth: '1990-05-29' name: given_name: Leslie family_name: Knope address: street: 123 Main St. street2: Unit 42 city: Pawnee region: IN postal_code: '46001' country: US email_address: user@example.com phone_number: '+19876543212' id_number: value: '123456789' type: us_ssn ip_address: 192.0.2.42 audit_trail: source: dashboard dashboard_user_id: 54350110fedcbaf01234ffee timestamp: '2020-07-24T03:26:02Z' request_id: saKrIBuEB9qJZng operationId: beaconUserUpdate description: "Update the identity data for a Beacon User in your Beacon Program.\n\nSimilar to `/beacon/user/create`, several checks are performed immediately when you submit a change to `/beacon/user/update`:\n\n - The user's updated PII is searched against all other users within the Beacon Program you specified. If a match is found that violates your program's \"Duplicate Information Filtering\" settings, the user will be returned with a status of `pending_review`.\n\n - The user's updated PII is also searched against all fraud reports created by your organization across all of your Beacon Programs. If the user's data matches a fraud report that your team created, the user will be returned with a status of `rejected`.\n\n - Finally, the user's PII is searched against all fraud report shared with the Beacon Network by other companies. If a matching fraud report is found, the user will be returned with a `pending_review` status if your program has enabled automatic flagging based on network fraud.\n\nPlaid maintains a version history for each Beacon User, so the Beacon User's identity data before and after the update is retained as separate versions." externalDocs: url: /api/products/beacon/#beaconuserupdate servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /beacon/duplicate/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Get a Beacon Duplicate requestBody: content: application/json: schema: $ref: '#/components/schemas/BeaconDuplicateGetRequest' required: true tags: - Plaid responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/BeaconDuplicateGetResponse' examples: example-1: value: id: becdup_11111111111111 beacon_user1: id: becusr_42cF1MNo42r9Xj version: 1 beacon_user2: id: becusr_42cF1MNo42r9Xj version: 1 analysis: address: match date_of_birth: match email_address: match name: match id_number: match ip_address: match phone_number: match request_id: saKrIBuEB9qJZng operationId: beaconDuplicateGet description: 'Returns a Beacon Duplicate for a given Beacon Duplicate id. A Beacon Duplicate represents a pair of similar Beacon Users within your organization. Two Beacon User revisions are returned for each Duplicate record in either the `beacon_user1` or `beacon_user2` response fields. The `analysis` field in the response indicates which fields matched between `beacon_user1` and `beacon_user2`. ' externalDocs: url: /api/products/beacon/#beaconduplicateget servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /beacon/user/history/list: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid List a Beacon User's history requestBody: content: application/json: schema: $ref: '#/components/schemas/BeaconUserHistoryListRequest' required: true tags: - Plaid responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/BeaconUserHistoryListResponse' examples: example-1: value: beacon_users: - id: becusr_42cF1MNo42r9Xj version: 1 created_at: '2020-07-24T03:26:02Z' updated_at: '2020-07-24T03:26:02Z' status: cleared program_id: becprg_11111111111111 client_user_id: your-db-id-3b24110 user: date_of_birth: '1990-05-29' name: given_name: Leslie family_name: Knope address: street: 123 Main St. street2: Unit 42 city: Pawnee region: IN postal_code: '46001' country: US email_address: user@example.com phone_number: '+19876543212' id_number: value: '123456789' type: us_ssn ip_address: 192.0.2.42 audit_trail: source: dashboard dashboard_user_id: 54350110fedcbaf01234ffee timestamp: '2020-07-24T03:26:02Z' next_cursor: eyJkaXJlY3Rpb24iOiJuZXh0Iiwib2Zmc2V0IjoiMTU5NDM request_id: saKrIBuEB9qJZng operationId: beaconUserHistoryList description: List all changes to the Beacon User in reverse-chronological order. externalDocs: url: /api/products/beacon/#beaconuserhistorylist servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /beta/credit/v1/bank_employment/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Retrieve information from the bank accounts used for employment verification tags: - Plaid responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/CreditBankEmploymentGetResponse' examples: example-1: value: request_id: LhQf0THi8SH1yJm bank_employment_reports: - bank_employment_report_id: 0a7eaed6-5da7-4846-baaf-ad787306575e generated_time: '2023-01-23T22:47:53Z' days_requested: 90 items: - item_id: eVBnVMp7zdTJLkRNr33Rs6zr7KNJqBFL9DrE6 last_updated_time: '2023-01-23T22:47:53Z' institution_id: ins_0 institution_name: Plaid Bank bank_employments: - bank_employment_id: f17efbdd-caab-4278-8ece-963511cd3d51 account_id: GeooLPBGDEunl54q7N3ZcyD5aLPLEai1nkzM9 employer: name: Plaid Inc. latest_deposit_date: '2023-01-15' earliest_deposit_date: '2022-01-15' bank_employment_accounts: - account_id: GeooLPBGDEunl54q7N3ZcyD5aLPLEai1nkzM9 mask: '8888' name: Plaid Checking Account official_name: Plaid Checking Account type: depository subtype: checking owners: - addresses: - data: city: Malakoff country: US postal_code: '14236' region: NY street: 2992 Cameron Road primary: true - data: city: San Matias country: US postal_code: 93405-2255 region: CA street: 2493 Leisure Lane primary: false emails: - data: accountholder0@example.com primary: true type: primary - data: accountholder1@example.com primary: false type: secondary - data: extraordinarily.long.email.username.123456@reallylonghostname.com primary: false type: other names: - Alberta Bobbeth Charleson phone_numbers: - data: '1112223333' primary: false type: home - data: '1112224444' primary: false type: work - data: '1112225555' primary: false type: mobile warnings: [] externalDocs: url: /api/products/income/#creditbank_employmentget operationId: creditBankEmploymentGet description: '`/credit/bank_employment/get` returns the employment report(s) derived from bank transaction data for a specified user.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreditBankEmploymentGetRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /beta/transactions/v1/enhance: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid enhance locally-held transaction data operationId: transactionsEnhance responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/TransactionsEnhanceGetResponse' examples: example-1: value: enhanced_transactions: - id: 6135818adda16500147e7c1d description: Debit purchase Apple 1235 amount: 2307.21 iso_currency_code: USD enhancements: category: - Shops - Computers and Electronics category_id: '19013000' check_number: null counterparties: - name: Apple type: merchant logo_url: https://plaid-merchant-logos.plaid.com/apple_63.png website: apple.com confidence_level: VERY_HIGH phone_number: null location: address: 300 Post St city: San Francisco region: CA postal_code: '94108' country: US lat: 40.740352 lon: -74.001761 store_number: '1235' merchant_name: Apple website: apple.com logo_url: https://plaid-merchant-logos.plaid.com/apple_63.png payment_channel: in store personal_finance_category: primary: GENERAL_MERCHANDISE detailed: GENERAL_MERCHANDISE_ELECTRONICS personal_finance_category_icon_url: https://plaid-category-icons.plaid.com/PFC_GENERAL_MERCHANDISE.png phone_number: null default: content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Error response description: 'The `/beta/transactions/v1/enhance` endpoint enriches raw transaction data provided directly by clients. The product is currently in beta.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TransactionsEnhanceGetRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /beta/transactions/rules/v1/create: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Create transaction category rule operationId: transactionsRulesCreate responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/TransactionsRulesCreateResponse' examples: example-1: value: rule: id: lPNjeW1nR6CDn5okmGQ6hEpMo4lLNo item_id: wz666MBjYWTp2PDzzggYhM6oWWmBb created_at: '2022-02-28T11:00:00Z' personal_finance_category: FOOD_AND_DRINK_FAST_FOOD rule_details: field: NAME type: SUBSTRING_MATCH query: Burger Shack request_id: 4zlKapIkTm8p5KM default: content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Error response description: 'The `/transactions/rules/v1/create` endpoint creates transaction categorization rules. Rules will be applied on the Item''s transactions returned in `/transactions/get` response. The product is currently in beta. To request access, contact transactions-feedback@plaid.com.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TransactionsRulesCreateRequest' examples: example-1: value: client_id: 7f57eb3d2a9j6480121fx361 secret: 79g03eoofwl8240v776r2h667442119 access_token: access-sandbox-71e02f71-0960-4a27-abd2-5631e04f2175 personal_finance_category: FOOD_AND_DRINK_FAST_FOOD rule_details: field: NAME type: SUBSTRING_MATCH query: Burger Shack servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /beta/transactions/rules/v1/list: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Return a list of rules created for the Item associated with the access token. operationId: transactionsRulesList responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/TransactionsRulesListResponse' examples: example-1: value: rules: - id: lPNjeW1nR6CDn5okmGQ6hEpMo4lLNo item_id: wz666MBjYWTp2PDzzggYhM6oWWmBb created_at: '2022-02-28T11:00:00Z' personal_finance_category: FOOD_AND_DRINK_FAST_FOOD rule_details: field: NAME type: SUBSTRING_MATCH query: Burger Shack - id: eVBnVMp7zdTJLkRNr33Rs6zr7KNJqBF item_id: wz666MBjYWTp2PDzzggYhM6oWWmBb created_at: '2022-02-27T14:50:00Z' personal_finance_category: TRANSFER_IN_ACCOUNT_TRANSFER rule_details: field: TRANSACTION_ID type: EXACT_MATCH query: kgygNvAVPzSX9KkddNdWHaVGRVex1MHm3k9no request_id: 4zlKapIkTm8p5KM default: content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Error response description: The `/transactions/rules/v1/list` returns a list of transaction rules created for the Item associated with the access token. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TransactionsRulesListRequest' examples: example-1: value: client_id: 7f57eb3d2a9j6480121fx361 secret: 79g03eoofwl8240v776r2h667442119 access_token: access-sandbox-71e02f71-0960-4a27-abd2-5631e04f2175 servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /beta/transactions/rules/v1/remove: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Remove transaction rule operationId: transactionsRulesRemove responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/TransactionsRulesRemoveResponse' examples: example-1: value: request_id: 4zlKapIkTm8p5KM default: content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Error response description: The `/transactions/rules/v1/remove` endpoint is used to remove a transaction rule. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TransactionsRulesRemoveRequest' examples: example-1: value: client_id: 7f57eb3d2a9j6480121fx361 secret: 79g03eoofwl8240v776r2h667442119 access_token: access-sandbox-71e02f71-0960-4a27-abd2-5631e04f2175 rule_id: eVBnVMp7zdTJLkRNr33Rs6zr7KNJqBF servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /beta/transactions/user_insights/v1/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID x-hidden-from-docs: true post: tags: - Plaid summary: Plaid Obtain user insights based on transactions sent through /transactions/enrich x-hidden-from-docs: true externalDocs: url: /api/products/enrich/#userinsightsget operationId: transactionsUserInsightsGet responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/TransactionsUserInsightsGetResponse' examples: example-1: value: user_data_overview: transaction_count: 21 oldest_transaction_date: '2023-01-01' newest_transaction_date: '2023-01-31' days_available: 31 total_outflows: 1245.11 total_inflows: 2300.12 counterparty_insights: financial_institution_insights: - name: Chase entity_id: o2Ry34bq605MvmEed3yjqjkYWwqRQYpnkjd0O website: chase.com detected_accounts: - account_type: depository account_subtype: null transaction_count: 1 oldest_transaction_date: '2022-01-24' newest_transaction_date: '2023-01-05' newest_transaction_amount: 500 total_outflows: 503 total_inflows: 0 merchant_insights: - name: Costco entity_id: pBowAoZJMM9DKR37jvNmzM4yWBBXyMzV2rM3A website: costco.com personal_finance_category_primary: GENERAL_MERCHANDISE personal_finance_category_detailed: GENERAL_MERCHANDISE_SUPERSTORES transaction_count: 2 total_outflows: 953.46 total_inflows: 24.99 - name: PG&E entity_id: 6gEJJBrw8daLroaYgBAkpa65v9jVby69vejY0 website: pge.com personal_finance_category_primary: RENT_AND_UTILITIES personal_finance_category_detailed: RENT_AND_UTILITIES_GAS_AND_ELECTRICITY transaction_count: 1 total_outflows: 123.01 total_inflows: 0 category_insights: primary_category_insights: - name: GENERAL_MERCHANDISE transaction_count: 7 total_outflows: 1025.23 total_inflows: 24.99 top_counterparties: - Costco - name: RENT_AND_UTILITIES transaction_count: 1 total_outflows: 123.01 total_inflows: 0 top_counterparties: - PG&E detailed_category_insights: - name: GENERAL_MERCHANDISE_SUPERSTORES transaction_count: 3 total_outflows: 997.11 total_inflows: 24.99 top_counterparties: - Costco recurring_transactions: inflow_streams: - stream_id: yhnUVSIfe7SfeU0bcz8PDQr5ZUxUXebUvbKC0 description: Payroll * Plaid merchant_name: Plaid oldest_transaction_date: '2020-02-04' newest_transaction_date: '2023-08-02' average_days_apart: 7 frequency: WEEKLY transaction_count: 5 transaction_ids: - nkeaNrDGrhdo6c4qZWDA8ekuIPuJ4Avg5nKfw - EfC5ekksdy30KuNzad2tQupW8WIPwvjXGbGHL - ozfvj3FFgp6frbXKJGitsDzck5eWQH7zOJBYd - QvdDE8AqVWo3bkBZ7WvCd7LskxVix8Q74iMoK - uQozFPfMzibBouS9h9tz4CsyvFll17jKLdPAF average_amount: amount: 1000.91 iso_currency_code: USD unofficial_currency_code: null last_amount: amount: 1000 iso_currency_code: USD unofficial_currency_code: null is_active: true status: MATURE personal_finance_category_primary: INCOME personal_finance_category_detailed: INCOME_WAGES outflow_streams: - stream_id: no86Eox18VHMvaOVL7gPUM9ap3aR1LsAVZ5nd description: ConEd Bill Payment merchant_name: ConEd oldest_transaction_date: '2022-02-04' newest_transaction_date: '2022-05-02' average_days_apart: 29 frequency: MONTHLY transaction_count: 4 transaction_ids: - yhnUVvtcGGcCKU0bcz8PDQr5ZUxUXebUvbKC0 - HPDnUVgI5Pa0YQSl0rxwYRwVXeLyJXTWDAvpR - jEPoSfF8xzMClE9Ohj1he91QnvYoSdwg7IT8L - CmdQTNgems8BT1B7ibkoUXVPyAeehT3Tmzk0l average_amount: amount: 85 iso_currency_code: USD unofficial_currency_code: null last_amount: amount: 100 iso_currency_code: USD unofficial_currency_code: null is_active: true status: MATURE personal_finance_category_primary: RENT_AND_UTILITIES personal_finance_category_detailed: RENT_AND_UTILITIES_GAS_AND_ELECTRICITY default: content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Error response description: 'The `/beta/transactions/user_insights/v1/get` gets user insights for clients who have enriched data with `/transactions/enrich`. The product is currently in beta.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TransactionsUserInsightsGetRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /categories/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: security: [] tags: - Plaid summary: Plaid Get categories externalDocs: url: /api/products/transactions/#categoriesget operationId: categoriesGet description: 'Send a request to the `/categories/get` endpoint to get detailed information on categories returned by Plaid. This endpoint does not require authentication. All implementations are recommended to use the newer `personal_finance_category` taxonomy instead of the older `category` taxonomy supported by this endpoint. The [`personal_finance_category taxonomy` CSV file](https://plaid.com/documents/transactions-personal-finance-category-taxonomy.csv) is available for download and is not accessible via API.' responses: '200': description: success content: application/json: schema: $ref: '#/components/schemas/CategoriesGetResponse' examples: example-1: value: categories: - category_id: '10000000' group: special hierarchy: - Bank Fees - category_id: '10001000' group: special hierarchy: - Bank Fees - Overdraft - category_id: '12001000' group: place hierarchy: - Community - Animal Shelter request_id: ixTBLZGvhD4NnmB default: description: Error response. content: application/json: schema: $ref: '#/components/schemas/PlaidError' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CategoriesGetRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /cra/base_report/get: x-plaid-business-unit-context: BUSINESS_UNIT_CRA post: summary: Plaid Retrieve a Base Report tags: - Plaid operationId: baseReportGet x-hidden-from-docs: true externalDocs: url: /none/ requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/BaseReportGetRequest' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/BaseReportGetResponse' examples: example-1: value: report: report_id: 028e8404-a013-4a45-ac9e-002482f9cafc date_generated: '2023-03-30T18:27:37Z' days_requested: 5 items: - accounts: - balances: available: 43200 current: 43200 iso_currency_code: USD unofficial_currency_code: null limit: null days_available: 5 historical_balances: - current: 49050 date: '2023-03-29' iso_currency_code: USD unofficial_currency_code: null - current: 49050 date: '2023-03-28' iso_currency_code: USD unofficial_currency_code: null - current: 49050 date: '2023-03-27' iso_currency_code: USD unofficial_currency_code: null - current: 49050 date: '2023-03-26' iso_currency_code: USD unofficial_currency_code: null - current: 49050 date: '2023-03-25' iso_currency_code: USD unofficial_currency_code: null mask: '4444' name: Plaid Money Market official_name: Plaid Platinum Standard 1.85% Interest Money Market owners: - addresses: - data: city: Malakoff country: US region: NY street: 2992 Cameron Road postal_code: '14236' primary: true - data: city: San Matias country: US region: CA street: 2493 Leisure Lane postal_code: 93405-2255 primary: false emails: - data: accountholder0@example.com primary: true type: primary - data: accountholder1@example.com primary: false type: secondary - data: extraordinarily.long.email.username.123456@reallylonghostname.com primary: false type: other names: - Alberta Bobbeth Charleson phone_numbers: - data: '1112223333' primary: false type: home - data: '1112224444' primary: false type: work - data: '1112225555' primary: false type: mobile ownership_type: null subtype: money market transactions: - amount: 5850 date: '2023-03-30' iso_currency_code: USD original_description: ACH Electronic CreditGUSTO PAY 123456 pending: false unofficial_currency_code: null type: depository - balances: available: 100 current: 110 iso_currency_code: USD unofficial_currency_code: null limit: null days_available: 5 historical_balances: - current: 110 date: '2023-03-29' iso_currency_code: USD unofficial_currency_code: null - current: -390 date: '2023-03-28' iso_currency_code: USD unofficial_currency_code: null - current: -373.67 date: '2023-03-27' iso_currency_code: USD unofficial_currency_code: null - current: -284.27 date: '2023-03-26' iso_currency_code: USD unofficial_currency_code: null - current: -284.27 date: '2023-03-25' iso_currency_code: USD unofficial_currency_code: null mask: '0000' name: Plaid Checking official_name: Plaid Gold Standard 0% Interest Checking owners: - addresses: - data: city: Malakoff country: US region: NY street: 2992 Cameron Road postal_code: '14236' primary: true - data: city: San Matias country: US region: CA street: 2493 Leisure Lane postal_code: 93405-2255 primary: false emails: - data: accountholder0@example.com primary: true type: primary - data: accountholder1@example.com primary: false type: secondary - data: extraordinarily.long.email.username.123456@reallylonghostname.com primary: false type: other names: - Alberta Bobbeth Charleson phone_numbers: - data: '1112223333' primary: false type: home - data: '1112224444' primary: false type: work - data: '1112225555' primary: false type: mobile ownership_type: null subtype: checking transactions: - amount: 89.4 date: '2023-03-27' iso_currency_code: USD original_description: SparkFun pending: false unofficial_currency_code: null - amount: 12 date: '2023-03-28' iso_currency_code: USD original_description: 'McDonalds #3322' pending: false unofficial_currency_code: null - amount: 4.33 date: '2023-03-28' iso_currency_code: USD original_description: Starbucks pending: false unofficial_currency_code: null - amount: -500 date: '2023-03-29' iso_currency_code: USD original_description: United Airlines **** REFUND **** pending: false unofficial_currency_code: null type: depository date_last_updated: '2023-03-30T18:25:26Z' institution_id: ins_109508 institution_name: First Platypus Bank request_id: GVzMdiDd8DDAQK4 description: This endpoint allows the customer to retrieve a Base Report. Customers should pass in the `user_token` created in `/link/token/create`. servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /cra/base_report/create: x-plaid-business-unit-context: BUSINESS_UNIT_CRA post: summary: Plaid Create a Base Report tags: - Plaid operationId: baseReportCreate x-hidden-from-docs: true externalDocs: url: /none/ requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/BaseReportCreateRequest' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/BaseReportCreateResponse' examples: example-1: value: request_id: GVzMdiDd8DDAQK4 description: This endpoint allows the customer to create a Base Report by passing in a user token. The Base Report will be generated based on the most recently linked item from the user token. servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /cra/bank_income/get: x-plaid-business-unit-context: BUSINESS_UNIT_CRA post: summary: Plaid Retrieve information from the bank accounts used for income verification tags: - Plaid responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/CraBankIncomeGetResponse' examples: example-1: value: request_id: LhQf0THi8SH1yJm bank_income: - bank_income_id: abc123 generated_time: '2022-01-31T22:47:53Z' days_requested: 90 items: - last_updated_time: '2022-01-31T22:47:53Z' institution_id: ins_0 institution_name: Plaid Bank bank_income_accounts: - mask: '8888' name: Plaid Checking Account official_name: Plaid Checking Account type: depository subtype: checking owners: - addresses: - data: city: Malakoff country: US postal_code: '14236' region: NY street: 2992 Cameron Road primary: true - data: city: San Matias country: US postal_code: 93405-2255 region: CA street: 2493 Leisure Lane primary: false emails: - data: accountholder0@example.com primary: true type: primary - data: accountholder1@example.com primary: false type: secondary - data: extraordinarily.long.email.username.123456@reallylonghostname.com primary: false type: other names: - Alberta Bobbeth Charleson phone_numbers: - data: '1112223333' primary: false type: home - data: '1112224444' primary: false type: work - data: '1112225555' primary: false type: mobile bank_income_sources: - income_source_id: “f17efbdd-caab-4278-8ece-963511cd3d51” income_description: “PLAID_INC_DIRECT_DEP_PPD” income_category: SALARY start_date: '2021-11-15' end_date: '2022-01-15' pay_frequency: MONTHLY total_amount: 300 iso_currency_code: USD unofficial_currency_code: null transaction_count: 1 next_payment_date: '2022-12-15' historical_average_monthly_gross_income: 390 historical_average_monthly_income: 300 forecasted_average_monthly_income: 300 forecasted_average_monthly_income_prediction_intervals: - lower_bound: 200 upper_bound: 400 probability: 0.8 employer: name: Plaid Inc historical_summary: - start_date: '2021-11-02' end_date: '2021-11-30' total_amounts: - amount: 100 iso_currency_code: USD unofficial_currency_code: null transactions: - amount: -100 date: '2021-11-15' name: “PLAID_INC_DIRECT_DEP_PPD” original_description: PLAID_INC_DIRECT_DEP_PPD 123 pending: false check_number: null iso_currency_code: USD unofficial_currency_code: null - start_date: '2021-12-01' end_date: '2021-12-31' total_amounts: - amount: 100 iso_currency_code: USD unofficial_currency_code: null transactions: - amount: -100 date: '2021-12-15' name: “PLAID_INC_DIRECT_DEP_PPD” original_description: PLAID_INC_DIRECT_DEP_PPD 123 pending: false check_number: null iso_currency_code: USD unofficial_currency_code: null - start_date: '2022-01-01' end_date: '2022-01-31' total_amounts: - amount: 100 iso_currency_code: USD unofficial_currency_code: null transactions: - amount: -100 date: '2022-01-31' name: “PLAID_INC_DIRECT_DEP_PPD” original_description: PLAID_INC_DIRECT_DEP_PPD 123 pending: false check_number: null iso_currency_code: USD unofficial_currency_code: null bank_income_summary: total_amounts: - amount: 300 iso_currency_code: USD unofficial_currency_code: null start_date: '2021-11-15' end_date: '2022-01-15' income_sources_count: 1 income_categories_count: 1 income_transactions_count: 1 historical_average_monthly_gross_income: - amount: 390 iso_currency_code: USD unofficial_currency_code: null historical_average_monthly_income: - amount: 300 iso_currency_code: USD unofficial_currency_code: null forecasted_average_monthly_income: - amount: 300 iso_currency_code: USD unofficial_currency_code: null historical_annual_gross_income: - amount: 4680 iso_currency_code: USD unofficial_currency_code: null historical_annual_income: - amount: 3600 iso_currency_code: USD unofficial_currency_code: null forecasted_annual_income: - amount: 3600 iso_currency_code: USD unofficial_currency_code: null historical_summary: - start_date: '2021-11-02' end_date: '2021-11-30' total_amounts: - amount: 100 iso_currency_code: USD unofficial_currency_code: null transactions: - amount: -100 date: '2021-11-15' name: “PLAID_INC_DIRECT_DEP_PPD” original_description: PLAID_INC_DIRECT_DEP_PPD 123 pending: false check_number: null iso_currency_code: USD unofficial_currency_code: null - start_date: '2021-12-01' end_date: '2021-12-31' total_amounts: - amount: 100 iso_currency_code: USD unofficial_currency_code: null transactions: - amount: -100 date: '2021-12-15' name: “PLAID_INC_DIRECT_DEP_PPD” original_description: PLAID_INC_DIRECT_DEP_PPD 123 pending: false check_number: null iso_currency_code: USD unofficial_currency_code: null - start_date: '2022-01-01' end_date: '2022-01-31' total_amounts: - amount: 100 iso_currency_code: USD unofficial_currency_code: null transactions: - amount: -100 date: '2022-01-31' name: “PLAID_INC_DIRECT_DEP_PPD” original_description: PLAID_INC_DIRECT_DEP_PPD 123 pending: false check_number: null iso_currency_code: USD unofficial_currency_code: null warnings: [] externalDocs: url: /api/products/income/#crabank_incomeget operationId: craBankIncomeGet description: '`/cra/bank_income/get` returns the bank income report(s) for a specified user.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CraBankIncomeGetRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /cra/bank_income/create: x-plaid-business-unit-context: BUSINESS_UNIT_CRA post: summary: Plaid Create a CRA report for income verification tags: - Plaid responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/CraBankIncomeCreateResponse' examples: example-1: value: request_id: LhQf0THi8SH1yJm externalDocs: url: /api/products/income/#crabank_incomecreate operationId: craBankIncomeCreate description: '`/cra/bank_income/create` creates a CRA report for income verification' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CraBankIncomeCreateRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /cra/partner_insights/get: x-plaid-business-unit-context: BUSINESS_UNIT_CRA post: summary: Plaid Retrieve cash flow insights from the bank accounts used for income verification tags: - Plaid responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/CraPartnerInsightsGetResponse' examples: example-1: value: request_id: LhQf0THi8SH1yJm report: - report_id: abc123 generated_time: '2022-01-31T22:47:53Z' items: - institution_id: ins_0 institution_name: Plaid Bank item_id: ABC123 accounts: - mask: '8888' name: Plaid Checking Account official_name: Plaid Checking Account type: depository subtype: checking owners: - addresses: - data: city: Malakoff country: US postal_code: '14236' region: NY street: 2992 Cameron Road primary: true - data: city: San Matias country: US postal_code: 93405-2255 region: CA street: 2493 Leisure Lane primary: false emails: - data: accountholder0@example.com primary: true type: primary - data: accountholder1@example.com primary: false type: secondary - data: extraordinarily.long.email.username.123456@reallylonghostname.com primary: false type: other names: - Alberta Bobbeth Charleson phone_numbers: - data: '1112223333' primary: false type: home - data: '1112224444' primary: false type: work - data: '1112225555' primary: false type: mobile prism: insights: version: 3 result: l6m_cumbal_acc: 1 cash_score: version: 3 score: 900 reason_codes: - CASHFLOW_D11 metadata: max_age: 20 min_age: 1 min_age_credit: 0 min_age_debit: 1 max_age_debit: 20 max_age_credit: 0 num_trxn_credit: 0 num_trxn_debit: 40 l1m_credit_value_cnt: 0 l1m_debit_value_cnt: 40 detect: version: 3 score: 900 reason_codes: - CASHFLOW_D11 metadata: max_age: 20 min_age: 1 min_age_credit: 0 min_age_debit: 1 max_age_debit: 20 max_age_credit: 0 num_trxn_credit: 0 num_trxn_debit: 40 l1m_credit_value_cnt: 0 l1m_debit_value_cnt: 40 status: SUCCESS default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' externalDocs: url: /api/products/income/#crapartner_insightsget operationId: craPartnerInsightsGet description: '`/cra/partner_insights/get` returns cash flow insights for a specified user.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CraPartnerInsightsGetRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /cra/loans/applications/register: x-plaid-business-unit-context: BUSINESS_UNIT_CRA post: tags: - Plaid summary: Plaid Register loan applications and decisions. responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/CraLoansApplicationsRegisterResponse' examples: example-1: value: request_id: LhQf0THi8SH1yJm operationId: craLoansApplicationsRegister externalDocs: url: /none/ description: '`/cra/loans/applications/register` registers loan applications and decisions.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CraLoansApplicationsRegisterRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /cra/loans/register: x-plaid-business-unit-context: BUSINESS_UNIT_CRA post: tags: - Plaid summary: Plaid Register a list of loans to their applicants. responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/CraLoansRegisterResponse' examples: example-1: value: request_id: LhQf0THi8SH1yJm operationId: craLoansRegister externalDocs: url: /none/ description: '`/cra/loans/register` registers a list of loans to their applicants.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CRALoansRegisterRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /cra/loans/update: x-plaid-business-unit-context: BUSINESS_UNIT_CRA post: tags: - Plaid summary: Plaid Updates loan data. responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/CraLoansUpdateResponse' examples: example-1: value: request_id: LhQf0THi8SH1yJm operationId: craLoansUpdate externalDocs: url: /none/ description: '`/cra/loans/update` updates loan information such as the status and payment history.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CraLoansUpdateRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /cra/loans/unregister: x-plaid-business-unit-context: BUSINESS_UNIT_CRA post: tags: - Plaid summary: Plaid Unregister a list of loans. responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/CraLoanUnregisterResponse' examples: example-1: value: request_id: LhQf0THi8SH1yJm operationId: craLoansUnregister externalDocs: url: /none/ description: '`/cra/loans/unregister` indicates the loans have reached a final status and no further updates are expected.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CraLoansUnregisterRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /credit/audit_copy_token/update: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Update an Audit Copy Token externalDocs: url: /none/ responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/CreditAuditCopyTokenUpdateResponse' examples: example-1: value: request_id: eYupqX1mZkEuQRx updated: true operationId: creditAuditCopyTokenUpdate description: The `/credit/audit_copy_token/update` endpoint updates an existing Audit Copy Token by adding the report tokens in the `report_tokens` field to the `audit_copy_token`. If the Audit Copy Token already contains a report of a certain type, it will be replaced with the token provided in the `report_tokens` field. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreditAuditCopyTokenUpdateRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /credit/sessions/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Retrieve Link sessions for your user externalDocs: url: /api/products/income/#creditsessionsget operationId: creditSessionsGet responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/CreditSessionsGetResponse' examples: example-1: value: request_id: Aim3b sessions: - link_session_id: 356dbb28-7f98-44d1-8e6d-0cec580f3171 results: item_add_results: - public_token: public-sandbox-5c224a01-8314-4491-a06f-39e193d5cddc item_id: M5eVJqLnv3tbzdngLDp9FL5OlDNxlNhlE55op institution_id: ins_56 bank_income_results: - status: APPROVED item_id: M5eVJqLnv3tbzdngLDp9FL5OlDNxlNhlE55op institution_id: ins_56 session_start_time: '2022-09-30T23:40:30.946225Z' - link_session_id: f742cae8-31e4-49cc-a621-6cafbdb26fb9 results: payroll_income_results: - num_paystubs_retrieved: 2 num_w2s_retrieved: 1 institution_id: ins_92 session_start_time: '2022-09-26T23:40:30.946225Z' description: 'This endpoint can be used for your end users after they complete the Link flow. This endpoint returns a list of Link sessions that your user completed, where each session includes the results from the Link flow. These results include details about the Item that was created and some product related metadata (showing, for example, whether the user finished the bank income verification step).' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreditSessionsGetRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /credit/audit_copy_token/create: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Create Asset or Income Report Audit Copy Token externalDocs: url: /api/products/income/#creditaudit_copy_tokencreate responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/CreditAuditCopyTokenCreateResponse' examples: example-1: value: audit_copy_token: a-production-3tau2cwvybdvrhucaaai27ulu4 request_id: Iam3b operationId: creditAuditCopyTokenCreate description: 'Plaid can create an Audit Copy token of an Asset Report and/or Income Report to share with participating Government Sponsored Entity (GSE). If you participate in the Day 1 Certainty™ program, Plaid can supply an Audit Copy token directly to Fannie Mae on your behalf. An Audit Copy token contains the same underlying data as the Asset Report and/or Income Report (result of /credit/payroll_income/get). Use the `/credit/audit_copy_token/create` endpoint to create an `audit_copy_token` and then pass that token to the GSE who needs access.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreditAuditCopyTokenCreateRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /credit/audit_copy_token/remove: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Remove an Audit Copy token externalDocs: url: /api/products/income/#creditaudit_copy_tokenremove responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/CreditAuditCopyTokenRemoveResponse' examples: example-1: value: removed: true request_id: m8MDnv9okwxFNBV operationId: creditReportAuditCopyRemove requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreditAuditCopyTokenRemoveRequest' description: '' description: The `/credit/audit_copy_token/remove` endpoint allows you to remove an Audit Copy. Removing an Audit Copy invalidates the `audit_copy_token` associated with it, meaning both you and any third parties holding the token will no longer be able to use it to access Report data. Items associated with the Report data and other Audit Copies of it are not affected and will remain accessible after removing the given Audit Copy. servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /credit/freddie_mac/reports/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Retrieve an Asset Report with Freddie Mac format (aka VOA - Verification Of Assets), and a Verification Of Employment (VOE) report if this one is available. Only Freddie Mac can use this endpoint. externalDocs: url: /none/ responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/CreditFreddieMacReportsGetResponse' examples: example-1: value: SchemaVersion: 2.4 DEAL: LOANS: LOAN: LoanRoleType: SubjectLoan LOAN_IDENTIFIERS: LOAN_IDENTIFIER: - LoanIdentifier: '100016746' LoanIdentifierType: LenderLoan PARTIES: PARTY: - INDIVIDUAL: NAME: FirstName: John LastName: Deere MiddleName: S ROLES: ROLE: ROLE_DETAIL: PartyRoleType: Borrower TAXPAYER_IDENTIFIERS: TAXPAYER_IDENTIFIER: TaxpayerIdentifierType: SocialSecurityNumber TaxpayerIdentifierValue: 123-45-6789 SERVICES: SERVICE: VERIFICATION_OF_ASSET: - REPORTING_INFORMATION: ReportIdentifierType: ReportID ReportDateTime: '' ReportingInformationParentIdentifier: a-prod-kol4xb5y4nf2zecqalb2d55mze ReportingInformationIdentifier: assets-prod-20746587-2ad7-407f-a201-0669e1368cf7 SERVICE_PRODUCT_FULFILLMENT: SERVICE_PRODUCT_FULFILLMENT_DETAIL: VendorOrderIdentifier: PLAID ServiceProductFulfillmentIdentifier: VOE VERIFICATION_OF_ASSET_RESPONSE: ASSETS: ASSET: - ASSET_DETAIL: AssetAccountIdentifier: '3847' AssetUniqueIdentifier: c251a55e-c503-471b-a3b1-11a9243bc189 AssetAsOfDate: '2022-07-27' AssetDescription: Unlimited Cash Rewards Visa Signature AssetAvailableBalanceAmount: 0 AssetCurrentBalanceAmount: 0 AssetType: Other AssetTypeAdditionalDescription: credit card AssetDaysRequestedCount: 61 AssetOwnershipType: null ASSET_OWNERS: ASSET_OWNER: - AssetOwnerText: Alberta Bobbeth Charleson ASSET_HOLDER: NAME: FullName: Wells Fargo ASSET_TRANSACTIONS: ASSET_TRANSACTION: - ASSET_TRANSACTION_DETAIL: AssetTransactionCategoryType: Reimbursement AssetTransactionAmount: 0 AssetTransactionDate: '2022-07-28' AssetTransactionPostDate: '2022-07-28' AssetTransactionType: Credit AssetTransactionPaidByName: null AssetTransactionPaidToName: null AssetTransactionTypeAdditionalDescription: null AssetTransactionUniqueIdentifier: 8XQ2rJzjagxp87SJLNPKM8eMNJUgeeNnbg FinancialInstitutionTransactionIdentifier: null ASSET_TRANSACTION_DESCRIPTION: - AssetTransactionDescription: UNITED AIRLINES SAN FRANCISCOCA VALIDATION_SOURCES: VALIDATION_SOURCE: - ValidationSourceName: '' ValidationSourceReferenceIdentifier: '' - REPORTING_INFORMATION: ReportDateTime: '' ReportingInformationParentIdentifier: a-prod-kol4xb5y4nf2zecqalb2d55mze ReportingInformationIdentifier: assets-prod-20746587-2ad7-407f-a201-0669e1368cf7 ReportIdentifierType: ReportID SERVICE_PRODUCT_FULFILLMENT: SERVICE_PRODUCT_FULFILLMENT_DETAIL: VendorOrderIdentifier: PLAID ServiceProductFulfillmentIdentifier: VOA VERIFICATION_OF_ASSET_RESPONSE: ASSETS: ASSET: - ASSET_DETAIL: AssetAccountIdentifier: '3847' AssetUniqueIdentifier: c251a55e-c503-471b-a3b1-11a9243bc189 AssetAsOfDate: '2022-07-27' AssetDescription: Unlimited Cash Rewards Visa Signature AssetAvailableBalanceAmount: 2073.99 AssetCurrentBalanceAmount: 2007.09 AssetType: Other AssetTypeAdditionalDescription: credit card AssetDaysRequestedCount: 61 AssetOwnershipType: null ASSET_OWNERS: ASSET_OWNER: - AssetOwnerText: Alberta Bobbeth Charleson ASSET_HOLDER: NAME: FullName: Wells Fargo ASSET_TRANSACTIONS: ASSET_TRANSACTION: - ASSET_TRANSACTION_DETAIL: AssetTransactionUniqueIdentifier: 7jagxo9Eq6cXPKM8eMNJUgeeNnbgQdSDw6zgN AssetTransactionAmount: 34.43 AssetTransactionDate: '2022-07-19' AssetTransactionPostDate: '2022-07-19' AssetTransactionType: Debit AssetTransactionPaidByName: null AssetTransactionTypeAdditionalDescription: null AssetTransactionCategoryType: FoodDining FinancialInstitutionTransactionIdentifier: null ASSET_TRANSACTION_DESCRIPTION: - AssetTransactionDescription: TONYS PIZZA NAPOLETANA SAN FRANCISCOCA VALIDATION_SOURCES: VALIDATION_SOURCE: - ValidationSourceName: '' ValidationSourceReferenceIdentifier: '' STATUSES: STATUS: StatusCode: success StatusDescription: null request_id: eYupqX1mZkEuQRx operationId: creditFreddieMacReportsGet description: The `credit/asset_report/freddie_mac/get` endpoint retrieves the Verification of Assets and Verification of Employment reports. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreditFreddieMacReportsGetRequest' description: '' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /credit/bank_income/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Retrieve information from the bank accounts used for income verification tags: - Plaid responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/CreditBankIncomeGetResponse' examples: example-1: value: request_id: LhQf0THi8SH1yJm bank_income: - bank_income_id: abc123 generated_time: '2022-01-31T22:47:53Z' days_requested: 90 items: - last_updated_time: '2022-01-31T22:47:53Z' institution_id: ins_0 institution_name: Plaid Bank item_id: “eVBnVMp7zdTJLkRNr33Rs6zr7KNJqBFL9DrE6” bank_income_accounts: - account_id: “GeooLPBGDEunl54q7N3ZcyD5aLPLEai1nkzM9” mask: '8888' name: Plaid Checking Account official_name: Plaid Checking Account type: depository subtype: checking owners: - addresses: - data: city: Malakoff country: US postal_code: '14236' region: NY street: 2992 Cameron Road primary: true - data: city: San Matias country: US postal_code: 93405-2255 region: CA street: 2493 Leisure Lane primary: false emails: - data: accountholder0@example.com primary: true type: primary - data: accountholder1@example.com primary: false type: secondary - data: extraordinarily.long.email.username.123456@reallylonghostname.com primary: false type: other names: - Alberta Bobbeth Charleson phone_numbers: - data: '1112223333' primary: false type: home - data: '1112224444' primary: false type: work - data: '1112225555' primary: false type: mobile bank_income_sources: - account_id: GeooLPBGDEunl54q7N3ZcyD5aLPLEai1nkzM9 income_source_id: “f17efbdd-caab-4278-8ece-963511cd3d51” income_description: “PLAID_INC_DIRECT_DEP_PPD” income_category: SALARY start_date: '2021-11-15' end_date: '2022-01-15' pay_frequency: MONTHLY total_amount: 300 transaction_count: 1 historical_summary: - start_date: '2021-11-02' end_date: '2021-11-30' total_amount: 100 iso_currency_code: USD unofficial_currency_code: null total_amounts: - amount: 100 iso_currency_code: USD unofficial_currency_code: null transactions: - amount: -100 date: '2021-11-15' name: “PLAID_INC_DIRECT_DEP_PPD” original_description: PLAID_INC_DIRECT_DEP_PPD 123 pending: false transaction_id: 6RddrWNwE1uM63Ex5GKLhzlBl76aAZfgzlQNm check_number: null iso_currency_code: USD unofficial_currency_code: null - start_date: '2021-12-01' end_date: '2021-12-31' total_amount: 100 iso_currency_code: USD unofficial_currency_code: null total_amounts: - amount: 100 iso_currency_code: USD unofficial_currency_code: null transactions: - amount: -100 date: '2021-12-15' name: “PLAID_INC_DIRECT_DEP_PPD” original_description: PLAID_INC_DIRECT_DEP_PPD 123 pending: false transaction_id: 7BddrWNwE1uM63Ex5GKLhzlBl82aAZfgzlCBl check_number: null iso_currency_code: USD unofficial_currency_code: null - start_date: '2022-01-01' end_date: '2021-01-31' total_amount: 100 iso_currency_code: USD unofficial_currency_code: null total_amounts: - amount: 100 iso_currency_code: USD unofficial_currency_code: null transactions: - amount: -100 date: '2022-01-31' name: “PLAID_INC_DIRECT_DEP_PPD” original_description: PLAID_INC_DIRECT_DEP_PPD 123 pending: false transaction_id: 9FddrWNwE1uM95Ex5GKLhzlBl76aAZfgzlNQr check_number: null iso_currency_code: USD unofficial_currency_code: null bank_income_summary: total_amount: 300 iso_currency_code: USD unofficial_currency_code: null total_amounts: - amount: 300 iso_currency_code: USD unofficial_currency_code: null start_date: '2021-11-15' end_date: '2022-01-15' income_sources_count: 1 income_categories_count: 1 income_transactions_count: 1 historical_summary: - start_date: '2021-11-02' end_date: '2021-11-30' total_amount: 100 iso_currency_code: USD unofficial_currency_code: null total_amounts: - amount: 100 iso_currency_code: USD unofficial_currency_code: null transactions: - amount: -100 date: '2021-11-15' name: “PLAID_INC_DIRECT_DEP_PPD” original_description: PLAID_INC_DIRECT_DEP_PPD 123 pending: false transaction_id: 6RddrWNwE1uM63Ex5GKLhzlBl76aAZfgzlQNm check_number: null iso_currency_code: USD unofficial_currency_code: null - start_date: '2021-12-01' end_date: '2021-12-31' total_amount: 100 iso_currency_code: USD unofficial_currency_code: null total_amounts: - amount: 100 iso_currency_code: USD unofficial_currency_code: null transactions: - amount: -100 date: '2021-12-15' name: “PLAID_INC_DIRECT_DEP_PPD” original_description: PLAID_INC_DIRECT_DEP_PPD 123 pending: false transaction_id: 7BddrWNwE1uM63Ex5GKLhzlBl82aAZfgzlCBl check_number: null iso_currency_code: USD unofficial_currency_code: null - start_date: '2022-01-01' end_date: '2021-01-31' total_amount: 100 iso_currency_code: USD unofficial_currency_code: null total_amounts: - amount: 100 iso_currency_code: USD unofficial_currency_code: null transactions: - amount: -100 date: '2022-01-31' name: “PLAID_INC_DIRECT_DEP_PPD” original_description: PLAID_INC_DIRECT_DEP_PPD 123 pending: false transaction_id: 9FddrWNwE1uM95Ex5GKLhzlBl76aAZfgzlNQr check_number: null iso_currency_code: USD unofficial_currency_code: null warnings: [] externalDocs: url: /api/products/income/#creditbank_incomeget operationId: creditBankIncomeGet description: '`/credit/bank_income/get` returns the bank income report(s) for a specified user.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreditBankIncomeGetRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /credit/bank_income/pdf/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Retrieve information from the bank accounts used for income verification in PDF format tags: - Plaid responses: '200': description: A PDF of the Bank Income Report content: application/pdf: schema: $ref: '#/components/schemas/CreditBankIncomePDFGetResponse' externalDocs: url: /api/products/income/#creditbank_incomepdfget operationId: creditBankIncomePdfGet description: '`/credit/bank_income/pdf/get` returns the most recent bank income report for a specified user in PDF format.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreditBankIncomePDFGetRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /credit/bank_income/refresh: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Refresh a user's bank income information tags: - Plaid externalDocs: url: /api/products/income/#creditbank_incomerefresh operationId: creditBankIncomeRefresh description: '`/credit/bank_income/refresh` refreshes the bank income report data for a specific user.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreditBankIncomeRefreshRequest' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/CreditBankIncomeRefreshResponse' examples: example-1: value: request_id: LhQf0THi8SH1yJm servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /credit/bank_income/webhook/update: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Subscribe and unsubscribe to proactive notifications for a user's income profile tags: - Plaid externalDocs: url: /api/products/income/#creditbank_incomewebhookupdate operationId: creditBankIncomeWebhookUpdate description: '`/credit/bank_income/webhook/update` allows you to subscribe or unsubscribe a user for income webhook notifications. By default, all users start out unsubscribed. If a user is subscribed, on significant changes to the user''s income profile, you will receive a `BANK_INCOME_REFRESH_UPDATE` webhook, prompting you to refresh bank income data for the user.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreditBankIncomeWebhookUpdateRequest' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/CreditBankIncomeWebhookUpdateResponse' examples: example-1: value: request_id: LhQf0THi8SH1yJm servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /credit/payroll_income/parsing_config/update: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Update the parsing configuration for a document income verification tags: - Plaid externalDocs: url: /api/products/income/#creditpayroll_incomeparsing_configupdate operationId: creditPayrollIncomeParsingConfigUpdate description: '`/credit/payroll_income/parsing_config/update` updates the parsing configuration for a document income verification.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreditPayrollIncomeParsingConfigUpdateRequest' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/CreditPayrollIncomeParsingConfigUpdateResponse' examples: example-1: value: request_id: LhQf0THi8SH1yJm servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /credit/bank_statements/uploads/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Retrieve data for a user's uploaded bank statements tags: - Plaid responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/CreditBankStatementsUploadsGetResponse' examples: example-1: value: items: - item_id: eVBnVMp7zdTJLkRNr33Rs6zr7KNJqBFL9DrE6 bank_statements: - transactions: - amount: -1000 date: '2023-01-01' original_description: PAYCHECK account_id: c6778d3f-e44c-4348-874e-71507c1ac12d document_metadata: document_type: BANK_STATEMENT name: statement_01.pdf status: PROCESSING_COMPLETE download_url: null page_count: 2 document_id: 2jkflanbd bank_accounts: - name: CHASE CHECKING bank_name: CHASE account_type: CHECKING account_number: 000009752 account_id: c6778d3f-e44c-4348-874e-71507c1ac12d owner: name: JANE DOE address: postal_code: '94133' country: US region: CA city: SAN FRANCISCO street: 2140 TAYLOR ST periods: - start_date: '2023-01-01' end_date: '2023-02-01' starting_balance: 2500 ending_balance: 3500 status: processing_status: PROCESSING_COMPLETE updated_at: '2023-02-01T21:14:54Z' request_id: LhQf0THi8SH1yJm default: description: Error response. content: application/json: schema: $ref: '#/components/schemas/PlaidError' externalDocs: url: /api/products/income/#creditbank_statementsuploadsget operationId: creditBankStatementsUploadsGet description: '`/credit/bank_statements/uploads/get` returns parsed data from bank statements uploaded by users as part of the Document Income flow. If your account is not enabled for Document Parsing, contact your account manager to request access.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreditBankStatementsUploadsGetRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /credit/payroll_income/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Retrieve a user's payroll information tags: - Plaid externalDocs: url: /api/products/income/#creditpayroll_incomeget operationId: creditPayrollIncomeGet description: This endpoint gets payroll income information for a specific user, either as a result of the user connecting to their payroll provider or uploading a pay related document. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreditPayrollIncomeGetRequest' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/CreditPayrollIncomeGetResponse' examples: example-1: value: items: - item_id: eVBnVMp7zdTJLkRNr33Rs6zr7KNJqBFL9DrE6 institution_id: ins_92 institution_name: ADP accounts: - account_id: GeooLPBGDEunl54q7N3ZcyD5aLPLEai1nkzM9 rate_of_pay: pay_amount: 100000 pay_rate: ANNUAL pay_frequency: BIWEEKLY payroll_income: - account_id: GeooLPBGDEunl54q7N3ZcyD5aLPLEai1nkzM9 pay_stubs: - deductions: breakdown: - current_amount: 123.45 description: taxes iso_currency_code: USD unofficial_currency_code: null ytd_amount: 246.9 total: current_amount: 123.45 iso_currency_code: USD unofficial_currency_code: null ytd_amount: 246.9 document_metadata: document_type: PAYSTUB name: paystub.pdf status: PROCESSING_COMPLETE download_url: null document_id: 2jkflanbd earnings: breakdown: - canonical_description: REGULAR_PAY current_amount: 200.22 description: salary earned hours: 80 iso_currency_code: USD rate: null unofficial_currency_code: null ytd_amount: 400.44 - canonical_description: BONUS current_amount: 100 description: bonus earned hours: null iso_currency_code: USD rate: null unofficial_currency_code: null ytd_amount: 100 total: current_amount: 300.22 hours: 160 iso_currency_code: USD unofficial_currency_code: null ytd_amount: 500.44 employee: address: city: SAN FRANCISCO country: US postal_code: '94133' region: CA street: 2140 TAYLOR ST name: ANNA CHARLESTON marital_status: SINGLE taxpayer_id: id_type: SSN id_mask: '3333' employer: name: PLAID INC address: city: SAN FRANCISCO country: US postal_code: '94111' region: CA street: 1098 HARRISON ST net_pay: current_amount: 123.34 description: TOTAL NET PAY iso_currency_code: USD unofficial_currency_code: null ytd_amount: 253.54 pay_period_details: distribution_breakdown: - account_name: Big time checking bank_name: bank of plaid current_amount: 176.77 iso_currency_code: USD mask: '1223' type: checking unofficial_currency_code: null end_date: '2020-12-15' gross_earnings: 4500 iso_currency_code: USD pay_amount: 1490.21 pay_date: '2020-12-15' pay_frequency: BIWEEKLY start_date: '2020-12-01' unofficial_currency_code: null w2s: - allocated_tips: '1000' box_12: - amount: '200' code: AA box_9: box9 dependent_care_benefits: '1000' document_metadata: document_type: US_TAX_W2 download_url: null name: w_2.pdf status: PROCESSING_COMPLETE document_id: 1pkflebk4 employee: address: city: San Francisco country: US postal_code: '94103' region: CA street: 1234 Grand St name: Josie Georgia Harrison marital_status: SINGLE taxpayer_id: id_type: SSN id_mask: '1234' employer: address: city: New York country: US postal_code: '10010' region: NY street: 456 Main St name: Acme Inc employer_id_number: 12-1234567 federal_income_tax_withheld: '1000' medicare_tax_withheld: '1000' medicare_wages_and_tips: '1000' nonqualified_plans: '1000' other: other retirement_plan: CHECKED social_security_tax_withheld: '1000' social_security_tips: '1000' social_security_wages: '1000' state_and_local_wages: - employer_state_id_number: 11111111111AAA local_income_tax: '200' local_wages_and_tips: '200' locality_name: local state: UT state_income_tax: '200' state_wages_tips: '200' statutory_employee: CHECKED tax_year: '2020' third_party_sick_pay: CHECKED wages_tips_other_comp: '1000' form1099s: - april_amount: null august_amount: null card_not_present_transaction: null crop_insurance_proceeds: 1000 december_amount: null document_id: mvMZ59Z2a5 document_metadata: document_type: US_TAX_1099_MISC download_url: null name: form_1099_misc.pdf status: PROCESSING_COMPLETE excess_golden_parachute_payments: 1000 feburary_amount: null federal_income_tax_withheld: 1000 filer: address: city: null country: null postal_code: null region: null street: null name: null tin: null type: null fishing_boat_proceeds: 1000 form_1099_type: FORM_1099_TYPE_MISC gross_amount: 1000 gross_proceeds_paid_to_an_attorney: 1000 january_amount: null july_amount: null june_amount: null march_amount: null may_amount: null medical_and_healthcare_payments: 1000 merchant_category_code: null nonemployee_compensation: 1000 november_amount: null number_of_payment_transactions: null october_amount: null other_income: 1000 payer: address: city: SAN FRANCISCO country: US postal_code: '94111' region: CA street: 1098 HARRISON ST name: PLAID INC telephone_number: (123)456-7890 tin: 12-3456789 payer_made_direct_sales_of_500_or_more_of_consumer_products_to_buyer: null payer_state_number: CA 12345 payer_state_number_lower: null primary_state: null primary_state_id: CA 12345 primary_state_income_tax: 1000 pse_name: null pse_telephone_number: null recipient: account_number: '45678' address: city: SAN FRANCISCO country: US postal_code: '94133' region: CA street: 2140 TAYLOR ST facta_filing_requirement: CHECKED name: Josie Georgia Harrison second_tin_exists: NOT CHECKED tin: 12-3456789 rents: 1000 royalties: 1000 secondary_state: null secondary_state_id: null secondary_state_income_tax: null section_409a_deferrals: 1000 section_409a_income: 1000 september_amount: null state_income: 1000 state_income_lower: null state_tax_withheld: 1000 state_tax_withheld_lower: null substitute_payments_in_lieu_of_dividends_or_interest: null tax_year: '2022' transactions_reported: null status: processing_status: PROCESSING_COMPLETE updated_at: '2022-08-02T21:14:54Z' request_id: 2pxQ59buGdsHRef servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /credit/payroll_income/risk_signals/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Retrieve fraud insights for a user's manually uploaded document(s). tags: - Plaid externalDocs: url: /api/products/income/#creditpayroll_incomerisk_signalsget operationId: creditPayrollIncomeRiskSignalsGet description: '`/credit/payroll_income/risk_signals/get` can be used as part of the Document Income flow to assess a user-uploaded document for signs of potential fraud or tampering. It returns a risk score for each uploaded document that indicates the likelihood of the document being fraudulent, in addition to details on the individual risk signals contributing to the score. To trigger risk signal generation for an Item, call `/link/token/create` with `parsing_config` set to include `risk_signals`, or call `/credit/payroll_income/parsing_config/update`. Once risk signal generation has been triggered, `/credit/payroll_income/risk_signals/get` can be called at any time after the `INCOME_VERIFICATION_RISK_SIGNALS` webhook has been fired. `/credit/payroll_income/risk_signals/get` is offered as an add-on to Document Income and is billed separately. To request access to this endpoint, submit a product access request or contact your Plaid account manager.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreditPayrollIncomeRiskSignalsGetRequest' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/CreditPayrollIncomeRiskSignalsGetResponse' examples: example-1: value: items: - item_id: testItemID verification_risk_signals: - account_id: null multi_document_risk_signals: [] single_document_risk_signals: - document_reference: document_id: lRepoQjxlJ1nz document_name: Paystub.pdf risk_summary: risk_score: 70 risk_signals: - actual_value: '0.00' expected_value: '25.09' field: null signal_description: null has_fraud_risk: true type: MASKING page_number: 1 institution_metadata: item_id: testItemID - actual_value: null expected_value: null field: null signal_description: Creation date and modification date do not match has_fraud_risk: true institution_metadata: null type: METADATA_DATES_OUTSIDE_WINDOW page_number: 0 request_id: LhQf0THi8SH1yJm servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /credit/payroll_income/precheck: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: deprecated: true summary: Plaid Check income verification eligibility and optimize conversion tags: - Plaid operationId: creditPayrollIncomePrecheck externalDocs: url: /api/products/income/#creditpayroll_incomeprecheck responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/CreditPayrollIncomePrecheckResponse' examples: example-1: value: request_id: lMjeOeu9X1VUh1F confidence: HIGH description: '`/credit/payroll_income/precheck` is an optional endpoint that can be called before initializing a Link session for income verification. It evaluates whether a given user is supportable by digital income verification. If the user is eligible for digital verification, that information will be associated with the user token, and in this way will generate a Link UI optimized for the end user and their specific employer. If the user cannot be confirmed as eligible, the user can still use the income verification flow, but they may be required to manually upload a paystub to verify their income. While all request fields are optional, providing `employer` data will increase the chance of receiving a useful result. When testing in Sandbox, you can control the results by providing special test values in the `employer` and `access_tokens` fields. `employer_good` and `employer_bad` will result in `HIGH` and `LOW` confidence values, respectively. `employer_multi` will result in a `HIGH` confidence with multiple payroll options. Likewise, `access_good` and `access_bad` will result in `HIGH` and `LOW` confidence values, respectively. Any other value for `employer` and `access_tokens` in Sandbox will result in `UNKNOWN` confidence.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreditPayrollIncomePrecheckRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /credit/employment/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Retrieve a summary of an individual's employment information tags: - Plaid operationId: creditEmploymentGet externalDocs: url: /api/products/income/#creditemploymentget responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/CreditEmploymentGetResponse' examples: example-1: value: items: - item_id: eVBnVMp7zdTJLkRNr33Rs6zr7KNJqBFL9DrE6 employments: - account_id: GeooLPBGDEunl54q7N3ZcyD5aLPLEai1nkzM9 status: ACTIVE start_date: '2020-01-01' end_date: null employer: name: Plaid Inc title: Software Engineer platform_ids: employee_id: '1234567' position_id: '8888' payroll_id: '1234567' employee_type: FULL_TIME last_paystub_date: '2022-01-15' request_id: LhQf0THi8SH1yJm description: '`/credit/employment/get` returns a list of items with employment information from a user''s payroll provider that was verified by an end user.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreditEmploymentGetRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /credit/payroll_income/refresh: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Refresh a digital payroll income verification externalDocs: url: /api/products/income/#creditpayroll_incomerefresh operationId: creditPayrollIncomeRefresh description: '`/credit/payroll_income/refresh` refreshes a given digital payroll income verification.' responses: '200': description: success content: application/json: schema: $ref: '#/components/schemas/CreditPayrollIncomeRefreshResponse' examples: example-1: value: request_id: nTkbCH41HYmpbm5 verification_refresh_status: USER_PRESENCE_REQUIRED default: description: Error response. content: application/json: schema: $ref: '#/components/schemas/PlaidError' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreditPayrollIncomeRefreshRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /credit/relay/create: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Create a relay token to share an Asset Report with a partner client tags: - Plaid operationId: creditRelayCreate externalDocs: url: /api/products/assets/#creditrelaycreate requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreditRelayCreateRequest' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/CreditRelayCreateResponse' examples: example-1: value: relay_token: credit-relay-production-3TAU2CWVYBDVRHUCAAAI27ULU4 request_id: Iam3b description: 'Plaid can share an Asset Report directly with a participating third party on your behalf. The shared Asset Report is the exact same Asset Report originally created in `/asset_report/create`. To grant a third party access to an Asset Report, use the `/credit/relay/create` endpoint to create a `relay_token` and then pass that token to your third party. Each third party has its own `secondary_client_id`; for example, `ce5bd328dcd34123456`. You''ll need to create a separate `relay_token` for each third party that needs access to the report on your behalf.' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /credit/relay/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Retrieve the reports associated with a relay token that was shared with you tags: - Plaid operationId: creditRelayGet externalDocs: url: /api/products/assets/#creditrelayget requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreditRelayGetRequest' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AssetReportGetResponse' examples: example-1: value: report: asset_report_id: 028e8404-a013-4a45-ac9e-002482f9cafc client_report_id: client_report_id_1221 date_generated: '2023-03-30T18:27:37Z' days_requested: 5 items: - accounts: - account_id: 1qKRXQjk8xUWDJojNwPXTj8gEmR48piqRNye8 balances: available: 43200 current: 43200 limit: null margin_loan_amount: null iso_currency_code: USD unofficial_currency_code: null days_available: 5 historical_balances: - current: 49050 date: '2023-03-29' iso_currency_code: USD unofficial_currency_code: null - current: 49050 date: '2023-03-28' iso_currency_code: USD unofficial_currency_code: null - current: 49050 date: '2023-03-27' iso_currency_code: USD unofficial_currency_code: null - current: 49050 date: '2023-03-26' iso_currency_code: USD unofficial_currency_code: null - current: 49050 date: '2023-03-25' iso_currency_code: USD unofficial_currency_code: null mask: '4444' name: Plaid Money Market official_name: Plaid Platinum Standard 1.85% Interest Money Market owners: - addresses: - data: city: Malakoff country: US region: NY street: 2992 Cameron Road postal_code: '14236' primary: true - data: city: San Matias country: US region: CA street: 2493 Leisure Lane postal_code: 93405-2255 primary: false emails: - data: accountholder0@example.com primary: true type: primary - data: accountholder1@example.com primary: false type: secondary - data: extraordinarily.long.email.username.123456@reallylonghostname.com primary: false type: other names: - Alberta Bobbeth Charleson phone_numbers: - data: '1112223333' primary: false type: home - data: '1112224444' primary: false type: work - data: '1112225555' primary: false type: mobile ownership_type: null subtype: money market transactions: - account_id: 1qKRXQjk8xUWDJojNwPXTj8gEmR48piqRNye8 amount: 5850 date: '2023-03-30' iso_currency_code: USD original_description: ACH Electronic CreditGUSTO PAY 123456 pending: false transaction_id: gGQgjoeyqBF89PND6K14Sow1wddZBmtLomJ78 unofficial_currency_code: null type: depository - account_id: eG7pNLjknrFpWvP7Dkbdf3Pq6GVBPKTaQJK5v balances: available: 100 current: 110 limit: null margin_loan_amount: null iso_currency_code: USD unofficial_currency_code: null days_available: 5 historical_balances: - current: 110 date: '2023-03-29' iso_currency_code: USD unofficial_currency_code: null - current: -390 date: '2023-03-28' iso_currency_code: USD unofficial_currency_code: null - current: -373.67 date: '2023-03-27' iso_currency_code: USD unofficial_currency_code: null - current: -284.27 date: '2023-03-26' iso_currency_code: USD unofficial_currency_code: null - current: -284.27 date: '2023-03-25' iso_currency_code: USD unofficial_currency_code: null mask: '0000' name: Plaid Checking official_name: Plaid Gold Standard 0% Interest Checking owners: - addresses: - data: city: Malakoff country: US region: NY street: 2992 Cameron Road postal_code: '14236' primary: true - data: city: San Matias country: US region: CA street: 2493 Leisure Lane postal_code: 93405-2255 primary: false emails: - data: accountholder0@example.com primary: true type: primary - data: accountholder1@example.com primary: false type: secondary - data: extraordinarily.long.email.username.123456@reallylonghostname.com primary: false type: other names: - Alberta Bobbeth Charleson phone_numbers: - data: '1112223333' primary: false type: home - data: '1112224444' primary: false type: work - data: '1112225555' primary: false type: mobile ownership_type: null subtype: checking transactions: - account_id: eG7pNLjknrFpWvP7Dkbdf3Pq6GVBPKTaQJK5v amount: 89.4 date: '2023-03-27' iso_currency_code: USD original_description: SparkFun pending: false transaction_id: 4zBRq1Qem4uAPnoyKjJNTRQpQddM4ztlo1PLD unofficial_currency_code: null - account_id: eG7pNLjknrFpWvP7Dkbdf3Pq6GVBPKTaQJK5v amount: 12 date: '2023-03-28' iso_currency_code: USD original_description: 'McDonalds #3322' pending: false transaction_id: dkjL41PnbKsPral79jpxhMWdW55gkPfBkWpRL unofficial_currency_code: null - account_id: eG7pNLjknrFpWvP7Dkbdf3Pq6GVBPKTaQJK5v amount: 4.33 date: '2023-03-28' iso_currency_code: USD original_description: Starbucks pending: false transaction_id: a84ZxQaWDAtDL3dRgmazT57K7jjN3WFkNWMDy unofficial_currency_code: null - account_id: eG7pNLjknrFpWvP7Dkbdf3Pq6GVBPKTaQJK5v amount: -500 date: '2023-03-29' iso_currency_code: USD original_description: United Airlines **** REFUND **** pending: false transaction_id: xG9jbv3eMoFWepzB7wQLT3LoLggX5Duy1Gbe5 unofficial_currency_code: null type: depository date_last_updated: '2023-03-30T18:25:26Z' institution_id: ins_109508 institution_name: First Platypus Bank item_id: AZMP7JrGXgtPd3AQMeg7hwMKgk5E8qU1V5ME7 user: client_user_id: uid_40332 email: abcharleston@example.com first_name: Anna last_name: Charleston middle_name: B phone_number: 1-415-867-5309 ssn: 111-22-1234 request_id: GVzMdiDd8DDAQK4 warnings: [] description: '`/credit/relay/get` allows third parties to receive a report that was shared with them, using a `relay_token` that was created by the report owner.' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /credit/relay/pdf/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Retrieve the pdf reports associated with a relay token that was shared with you (beta) tags: - Plaid responses: '200': description: A PDF of the Asset Report content: application/pdf: schema: $ref: '#/components/schemas/CreditRelayPDFGetResponse' operationId: creditRelayPdfGet externalDocs: url: /api/products/assets/#creditrelaypdfget requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreditRelayPDFGetRequest' description: '`/credit/relay/pdf/get` allows third parties to receive a pdf report that was shared with them, using a `relay_token` that was created by the report owner. The `/credit/relay/pdf/get` endpoint retrieves the Asset Report in PDF format. Before calling `/credit/relay/pdf/get`, you must first create the Asset Report using `/credit/relay/create` and then wait for the [`PRODUCT_READY`](https://plaid.com/docs/api/products/assets/#product_ready) webhook to fire, indicating that the Report is ready to be retrieved. The response to `/credit/relay/pdf/get` is the PDF binary data. The `request_id` is returned in the `Plaid-Request-ID` header. [View a sample PDF Asset Report](https://plaid.com/documents/sample-asset-report.pdf).' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /credit/relay/refresh: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Refresh a report of a relay token externalDocs: url: /api/products/assets/#creditrelayrefresh responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/CreditRelayRefreshResponse' examples: example-1: value: relay_token: credit-relay-sandbox-8218d5f8-6d6d-403d-92f5-13a9afaa4398 request_id: NBZaq asset_report_id: bf3a0490-344c-4620-a219-2693162e4b1d operationId: creditRelayRefresh description: The `/credit/relay/refresh` endpoint allows third parties to refresh a report that was relayed to them, using a `relay_token` that was created by the report owner. A new report will be created with the original report parameters, but with the most recent data available based on the `days_requested` value of the original report. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreditRelayRefreshRequest' description: '' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /credit/relay/remove: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Remove relay token externalDocs: url: /api/products/assets/#creditrelayremove responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/CreditRelayRemoveResponse' examples: example-1: value: removed: true request_id: m8MDnv9okwxFNBV operationId: creditRelayRemove requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreditRelayRemoveRequest' description: '' description: The `/credit/relay/remove` endpoint allows you to invalidate a `relay_token`. The third party holding the token will no longer be able to access or refresh the reports which the `relay_token` gives access to. The original report, associated Items, and other relay tokens that provide access to the same report are not affected and will remain accessible after removing the given `relay_token`. servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /dashboard_user/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Retrieve a dashboard user tags: - Plaid responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/DashboardUserGetResponse' examples: example-1: value: id: 54350110fedcbaf01234ffee created_at: '2020-07-24T03:26:02Z' email_address: user@example.com status: active request_id: saKrIBuEB9qJZng operationId: dashboardUserGet description: Retrieve information about a dashboard user. requestBody: content: application/json: schema: $ref: '#/components/schemas/DashboardUserGetRequest' required: true externalDocs: url: /api/products/monitor/#dashboard_userget servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /dashboard_user/list: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid List dashboard users tags: - Plaid responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/DashboardUserListResponse' examples: example-1: value: dashboard_users: - id: 54350110fedcbaf01234ffee created_at: '2020-07-24T03:26:02Z' email_address: user@example.com status: active next_cursor: eyJkaXJlY3Rpb24iOiJuZXh0Iiwib2Zmc2V0IjoiMTU5NDM request_id: saKrIBuEB9qJZng operationId: dashboardUserList description: List all dashboard users associated with your account. requestBody: content: application/json: schema: $ref: '#/components/schemas/DashboardUserListRequest' required: true externalDocs: url: /api/products/monitor/#dashboard_userlist servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /deposit_switch/create: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Create a deposit switch externalDocs: url: /deposit-switch/reference#deposit_switchcreate responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/DepositSwitchCreateResponse' examples: example-1: value: deposit_switch_id: c7jMwPPManIwy9rwMewWP7lpb4pKRbtrbMomp request_id: lMjeOeu9X1VUh1F operationId: depositSwitchCreate description: This endpoint creates a deposit switch entity that will be persisted throughout the lifecycle of the switch. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/DepositSwitchCreateRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /deposit_switch/token/create: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Create a deposit switch token externalDocs: url: /deposit-switch/reference#deposit_switchtokencreate responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/DepositSwitchTokenCreateResponse' examples: example-1: value: deposit_switch_token: deposit-switch-sandbox-3e5cacca-10a6-11ea-bcdb-6003089acac0 deposit_switch_token_expiration_time: '2019-12-31T12:01:37Z' request_id: 68MvHx4Ub5NYoXt operationId: depositSwitchTokenCreate description: 'In order for the end user to take action, you will need to create a public token representing the deposit switch. This token is used to initialize Link. It can be used one time and expires after 30 minutes. ' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/DepositSwitchTokenCreateRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /deposit_switch/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Retrieve a deposit switch externalDocs: url: /deposit-switch/reference#deposit_switchget tags: - Plaid responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/DepositSwitchGetResponse' examples: example-1: value: target_item_id: MdRAkq1QikR3BLjDyMfMkVpqLmEm1VR7bX5hE target_account_id: bX5hEMdRAkq1QikR3BLjDyMfMkVpqLmEm1VR7 deposit_switch_id: LjDyMfMkVpqLmEm1VR7bQikR3BX5hEMdRAkq1 state: completed switch_method: instant date_created: '2019-11-01' date_completed: '2019-11-01' account_has_multiple_allocations: true is_allocated_remainder: false percent_allocated: 50 amount_allocated: null employer_name: COMPANY INC employer_id: pqLmEm1VR7bQi11231 institution_name: Bank of America institution_id: ins_1 request_id: lMjeOeu9X1VUh1F operationId: depositSwitchGet description: This endpoint returns information related to how the user has configured their payroll allocation and the state of the switch. You can use this information to build logic related to the user's direct deposit allocation preferences. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/DepositSwitchGetRequest' parameters: [] servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /deposit_switch/alt/create: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Create a deposit switch without using Plaid Exchange tags: - Plaid externalDocs: url: /deposit-switch/reference#deposit_switchaltcreate responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/DepositSwitchAltCreateResponse' examples: example-1: value: deposit_switch_id: c7jMwPPManIwy9rwMewWP7lpb4pKRbtrbMomp request_id: lMjeOeu9X1VUh1F operationId: depositSwitchAltCreate description: This endpoint provides an alternative to `/deposit_switch/create` for customers who have not yet fully integrated with Plaid Exchange. Like `/deposit_switch/create`, it creates a deposit switch entity that will be persisted throughout the lifecycle of the switch. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/DepositSwitchAltCreateRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /employers/search: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid externalDocs: url: /api/employers/#employerssearch operationId: employersSearch summary: Plaid Search employer database responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/EmployersSearchResponse' examples: example-1: value: employers: - name: Plaid Inc. address: city: San Francisco country: US postal_code: '94103' region: CA street: 1098 Harrison St confidence_score: 1 employer_id: emp_1 request_id: ixTBLZGvhD4NnmB description: '`/employers/search` allows you the ability to search Plaid’s database of known employers, for use with Deposit Switch. You can use this endpoint to look up a user''s employer in order to confirm that they are supported. Users with non-supported employers can then be routed out of the Deposit Switch flow. The data in the employer database is currently limited. As the Deposit Switch and Income products progress through their respective beta periods, more employers are being regularly added. Because the employer database is frequently updated, we recommend that you do not cache or store data from this endpoint for more than a day.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/EmployersSearchRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /fdx/notifications: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid description: A generic webhook receiver endpoint for FDX Event Notifications x-hidden-from-docs: true externalDocs: url: /api/fdx/notifications/#post summary: Plaid Webhook receiver for fdx notifications operationId: fdxNotifications requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/FDXNotification' responses: '200': description: OK default: description: Error response. content: application/json: schema: $ref: '#/components/schemas/PlaidError' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /identity/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Retrieve identity data externalDocs: url: /api/products/identity/#identityget operationId: identityGet responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/IdentityGetResponse' examples: example-1: value: accounts: - account_id: BxBXxLj1m4HMXBm9WZZmCWVbPjX16EHwv99vp balances: available: 100 current: 110 iso_currency_code: USD limit: null unofficial_currency_code: null mask: '0000' name: Plaid Checking official_name: Plaid Gold Standard 0% Interest Checking owners: - addresses: - data: city: Malakoff country: US postal_code: '14236' region: NY street: 2992 Cameron Road primary: true - data: city: San Matias country: US postal_code: 93405-2255 region: CA street: 2493 Leisure Lane primary: false emails: - data: accountholder0@example.com primary: true type: primary - data: accountholder1@example.com primary: false type: secondary - data: extraordinarily.long.email.username.123456@reallylonghostname.com primary: false type: other names: - Alberta Bobbeth Charleson phone_numbers: - data: '1112223333' primary: false type: home - data: '1112224444' primary: false type: work - data: '1112225555' primary: false type: mobile subtype: checking type: depository - account_id: 3gE5gnRzNyfXpBK5wEEKcymJ5albGVUqg77gr balances: available: 200 current: 210 iso_currency_code: USD limit: null unofficial_currency_code: null mask: '1111' name: Plaid Saving official_name: Plaid Silver Standard 0.1% Interest Saving owners: - addresses: - data: city: Malakoff country: US postal_code: '14236' region: NY street: 2992 Cameron Road primary: true - data: city: San Matias country: US postal_code: 93405-2255 region: CA street: 2493 Leisure Lane primary: false emails: - data: accountholder0@example.com primary: true type: primary - data: accountholder1@example.com primary: false type: secondary - data: extraordinarily.long.email.username.123456@reallylonghostname.com primary: false type: other names: - Alberta Bobbeth Charleson phone_numbers: - data: '1112223333' primary: false type: home - data: '1112224444' primary: false type: work - data: '1112225555' primary: false type: mobile subtype: savings type: depository item: available_products: - balance - investments billed_products: - assets - auth - identity - liabilities - transactions consent_expiration_time: null error: null institution_id: ins_3 item_id: eVBnVMp7zdTJLkRNr33Rs6zr7KNJqBFL9DrE6 update_type: background webhook: https://www.genericwebhookurl.com/webhook request_id: 3nARps6TOYtbACO description: 'The `/identity/get` endpoint allows you to retrieve various account holder information on file with the financial institution, including names, emails, phone numbers, and addresses. Only name data is guaranteed to be returned; other fields will be empty arrays if not provided by the institution. This request may take some time to complete if identity was not specified as an initial product when creating the Item. This is because Plaid must communicate directly with the institution to retrieve the data. Note: In API versions 2018-05-22 and earlier, the `owners` object is not returned, and instead identity information is returned in the top level `identity` object. For more details, see [Plaid API versioning](https://plaid.com/docs/api/versioning/#version-2019-05-29).' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/IdentityGetRequest' description: '' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /identity/documents/uploads/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID x-hidden-from-docs: true post: tags: - Plaid summary: Plaid Returns uploaded document identity externalDocs: url: none operationId: identityDocumentsUploadsGet description: Use `/identity/documents/uploads/get` to retrieve document uploaded identity. responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/IdentityDocumentsUploadsGetResponse' examples: example-1: value: accounts: - account_id: BxBXxLj1m4HMXBm9WZZmCWVbPjX16EHwv99vp balances: available: 100 current: 110 iso_currency_code: USD limit: null unofficial_currency_code: null mask: '0000' name: Plaid Checking official_name: Plaid Gold Standard 0% Interest Checking owners: - addresses: - data: city: Malakoff country: US postal_code: '14236' region: NY street: 2992 Cameron Road primary: true - data: city: San Matias country: US postal_code: 93405-2255 region: CA street: 2493 Leisure Lane primary: false emails: - data: accountholder0@example.com primary: true type: primary - data: accountholder1@example.com primary: false type: secondary - data: extraordinarily.long.email.username.123456@reallylonghostname.com primary: false type: other names: - Alberta Bobbeth Charleson phone_numbers: - data: '1112223333' primary: false type: home - data: '1112224444' primary: false type: work - data: '1112225555' primary: false type: mobile subtype: checking type: depository - account_id: 3gE5gnRzNyfXpBK5wEEKcymJ5albGVUqg77gr balances: available: 200 current: 210 iso_currency_code: USD limit: null unofficial_currency_code: null mask: '1111' name: Plaid Saving official_name: Plaid Silver Standard 0.1% Interest Saving owners: - addresses: - data: city: Malakoff country: US postal_code: '14236' region: NY street: 2992 Cameron Road primary: true - data: city: San Matias country: US postal_code: 93405-2255 region: CA street: 2493 Leisure Lane primary: false emails: - data: accountholder0@example.com primary: true type: primary - data: accountholder1@example.com primary: false type: secondary - data: extraordinarily.long.email.username.123456@reallylonghostname.com primary: false type: other names: - Alberta Bobbeth Charleson phone_numbers: - data: '1112223333' primary: false type: home - data: '1112224444' primary: false type: work - data: '1112225555' primary: false type: mobile subtype: savings type: depository item: available_products: - balance - investments billed_products: - assets - auth - identity - liabilities - transactions consent_expiration_time: null error: null institution_id: ins_3 item_id: eVBnVMp7zdTJLkRNr33Rs6zr7KNJqBFL9DrE6 update_type: background webhook: https://www.genericwebhookurl.com/webhook request_id: 3nARps6TOYtbACO requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/IdentityDocumentsUploadsGetRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /identity/match: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Retrieve identity match score externalDocs: url: /api/products/identity/#identitymatch operationId: identityMatch responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/IdentityMatchResponse' examples: example-1: value: accounts: - account_id: BxBXxLj1m4HMXBm9WZZmCWVbPjX16EHwv99vp balances: available: null current: null iso_currency_code: null limit: null unofficial_currency_code: null mask: '0000' name: Plaid Checking official_name: Plaid Gold Standard 0% Interest Checking legal_name: score: 90 is_nickname_match: true is_first_name_or_last_name_match: true is_business_name_detected: false phone_number: score: 100 email_address: score: 100 address: score: 100 is_postal_code_match: true subtype: checking type: depository - account_id: 3gE5gnRzNyfXpBK5wEEKcymJ5albGVUqg77gr balances: available: null current: null iso_currency_code: null limit: null unofficial_currency_code: null mask: '1111' name: Plaid Saving official_name: Plaid Silver Standard 0.1% Interest Saving legal_name: score: 30 is_first_name_or_last_name_match: false phone_number: score: 100 email_address: null address: score: 100 is_postal_code_match: true subtype: savings type: depository item: available_products: - balance - investments billed_products: - assets - auth - identity - liabilities - transactions consent_expiration_time: null error: null institution_id: ins_3 item_id: eVBnVMp7zdTJLkRNr33Rs6zr7KNJqBFL9DrE6 update_type: background webhook: https://www.genericwebhookurl.com/webhook request_id: 3nARps6TOYtbACO description: 'The `/identity/match` endpoint generates a match score, which indicates how well the provided identity data matches the identity information on file with the account holder''s financial institution. Fields within the `balances` object will always be null when retrieved by `/identity/match`. Instead, use the free `/accounts/get` endpoint to request balance cached data, or `/accounts/balance/get` for real-time data. This request may take some time to complete if Identity was not specified as an initial product when creating the Item. This is because Plaid must communicate directly with the institution to retrieve the data.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/IdentityMatchRequest' description: '' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /identity/refresh: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Refresh identity data externalDocs: url: /api/products/identity/#identityrefresh operationId: identityRefresh responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/IdentityRefreshResponse' examples: example-1: value: request_id: 1vwmF5TBQwiqfwP default: content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Error response description: '`/identity/refresh` is an optional endpoint for users of the Identity product. It initiates an on-demand extraction to fetch the most up to date Identity information from the Financial Institution. This on-demand extraction takes place in addition to the periodic extractions that automatically occur for any Identity-enabled Item. If changes to Identity are discovered after calling `/identity/refresh`, Plaid will fire a webhook [`DEFAULT_UPDATE`](https://plaid.com/docs/api/products/identity/#default_update). As this endpoint triggers a synchronous request for fresh data, latency may be higher than for other Plaid endpoints (typically less than 10 seconds, but occasionally up to 30 seconds or more); if you encounter errors, you may find it necessary to adjust your timeout period when making requests. `/identity/refresh` is offered as an add-on to Identity and has a separate [fee model](/docs/account/billing/#per-request-flat-fee). To request access to this endpoint, submit a [product access request](https://dashboard.plaid.com/team/products) or contact your Plaid account manager.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/IdentityRefreshRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /processor/identity/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Retrieve Identity data externalDocs: url: /api/processor-partners/#processoridentityget operationId: processorIdentityGet responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ProcessorIdentityGetResponse' examples: example-1: value: account: account_id: XMGPJy4q1gsQoKd5z9R3tK8kJ9EWL8SdkgKMq balances: available: 100 current: 110 iso_currency_code: USD limit: null unofficial_currency_code: null mask: '0000' name: Plaid Checking official_name: Plaid Gold Standard 0% Interest Checking owners: - addresses: - data: city: Malakoff country: US postal_code: '14236' region: NY street: 2992 Cameron Road primary: true - data: city: San Matias country: US postal_code: 93405-2255 region: CA street: 2493 Leisure Lane primary: false emails: - data: accountholder0@example.com primary: true type: primary - data: accountholder1@example.com primary: false type: secondary - data: extraordinarily.long.email.username.123456@reallylonghostname.com primary: false type: other names: - Alberta Bobbeth Charleson phone_numbers: - data: '1112223333' primary: false type: home - data: '1112224444' primary: false type: work - data: '1112225555' primary: false type: mobile1 subtype: checking type: depository request_id: eOPkBl6t33veI2J description: The `/processor/identity/get` endpoint allows you to retrieve various account holder information on file with the financial institution, including names, emails, phone numbers, and addresses. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ProcessorIdentityGetRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /processor/identity/match: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Retrieve identity match score externalDocs: url: /api/processor-partners/#processoridentitymatch operationId: processorIdentityMatch responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ProcessorIdentityMatchResponse' examples: example-1: value: account: account_id: BxBXxLj1m4HMXBm9WZZmCWVbPjX16EHwv99vp balances: available: null current: null iso_currency_code: null limit: null unofficial_currency_code: null mask: '0000' name: Plaid Checking official_name: Plaid Gold Standard 0% Interest Checking legal_name: score: 90 is_nickname_match: true is_first_name_or_last_name_match: true is_business_name_detected: false phone_number: score: 100 email_address: score: 100 address: score: 100 is_postal_code_match: true subtype: checking type: depository request_id: 3nARps6TOYtbACO description: 'The `/processor/identity/match` endpoint generates a match score, which indicates how well the provided identity data matches the identity information on file with the account holder''s financial institution. Fields within the `balances` object will always be null when retrieved by `/identity/match`. Instead, use the free `/accounts/get` endpoint to request balance cached data, or `/accounts/balance/get` for real-time data. This request may take some time to complete if Identity was not specified as an initial product when creating the Item. This is because Plaid must communicate directly with the institution to retrieve the data.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ProcessorIdentityMatchRequest' description: '' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /identity_verification/create: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Create a new Identity Verification description: 'Create a new Identity Verification for the user specified by the `client_user_id` field. The requirements and behavior of the verification are determined by the `template_id` provided. If you don''t know whether the associated user already has an active Identity Verification, you can specify `"is_idempotent": true` in the request body. With idempotency enabled, a new Identity Verification will only be created if one does not already exist for the associated `client_user_id` and `template_id`. If an Identity Verification is found, it will be returned unmodified with an `200 OK` HTTP status code. You can also use this endpoint to supply information you already have collected about the user; if any of these fields are specified, the screens prompting the user to enter them will be skipped during the Link flow. ' tags: - Plaid responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/IdentityVerificationCreateResponse' examples: example-1: value: id: idv_52xR9LKo77r1Np client_user_id: your-db-id-3b24110 created_at: '2020-07-24T03:26:02Z' completed_at: '2020-07-24T03:26:02Z' previous_attempt_id: idv_42cF1MNo42r9Xj shareable_url: https://flow.plaid.com/verify/idv_4FrXJvfQU3zGUR?key=e004115db797f7cc3083bff3167cba30644ef630fb46f5b086cde6cc3b86a36f template: id: idvtmp_4FrXJvfQU3zGUR version: 2 user: phone_number: '+19876543212' date_of_birth: '1990-05-29' ip_address: 192.0.2.42 email_address: user@example.com name: given_name: Leslie family_name: Knope address: street: 123 Main St. street2: Unit 42 city: Pawnee region: IN postal_code: '46001' country: US id_number: value: '123456789' type: us_ssn status: success steps: accept_tos: success verify_sms: success kyc_check: success documentary_verification: success selfie_check: success watchlist_screening: success risk_check: success documentary_verification: status: success documents: - status: success attempt: 1 images: original_front: https://example.plaid.com/verifications/idv_52xR9LKo77r1Np/documents/1/original_front.jpeg original_back: https://example.plaid.com/verifications/idv_52xR9LKo77r1Np/documents/1/original_back.jpeg cropped_front: https://example.plaid.com/verifications/idv_52xR9LKo77r1Np/documents/1/cropped_front.jpeg cropped_back: https://example.plaid.com/verifications/idv_52xR9LKo77r1Np/documents/1/cropped_back.jpeg face: https://example.plaid.com/verifications/idv_52xR9LKo77r1Np/documents/1/face.jpeg extracted_data: id_number: AB123456 category: drivers_license expiration_date: '1990-05-29' issuing_country: US issuing_region: IN date_of_birth: '1990-05-29' address: street: 123 Main St. Unit 42 city: Pawnee region: IN postal_code: '46001' country: US analysis: authenticity: match image_quality: high extracted_data: name: match date_of_birth: match expiration_date: not_expired issuing_country: match redacted_at: '2020-07-24T03:26:02Z' selfie_check: status: success selfies: - status: success attempt: 1 capture: image_url: https://example.plaid.com/verifications/idv_52xR9LKo77r1Np/selfie/liveness.jpeg video_url: https://example.plaid.com/verifications/idv_52xR9LKo77r1Np/selfie/liveness.webm analysis: document_comparison: match kyc_check: status: success address: summary: match po_box: 'yes' type: residential name: summary: match date_of_birth: summary: match id_number: summary: match phone_number: summary: match area_code: match risk_check: status: success behavior: user_interactions: risky fraud_ring_detected: 'yes' bot_detected: 'yes' email: is_deliverable: 'yes' breach_count: 1 first_breached_at: '1990-05-29' last_breached_at: '1990-05-29' domain_registered_at: '1990-05-29' domain_is_free_provider: 'yes' domain_is_custom: 'yes' domain_is_disposable: 'yes' top_level_domain_is_suspicious: 'yes' linked_services: - apple phone: linked_services: - apple devices: - ip_proxy_type: none_detected ip_spam_list_count: 1 ip_timezone_offset: +06:00:00 identity_abuse_signals: synthetic_identity: score: 0 stolen_identity: score: 0 watchlist_screening_id: scr_52xR9LKo77r1Np redacted_at: '2020-07-24T03:26:02Z' request_id: saKrIBuEB9qJZng operationId: identityVerificationCreate requestBody: content: application/json: schema: $ref: '#/components/schemas/IdentityVerificationCreateRequest' required: true externalDocs: url: /api/products/identity-verification/#identity_verificationcreate servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /identity_verification/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Retrieve Identity Verification tags: - Plaid responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/IdentityVerificationGetResponse' examples: example-1: value: id: idv_52xR9LKo77r1Np client_user_id: your-db-id-3b24110 created_at: '2020-07-24T03:26:02Z' completed_at: '2020-07-24T03:26:02Z' previous_attempt_id: idv_42cF1MNo42r9Xj shareable_url: https://flow.plaid.com/verify/idv_4FrXJvfQU3zGUR?key=e004115db797f7cc3083bff3167cba30644ef630fb46f5b086cde6cc3b86a36f template: id: idvtmp_4FrXJvfQU3zGUR version: 2 user: phone_number: '+19876543212' date_of_birth: '1990-05-29' ip_address: 192.0.2.42 email_address: user@example.com name: given_name: Leslie family_name: Knope address: street: 123 Main St. street2: Unit 42 city: Pawnee region: IN postal_code: '46001' country: US id_number: value: '123456789' type: us_ssn status: success steps: accept_tos: success verify_sms: success kyc_check: success documentary_verification: success selfie_check: success watchlist_screening: success risk_check: success documentary_verification: status: success documents: - status: success attempt: 1 images: original_front: https://example.plaid.com/verifications/idv_52xR9LKo77r1Np/documents/1/original_front.jpeg original_back: https://example.plaid.com/verifications/idv_52xR9LKo77r1Np/documents/1/original_back.jpeg cropped_front: https://example.plaid.com/verifications/idv_52xR9LKo77r1Np/documents/1/cropped_front.jpeg cropped_back: https://example.plaid.com/verifications/idv_52xR9LKo77r1Np/documents/1/cropped_back.jpeg face: https://example.plaid.com/verifications/idv_52xR9LKo77r1Np/documents/1/face.jpeg extracted_data: id_number: AB123456 category: drivers_license expiration_date: '1990-05-29' issuing_country: US issuing_region: IN date_of_birth: '1990-05-29' address: street: 123 Main St. Unit 42 city: Pawnee region: IN postal_code: '46001' country: US analysis: authenticity: match image_quality: high extracted_data: name: match date_of_birth: match expiration_date: not_expired issuing_country: match redacted_at: '2020-07-24T03:26:02Z' selfie_check: status: success selfies: - status: success attempt: 1 capture: image_url: https://example.plaid.com/verifications/idv_52xR9LKo77r1Np/selfie/liveness.jpeg video_url: https://example.plaid.com/verifications/idv_52xR9LKo77r1Np/selfie/liveness.webm analysis: document_comparison: match kyc_check: status: success address: summary: match po_box: 'yes' type: residential name: summary: match date_of_birth: summary: match id_number: summary: match phone_number: summary: match area_code: match risk_check: status: success behavior: user_interactions: risky fraud_ring_detected: 'yes' bot_detected: 'yes' email: is_deliverable: 'yes' breach_count: 1 first_breached_at: '1990-05-29' last_breached_at: '1990-05-29' domain_registered_at: '1990-05-29' domain_is_free_provider: 'yes' domain_is_custom: 'yes' domain_is_disposable: 'yes' top_level_domain_is_suspicious: 'yes' linked_services: - apple phone: linked_services: - apple devices: - ip_proxy_type: none_detected ip_spam_list_count: 1 ip_timezone_offset: +06:00:00 identity_abuse_signals: synthetic_identity: score: 0 stolen_identity: score: 0 watchlist_screening_id: scr_52xR9LKo77r1Np redacted_at: '2020-07-24T03:26:02Z' request_id: saKrIBuEB9qJZng operationId: identityVerificationGet description: Retrieve a previously created Identity Verification. requestBody: content: application/json: schema: $ref: '#/components/schemas/IdentityVerificationGetRequest' required: true externalDocs: url: /api/products/identity-verification/#identity_verificationget servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /identity_verification/list: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid List Identity Verifications tags: - Plaid responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/IdentityVerificationListResponse' examples: example-1: value: identity_verifications: - id: idv_52xR9LKo77r1Np client_user_id: your-db-id-3b24110 created_at: '2020-07-24T03:26:02Z' completed_at: '2020-07-24T03:26:02Z' previous_attempt_id: idv_42cF1MNo42r9Xj shareable_url: https://flow.plaid.com/verify/idv_4FrXJvfQU3zGUR?key=e004115db797f7cc3083bff3167cba30644ef630fb46f5b086cde6cc3b86a36f template: id: idvtmp_4FrXJvfQU3zGUR version: 2 user: phone_number: '+19876543212' date_of_birth: '1990-05-29' ip_address: 192.0.2.42 email_address: user@example.com name: given_name: Leslie family_name: Knope address: street: 123 Main St. street2: Unit 42 city: Pawnee region: IN postal_code: '46001' country: US id_number: value: '123456789' type: us_ssn status: success steps: accept_tos: success verify_sms: success kyc_check: success documentary_verification: success selfie_check: success watchlist_screening: success risk_check: success documentary_verification: status: success documents: - status: success attempt: 1 images: original_front: https://example.plaid.com/verifications/idv_52xR9LKo77r1Np/documents/1/original_front.jpeg original_back: https://example.plaid.com/verifications/idv_52xR9LKo77r1Np/documents/1/original_back.jpeg cropped_front: https://example.plaid.com/verifications/idv_52xR9LKo77r1Np/documents/1/cropped_front.jpeg cropped_back: https://example.plaid.com/verifications/idv_52xR9LKo77r1Np/documents/1/cropped_back.jpeg face: https://example.plaid.com/verifications/idv_52xR9LKo77r1Np/documents/1/face.jpeg extracted_data: id_number: AB123456 category: drivers_license expiration_date: '1990-05-29' issuing_country: US issuing_region: IN date_of_birth: '1990-05-29' address: street: 123 Main St. Unit 42 city: Pawnee region: IN postal_code: '46001' country: US analysis: authenticity: match image_quality: high extracted_data: name: match date_of_birth: match expiration_date: not_expired issuing_country: match redacted_at: '2020-07-24T03:26:02Z' selfie_check: status: success selfies: - status: success attempt: 1 capture: image_url: https://example.plaid.com/verifications/idv_52xR9LKo77r1Np/selfie/liveness.jpeg video_url: https://example.plaid.com/verifications/idv_52xR9LKo77r1Np/selfie/liveness.webm analysis: document_comparison: match kyc_check: status: success address: summary: match po_box: 'yes' type: residential name: summary: match date_of_birth: summary: match id_number: summary: match phone_number: summary: match area_code: match risk_check: status: success behavior: user_interactions: risky fraud_ring_detected: 'yes' bot_detected: 'yes' email: is_deliverable: 'yes' breach_count: 1 first_breached_at: '1990-05-29' last_breached_at: '1990-05-29' domain_registered_at: '1990-05-29' domain_is_free_provider: 'yes' domain_is_custom: 'yes' domain_is_disposable: 'yes' top_level_domain_is_suspicious: 'yes' linked_services: - apple phone: linked_services: - apple devices: - ip_proxy_type: none_detected ip_spam_list_count: 1 ip_timezone_offset: +06:00:00 identity_abuse_signals: synthetic_identity: score: 0 stolen_identity: score: 0 watchlist_screening_id: scr_52xR9LKo77r1Np redacted_at: '2020-07-24T03:26:02Z' next_cursor: eyJkaXJlY3Rpb24iOiJuZXh0Iiwib2Zmc2V0IjoiMTU5NDM request_id: saKrIBuEB9qJZng operationId: identityVerificationList description: Filter and list Identity Verifications created by your account requestBody: content: application/json: schema: $ref: '#/components/schemas/IdentityVerificationListRequest' required: true externalDocs: url: /api/products/identity-verification/#identity_verificationlist servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /identity_verification/retry: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Retry an Identity Verification requestBody: content: application/json: schema: $ref: '#/components/schemas/IdentityVerificationRetryRequest' required: true tags: - Plaid responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/IdentityVerificationRetryResponse' examples: example-1: value: id: idv_52xR9LKo77r1Np client_user_id: your-db-id-3b24110 created_at: '2020-07-24T03:26:02Z' completed_at: '2020-07-24T03:26:02Z' previous_attempt_id: idv_42cF1MNo42r9Xj shareable_url: https://flow.plaid.com/verify/idv_4FrXJvfQU3zGUR?key=e004115db797f7cc3083bff3167cba30644ef630fb46f5b086cde6cc3b86a36f template: id: idvtmp_4FrXJvfQU3zGUR version: 2 user: phone_number: '+19876543212' date_of_birth: '1990-05-29' ip_address: 192.0.2.42 email_address: user@example.com name: given_name: Leslie family_name: Knope address: street: 123 Main St. street2: Unit 42 city: Pawnee region: IN postal_code: '46001' country: US id_number: value: '123456789' type: us_ssn status: success steps: accept_tos: success verify_sms: success kyc_check: success documentary_verification: success selfie_check: success watchlist_screening: success risk_check: success documentary_verification: status: success documents: - status: success attempt: 1 images: original_front: https://example.plaid.com/verifications/idv_52xR9LKo77r1Np/documents/1/original_front.jpeg original_back: https://example.plaid.com/verifications/idv_52xR9LKo77r1Np/documents/1/original_back.jpeg cropped_front: https://example.plaid.com/verifications/idv_52xR9LKo77r1Np/documents/1/cropped_front.jpeg cropped_back: https://example.plaid.com/verifications/idv_52xR9LKo77r1Np/documents/1/cropped_back.jpeg face: https://example.plaid.com/verifications/idv_52xR9LKo77r1Np/documents/1/face.jpeg extracted_data: id_number: AB123456 category: drivers_license expiration_date: '1990-05-29' issuing_country: US issuing_region: IN date_of_birth: '1990-05-29' address: street: 123 Main St. Unit 42 city: Pawnee region: IN postal_code: '46001' country: US analysis: authenticity: match image_quality: high extracted_data: name: match date_of_birth: match expiration_date: not_expired issuing_country: match redacted_at: '2020-07-24T03:26:02Z' selfie_check: status: success selfies: - status: success attempt: 1 capture: image_url: https://example.plaid.com/verifications/idv_52xR9LKo77r1Np/selfie/liveness.jpeg video_url: https://example.plaid.com/verifications/idv_52xR9LKo77r1Np/selfie/liveness.webm analysis: document_comparison: match kyc_check: status: success address: summary: match po_box: 'yes' type: residential name: summary: match date_of_birth: summary: match id_number: summary: match phone_number: summary: match area_code: match risk_check: status: success behavior: user_interactions: risky fraud_ring_detected: 'yes' bot_detected: 'yes' email: is_deliverable: 'yes' breach_count: 1 first_breached_at: '1990-05-29' last_breached_at: '1990-05-29' domain_registered_at: '1990-05-29' domain_is_free_provider: 'yes' domain_is_custom: 'yes' domain_is_disposable: 'yes' top_level_domain_is_suspicious: 'yes' linked_services: - apple phone: linked_services: - apple devices: - ip_proxy_type: none_detected ip_spam_list_count: 1 ip_timezone_offset: +06:00:00 identity_abuse_signals: synthetic_identity: score: 0 stolen_identity: score: 0 watchlist_screening_id: scr_52xR9LKo77r1Np redacted_at: '2020-07-24T03:26:02Z' request_id: saKrIBuEB9qJZng operationId: identityVerificationRetry description: Allow a customer to retry their Identity Verification externalDocs: url: /api/products/identity-verification/#identity_verificationretry servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /identity_verification/autofill/create: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: x-hidden-from-docs: true summary: Plaid Create autofill for an Identity Verification description: Try to autofill an Identity Verification based of the provided phone number, date of birth and country of residence. tags: - Plaid requestBody: content: application/json: schema: $ref: '#/components/schemas/IdentityVerificationAutofillCreateRequest' example: identity_verification_id: flwses_42cF1MNo42r9Xj required: true responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/IdentityVerificationAutofillCreateResponse' examples: example-1: value: status: success user: name: given_name: Leslie family_name: Knope address: street: 123 Main St. street2: Unit 42 city: Pawnee region: IN postal_code: '46001' country: US po_box: 'yes' type: residential id_number: value: '123456789' type: us_ssn request_id: saKrIBuEB9qJZng operationId: identityVerificationAutofillCreate externalDocs: url: /api/products/identity-verification/#identity_verificationautofillcreate servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /income/verification/create: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid (Deprecated) Create an income verification instance tags: - Plaid deprecated: true externalDocs: url: /api/products/income/#incomeverificationcreate operationId: incomeVerificationCreate responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/IncomeVerificationCreateResponse' examples: example-1: value: income_verification_id: f2a826d7-25cf-483b-a124-c40beb64b732 request_id: lMjeOeu9X1VUh1F description: '`/income/verification/create` begins the income verification process by returning an `income_verification_id`. You can then provide the `income_verification_id` to `/link/token/create` under the `income_verification` parameter in order to create a Link instance that will prompt the user to go through the income verification flow. Plaid will fire an `INCOME` webhook once the user completes the Payroll Income flow, or when the uploaded documents in the Document Income flow have finished processing. ' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/IncomeVerificationCreateRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /income/verification/paystubs/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid (Deprecated) Retrieve information from the paystubs used for income verification deprecated: true tags: - Plaid externalDocs: url: /api/products/income/#incomeverificationpaystubsget operationId: incomeVerificationPaystubsGet responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/IncomeVerificationPaystubsGetResponse' examples: example-1: value: document_metadata: - doc_id: 2jkflanbd doc_type: DOCUMENT_TYPE_PAYSTUB name: paystub.pdf status: DOCUMENT_STATUS_PROCESSING_COMPLETE paystubs: - deductions: breakdown: - current_amount: 123.45 description: taxes iso_currency_code: USD unofficial_currency_code: null ytd_amount: 246.9 total: current_amount: 123.45 iso_currency_code: USD unofficial_currency_code: null ytd_amount: 246.9 doc_id: 2jkflanbd earnings: breakdown: - canonical_description: REGULAR PAY current_amount: 200.22 description: salary earned hours: 80 iso_currency_code: USD rate: null unofficial_currency_code: null ytd_amount: 400.44 - canonical_desription: BONUS current_amount: 100 description: bonus earned hours: null iso_currency_code: USD rate: null unofficial_currency_code: null ytd_amount: 100 total: current_amount: 300.22 hours: 160 iso_currency_code: USD unofficial_currency_code: null ytd_amount: 500.44 employee: address: city: SAN FRANCISCO country: US postal_code: '94133' region: CA street: 2140 TAYLOR ST name: ANNA CHARLESTON marital_status: single taxpayer_id: id_type: SSN id_mask: '3333' employer: name: PLAID INC address: city: SAN FRANCISCO country: US postal_code: '94111' region: CA street: 1098 HARRISON ST net_pay: current_amount: 123.34 description: TOTAL NET PAY iso_currency_code: USD unofficial_currency_code: null ytd_amount: 253.54 pay_period_details: check_amount: 1490.21 distribution_breakdown: - account_name: Big time checking bank_name: bank of plaid current_amount: 176.77 iso_currency_code: USD mask: '1223' type: checking unofficial_currency_code: null end_date: '2020-12-15' gross_earnings: 4500 pay_date: '2020-12-15' start_date: '2020-12-01' pay_frequency: PAY_FREQUENCY_BIWEEKLY request_id: 2pxQ59buGdsHRef requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/IncomeVerificationPaystubsGetRequest' description: '' description: '`/income/verification/paystubs/get` returns the information collected from the paystubs that were used to verify an end user''s income. It can be called once the status of the verification has been set to `VERIFICATION_STATUS_PROCESSING_COMPLETE`, as reported by the `INCOME: verification_status` webhook. Attempting to call the endpoint before verification has been completed will result in an error. This endpoint has been deprecated; new integrations should use `/credit/payroll_income/get` instead.' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /income/verification/documents/download: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: deprecated: true summary: Plaid (Deprecated) Download the original documents used for income verification tags: - Plaid externalDocs: url: /api/products/income/#incomeverificationdocumentsdownload operationId: incomeVerificationDocumentsDownload responses: '200': description: A ZIP file containing source documents(s) used as the basis for income verification. content: application/zip: schema: type: string format: binary description: '`/income/verification/documents/download` provides the ability to download the source documents associated with the verification. If Document Income was used, the documents will be those the user provided in Link. For Payroll Income, the most recent files available for download from the payroll provider will be available from this endpoint. The response to `/income/verification/documents/download` is a ZIP file in binary data. If a `document_id` is passed, a single document will be contained in this file. If not, the response will contain all documents associated with the verification. The `request_id` is returned in the `Plaid-Request-ID` header.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/IncomeVerificationDocumentsDownloadRequest' parameters: [] servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /income/verification/taxforms/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: deprecated: true tags: - Plaid summary: Plaid (Deprecated) Retrieve information from the tax documents used for income verification externalDocs: url: /api/products/income/#incomeverificationtaxformsget operationId: incomeVerificationTaxformsGet description: '`/income/verification/taxforms/get` returns the information collected from forms that were used to verify an end user''''s income. It can be called once the status of the verification has been set to `VERIFICATION_STATUS_PROCESSING_COMPLETE`, as reported by the `INCOME: verification_status` webhook. Attempting to call the endpoint before verification has been completed will result in an error. This endpoint has been deprecated; new integrations should use `/credit/payroll_income/get` instead.' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/IncomeVerificationTaxformsGetResponse' examples: example-1: value: document_metadata: - doc_id: q5Ypbbr03p doc_type: DOCUMENT_TYPE_US_TAX_W2 name: my_w2.pdf status: DOCUMENT_STATUS_PROCESSING_COMPLETE request_id: 73W7sz8nIP8Mgck taxforms: - document_type: W2 w2: allocated_tips: '1000' box_12: - amount: '200' code: AA box_9: box9 dependent_care_benefits: '1000' employee: address: city: San Francisco country: US postal_code: '94103' region: CA street: 1234 Grand St name: Josie Georgia Harrison marital_status: single taxpayer_id: id_type: SSN id_mask: '1234' employer: address: city: New York country: US postal_code: '10010' region: NY street: 456 Main St name: Acme Inc employee_id_number: 12-1234567 federal_income_tax_withheld: '1000' medicare_tax_withheld: '1000' medicare_wages_and_tips: '1000' nonqualified_plans: '1000' other: other retirement_plan: CHECKED social_security_tax_withheld: '1000' social_security_tips: '1000' social_security_wages: '1000' state_and_local_wages: - employer_state_id_number: 11111111111AAA local_income_tax: '200' local_wages_tips: '200' locality_name: local state: UT state_income_tax: '200' state_wages_tips: '200' statutory_employee: CHECKED tax_year: '2020' third_party_sick_pay: CHECKED wages_tips_other_comp: '1000' default: description: Error response. content: application/json: schema: $ref: '#/components/schemas/PlaidError' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/IncomeVerificationTaxformsGetRequest' description: '' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /income/verification/precheck: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: deprecated: true summary: Plaid (Deprecated) Check digital income verification eligibility and optimize conversion tags: - Plaid operationId: incomeVerificationPrecheck externalDocs: url: /api/products/income/#incomeverificationprecheck responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/IncomeVerificationPrecheckResponse' examples: example-1: value: request_id: lMjeOeu9X1VUh1F precheck_id: n9elqYlvYm confidence: HIGH description: '`/income/verification/precheck` is an optional endpoint that can be called before initializing a Link session for income verification. It evaluates whether a given user is supportable by digital income verification and returns a `precheck_id` that can be provided to `/link/token/create`. If the user is eligible for digital verification, providing the `precheck_id` in this way will generate a Link UI optimized for the end user and their specific employer. If the user cannot be confirmed as eligible, the `precheck_id` can still be provided to `/link/token/create` and the user can still use the income verification flow, but they may be required to manually upload a paystub to verify their income. While all request fields are optional, providing either `employer` or `transactions_access_tokens` data will increase the chance of receiving a useful result. This endpoint has been deprecated; new integrations should use `/credit/payroll_income/precheck` instead.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/IncomeVerificationPrecheckRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /sandbox/income/fire_webhook: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Manually fire an Income webhook tags: - Plaid externalDocs: url: /api/sandbox/#sandboxincomefire_webhook operationId: sandboxIncomeFireWebhook responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/SandboxIncomeFireWebhookResponse' examples: example-1: value: request_id: mdqfuVxeoza6mhu default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Use the `/sandbox/income/fire_webhook` endpoint to manually trigger a Payroll or Document Income webhook in the Sandbox environment. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SandboxIncomeFireWebhookRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /institutions/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Get details of all supported institutions externalDocs: url: /api/institutions/#institutionsget operationId: institutionsGet responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/InstitutionsGetResponse' examples: example-1: value: institutions: - country_codes: - US institution_id: ins_1 name: Bank of America products: - assets - auth - balance - transactions - identity - liabilities routing_numbers: - 011000138 - '011200365' - 011400495 dtc_numbers: - '2236' - 0955 - '1367' oauth: false status: item_logins: status: HEALTHY last_status_change: '2019-02-15T15:53:00Z' breakdown: success: 0.9 error_plaid: 0.01 error_institution: 0.09 transactions_updates: status: HEALTHY last_status_change: '2019-02-12T08:22:00Z' breakdown: success: 0.95 error_plaid: 0.02 error_institution: 0.03 refresh_interval: NORMAL auth: status: HEALTHY last_status_change: '2019-02-15T15:53:00Z' breakdown: success: 0.91 error_plaid: 0.01 error_institution: 0.08 identity: status: DEGRADED last_status_change: '2019-02-15T15:50:00Z' breakdown: success: 0.42 error_plaid: 0.08 error_institution: 0.5 investments: status: HEALTHY last_status_change: '2019-02-15T15:53:00Z' breakdown: success: 0.89 error_plaid: 0.02 error_institution: 0.09 liabilities: status: HEALTHY last_status_change: '2019-02-15T15:53:00Z' breakdown: success: 0.89 error_plaid: 0.02 error_institution: 0.09 investments_updates: status: HEALTHY last_status_change: '2019-02-12T08:22:00Z' breakdown: success: 0.95 error_plaid: 0.02 error_institution: 0.03 refresh_interval: NORMAL liabilities_updates: status: HEALTHY last_status_change: '2019-02-12T08:22:00Z' breakdown: success: 0.95 error_plaid: 0.02 error_institution: 0.03 refresh_interval: NORMAL request_id: tbFyCEqkU774ZGG total: 11384 default: content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Error response description: 'Returns a JSON response containing details on all financial institutions currently supported by Plaid. Because Plaid supports thousands of institutions, results are paginated. If there is no overlap between an institution’s enabled products and a client’s enabled products, then the institution will be filtered out from the response. As a result, the number of institutions returned may not match the count specified in the call.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/InstitutionsGetRequest' description: '' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /institutions/search: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Search institutions externalDocs: url: /api/institutions/#institutionssearch operationId: institutionsSearch responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/InstitutionsSearchResponse' examples: example-1: value: institutions: - country_codes: - US institution_id: ins_118923 name: Red Platypus Bank - Red Platypus Bank products: - assets - auth - balance - transactions - identity routing_numbers: - 011000138 - '011200365' - 011400495 dtc_numbers: - '2236' - 0955 - '1367' oauth: false status: item_logins: status: HEALTHY last_status_change: '2019-02-15T15:53:00Z' breakdown: success: 0.9 error_plaid: 0.01 error_institution: 0.09 transactions_updates: status: HEALTHY last_status_change: '2019-02-12T08:22:00Z' breakdown: success: 0.95 error_plaid: 0.02 error_institution: 0.03 refresh_interval: NORMAL auth: status: HEALTHY last_status_change: '2019-02-15T15:53:00Z' breakdown: success: 0.91 error_plaid: 0.01 error_institution: 0.08 identity: status: DEGRADED last_status_change: '2019-02-15T15:50:00Z' breakdown: success: 0.42 error_plaid: 0.08 error_institution: 0.5 investments: status: HEALTHY last_status_change: '2019-02-15T15:53:00Z' breakdown: success: 0.89 error_plaid: 0.02 error_institution: 0.09 liabilities: status: HEALTHY last_status_change: '2019-02-15T15:53:00Z' breakdown: success: 0.89 error_plaid: 0.02 error_institution: 0.09 investments_updates: status: HEALTHY last_status_change: '2019-02-12T08:22:00Z' breakdown: success: 0.95 error_plaid: 0.02 error_institution: 0.03 refresh_interval: NORMAL liabilities_updates: status: HEALTHY last_status_change: '2019-02-12T08:22:00Z' breakdown: success: 0.95 error_plaid: 0.02 error_institution: 0.03 refresh_interval: NORMAL request_id: Ggmk0enW4smO2Tp default: content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Error response description: 'Returns a JSON response containing details for institutions that match the query parameters, up to a maximum of ten institutions per query. Versioning note: API versions 2019-05-29 and earlier allow use of the `public_key` parameter instead of the `client_id` and `secret` parameters to authenticate to this endpoint. The `public_key` parameter has since been deprecated; all customers are encouraged to use `client_id` and `secret` instead. ' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/InstitutionsSearchRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /institutions/get_by_id: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Get details of an institution externalDocs: url: /api/institutions/#institutionsget_by_id operationId: institutionsGetById responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/InstitutionsGetByIdResponse' examples: example-1: value: institution: country_codes: - US institution_id: ins_109512 name: Houndstooth Bank products: - auth - balance - identity - transactions routing_numbers: - 011000138 - '011200365' - 011400495 dtc_numbers: - '2236' - 0955 - '1367' oauth: false status: item_logins: status: HEALTHY last_status_change: '2019-02-15T15:53:00Z' breakdown: success: 0.9 error_plaid: 0.01 error_institution: 0.09 transactions_updates: status: HEALTHY last_status_change: '2019-02-12T08:22:00Z' breakdown: success: 0.95 error_plaid: 0.02 error_institution: 0.03 refresh_interval: NORMAL auth: status: HEALTHY last_status_change: '2019-02-15T15:53:00Z' breakdown: success: 0.91 error_plaid: 0.01 error_institution: 0.08 identity: status: DEGRADED last_status_change: '2019-02-15T15:50:00Z' breakdown: success: 0.42 error_plaid: 0.08 error_institution: 0.5 investments: status: HEALTHY last_status_change: '2019-02-15T15:53:00Z' breakdown: success: 0.89 error_plaid: 0.02 error_institution: 0.09 liabilities: status: HEALTHY last_status_change: '2019-02-15T15:53:00Z' breakdown: success: 0.89 error_plaid: 0.02 error_institution: 0.09 investments_updates: status: HEALTHY last_status_change: '2019-02-12T08:22:00Z' breakdown: success: 0.95 error_plaid: 0.02 error_institution: 0.03 refresh_interval: NORMAL liabilities_updates: status: HEALTHY last_status_change: '2019-02-12T08:22:00Z' breakdown: success: 0.95 error_plaid: 0.02 error_institution: 0.03 refresh_interval: NORMAL primary_color: '#004966' url: https://plaid.com logo: null request_id: m8MDnv9okwxFNBV default: content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Error response description: 'Returns a JSON response containing details on a specified financial institution currently supported by Plaid. Versioning note: API versions 2019-05-29 and earlier allow use of the `public_key` parameter instead of the `client_id` and `secret` to authenticate to this endpoint. The `public_key` has been deprecated; all customers are encouraged to use `client_id` and `secret` instead. ' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/InstitutionsGetByIdRequest' description: '' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /investments/holdings/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Get Investment holdings externalDocs: url: /api/products/investments/#investmentsholdingsget responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/InvestmentsHoldingsGetResponse' examples: example-1: value: accounts: - account_id: 5Bvpj4QknlhVWk7GygpwfVKdd133GoCxB814g balances: available: 43200 current: 43200 iso_currency_code: USD limit: null unofficial_currency_code: null mask: '4444' name: Plaid Money Market official_name: Plaid Platinum Standard 1.85% Interest Money Market subtype: money market type: depository - account_id: JqMLm4rJwpF6gMPJwBqdh9ZjjPvvpDcb7kDK1 balances: available: null current: 110.01 iso_currency_code: USD limit: null unofficial_currency_code: null mask: '5555' name: Plaid IRA official_name: null subtype: ira type: investment - account_id: k67E4xKvMlhmleEa4pg9hlwGGNnnEeixPolGm balances: available: null current: 23631.9805 iso_currency_code: USD limit: null unofficial_currency_code: null mask: '6666' name: Plaid 401k official_name: null subtype: 401k type: investment - account_id: ax0xgOBYRAIqOOjeLZr0iZBb8r6K88HZXpvmq balances: available: 48200.03 current: 48200.03 iso_currency_code: USD limit: null unofficial_currency_code: null mask: '4092' name: Plaid Crypto Exchange Account official_name: null subtype: crypto exchange type: investment holdings: - account_id: JqMLm4rJwpF6gMPJwBqdh9ZjjPvvpDcb7kDK1 cost_basis: 1 institution_price: 1 institution_price_as_of: '2021-04-13' institution_price_datetime: null institution_value: 0.01 iso_currency_code: USD quantity: 0.01 security_id: d6ePmbPxgWCWmMVv66q9iPV94n91vMtov5Are unofficial_currency_code: null - account_id: k67E4xKvMlhmleEa4pg9hlwGGNnnEeixPolGm cost_basis: 1.5 institution_price: 2.11 institution_price_as_of: '2021-04-13' institution_price_datetime: null institution_value: 2.11 iso_currency_code: USD quantity: 1 security_id: KDwjlXj1Rqt58dVvmzRguxJybmyQL8FgeWWAy unofficial_currency_code: null - account_id: k67E4xKvMlhmleEa4pg9hlwGGNnnEeixPolGm cost_basis: 10 institution_price: 10.42 institution_price_as_of: '2021-04-13' institution_price_datetime: null institution_value: 20.84 iso_currency_code: USD quantity: 2 security_id: NDVQrXQoqzt5v3bAe8qRt4A7mK7wvZCLEBBJk unofficial_currency_code: null - account_id: JqMLm4rJwpF6gMPJwBqdh9ZjjPvvpDcb7kDK1 cost_basis: 0.01 institution_price: 0.011 institution_price_as_of: '2021-04-13' institution_price_datetime: null institution_value: 110 iso_currency_code: USD quantity: 10000 security_id: 8E4L9XLl6MudjEpwPAAgivmdZRdBPJuvMPlPb unofficial_currency_code: null - account_id: k67E4xKvMlhmleEa4pg9hlwGGNnnEeixPolGm cost_basis: 23 institution_price: 27 institution_price_as_of: '2021-04-13' institution_price_datetime: null institution_value: 636.309 iso_currency_code: USD quantity: 23.567 security_id: JDdP7XPMklt5vwPmDN45t3KAoWAPmjtpaW7DP unofficial_currency_code: null - account_id: k67E4xKvMlhmleEa4pg9hlwGGNnnEeixPolGm cost_basis: 15 institution_price: 13.73 institution_price_as_of: '2021-04-13' institution_price_datetime: null institution_value: 1373.6865 iso_currency_code: USD quantity: 100.05 security_id: nnmo8doZ4lfKNEDe3mPJipLGkaGw3jfPrpxoN unofficial_currency_code: null - account_id: k67E4xKvMlhmleEa4pg9hlwGGNnnEeixPolGm cost_basis: 1 institution_price: 1 institution_price_as_of: '2021-04-13' institution_price_datetime: null institution_value: 12345.67 iso_currency_code: USD quantity: 12345.67 security_id: d6ePmbPxgWCWmMVv66q9iPV94n91vMtov5Are unofficial_currency_code: null - account_id: ax0xgOBYRAIqOOjeLZr0iZBb8r6K88HZXpvmq cost_basis: 92.47 institution_price: 0.177494362 institution_price_as_of: '2022-01-14' institution_price_datetime: '2022-06-07T23:01:00Z' institution_value: 4437.35905 iso_currency_code: USD quantity: 25000 security_id: vLRMV3MvY1FYNP91on35CJD5QN5rw9Fpa9qOL unofficial_currency_code: null item: available_products: - balance - identity - liabilities - transactions billed_products: - assets - auth - investments consent_expiration_time: null error: null institution_id: ins_3 item_id: 4z9LPae1nRHWy8pvg9jrsgbRP4ZNQvIdbLq7g update_type: background webhook: https://www.genericwebhookurl.com/webhook request_id: l68wb8zpS0hqmsJ securities: - close_price: 0.011 close_price_as_of: '2021-04-13' cusip: null institution_id: null institution_security_id: null is_cash_equivalent: false isin: null iso_currency_code: USD name: Nflx Feb 01'18 $355 Call proxy_security_id: null security_id: 8E4L9XLl6MudjEpwPAAgivmdZRdBPJuvMPlPb sedol: null ticker_symbol: NFLX180201C00355000 type: derivative unofficial_currency_code: null update_datetime: null market_identifier_code: XNAS option_contract: contract_type: call expiration_date: '2018-02-01' strike_price: 355 underlying_security_ticker: NFLX - close_price: 27 close_price_as_of: null cusip: '577130834' institution_id: null institution_security_id: null is_cash_equivalent: false isin: US5771308344 iso_currency_code: USD name: Matthews Pacific Tiger Fund Insti Class proxy_security_id: null security_id: JDdP7XPMklt5vwPmDN45t3KAoWAPmjtpaW7DP sedol: null ticker_symbol: MIPTX type: mutual fund unofficial_currency_code: null update_datetime: null market_identifier_code: XNAS option_contract: null - close_price: 2.11 close_price_as_of: null cusip: 00448Q201 institution_id: null institution_security_id: null is_cash_equivalent: false isin: US00448Q2012 iso_currency_code: USD name: Achillion Pharmaceuticals Inc. proxy_security_id: null security_id: KDwjlXj1Rqt58dVvmzRguxJybmyQL8FgeWWAy sedol: null ticker_symbol: ACHN type: equity unofficial_currency_code: null update_datetime: null market_identifier_code: XNAS option_contract: null - close_price: 10.42 close_price_as_of: null cusip: '258620103' institution_id: null institution_security_id: null is_cash_equivalent: false isin: US2586201038 iso_currency_code: USD name: DoubleLine Total Return Bond Fund proxy_security_id: null security_id: NDVQrXQoqzt5v3bAe8qRt4A7mK7wvZCLEBBJk sedol: null ticker_symbol: DBLTX type: mutual fund unofficial_currency_code: null update_datetime: null market_identifier_code: XNAS option_contract: null - close_price: 1 close_price_as_of: null cusip: null institution_id: null institution_security_id: null is_cash_equivalent: true isin: null iso_currency_code: USD name: U S Dollar proxy_security_id: null security_id: d6ePmbPxgWCWmMVv66q9iPV94n91vMtov5Are sedol: null ticker_symbol: USD type: cash unofficial_currency_code: null update_datetime: null market_identifier_code: null option_contract: null - close_price: 13.73 close_price_as_of: null cusip: null institution_id: ins_3 institution_security_id: NHX105509 is_cash_equivalent: false isin: null iso_currency_code: USD name: NH PORTFOLIO 1055 (FIDELITY INDEX) proxy_security_id: null security_id: nnmo8doZ4lfKNEDe3mPJipLGkaGw3jfPrpxoN sedol: null ticker_symbol: NHX105509 type: etf unofficial_currency_code: null update_datetime: null market_identifier_code: XNAS option_contract: null - close_price: 0.140034616 close_price_as_of: '2022-01-24' cusip: null institution_id: ins_3 institution_security_id: null is_cash_equivalent: true isin: null iso_currency_code: USD name: Dogecoin proxy_security_id: null security_id: vLRMV3MvY1FYNP91on35CJD5QN5rw9Fpa9qOL sedol: null ticker_symbol: DOGE type: cryptocurrency unofficial_currency_code: null update_datetime: '2022-06-07T23:01:00Z' market_identifier_code: XNAS option_contract: null operationId: investmentsHoldingsGet description: The `/investments/holdings/get` endpoint allows developers to receive user-authorized stock position data for `investment`-type accounts. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/InvestmentsHoldingsGetRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /investments/transactions/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Get investment transactions externalDocs: url: /api/products/investments/#investmentstransactionsget responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/InvestmentsTransactionsGetResponse' examples: example-1: value: accounts: - account_id: 5e66Dl6jNatx3nXPGwZ7UkJed4z6KBcZA4Rbe balances: available: 100 current: 110 iso_currency_code: USD limit: null unofficial_currency_code: null mask: '0000' name: Plaid Checking official_name: Plaid Gold Standard 0% Interest Checking subtype: checking type: depository - account_id: KqZZMoZmBWHJlz7yKaZjHZb78VNpaxfVa7e5z balances: available: null current: 320.76 iso_currency_code: USD limit: null unofficial_currency_code: null mask: '5555' name: Plaid IRA official_name: null subtype: ira type: investment - account_id: rz99ex9ZQotvnjXdgQLEsR81e3ArPgulVWjGj balances: available: null current: 23631.9805 iso_currency_code: USD limit: null unofficial_currency_code: null mask: '6666' name: Plaid 401k official_name: null subtype: 401k type: investment investment_transactions: - account_id: rz99ex9ZQotvnjXdgQLEsR81e3ArPgulVWjGj amount: -8.72 cancel_transaction_id: null date: '2020-05-29' fees: 0 investment_transaction_id: oq99Pz97joHQem4BNjXECev1E4B6L6sRzwANW iso_currency_code: USD name: INCOME DIV DIVIDEND RECEIVED price: 0 quantity: 0 security_id: eW4jmnjd6AtjxXVrjmj6SX1dNEdZp3Cy8RnRQ subtype: dividend type: cash unofficial_currency_code: null - account_id: rz99ex9ZQotvnjXdgQLEsR81e3ArPgulVWjGj amount: -1289.01 cancel_transaction_id: null date: '2020-05-28' fees: 7.99 investment_transaction_id: pK99jB9e7mtwjA435GpVuMvmWQKVbVFLWme57 iso_currency_code: USD name: SELL Matthews Pacific Tiger Fund Insti Class price: 27.53 quantity: -47.74104242992852 security_id: JDdP7XPMklt5vwPmDN45t3KAoWAPmjtpaW7DP subtype: sell type: sell unofficial_currency_code: null - account_id: rz99ex9ZQotvnjXdgQLEsR81e3ArPgulVWjGj amount: 7.7 cancel_transaction_id: null date: '2020-05-27' fees: 7.99 investment_transaction_id: LKoo1ko93wtreBwM7yQnuQ3P5DNKbKSPRzBNv iso_currency_code: USD name: BUY DoubleLine Total Return Bond Fund price: 10.42 quantity: 0.7388014749727547 security_id: NDVQrXQoqzt5v3bAe8qRt4A7mK7wvZCLEBBJk subtype: buy type: buy unofficial_currency_code: null item: available_products: - assets - balance - identity - transactions billed_products: - auth - investments consent_expiration_time: null error: null institution_id: ins_12 item_id: 8Mqq5rqQ7Pcxq9MGDv3JULZ6yzZDLMCwoxGDq update_type: background webhook: https://www.genericwebhookurl.com/webhook request_id: iv4q3ZlytOOthkv securities: - close_price: 27 close_price_as_of: null cusip: '577130834' institution_id: null institution_security_id: null is_cash_equivalent: false isin: US5771308344 iso_currency_code: USD name: Matthews Pacific Tiger Fund Insti Class proxy_security_id: null security_id: JDdP7XPMklt5vwPmDN45t3KAoWAPmjtpaW7DP sedol: null ticker_symbol: MIPTX type: mutual fund unofficial_currency_code: null update_datetime: null market_identifier_code: XNAS option_contract: null - close_price: 10.42 close_price_as_of: null cusip: '258620103' institution_id: null institution_security_id: null is_cash_equivalent: false isin: US2586201038 iso_currency_code: USD name: DoubleLine Total Return Bond Fund proxy_security_id: null security_id: NDVQrXQoqzt5v3bAe8qRt4A7mK7wvZCLEBBJk sedol: null ticker_symbol: DBLTX type: mutual fund unofficial_currency_code: null update_datetime: null market_identifier_code: XNAS option_contract: null - close_price: 34.73 close_price_as_of: null cusip: 84470P109 institution_id: null institution_security_id: null is_cash_equivalent: false isin: US84470P1093 iso_currency_code: USD name: Southside Bancshares Inc. proxy_security_id: null security_id: eW4jmnjd6AtjxXVrjmj6SX1dNEdZp3Cy8RnRQ sedol: null ticker_symbol: SBSI type: equity unofficial_currency_code: null update_datetime: null market_identifier_code: XNAS option_contract: null total_investment_transactions: 3 operationId: investmentsTransactionsGet description: 'The `/investments/transactions/get` endpoint allows developers to retrieve up to 24 months of user-authorized transaction data for investment accounts. Transactions are returned in reverse-chronological order, and the sequence of transaction ordering is stable and will not shift. Due to the potentially large number of investment transactions associated with an Item, results are paginated. Manipulate the count and offset parameters in conjunction with the `total_investment_transactions` response body field to fetch all available investment transactions. Note that Investments does not have a webhook to indicate when initial transaction data has loaded (unless you use the `async_update` option). Instead, if transactions data is not ready when `/investments/transactions/get` is first called, Plaid will wait for the data. For this reason, calling `/investments/transactions/get` immediately after Link may take up to one to two minutes to return. Data returned by the asynchronous investments extraction flow (when `async_update` is set to true) may not be immediately available to `/investments/transactions/get`. To be alerted when the data is ready to be fetched, listen for the `HISTORICAL_UPDATE` webhook. If no investments history is ready when `/investments/transactions/get` is called, it will return a `PRODUCT_NOT_READY` error.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/InvestmentsTransactionsGetRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /investments/refresh: x-hidden-from-docs: true x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Refresh investment data externalDocs: url: /api/products/investments/#investmentsrefresh operationId: investmentsRefresh responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/InvestmentsRefreshResponse' examples: example-1: value: request_id: 1vwmF5TBQwiqfwP default: content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Error response description: '`/investments/refresh` is an optional endpoint for users of the Investments product. It initiates an on-demand extraction to fetch the newest investments, holdings and investment transactions for an Item. This on-demand extraction takes place in addition to the periodic extractions that automatically occur one or more times per day for any Investments-enabled Item. If changes to investments are discovered after calling `/investments/refresh`, Plaid will fire webhooks: [`HOLDINGS: DEFAULT_UPDATE`](https://plaid.com/docs/api/products/investments/#holdings-default_update) if any new holdings are detected, and [INVESTMENTS_TRANSACTIONS: DEFAULT_UPDATE](https://plaid.com/docs/api/products/investments/#investments_transactions-default_update) if any new investment transactions are detected. Updated holdings and investment transactions can be fetched by calling `/investments/holdings/get` and `/investments/transactions/get`. "Note that the `/investments/refresh` endpoint is not supported by all institutions. If called on an Item from an institution that does not support this functionality, it will return a `PRODUCT_NOT_SUPPORTED` error. As this endpoint triggers a synchronous request for fresh data, latency may be higher than for other Plaid endpoints (typically less than 10 seconds, but occasionally up to 30 seconds or more); if you encounter errors, you may find it necessary to adjust your timeout period when making requests. `/investments/refresh` is offered as an add-on to Investments and has a separate [fee model](/docs/account/billing/#per-request-flat-fee). To request access to this endpoint, submit a [product access request](https://dashboard.plaid.com/team/products) or contact your Plaid account manager.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/InvestmentsRefreshRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /item/activity/list: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid List a historical log of user consent events operationId: itemActivityList description: List a historical log of user consent events responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ItemActivityListResponse' examples: example-1: value: request_id: m8MDnv9okwxFNBV activities: [] last_data_access_times: [] default: description: Error response. content: application/json: schema: $ref: '#/components/schemas/PlaidError' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ItemActivityListRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /item/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Retrieve an Item externalDocs: url: /api/items/#itemget operationId: itemGet description: Returns information about the status of an Item. responses: '200': description: success content: application/json: schema: $ref: '#/components/schemas/ItemGetResponse' examples: example-1: value: item: available_products: - balance - auth billed_products: - identity - transactions error: null institution_id: ins_109508 item_id: Ed6bjNrDLJfGvZWwnkQlfxwoNz54B5C97ejBr update_type: background webhook: https://plaid.com/example/hook consent_expiration_time: null status: transactions: last_successful_update: '2019-02-15T15:52:39Z' last_failed_update: '2019-01-22T04:32:00Z' last_webhook: sent_at: '2019-02-15T15:53:00Z' code_sent: DEFAULT_UPDATE request_id: m8MDnv9okwxFNBV default: description: Error response. content: application/json: schema: $ref: '#/components/schemas/PlaidError' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ItemGetRequest' description: '' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /item/remove: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Remove an Item externalDocs: url: /api/items/#itemremove operationId: itemRemove description: 'The `/item/remove` endpoint allows you to remove an Item. Once removed, the `access_token`, as well as any processor tokens or bank account tokens associated with the Item, is no longer valid and cannot be used to access any data that was associated with the Item. Removing an Item does not affect any Asset Reports or Audit Copies you have already created, which will remain accessible until you remove access to them specifically using the `/asset_report/remove` endpoint. Note that in the Development environment, issuing an `/item/remove` request will not decrement your live credential count. To increase your credential account in Development, contact Support. Also note that for certain OAuth-based institutions, an Item removed via `/item/remove` may still show as an active connection in the institution''s OAuth permission manager. API versions 2019-05-29 and earlier return a `removed` boolean as part of the response.' responses: '200': description: success content: application/json: schema: $ref: '#/components/schemas/ItemRemoveResponse' examples: example-1: value: request_id: m8MDnv9okwxFNBV default: description: Error response. content: application/json: schema: $ref: '#/components/schemas/PlaidError' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ItemRemoveRequest' description: '' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /sandbox/item/fire_webhook: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Fire a test webhook externalDocs: url: /api/sandbox/#sandboxitemfire_webhook operationId: sandboxItemFireWebhook description: 'The `/sandbox/item/fire_webhook` endpoint is used to test that code correctly handles webhooks. This endpoint can trigger the following webhooks: `DEFAULT_UPDATE`: Transactions update webhook to be fired for a given Sandbox Item. If the Item does not support Transactions, a `SANDBOX_PRODUCT_NOT_ENABLED` error will result. `NEW_ACCOUNTS_AVAILABLE`: Webhook to be fired for a given Sandbox Item created with Account Select v2. `AUTH_DATA_UPDATE`: Webhook to be fired for a given Sandbox Item created with Auth as an enabled product. `SMS_MICRODEPOSITS_VERIFICATION`: Fired when a given same day micro-deposit item is verified via SMS verification. `LOGIN_REPAIRED`: Fired when an Item recovers from the `ITEM_LOGIN_REQUIRED` without the user going through update mode in your app. `RECURRING_TRANSACTIONS_UPDATE`: Recurring Transactions webhook to be fired for a given Sandbox Item. If the Item does not support Recurring Transactions, a `SANDBOX_PRODUCT_NOT_ENABLED` error will result. `SYNC_UPDATES_AVAILABLE`: Transactions webhook to be fired for a given Sandbox Item. If the Item does not support Transactions, a `SANDBOX_PRODUCT_NOT_ENABLED` error will result. `PRODUCT_READY`: Assets webhook to be fired when a given asset report has been successfully generated. If the Item does not support Assets, a `SANDBOX_PRODUCT_NOT_ENABLED` error will result. `ERROR`: Assets webhook to be fired when asset report generation has failed. If the Item does not support Assets, a `SANDBOX_PRODUCT_NOT_ENABLED` error will result. Note that this endpoint is provided for developer ease-of-use and is not required for testing webhooks; webhooks will also fire in Sandbox under the same conditions that they would in Production or Development (except for webhooks of type `TRANSFER`).' responses: '200': description: success content: application/json: schema: $ref: '#/components/schemas/SandboxItemFireWebhookResponse' examples: example-1: value: webhook_fired: true request_id: 1vwmF5TBQwiqfwP default: description: Error response. content: application/json: schema: $ref: '#/components/schemas/PlaidError' requestBody: required: true description: '' content: application/json: schema: $ref: '#/components/schemas/SandboxItemFireWebhookRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /item/webhook/update: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Update Webhook URL externalDocs: url: /api/items/#itemwebhookupdate operationId: itemWebhookUpdate responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ItemWebhookUpdateResponse' examples: example-1: value: item: available_products: - balance - identity - payment_initiation - transactions billed_products: - assets - auth consent_expiration_time: null error: null institution_id: ins_117650 item_id: DWVAAPWq4RHGlEaNyGKRTAnPLaEmo8Cvq7na6 update_type: background webhook: https://www.genericwebhookurl.com/webhook request_id: vYK11LNTfRoAMbj description: The POST `/item/webhook/update` allows you to update the webhook URL associated with an Item. This request triggers a [`WEBHOOK_UPDATE_ACKNOWLEDGED`](https://plaid.com/docs/api/items/#webhook_update_acknowledged) webhook to the newly specified webhook URL. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ItemWebhookUpdateRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /item/access_token/invalidate: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Invalidate access_token externalDocs: url: /api/tokens/#itemaccess_tokeninvalidate operationId: itemAccessTokenInvalidate responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ItemAccessTokenInvalidateResponse' examples: example-1: value: new_access_token: access-sandbox-8ab976e6-64bc-4b38-98f7-731e7a349970 request_id: m8MDnv9okwxFNBV description: 'By default, the `access_token` associated with an Item does not expire and should be stored in a persistent, secure manner. You can use the `/item/access_token/invalidate` endpoint to rotate the `access_token` associated with an Item. The endpoint returns a new `access_token` and immediately invalidates the previous `access_token`. ' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ItemAccessTokenInvalidateRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /sandbox/item/reset_login: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Force a Sandbox Item into an error state externalDocs: url: /api/sandbox/#sandboxitemreset_login operationId: sandboxItemResetLogin responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/SandboxItemResetLoginResponse' examples: example-1: value: reset_login: true request_id: m8MDnv9okwxFNBV description: '`/sandbox/item/reset_login/` forces an Item into an `ITEM_LOGIN_REQUIRED` state in order to simulate an Item whose login is no longer valid. This makes it easy to test Link''s [update mode](https://plaid.com/docs/link/update-mode) flow in the Sandbox environment. After calling `/sandbox/item/reset_login`, You can then use Plaid Link update mode to restore the Item to a good state. An `ITEM_LOGIN_REQUIRED` webhook will also be fired after a call to this endpoint, if one is associated with the Item. In the Sandbox, Items will transition to an `ITEM_LOGIN_REQUIRED` error state automatically after 30 days, even if this endpoint is not called.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SandboxItemResetLoginRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /sandbox/item/set_verification_status: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Set verification status for Sandbox account externalDocs: url: /api/sandbox/#sandboxitemset_verification_status operationId: sandboxItemSetVerificationStatus responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/SandboxItemSetVerificationStatusResponse' examples: example-1: value: request_id: 1vwmF5TBQwiqfwP description: 'The `/sandbox/item/set_verification_status` endpoint can be used to change the verification status of an Item in in the Sandbox in order to simulate the Automated Micro-deposit flow. For more information on testing Automated Micro-deposits in Sandbox, see [Auth full coverage testing](https://plaid.com/docs/auth/coverage/testing#).' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SandboxItemSetVerificationStatusRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /item/public_token/exchange: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Exchange public token for an access token externalDocs: url: /api/tokens/#itempublic_tokenexchange operationId: itemPublicTokenExchange responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ItemPublicTokenExchangeResponse' examples: example-1: value: access_token: access-sandbox-de3ce8ef-33f8-452c-a685-8671031fc0f6 item_id: M5eVJqLnv3tbzdngLDp9FL5OlDNxlNhlE55op request_id: Aim3b description: 'Exchange a Link `public_token` for an API `access_token`. Link hands off the `public_token` client-side via the `onSuccess` callback once a user has successfully created an Item. The `public_token` is ephemeral and expires after 30 minutes. An `access_token` does not expire, but can be revoked by calling `/item/remove`. The response also includes an `item_id` that should be stored with the `access_token`. The `item_id` is used to identify an Item in a webhook. The `item_id` can also be retrieved by making an `/item/get` request.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ItemPublicTokenExchangeRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /item/public_token/create: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Create public token externalDocs: url: /api/tokens/#itempublic_tokencreate operationId: itemCreatePublicToken responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ItemPublicTokenCreateResponse' examples: example-1: value: public_token: public-sandbox-b0e2c4ee-a763-4df5-bfe9-46a46bce993d request_id: Aim3b description: 'Note: As of July 2020, the `/item/public_token/create` endpoint is deprecated. Instead, use `/link/token/create` with an `access_token` to create a Link token for use with [update mode](https://plaid.com/docs/link/update-mode). If you need your user to take action to restore or resolve an error associated with an Item, generate a public token with the `/item/public_token/create` endpoint and then initialize Link with that `public_token`. A `public_token` is one-time use and expires after 30 minutes. You use a `public_token` to initialize Link in [update mode](https://plaid.com/docs/link/update-mode) for a particular Item. You can generate a `public_token` for an Item even if you did not use Link to create the Item originally. The `/item/public_token/create` endpoint is **not** used to create your initial `public_token`. If you have not already received an `access_token` for a specific Item, use Link to obtain your `public_token` instead. See the [Quickstart](https://plaid.com/docs/quickstart) for more information.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ItemPublicTokenCreateRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /item/import: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Import Item responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ItemImportResponse' examples: example-1: value: access_token: access-sandbox-99ace160-3cf7-4e51-a083-403633425815 request_id: ewIBAn6RZirsk4W operationId: itemImport description: '`/item/import` creates an Item via your Plaid Exchange Integration and returns an `access_token`. As part of an `/item/import` request, you will include a User ID (`user_auth.user_id`) and Authentication Token (`user_auth.auth_token`) that enable data aggregation through your Plaid Exchange API endpoints. These authentication principals are to be chosen by you. Upon creating an Item via `/item/import`, Plaid will automatically begin an extraction of that Item through the Plaid Exchange infrastructure you have already integrated.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ItemImportRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /processor/liabilities/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Retrieve Liabilities data externalDocs: url: /api/processor-partners/#processorliabilitiesget operationId: processorLiabilitiesGet responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ProcessorLiabilitiesGetResponse' examples: example-1: value: account: account_id: dVzbVMLjrxTnLjX4G66XUp5GLklm4oiZy88yK balances: available: null current: 410 iso_currency_code: USD limit: 2000 unofficial_currency_code: null mask: '3333' name: Plaid Credit Card official_name: Plaid Diamond 12.5% APR Interest Credit Card subtype: credit card type: credit liabilities: credit: - account_id: dVzbVMLjrxTnLjX4G66XUp5GLklm4oiZy88yK aprs: - apr_percentage: 15.24 apr_type: balance_transfer_apr balance_subject_to_apr: 1562.32 interest_charge_amount: 130.22 - apr_percentage: 27.95 apr_type: cash_apr balance_subject_to_apr: 56.22 interest_charge_amount: 14.81 - apr_percentage: 12.5 apr_type: purchase_apr balance_subject_to_apr: 157.01 interest_charge_amount: 25.66 - apr_percentage: 0 apr_type: special balance_subject_to_apr: 1000 interest_charge_amount: 0 is_overdue: false last_payment_amount: 168.25 last_payment_date: '2019-05-22' last_statement_issue_date: '2019-05-28' last_statement_balance: 1708.77 minimum_payment_amount: 20 next_payment_due_date: '2020-05-28' mortgage: [] student: [] request_id: dTnnm60WgKGLnKL description: 'The `/processor/liabilities/get` endpoint returns various details about a loan or credit account. Liabilities data is available primarily for US financial institutions, with some limited coverage of Canadian institutions. Currently supported account types are account type `credit` with account subtype `credit card` or `paypal`, and account type `loan` with account subtype `student` or `mortgage`. The types of information returned by Liabilities can include balances and due dates, loan terms, and account details such as original loan amount and guarantor. Data is refreshed approximately once per day; the latest data can be retrieved by calling `/processor/liabilities/get`. Note: This request may take some time to complete if `liabilities` was not specified as an initial product when creating the processor token. This is because Plaid must communicate directly with the institution to retrieve the additional data.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ProcessorLiabilitiesGetRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /liabilities/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Retrieve Liabilities data externalDocs: url: /api/products/liabilities/#liabilitiesget operationId: liabilitiesGet responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/LiabilitiesGetResponse' examples: example-1: value: accounts: - account_id: BxBXxLj1m4HMXBm9WZZmCWVbPjX16EHwv99vp balances: available: 100 current: 110 iso_currency_code: USD limit: null unofficial_currency_code: null mask: '0000' name: Plaid Checking official_name: Plaid Gold Standard 0% Interest Checking subtype: checking type: depository - account_id: dVzbVMLjrxTnLjX4G66XUp5GLklm4oiZy88yK balances: available: null current: 410 iso_currency_code: USD limit: 2000 unofficial_currency_code: null mask: '3333' name: Plaid Credit Card official_name: Plaid Diamond 12.5% APR Interest Credit Card subtype: credit card type: credit - account_id: Pp1Vpkl9w8sajvK6oEEKtr7vZxBnGpf7LxxLE balances: available: null current: 65262 iso_currency_code: USD limit: null unofficial_currency_code: null mask: '7777' name: Plaid Student Loan official_name: null subtype: student type: loan - account_id: BxBXxLj1m4HMXBm9WZJyUg9XLd4rKEhw8Pb1J balances: available: null current: 56302.06 iso_currency_code: USD limit: null unofficial_currency_code: null mask: '8888' name: Plaid Mortgage official_name: null subtype: mortgage type: loan item: available_products: - balance - investments billed_products: - assets - auth - identity - liabilities - transactions consent_expiration_time: null error: null institution_id: ins_3 item_id: eVBnVMp7zdTJLkRNr33Rs6zr7KNJqBFL9DrE6 update_type: background webhook: https://www.genericwebhookurl.com/webhook liabilities: credit: - account_id: dVzbVMLjrxTnLjX4G66XUp5GLklm4oiZy88yK aprs: - apr_percentage: 15.24 apr_type: balance_transfer_apr balance_subject_to_apr: 1562.32 interest_charge_amount: 130.22 - apr_percentage: 27.95 apr_type: cash_apr balance_subject_to_apr: 56.22 interest_charge_amount: 14.81 - apr_percentage: 12.5 apr_type: purchase_apr balance_subject_to_apr: 157.01 interest_charge_amount: 25.66 - apr_percentage: 0 apr_type: special balance_subject_to_apr: 1000 interest_charge_amount: 0 is_overdue: false last_payment_amount: 168.25 last_payment_date: '2019-05-22' last_statement_issue_date: '2019-05-28' last_statement_balance: 1708.77 minimum_payment_amount: 20 next_payment_due_date: '2020-05-28' mortgage: - account_id: BxBXxLj1m4HMXBm9WZJyUg9XLd4rKEhw8Pb1J account_number: '3120194154' current_late_fee: 25 escrow_balance: 3141.54 has_pmi: true has_prepayment_penalty: true interest_rate: percentage: 3.99 type: fixed last_payment_amount: 3141.54 last_payment_date: '2019-08-01' loan_term: 30 year loan_type_description: conventional maturity_date: '2045-07-31' next_monthly_payment: 3141.54 next_payment_due_date: '2019-11-15' origination_date: '2015-08-01' origination_principal_amount: 425000 past_due_amount: 2304 property_address: city: Malakoff country: US postal_code: '14236' region: NY street: 2992 Cameron Road ytd_interest_paid: 12300.4 ytd_principal_paid: 12340.5 student: - account_id: Pp1Vpkl9w8sajvK6oEEKtr7vZxBnGpf7LxxLE account_number: '4277075694' disbursement_dates: - '2002-08-28' expected_payoff_date: '2032-07-28' guarantor: DEPT OF ED interest_rate_percentage: 5.25 is_overdue: false last_payment_amount: 138.05 last_payment_date: '2019-04-22' last_statement_issue_date: '2019-04-28' loan_name: Consolidation loan_status: end_date: '2032-07-28' type: repayment minimum_payment_amount: 25 next_payment_due_date: '2019-05-28' origination_date: '2002-08-28' origination_principal_amount: 25000 outstanding_interest_amount: 6227.36 payment_reference_number: '4277075694' pslf_status: estimated_eligibility_date: '2021-01-01' payments_made: 200 payments_remaining: 160 repayment_plan: description: Standard Repayment type: standard sequence_number: '1' servicer_address: city: San Matias country: US postal_code: '99415' region: CA street: 123 Relaxation Road ytd_interest_paid: 280.55 ytd_principal_paid: 271.65 request_id: dTnnm60WgKGLnKL requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LiabilitiesGetRequest' description: 'The `/liabilities/get` endpoint returns various details about an Item with loan or credit accounts. Liabilities data is available primarily for US financial institutions, with some limited coverage of Canadian institutions. Currently supported account types are account type `credit` with account subtype `credit card` or `paypal`, and account type `loan` with account subtype `student` or `mortgage`. To limit accounts listed in Link to types and subtypes supported by Liabilities, you can use the `account_filters` parameter when [creating a Link token](https://plaid.com/docs/api/tokens/#linktokencreate). The types of information returned by Liabilities can include balances and due dates, loan terms, and account details such as original loan amount and guarantor. Data is refreshed approximately once per day; the latest data can be retrieved by calling `/liabilities/get`. Note: This request may take some time to complete if `liabilities` was not specified as an initial product when creating the Item. This is because Plaid must communicate directly with the institution to retrieve the additional data.' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /link/profile/eligibility/check: x-hidden-from-docs: true x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Check profile eligibility externalDocs: url: /api/link/#profileeligibilitycheck operationId: linkProfileEligibilityCheck responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/LinkProfileEligibilityCheckResponse' examples: example-1: value: profile_matches: true request_id: XQVgFigpGHXkb0b description: 'The `/link/profile/eligibility/check` endpoint can be used to check whether a user with the supplied phone number has a saved profile that satisfies customer-defined eligibility requirements.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LinkProfileEligibilityCheckRequest' description: '' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /link/token/create: x-plaid-business-unit-context: BUSINESS_UNIT_UNDETERMINED post: tags: - Plaid summary: Plaid Create Link Token externalDocs: url: /api/tokens/#linktokencreate operationId: linkTokenCreate responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/LinkTokenCreateResponse' examples: example-1: value: link_token: link-sandbox-af1a0311-da53-4636-b754-dd15cc058176 expiration: '2020-03-27T12:56:34Z' request_id: XQVgFigpGHXkb0b description: 'The `/link/token/create` endpoint creates a `link_token`, which is required as a parameter when initializing Link. Once Link has been initialized, it returns a `public_token`, which can then be exchanged for an `access_token` via `/item/public_token/exchange` as part of the main Link flow. A `link_token` generated by `/link/token/create` is also used to initialize other Link flows, such as the update mode flow for tokens with expired credentials, or the Payment Initiation (Europe) flow.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LinkTokenCreateRequest' description: '' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /link/token/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Get Link Token externalDocs: url: /api/tokens/#linktokenget operationId: linkTokenGet responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/LinkTokenGetResponse' examples: example-1: value: created_at: '2020-12-02T21:14:54Z' expiration: '2020-12-03T01:14:54Z' link_token: link-sandbox-33792986-2b9c-4b80-b1f2-518caaac6183 metadata: account_filters: depository: account_subtypes: - checking - savings client_name: Insert Client name here country_codes: - US initial_products: - auth language: en redirect_uri: null webhook: https://www.example.com/webhook request_id: u0ydFs493XjyTYn description: 'The `/link/token/get` endpoint gets information about a previously-created `link_token` using the `/link/token/create` endpoint. It can be useful for debugging purposes.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LinkTokenGetRequest' description: '' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /link/oauth/correlation_id/exchange: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Exchange the Link Correlation Id for a Link Token externalDocs: url: /api/oauth/#linkcorrelationid operationId: linkOauthCorrelationIdExchange responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/LinkOAuthCorrelationIdExchangeResponse' examples: example-1: value: link_token: link-sandbox-33792986-2b9c-4b80-b1f2-518caaac6183 request_id: u0ydFs493XjyTYn description: 'Exchange an OAuth `link_correlation_id` for the corresponding `link_token`. The `link_correlation_id` is only available for ''payment_initiation'' products and is provided to the client via the OAuth `redirect_uri` as a query parameter. The `link_correlation_id` is ephemeral and expires in a brief period, after which it can no longer be exchanged for the ''link_token''.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LinkOAuthCorrelationIdExchangeRequest' description: '' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /link_delivery/create: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Create Hosted Link session externalDocs: url: /assets/waitlist/hosted-link/ operationId: linkDeliveryCreate responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/LinkDeliveryCreateResponse' examples: example-1: value: link_delivery_url: http://secure.plaid.com/99ace160-3cf7-4e51-a083-403633425815 link_delivery_session_id: 99ace160-3cf7-4e51-a083-403633425815 request_id: 4ciYmmesdqSiUAB default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Use the `/link_delivery/create` endpoint to create a Hosted Link session. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LinkDeliveryCreateRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /link_delivery/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Get Hosted Link session externalDocs: url: /assets/waitlist/hosted-link/ operationId: linkDeliveryGet responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/LinkDeliveryGetResponse' examples: example-1: value: status: COMPLETED created_at: '2019-10-12T07:20:50.52Z' public_tokens: - public-sandbox-b0e2c4ee-a763-4df5-bfe9-46a46bce993d completed_at: '2019-10-12T07:21:50.52Z' request_id: 4ciYmmesdqSiUAB default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Use the `/link_delivery/get` endpoint to get the status of a Hosted Link session. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LinkDeliveryGetRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /consumer_report/pdf/get: x-plaid-business-unit-context: BUSINESS_UNIT_CRA post: tags: - Plaid summary: Plaid Retrieve a PDF Reports responses: '200': description: OK content: application/pdf: schema: $ref: '#/components/schemas/ConsumerReportPDFGetResponse' operationId: consumerReportPdfGet externalDocs: url: /none/ description: 'Retrieves all existing CRB Bank Income and Base reports for the consumer in PDF format. Response is PDF binary data. The `request_id` is returned in the `Plaid-Request-ID` header.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ConsumerReportPDFGetRequest' description: '' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /statements/list: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Retrieve a list of all statements associated with an item. externalDocs: url: /api/products/statements#statementslist responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/StatementsListResponse' examples: example-1: value: item_id: eVBnVMp7zdTJLkRNr33Rs6zr7KNJqBFL9DrE6 institution_id: ins_3 institution_name: Chase accounts: - account_id: 3gE5gnRzNyfXpBK5wEEKcymJ5albGVUqg77gr account_mask: '0000' account_name: Plaid Saving account_official_name: Plaid Silver Standard 0.1% Interest Saving account_subtype: savings account_type: depository statements: - statement_id: vzeNDwK7KQIm4yEog683uElbp9GRLEFXGK98D month: 5 year: 2023 request_id: eYupqX1mZkEuQRx operationId: statementsList description: The `/statements/list` endpoint retrieves a list of all statements associated with an item. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/StatementsListRequest' description: '' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /statements/download: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Retrieve a single statement. externalDocs: url: /api/products/statements#statementsdownload responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/StatementsDownloadResponse' operationId: statementsDownload description: The `/statements/download` endpoint retrieves a single statement PDF in binary format. The response will contain a `Plaid-Content-Hash` header containing a SHA 256 checksum of the statement. This can be used to verify that the file being sent by Plaid is the same file that was downloaded to your system. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/StatementsDownloadRequest' description: '' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /statements/refresh: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid externalDocs: url: /api/products/statements#statementsrefresh summary: Plaid Refresh statements data. responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/StatementsRefreshResponse' examples: example-1: value: request_id: eYupqX1mZkEuQRx operationId: statementsRefresh description: '`/statements/refresh` initiates an on-demand extraction to fetch the statements for the provided dates.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/StatementsRefreshRequest' description: '' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /profile/get: x-hidden-from-docs: true x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Retrieve a Profile externalDocs: url: /api/profile/#profileget operationId: profileGet description: Returns user permissioned profile data including identity and item access tokens. responses: '200': description: success content: application/json: schema: $ref: '#/components/schemas/ProfileGetResponse' examples: example-1: value: identity: name: first_name: Leslie last_name: Knope address: street: 123 Main St. street2: '' city: Pawnee region: IN postal_code: '41006' country: US email: leslie@knope.com phone: '+14151234567' date_of_birth: '1975-01-18' ssn: '987654321' ssn_last_4: '4321' items: - item_id: Ed6bjNrDLJfGvZWwnkQlfxwoNz54B5C97ejBr access_token: access-sandbox-435beced-94e8-4df3-a181-1dde1cfa19f0 request_id: m8MDnv9okwxFNBV default: description: Error response. content: application/json: schema: $ref: '#/components/schemas/PlaidError' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ProfileGetRequest' description: '' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /transactions/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Get transaction data externalDocs: url: /api/products/transactions/#transactionsget operationId: transactionsGet responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/TransactionsGetResponse' examples: example-1: value: accounts: - account_id: BxBXxLj1m4HMXBm9WZZmCWVbPjX16EHwv99vp balances: available: 110.94 current: 110.94 iso_currency_code: USD limit: null unofficial_currency_code: null mask: '0000' name: Plaid Checking official_name: Plaid Gold Standard 0% Interest Checking subtype: checking type: depository transactions: - account_id: BxBXxLj1m4HMXBm9WZZmCWVbPjX16EHwv99vp account_owner: null amount: 28.34 iso_currency_code: USD unofficial_currency_code: null category: - Food and Drink - Restaurants - Fast Food category_id: '13005032' check_number: null counterparties: - name: DoorDash type: marketplace logo_url: https://plaid-counterparty-logos.plaid.com/doordash_1.png website: doordash.com entity_id: YNRJg5o2djJLv52nBA1Yn1KpL858egYVo4dpm confidence_level: HIGH - name: Burger King type: merchant logo_url: https://plaid-merchant-logos.plaid.com/burger_king_155.png website: burgerking.com entity_id: mVrw538wamwdm22mK8jqpp7qd5br0eeV9o4a1 confidence_level: VERY_HIGH date: '2023-09-28' datetime: '2023-09-28T15:10:09Z' authorized_date: '2023-09-27' authorized_datetime: '2023-09-27T08:01:58Z' location: address: null city: null region: null postal_code: null country: null lat: null lon: null store_number: null name: Dd Doordash Burgerkin merchant_name: Burger King merchant_entity_id: mVrw538wamwdm22mK8jqpp7qd5br0eeV9o4a1 logo_url: https://plaid-merchant-logos.plaid.com/burger_king_155.png website: burgerking.com payment_meta: by_order_of: null payee: null payer: null payment_method: null payment_processor: null ppd_id: null reason: null reference_number: null payment_channel: online pending: true pending_transaction_id: null personal_finance_category: primary: FOOD_AND_DRINK detailed: FOOD_AND_DRINK_FAST_FOOD confidence_level: VERY_HIGH personal_finance_category_icon_url: https://plaid-category-icons.plaid.com/PFC_FOOD_AND_DRINK.png transaction_id: yhnUVvtcGGcCKU0bcz8PDQr5ZUxUXebUvbKC0 transaction_code: null transaction_type: digital - account_id: BxBXxLj1m4HMXBm9WZZmCWVbPjX16EHwv99vp account_owner: null amount: 72.1 iso_currency_code: USD unofficial_currency_code: null category: - Shops - Supermarkets and Groceries category_id: '19046000' check_number: null counterparties: - name: Walmart type: merchant logo_url: https://plaid-merchant-logos.plaid.com/walmart_1100.png website: walmart.com entity_id: O5W5j4dN9OR3E6ypQmjdkWZZRoXEzVMz2ByWM confidence_level: VERY_HIGH date: '2023-09-24' datetime: '2023-09-24T11:01:01Z' authorized_date: '2023-09-22' authorized_datetime: '2023-09-22T10:34:50Z' location: address: 13425 Community Rd city: Poway region: CA postal_code: '92064' country: US lat: 32.959068 lon: -117.037666 store_number: '1700' name: 'PURCHASE WM SUPERCENTER #1700' merchant_name: Walmart merchant_entity_id: O5W5j4dN9OR3E6ypQmjdkWZZRoXEzVMz2ByWM logo_url: https://plaid-merchant-logos.plaid.com/walmart_1100.png website: walmart.com payment_meta: by_order_of: null payee: null payer: null payment_method: null payment_processor: null ppd_id: null reason: null reference_number: null payment_channel: in store pending: false pending_transaction_id: no86Eox18VHMvaOVL7gPUM9ap3aR1LsAVZ5nc personal_finance_category: primary: GENERAL_MERCHANDISE detailed: GENERAL_MERCHANDISE_SUPERSTORES confidence_level: VERY_HIGH personal_finance_category_icon_url: https://plaid-category-icons.plaid.com/PFC_GENERAL_MERCHANDISE.png transaction_id: lPNjeW1nR6CDn5okmGQ6hEpMo4lLNoSrzqDje transaction_code: null transaction_type: place item: available_products: - balance - identity - investments billed_products: - assets - auth - liabilities - transactions consent_expiration_time: null error: null institution_id: ins_3 item_id: eVBnVMp7zdTJLkRNr33Rs6zr7KNJqBFL9DrE6 update_type: background webhook: https://www.genericwebhookurl.com/webhook total_transactions: 1 request_id: 45QSn default: content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Error response description: 'Note: All new implementations are encouraged to use `/transactions/sync` rather than `/transactions/get`. `/transactions/sync` provides the same functionality as `/transactions/get` and improves developer ease-of-use for handling transactions updates. The `/transactions/get` endpoint allows developers to receive user-authorized transaction data for credit, depository, and some loan-type accounts (only those with account subtype `student`; coverage may be limited). For transaction history from investments accounts, use the [Investments endpoint](https://plaid.com/docs/api/products/investments/) instead. Transaction data is standardized across financial institutions, and in many cases transactions are linked to a clean name, entity type, location, and category. Similarly, account data is standardized and returned with a clean name, number, balance, and other meta information where available. Transactions are returned in reverse-chronological order, and the sequence of transaction ordering is stable and will not shift. Transactions are not immutable and can also be removed altogether by the institution; a removed transaction will no longer appear in `/transactions/get`. For more details, see [Pending and posted transactions](https://plaid.com/docs/transactions/transactions-data/#pending-and-posted-transactions). Due to the potentially large number of transactions associated with an Item, results are paginated. Manipulate the `count` and `offset` parameters in conjunction with the `total_transactions` response body field to fetch all available transactions. Data returned by `/transactions/get` will be the data available for the Item as of the most recent successful check for new transactions. Plaid typically checks for new data multiple times a day, but these checks may occur less frequently, such as once a day, depending on the institution. To find out when the Item was last updated, use the [Item Debugger](https://plaid.com/docs/account/activity/#troubleshooting-with-item-debugger) or call `/item/get`; the `item.status.transactions.last_successful_update` field will show the timestamp of the most recent successful update. To force Plaid to check for new transactions, you can use the `/transactions/refresh` endpoint. Note that data may not be immediately available to `/transactions/get`. Plaid will begin to prepare transactions data upon Item link, if Link was initialized with `transactions`, or upon the first call to `/transactions/get`, if it wasn''t. To be alerted when transaction data is ready to be fetched, listen for the [`INITIAL_UPDATE`](https://plaid.com/docs/api/products/transactions/#initial_update) and [`HISTORICAL_UPDATE`](https://plaid.com/docs/api/products/transactions/#historical_update) webhooks. If no transaction history is ready when `/transactions/get` is called, it will return a `PRODUCT_NOT_READY` error.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TransactionsGetRequest' examples: {} servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /transactions/refresh: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Refresh transaction data externalDocs: url: /api/products/transactions/#transactionsrefresh operationId: transactionsRefresh responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/TransactionsRefreshResponse' examples: example-1: value: request_id: 1vwmF5TBQwiqfwP default: content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Error response description: '`/transactions/refresh` is an optional endpoint that initiates an on-demand extraction to fetch the newest transactions for an Item. The on-demand extraction takes place in addition to the periodic extractions that automatically occur one or more times per day for any Transactions-enabled Item. The Item must already have Transactions added as a product in order to call `/transactions/refresh`. If changes to transactions are discovered after calling `/transactions/refresh`, Plaid will fire a webhook: for `/transactions/sync` users, [`SYNC_UPDATES_AVAILABLE`](https://plaid.com/docs/api/products/transactions/#sync_updates_available) will be fired if there are any transactions updated, added, or removed. For users of both `/transactions/sync` and `/transactions/get`, [`TRANSACTIONS_REMOVED`](https://plaid.com/docs/api/products/transactions/#transactions_removed) will be fired if any removed transactions are detected, and [`DEFAULT_UPDATE`](https://plaid.com/docs/api/products/transactions/#default_update) will be fired if any new transactions are detected. New transactions can be fetched by calling `/transactions/get` or `/transactions/sync`. Note that the `/transactions/refresh` endpoint is not supported for Capital One (`ins_128026`) and will result in a `PRODUCTS_NOT_SUPPORTED` error if called on an Item from that institution. As this endpoint triggers a synchronous request for fresh data, latency may be higher than for other Plaid endpoints (typically less than 10 seconds, but occasionally up to 30 seconds or more); if you encounter errors, you may find it necessary to adjust your timeout period when making requests. `/transactions/refresh` is offered as an optional add-on to Transactions and has a separate [fee model](/docs/account/billing/#per-request-flat-fee). To request access to this endpoint, submit a [product access request](https://dashboard.plaid.com/team/products) or contact your Plaid account manager.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TransactionsRefreshRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /transactions/recurring/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Fetch recurring transaction streams externalDocs: url: /api/products/transactions/#transactionsrecurringget operationId: transactionsRecurringGet responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/TransactionsRecurringGetResponse' examples: example-1: value: updated_datetime: '2022-05-01T00:00:00Z' inflow_streams: - account_id: lPNjeW1nR6CDn5okmGQ6hEpMo4lLNoSrzqDje stream_id: no86Eox18VHMvaOVL7gPUM9ap3aR1LsAVZ5nc category: - Transfer - Payroll category_id: '21009000' description: Platypus Payroll merchant_name: null personal_finance_category: primary: INCOME detailed: INCOME_WAGES confidence_level: UNKNOWN first_date: '2022-02-28' last_date: '2022-04-30' frequency: SEMI_MONTHLY transaction_ids: - nkeaNrDGrhdo6c4qZWDA8ekuIPuJ4Avg5nKfw - EfC5ekksdy30KuNzad2tQupW8WIPwvjXGbGHL - ozfvj3FFgp6frbXKJGitsDzck5eWQH7zOJBYd - QvdDE8AqVWo3bkBZ7WvCd7LskxVix8Q74iMoK - uQozFPfMzibBouS9h9tz4CsyvFll17jKLdPAF average_amount: amount: -800 iso_currency_code: USD unofficial_currency_code: null last_amount: amount: -1000 iso_currency_code: USD unofficial_currency_code: null is_active: true status: MATURE is_user_modified: true last_user_modified_datetime: '2023-01-19T10:34:50Z' outflow_streams: - account_id: lPNjeW1nR6CDn5okmGQ6hEpMo4lLNoSrzqDff stream_id: no86Eox18VHMvaOVL7gPUM9ap3aR1LsAVZ5nd category: - Service - Utilities - Electric category_id: '18068005' description: ConEd Bill Payment merchant_name: ConEd personal_finance_category: primary: RENT_AND_UTILITIES detailed: RENT_AND_UTILITIES_GAS_AND_ELECTRICITY confidence_level: UNKNOWN first_date: '2022-02-04' last_date: '2022-05-02' frequency: MONTHLY transaction_ids: - yhnUVvtcGGcCKU0bcz8PDQr5ZUxUXebUvbKC0 - HPDnUVgI5Pa0YQSl0rxwYRwVXeLyJXTWDAvpR - jEPoSfF8xzMClE9Ohj1he91QnvYoSdwg7IT8L - CmdQTNgems8BT1B7ibkoUXVPyAeehT3Tmzk0l average_amount: amount: 85 iso_currency_code: USD unofficial_currency_code: null last_amount: amount: 100 iso_currency_code: USD unofficial_currency_code: null is_active: true status: MATURE is_user_modified: false - account_id: lPNjeW1nR6CDn5okmGQ6hEpMo4lLNoSrzqDff stream_id: SrBNJZDuUMweodmPmSOeOImwsWt53ZXfJQAfC category: - Shops - Warehouses and Wholesale Stores category_id: '19051000' description: Costco Annual Membership merchant_name: Costco personal_finance_category: primary: GENERAL_MERCHANDISE detailed: GENERAL_MERCHANDISE_SUPERSTORES confidence_level: UNKNOWN first_date: '2022-01-23' last_date: '2023-01-22' frequency: ANNUALLY transaction_ids: - yqEBJ72cS4jFwcpxJcDuQr94oAQ1R1lMC33D4 - Kz5Hm3cZCgpn4tMEKUGAGD6kAcxMBsEZDSwJJ average_amount: amount: 120 iso_currency_code: USD unofficial_currency_code: null last_amount: amount: 120 iso_currency_code: USD unofficial_currency_code: null is_active: true status: MATURE is_user_modified: true last_user_modified_datetime: '2023-01-19T10:34:50Z' request_id: tbFyCEqkU775ZGG default: content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Error response description: 'The `/transactions/recurring/get` endpoint allows developers to receive a summary of the recurring outflow and inflow streams (expenses and deposits) from a user’s checking, savings or credit card accounts. Additionally, Plaid provides key insights about each recurring stream including the category, merchant, last amount, and more. Developers can use these insights to build tools and experiences that help their users better manage cash flow, monitor subscriptions, reduce spend, and stay on track with bill payments. This endpoint is offered as an add-on to Transactions. To request access to this endpoint, submit a [product access request](https://dashboard.plaid.com/team/products) or contact your Plaid account manager. This endpoint can only be called on an Item that has already been initialized with Transactions (either during Link, by specifying it in `/link/token/create`; or after Link, by calling `/transactions/get` or `/transactions/sync`). For optimal results, we strongly recommend customers using Recurring Transactions to request at least 180 days of history when initializing items with Transactions (using the [`days_requested`](https://plaid.com/docs/api/tokens/#link-token-create-request-transactions-days-requested) option). Once all historical transactions have been fetched, call `/transactions/recurring/get` to receive the Recurring Transactions streams and subscribe to the [`RECURRING_TRANSACTIONS_UPDATE`](https://plaid.com/docs/api/products/transactions/#recurring_transactions_update) webhook. To know when historical transactions have been fetched, if you are using `/transactions/sync` listen for the [`SYNC_UPDATES_AVAILABLE`](https://plaid.com/docs/api/products/transactions/#SyncUpdatesAvailableWebhook-historical-update-complete) webhook and check that the `historical_update_complete` field in the payload is `true`. If using `/transactions/get`, listen for the [`HISTORICAL_UPDATE`](https://plaid.com/docs/api/products/transactions/#historical_update) webhook. After the initial call, you can call `/transactions/recurring/get` endpoint at any point in the future to retrieve the latest summary of recurring streams. Listen to the [`RECURRING_TRANSACTIONS_UPDATE`](https://plaid.com/docs/api/products/transactions/#recurring_transactions_update) webhook to be notified when new updates are available.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TransactionsRecurringGetRequest' examples: {} servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /transactions/sync: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Get incremental transaction updates on an Item externalDocs: url: /api/products/transactions/#transactionssync operationId: transactionsSync responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/TransactionsSyncResponse' examples: example-1: value: accounts: - account_id: BxBXxLj1m4HMXBm9WZZmCWVbPjX16EHwv99vp balances: available: 110.94 current: 110.94 iso_currency_code: USD limit: null unofficial_currency_code: null mask: '0000' name: Plaid Checking official_name: Plaid Gold Standard 0% Interest Checking subtype: checking type: depository added: - account_id: BxBXxLj1m4HMXBm9WZZmCWVbPjX16EHwv99vp account_owner: null amount: 72.1 iso_currency_code: USD unofficial_currency_code: null category: - Shops - Supermarkets and Groceries category_id: '19046000' check_number: null counterparties: - name: Walmart type: merchant logo_url: https://plaid-merchant-logos.plaid.com/walmart_1100.png website: walmart.com entity_id: O5W5j4dN9OR3E6ypQmjdkWZZRoXEzVMz2ByWM confidence_level: VERY_HIGH date: '2023-09-24' datetime: '2023-09-24T11:01:01Z' authorized_date: '2023-09-22' authorized_datetime: '2023-09-22T10:34:50Z' location: address: 13425 Community Rd city: Poway region: CA postal_code: '92064' country: US lat: 32.959068 lon: -117.037666 store_number: '1700' name: 'PURCHASE WM SUPERCENTER #1700' merchant_name: Walmart merchant_entity_id: O5W5j4dN9OR3E6ypQmjdkWZZRoXEzVMz2ByWM logo_url: https://plaid-merchant-logos.plaid.com/walmart_1100.png website: walmart.com payment_meta: by_order_of: null payee: null payer: null payment_method: null payment_processor: null ppd_id: null reason: null reference_number: null payment_channel: in store pending: false pending_transaction_id: no86Eox18VHMvaOVL7gPUM9ap3aR1LsAVZ5nc personal_finance_category: primary: GENERAL_MERCHANDISE detailed: GENERAL_MERCHANDISE_SUPERSTORES confidence_level: VERY_HIGH personal_finance_category_icon_url: https://plaid-category-icons.plaid.com/PFC_GENERAL_MERCHANDISE.png transaction_id: lPNjeW1nR6CDn5okmGQ6hEpMo4lLNoSrzqDje transaction_code: null transaction_type: place modified: - account_id: BxBXxLj1m4HMXBm9WZZmCWVbPjX16EHwv99vp account_owner: null amount: 28.34 iso_currency_code: USD unofficial_currency_code: null category: - Food and Drink - Restaurants - Fast Food category_id: '13005032' check_number: null counterparties: - name: DoorDash type: marketplace logo_url: https://plaid-counterparty-logos.plaid.com/doordash_1.png website: doordash.com entity_id: YNRJg5o2djJLv52nBA1Yn1KpL858egYVo4dpm confidence_level: HIGH - name: Burger King type: merchant logo_url: https://plaid-merchant-logos.plaid.com/burger_king_155.png website: burgerking.com entity_id: mVrw538wamwdm22mK8jqpp7qd5br0eeV9o4a1 confidence_level: VERY_HIGH date: '2023-09-28' datetime: '2023-09-28T15:10:09Z' authorized_date: '2023-09-27' authorized_datetime: '2023-09-27T08:01:58Z' location: address: null city: null region: null postal_code: null country: null lat: null lon: null store_number: null name: Dd Doordash Burgerkin merchant_name: Burger King merchant_entity_id: mVrw538wamwdm22mK8jqpp7qd5br0eeV9o4a1 logo_url: https://plaid-merchant-logos.plaid.com/burger_king_155.png website: burgerking.com payment_meta: by_order_of: null payee: null payer: null payment_method: null payment_processor: null ppd_id: null reason: null reference_number: null payment_channel: online pending: true pending_transaction_id: null personal_finance_category: primary: FOOD_AND_DRINK detailed: FOOD_AND_DRINK_FAST_FOOD confidence_level: VERY_HIGH personal_finance_category_icon_url: https://plaid-category-icons.plaid.com/PFC_FOOD_AND_DRINK.png transaction_id: yhnUVvtcGGcCKU0bcz8PDQr5ZUxUXebUvbKC0 transaction_code: null transaction_type: digital removed: - account_id: BxBXxLj1m4HMXBm9WZZmCWVbPjX16EHwv99vp transaction_id: CmdQTNgems8BT1B7ibkoUXVPyAeehT3Tmzk0l next_cursor: tVUUL15lYQN5rBnfDIc1I8xudpGdIlw9nsgeXWvhOfkECvUeR663i3Dt1uf/94S8ASkitgLcIiOSqNwzzp+bh89kirazha5vuZHBb2ZA5NtCDkkV has_more: false request_id: Wvhy9PZHQLV8njG transactions_update_status: HISTORICAL_UPDATE_COMPLETE default: content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Error response description: 'The `/transactions/sync` endpoint allows developers to subscribe to all transactions associated with an Item and get updates synchronously in a stream-like manner, using a cursor to track which updates have already been seen. `/transactions/sync` provides the same functionality as `/transactions/get` and can be used instead of `/transactions/get` to simplify the process of tracking transactions updates. To learn more about migrating from `/transactions/get`, see the [Transactions Sync migration guide](https://plaid.com/docs/transactions/sync-migration/). This endpoint provides user-authorized transaction data for `credit`, `depository`, and some loan-type accounts (only those with account subtype `student`; coverage may be limited). For transaction history from `investments` accounts, use `/investments/transactions/get` instead. Returned transactions data is grouped into three types of update, indicating whether the transaction was added, removed, or modified since the last call to the API. In the first call to `/transactions/sync` for an Item, the endpoint will return all historical transactions data associated with that Item up until the time of the API call (as "adds"), which then generates a `next_cursor` for that Item. In subsequent calls, send the `next_cursor` to receive only the changes that have occurred since the previous call. Due to the potentially large number of transactions associated with an Item, results are paginated. The `has_more` field specifies if additional calls are necessary to fetch all available transaction updates. Call `/transactions/sync` with the new cursor, pulling all updates, until `has_more` is `false`. When retrieving paginated updates, track both the `next_cursor` from the latest response and the original cursor from the first call in which `has_more` was `true`; if a call to `/transactions/sync` fails due to the [`TRANSACTIONS_SYNC_MUTATION_DURING_PAGINATION`](https://plaid.com/docs/errors/transactions/#transactions_sync_mutation_during_pagination) error, the entire pagination request loop must be restarted beginning with the cursor for the first page of the update, rather than retrying only the single request that failed. Whenever new or updated transaction data becomes available, `/transactions/sync` will provide these updates. Plaid typically checks for new data multiple times a day, but these checks may occur less frequently, such as once a day, depending on the institution. To find out when the Item was last updated, use the [Item Debugger](https://plaid.com/docs/account/activity/#troubleshooting-with-item-debugger) or call `/item/get`; the `item.status.transactions.last_successful_update` field will show the timestamp of the most recent successful update. To force Plaid to check for new transactions, use the `/transactions/refresh` endpoint. For newly created Items, data may not be immediately available to `/transactions/sync`. Plaid begins preparing transactions data when the Item is created, but the process can take anywhere from a few seconds to several minutes to complete, depending on the number of transactions available. To be alerted when new data is available, listen for the [`SYNC_UPDATES_AVAILABLE`](https://plaid.com/docs/api/products/transactions/#sync_updates_available) webhook.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TransactionsSyncRequest' examples: {} servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /transactions/enrich: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Enrich locally-held transaction data externalDocs: url: /api/products/enrich/#transactionsenrich operationId: transactionsEnrich responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/TransactionsEnrichResponse' examples: example-1: value: enriched_transactions: - id: 6135818adda16500147e7c1d description: 'PURCHASE WM SUPERCENTER #1700' amount: 72.1 direction: OUTFLOW iso_currency_code: USD enrichments: counterparties: - name: Walmart type: merchant logo_url: https://plaid-merchant-logos.plaid.com/walmart_1100.png website: walmart.com entity_id: O5W5j4dN9OR3E6ypQmjdkWZZRoXEzVMz2ByWM confidence_level: VERY_HIGH phone_number: '+18009256278' entity_id: O5W5j4dN9OR3E6ypQmjdkWZZRoXEzVMz2ByWM location: address: 13425 Community Rd city: Poway region: CA postal_code: '92064' country: US store_number: '1700' lat: 32.959068 lon: -117.037666 logo_url: https://plaid-merchant-logos.plaid.com/walmart_1100.png merchant_name: Walmart payment_channel: in store personal_finance_category: detailed: GENERAL_MERCHANDISE_SUPERSTORES primary: GENERAL_MERCHANDISE confidence_level: VERY_HIGH phone_number: '+18009256278' recurrence: is_recurring: false personal_finance_category_icon_url: https://plaid-category-icons.plaid.com/PFC_GENERAL_MERCHANDISE.png website: walmart.com - id: 3958434bhde9384bcmeo3401 description: DD DOORDASH BURGERKIN 855-123-4567 CA amount: 28.34 direction: OUTFLOW iso_currency_code: USD enrichments: counterparties: - name: DoorDash type: marketplace logo_url: https://plaid-counterparty-logos.plaid.com/doordash_1.png website: doordash.com entity_id: YNRJg5o2djJLv52nBA1Yn1KpL858egYVo4dpm confidence_level: VERY_HIGH phone_number: '+18001234567' - name: Burger King type: merchant logo_url: https://plaid-merchant-logos.plaid.com/burger_king_155.png website: burgerking.com entity_id: mVrw538wamwdm22mK8jqpp7qd5br0eeV9o4a1 confidence_level: VERY_HIGH phone_number: null location: address: null city: null region: null postal_code: null country: null store_number: null lat: null lon: null entity_id: mVrw538wamwdm22mK8jqpp7qd5br0eeV9o4a1 logo_url: https://plaid-merchant-logos.plaid.com/burger_king_155.png merchant_name: Burger King payment_channel: online personal_finance_category: detailed: FOOD_AND_DRINK_FAST_FOOD primary: FOOD_AND_DRINK confidence_level: VERY_HIGH personal_finance_category_icon_url: https://plaid-category-icons.plaid.com/PFC_FOOD_AND_DRINK.png phone_number: null recurrence: is_recurring: false website: burgerking.com request_id: Wvhy9PZHQLV8njG default: content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Error response description: The `/transactions/enrich` endpoint enriches raw transaction data generated by your own banking products or retrieved from other non-Plaid sources. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TransactionsEnrichRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /sandbox/processor_token/create: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Create a test Item and processor token externalDocs: url: /api/sandbox/#sandboxprocessor_tokencreate operationId: sandboxProcessorTokenCreate description: Use the `/sandbox/processor_token/create` endpoint to create a valid `processor_token` for an arbitrary institution ID and test credentials. The created `processor_token` corresponds to a new Sandbox Item. You can then use this `processor_token` with the `/processor/` API endpoints in Sandbox. You can also use `/sandbox/processor_token/create` with the [`user_custom` test username](https://plaid.com/docs/sandbox/user-custom) to generate a test account with custom data. responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/SandboxProcessorTokenCreateResponse' examples: example-1: value: processor_token: processor-sandbox-b0e2c4ee-a763-4df5-bfe9-46a46bce993d request_id: Aim3b default: description: Error response. content: application/json: schema: $ref: '#/components/schemas/PlaidError' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SandboxProcessorTokenCreateRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /sandbox/public_token/create: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Create a test Item externalDocs: url: /api/sandbox/#sandboxpublic_tokencreate operationId: sandboxPublicTokenCreate description: Use the `/sandbox/public_token/create` endpoint to create a valid `public_token` for an arbitrary institution ID, initial products, and test credentials. The created `public_token` maps to a new Sandbox Item. You can then call `/item/public_token/exchange` to exchange the `public_token` for an `access_token` and perform all API actions. `/sandbox/public_token/create` can also be used with the [`user_custom` test username](https://plaid.com/docs/sandbox/user-custom) to generate a test account with custom data. `/sandbox/public_token/create` cannot be used with OAuth institutions. responses: '200': description: success content: application/json: schema: $ref: '#/components/schemas/SandboxPublicTokenCreateResponse' examples: example-1: value: public_token: public-sandbox-b0e2c4ee-a763-4df5-bfe9-46a46bce993d request_id: Aim3b default: description: Error response. content: application/json: schema: $ref: '#/components/schemas/PlaidError' requestBody: required: true description: '' content: application/json: schema: $ref: '#/components/schemas/SandboxPublicTokenCreateRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /watchlist_screening/entity/create: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Create a watchlist screening for an entity operationId: watchlistScreeningEntityCreate responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/WatchlistScreeningEntityCreateResponse' examples: example-1: value: id: entscr_52xR9LKo77r1Np search_terms: entity_watchlist_program_id: entprg_2eRPsDnL66rZ7H legal_name: Al-Qaida document_number: C31195855 email_address: user@example.com country: US phone_number: '+14025671234' url: https://example.com version: 1 assignee: 54350110fedcbaf01234ffee status: cleared client_user_id: your-db-id-3b24110 audit_trail: source: dashboard dashboard_user_id: 54350110fedcbaf01234ffee timestamp: '2020-07-24T03:26:02Z' request_id: saKrIBuEB9qJZng description: Create a new entity watchlist screening to check your customer against watchlists defined in the associated entity watchlist program. If your associated program has ongoing screening enabled, this is the profile information that will be used to monitor your customer over time. tags: - Plaid requestBody: content: application/json: schema: $ref: '#/components/schemas/WatchlistScreeningEntityCreateRequest' required: true externalDocs: url: /api/products/monitor/#watchlist_screeningentitycreate servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /watchlist_screening/entity/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Get an entity screening tags: - Plaid responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/WatchlistScreeningEntityGetResponse' examples: example-1: value: id: entscr_52xR9LKo77r1Np search_terms: entity_watchlist_program_id: entprg_2eRPsDnL66rZ7H legal_name: Al-Qaida document_number: C31195855 email_address: user@example.com country: US phone_number: '+14025671234' url: https://example.com version: 1 assignee: 54350110fedcbaf01234ffee status: cleared client_user_id: your-db-id-3b24110 audit_trail: source: dashboard dashboard_user_id: 54350110fedcbaf01234ffee timestamp: '2020-07-24T03:26:02Z' request_id: saKrIBuEB9qJZng operationId: watchlistScreeningEntityGet description: Retrieve an entity watchlist screening. requestBody: content: application/json: schema: $ref: '#/components/schemas/WatchlistScreeningEntityGetRequest' required: true externalDocs: url: /api/products/monitor/#watchlist_screeningentityget servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /watchlist_screening/entity/history/list: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid List history for entity watchlist screenings tags: - Plaid responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/WatchlistScreeningEntityHistoryListResponse' examples: example-1: value: entity_watchlist_screenings: - id: entscr_52xR9LKo77r1Np search_terms: entity_watchlist_program_id: entprg_2eRPsDnL66rZ7H legal_name: Al-Qaida document_number: C31195855 email_address: user@example.com country: US phone_number: '+14025671234' url: https://example.com version: 1 assignee: 54350110fedcbaf01234ffee status: cleared client_user_id: your-db-id-3b24110 audit_trail: source: dashboard dashboard_user_id: 54350110fedcbaf01234ffee timestamp: '2020-07-24T03:26:02Z' next_cursor: eyJkaXJlY3Rpb24iOiJuZXh0Iiwib2Zmc2V0IjoiMTU5NDM request_id: saKrIBuEB9qJZng operationId: watchlistScreeningEntityHistoryList description: List all changes to the entity watchlist screening in reverse-chronological order. If the watchlist screening has not been edited, no history will be returned. requestBody: content: application/json: schema: $ref: '#/components/schemas/WatchlistScreeningEntityHistoryListRequest' required: true externalDocs: url: /api/products/monitor/#watchlist_screeningentityhistorylist servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /watchlist_screening/entity/hit/list: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid List hits for entity watchlist screenings tags: - Plaid responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/WatchlistScreeningEntityHitListResponse' examples: example-1: value: entity_watchlist_screening_hits: - id: enthit_52xR9LKo77r1Np review_status: pending_review first_active: '2020-07-24T03:26:02Z' inactive_since: '2020-07-24T03:26:02Z' historical_since: '2020-07-24T03:26:02Z' list_code: EU_CON plaid_uid: uid_3NggckTimGSJHS source_uid: 26192ABC analysis: documents: match email_addresses: match locations: match names: match phone_numbers: match urls: match search_terms_version: 1 data: documents: - analysis: summary: match data: type: swift number: C31195855 email_addresses: - analysis: summary: match data: email_address: user@example.com locations: - analysis: summary: match data: full: Florida, US country: US names: - analysis: summary: match data: full: Al Qaida is_primary: false weak_alias_determination: none phone_numbers: - analysis: summary: match data: type: phone phone_number: '+14025671234' urls: - analysis: summary: match data: url: https://example.com next_cursor: eyJkaXJlY3Rpb24iOiJuZXh0Iiwib2Zmc2V0IjoiMTU5NDM request_id: saKrIBuEB9qJZng operationId: watchlistScreeningEntityHitList description: List all hits for the entity watchlist screening. requestBody: content: application/json: schema: $ref: '#/components/schemas/WatchlistScreeningEntityHitListRequest' required: true externalDocs: url: /api/products/monitor/#watchlist_screeningentityhitlist servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /watchlist_screening/entity/list: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid List entity watchlist screenings responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/WatchlistScreeningEntityListResponse' examples: example-1: value: entity_watchlist_screenings: - id: entscr_52xR9LKo77r1Np search_terms: entity_watchlist_program_id: entprg_2eRPsDnL66rZ7H legal_name: Al-Qaida document_number: C31195855 email_address: user@example.com country: US phone_number: '+14025671234' url: https://example.com version: 1 assignee: 54350110fedcbaf01234ffee status: cleared client_user_id: your-db-id-3b24110 audit_trail: source: dashboard dashboard_user_id: 54350110fedcbaf01234ffee timestamp: '2020-07-24T03:26:02Z' next_cursor: eyJkaXJlY3Rpb24iOiJuZXh0Iiwib2Zmc2V0IjoiMTU5NDM request_id: saKrIBuEB9qJZng operationId: watchlistScreeningEntityList description: List all entity screenings. tags: - Plaid requestBody: content: application/json: schema: $ref: '#/components/schemas/WatchlistScreeningEntityListRequest' required: true externalDocs: url: /api/products/monitor/#watchlist_screeningentitylist servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /watchlist_screening/entity/program/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Get entity watchlist screening program tags: - Plaid responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/WatchlistScreeningEntityProgramGetResponse' examples: example-1: value: id: entprg_2eRPsDnL66rZ7H created_at: '2020-07-24T03:26:02Z' is_rescanning_enabled: true lists_enabled: - EU_CON name: Sample Program name_sensitivity: balanced audit_trail: source: dashboard dashboard_user_id: 54350110fedcbaf01234ffee timestamp: '2020-07-24T03:26:02Z' is_archived: false request_id: saKrIBuEB9qJZng operationId: watchlistScreeningEntityProgramGet description: Get an entity watchlist screening program requestBody: content: application/json: schema: $ref: '#/components/schemas/WatchlistScreeningEntityProgramGetRequest' required: true externalDocs: url: /api/products/monitor/#watchlist_screeningentityprogramget servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /watchlist_screening/entity/program/list: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid List entity watchlist screening programs responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/WatchlistScreeningEntityProgramListResponse' examples: example-1: value: entity_watchlist_programs: - id: entprg_2eRPsDnL66rZ7H created_at: '2020-07-24T03:26:02Z' is_rescanning_enabled: true lists_enabled: - EU_CON name: Sample Program name_sensitivity: balanced audit_trail: source: dashboard dashboard_user_id: 54350110fedcbaf01234ffee timestamp: '2020-07-24T03:26:02Z' is_archived: false next_cursor: eyJkaXJlY3Rpb24iOiJuZXh0Iiwib2Zmc2V0IjoiMTU5NDM request_id: saKrIBuEB9qJZng operationId: watchlistScreeningEntityProgramList description: List all entity watchlist screening programs tags: - Plaid requestBody: content: application/json: schema: $ref: '#/components/schemas/WatchlistScreeningEntityProgramListRequest' required: true externalDocs: url: /api/products/monitor/#watchlist_screeningentityprogramlist servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /watchlist_screening/entity/review/create: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Create a review for an entity watchlist screening operationId: watchlistScreeningEntityReviewCreate description: Create a review for an entity watchlist screening. Reviews are compliance reports created by users in your organization regarding the relevance of potential hits found by Plaid. requestBody: content: application/json: schema: $ref: '#/components/schemas/WatchlistScreeningEntityReviewCreateRequest' required: true responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/WatchlistScreeningEntityReviewCreateResponse' examples: example-1: value: id: entrev_aCLNRxK3UVzn2r confirmed_hits: - enthit_52xR9LKo77r1Np dismissed_hits: - enthit_52xR9LKo77r1Np comment: These look like legitimate matches, rejecting the customer. audit_trail: source: dashboard dashboard_user_id: 54350110fedcbaf01234ffee timestamp: '2020-07-24T03:26:02Z' request_id: saKrIBuEB9qJZng tags: - Plaid externalDocs: url: /api/products/monitor/#watchlist_screeningentityreviewcreate servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /watchlist_screening/entity/review/list: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid List reviews for entity watchlist screenings tags: - Plaid responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/WatchlistScreeningEntityReviewListResponse' examples: example-1: value: entity_watchlist_screening_reviews: - id: entrev_aCLNRxK3UVzn2r confirmed_hits: - enthit_52xR9LKo77r1Np dismissed_hits: - enthit_52xR9LKo77r1Np comment: These look like legitimate matches, rejecting the customer. audit_trail: source: dashboard dashboard_user_id: 54350110fedcbaf01234ffee timestamp: '2020-07-24T03:26:02Z' next_cursor: eyJkaXJlY3Rpb24iOiJuZXh0Iiwib2Zmc2V0IjoiMTU5NDM request_id: saKrIBuEB9qJZng operationId: watchlistScreeningEntityReviewList description: List all reviews for a particular entity watchlist screening. Reviews are compliance reports created by users in your organization regarding the relevance of potential hits found by Plaid. requestBody: content: application/json: schema: $ref: '#/components/schemas/WatchlistScreeningEntityReviewListRequest' required: true externalDocs: url: /api/products/monitor/#watchlist_screeningentityreviewlist servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /watchlist_screening/entity/update: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Update an entity screening operationId: watchlistScreeningEntityUpdate responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/WatchlistScreeningEntityUpdateResponse' examples: example-1: value: id: entscr_52xR9LKo77r1Np search_terms: entity_watchlist_program_id: entprg_2eRPsDnL66rZ7H legal_name: Al-Qaida document_number: C31195855 email_address: user@example.com country: US phone_number: '+14025671234' url: https://example.com version: 1 assignee: 54350110fedcbaf01234ffee status: cleared client_user_id: your-db-id-3b24110 audit_trail: source: dashboard dashboard_user_id: 54350110fedcbaf01234ffee timestamp: '2020-07-24T03:26:02Z' request_id: saKrIBuEB9qJZng description: Update an entity watchlist screening. tags: - Plaid requestBody: content: application/json: schema: $ref: '#/components/schemas/WatchlistScreeningEntityUpdateRequest' description: The entity screening was successfully updated. required: true externalDocs: url: /api/products/monitor/#watchlist_screeningentityupdate servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /watchlist_screening/individual/create: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Create a watchlist screening for a person operationId: watchlistScreeningIndividualCreate responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/WatchlistScreeningIndividualCreateResponse' examples: example-1: value: id: scr_52xR9LKo77r1Np search_terms: watchlist_program_id: prg_2eRPsDnL66rZ7H legal_name: Aleksey Potemkin date_of_birth: '1990-05-29' document_number: C31195855 country: US version: 1 assignee: 54350110fedcbaf01234ffee status: cleared client_user_id: your-db-id-3b24110 audit_trail: source: dashboard dashboard_user_id: 54350110fedcbaf01234ffee timestamp: '2020-07-24T03:26:02Z' request_id: saKrIBuEB9qJZng description: Create a new Watchlist Screening to check your customer against watchlists defined in the associated Watchlist Program. If your associated program has ongoing screening enabled, this is the profile information that will be used to monitor your customer over time. tags: - Plaid requestBody: content: application/json: schema: $ref: '#/components/schemas/WatchlistScreeningIndividualCreateRequest' required: true externalDocs: url: /api/products/monitor/#watchlist_screeningindividualcreate servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /watchlist_screening/individual/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Retrieve an individual watchlist screening tags: - Plaid responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/WatchlistScreeningIndividualGetResponse' examples: example-1: value: id: scr_52xR9LKo77r1Np search_terms: watchlist_program_id: prg_2eRPsDnL66rZ7H legal_name: Aleksey Potemkin date_of_birth: '1990-05-29' document_number: C31195855 country: US version: 1 assignee: 54350110fedcbaf01234ffee status: cleared client_user_id: your-db-id-3b24110 audit_trail: source: dashboard dashboard_user_id: 54350110fedcbaf01234ffee timestamp: '2020-07-24T03:26:02Z' request_id: saKrIBuEB9qJZng operationId: watchlistScreeningIndividualGet description: Retrieve a previously created individual watchlist screening requestBody: content: application/json: schema: $ref: '#/components/schemas/WatchlistScreeningIndividualGetRequest' required: true externalDocs: url: /api/products/monitor/#watchlist_screeningindividualget servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /watchlist_screening/individual/history/list: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid List history for individual watchlist screenings tags: - Plaid responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/WatchlistScreeningIndividualHistoryListResponse' examples: example-1: value: watchlist_screenings: - id: scr_52xR9LKo77r1Np search_terms: watchlist_program_id: prg_2eRPsDnL66rZ7H legal_name: Aleksey Potemkin date_of_birth: '1990-05-29' document_number: C31195855 country: US version: 1 assignee: 54350110fedcbaf01234ffee status: cleared client_user_id: your-db-id-3b24110 audit_trail: source: dashboard dashboard_user_id: 54350110fedcbaf01234ffee timestamp: '2020-07-24T03:26:02Z' next_cursor: eyJkaXJlY3Rpb24iOiJuZXh0Iiwib2Zmc2V0IjoiMTU5NDM request_id: saKrIBuEB9qJZng operationId: watchlistScreeningIndividualHistoryList description: List all changes to the individual watchlist screening in reverse-chronological order. If the watchlist screening has not been edited, no history will be returned. requestBody: content: application/json: schema: $ref: '#/components/schemas/WatchlistScreeningIndividualHistoryListRequest' required: true externalDocs: url: /api/products/monitor/#watchlist_screeningindividualhistorylist servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /watchlist_screening/individual/hit/list: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid List hits for individual watchlist screening tags: - Plaid responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/WatchlistScreeningIndividualHitListResponse' examples: example-1: value: watchlist_screening_hits: - id: scrhit_52xR9LKo77r1Np review_status: pending_review first_active: '2020-07-24T03:26:02Z' inactive_since: '2020-07-24T03:26:02Z' historical_since: '2020-07-24T03:26:02Z' list_code: US_SDN plaid_uid: uid_3NggckTimGSJHS source_uid: 26192ABC analysis: dates_of_birth: match documents: match locations: match names: match search_terms_version: 1 data: dates_of_birth: - analysis: summary: match data: beginning: '1990-05-29' ending: '1990-05-29' documents: - analysis: summary: match data: type: passport number: C31195855 locations: - analysis: summary: match data: full: Florida, US country: US names: - analysis: summary: match data: full: Aleksey Potemkin is_primary: false weak_alias_determination: none next_cursor: eyJkaXJlY3Rpb24iOiJuZXh0Iiwib2Zmc2V0IjoiMTU5NDM request_id: saKrIBuEB9qJZng operationId: watchlistScreeningIndividualHitList description: List all hits found by Plaid for a particular individual watchlist screening. requestBody: content: application/json: schema: $ref: '#/components/schemas/WatchlistScreeningIndividualHitListRequest' required: true externalDocs: url: /api/products/monitor/#watchlist_screeningindividualhitlist servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /watchlist_screening/individual/list: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid List Individual Watchlist Screenings responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/WatchlistScreeningIndividualListResponse' examples: example-1: value: watchlist_screenings: - id: scr_52xR9LKo77r1Np search_terms: watchlist_program_id: prg_2eRPsDnL66rZ7H legal_name: Aleksey Potemkin date_of_birth: '1990-05-29' document_number: C31195855 country: US version: 1 assignee: 54350110fedcbaf01234ffee status: cleared client_user_id: your-db-id-3b24110 audit_trail: source: dashboard dashboard_user_id: 54350110fedcbaf01234ffee timestamp: '2020-07-24T03:26:02Z' next_cursor: eyJkaXJlY3Rpb24iOiJuZXh0Iiwib2Zmc2V0IjoiMTU5NDM request_id: saKrIBuEB9qJZng operationId: watchlistScreeningIndividualList description: List previously created watchlist screenings for individuals tags: - Plaid requestBody: content: application/json: schema: $ref: '#/components/schemas/WatchlistScreeningIndividualListRequest' required: true externalDocs: url: /api/products/monitor/#watchlist_screeningindividuallist servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /watchlist_screening/individual/program/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Get individual watchlist screening program tags: - Plaid responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/WatchlistScreeningIndividualProgramGetResponse' examples: example-1: value: id: prg_2eRPsDnL66rZ7H created_at: '2020-07-24T03:26:02Z' is_rescanning_enabled: true lists_enabled: - US_SDN name: Sample Program name_sensitivity: balanced audit_trail: source: dashboard dashboard_user_id: 54350110fedcbaf01234ffee timestamp: '2020-07-24T03:26:02Z' is_archived: false request_id: saKrIBuEB9qJZng operationId: watchlistScreeningIndividualProgramGet description: Get an individual watchlist screening program requestBody: content: application/json: schema: $ref: '#/components/schemas/WatchlistScreeningIndividualProgramGetRequest' required: true externalDocs: url: /api/products/monitor/#watchlist_screeningindividualprogramget servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /watchlist_screening/individual/program/list: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid List individual watchlist screening programs responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/WatchlistScreeningIndividualProgramListResponse' examples: example-1: value: watchlist_programs: - id: prg_2eRPsDnL66rZ7H created_at: '2020-07-24T03:26:02Z' is_rescanning_enabled: true lists_enabled: - US_SDN name: Sample Program name_sensitivity: balanced audit_trail: source: dashboard dashboard_user_id: 54350110fedcbaf01234ffee timestamp: '2020-07-24T03:26:02Z' is_archived: false next_cursor: eyJkaXJlY3Rpb24iOiJuZXh0Iiwib2Zmc2V0IjoiMTU5NDM request_id: saKrIBuEB9qJZng operationId: watchlistScreeningIndividualProgramList description: List all individual watchlist screening programs tags: - Plaid requestBody: content: application/json: schema: $ref: '#/components/schemas/WatchlistScreeningIndividualProgramListRequest' required: true externalDocs: url: /api/products/monitor/#watchlist_screeningindividualprogramlist servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /watchlist_screening/individual/review/create: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Create a review for an individual watchlist screening operationId: watchlistScreeningIndividualReviewCreate description: Create a review for the individual watchlist screening. Reviews are compliance reports created by users in your organization regarding the relevance of potential hits found by Plaid. requestBody: content: application/json: schema: $ref: '#/components/schemas/WatchlistScreeningIndividualReviewCreateRequest' required: true responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/WatchlistScreeningIndividualReviewCreateResponse' examples: example-1: value: id: rev_aCLNRxK3UVzn2r confirmed_hits: - scrhit_52xR9LKo77r1Np dismissed_hits: - scrhit_52xR9LKo77r1Np comment: These look like legitimate matches, rejecting the customer. audit_trail: source: dashboard dashboard_user_id: 54350110fedcbaf01234ffee timestamp: '2020-07-24T03:26:02Z' request_id: saKrIBuEB9qJZng tags: - Plaid externalDocs: url: /api/products/monitor/#watchlist_screeningindividualreviewcreate servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /watchlist_screening/individual/review/list: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid List reviews for individual watchlist screenings tags: - Plaid responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/WatchlistScreeningIndividualReviewListResponse' examples: example-1: value: watchlist_screening_reviews: - id: rev_aCLNRxK3UVzn2r confirmed_hits: - scrhit_52xR9LKo77r1Np dismissed_hits: - scrhit_52xR9LKo77r1Np comment: These look like legitimate matches, rejecting the customer. audit_trail: source: dashboard dashboard_user_id: 54350110fedcbaf01234ffee timestamp: '2020-07-24T03:26:02Z' next_cursor: eyJkaXJlY3Rpb24iOiJuZXh0Iiwib2Zmc2V0IjoiMTU5NDM request_id: saKrIBuEB9qJZng operationId: watchlistScreeningIndividualReviewList description: List all reviews for the individual watchlist screening. requestBody: content: application/json: schema: $ref: '#/components/schemas/WatchlistScreeningIndividualReviewListRequest' required: true externalDocs: url: /api/products/monitor/#watchlist_screeningindividualreviewlist servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /watchlist_screening/individual/update: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Update individual watchlist screening operationId: watchlistScreeningIndividualUpdate responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/WatchlistScreeningIndividualUpdateResponse' examples: example-1: value: id: scr_52xR9LKo77r1Np search_terms: watchlist_program_id: prg_2eRPsDnL66rZ7H legal_name: Aleksey Potemkin date_of_birth: '1990-05-29' document_number: C31195855 country: US version: 1 assignee: 54350110fedcbaf01234ffee status: cleared client_user_id: your-db-id-3b24110 audit_trail: source: dashboard dashboard_user_id: 54350110fedcbaf01234ffee timestamp: '2020-07-24T03:26:02Z' request_id: saKrIBuEB9qJZng description: Update a specific individual watchlist screening. This endpoint can be used to add additional customer information, correct outdated information, add a reference id, assign the individual to a reviewer, and update which program it is associated with. Please note that you may not update `search_terms` and `status` at the same time since editing `search_terms` may trigger an automatic `status` change. tags: - Plaid requestBody: content: application/json: schema: $ref: '#/components/schemas/WatchlistScreeningIndividualUpdateRequest' required: true externalDocs: url: /api/products/monitor/#watchlist_screeningindividualupdate servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /processor/account/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Retrieve the account associated with a processor token externalDocs: url: /api/processor-partners/#processoraccountget operationId: processorAccountGet responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ProcessorAccountGetResponse' examples: example-1: value: account: account_id: QKKzevvp33HxPWpoqn6rI13BxW4awNSjnw4xv balances: available: 100 current: 110 limit: null iso_currency_code: USD unofficial_currency_code: null mask: '0000' name: Plaid Checking official_name: Plaid Gold Checking subtype: checking type: depository institution_id: ins_109508 request_id: 1zlMf description: 'This endpoint returns the account associated with a given processor token. This endpoint retrieves cached information, rather than extracting fresh information from the institution. As a result, the account balance returned may not be up-to-date; for realtime balance information, use `/processor/balance/get` instead. Note that some information is nullable. ' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ProcessorAccountGetRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /processor/transactions/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Get transaction data externalDocs: url: /api/processor-partners/#processortransactionsget operationId: processorTransactionsGet responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ProcessorTransactionsGetResponse' examples: example-1: value: account: account_id: BxBXxLj1m4HMXBm9WZZmCWVbPjX16EHwv99vp balances: available: 110.94 current: 110.94 iso_currency_code: USD limit: null unofficial_currency_code: null mask: '0000' name: Plaid Checking official_name: Plaid Gold Standard 0% Interest Checking subtype: checking type: depository transactions: - account_id: BxBXxLj1m4HMXBm9WZZmCWVbPjX16EHwv99vp account_owner: null amount: 28.34 iso_currency_code: USD unofficial_currency_code: null category: - Food and Drink - Restaurants - Fast Food category_id: '13005032' check_number: null counterparties: - name: DoorDash type: marketplace logo_url: https://plaid-counterparty-logos.plaid.com/doordash_1.png website: doordash.com entity_id: YNRJg5o2djJLv52nBA1Yn1KpL858egYVo4dpm confidence_level: HIGH - name: Burger King type: merchant logo_url: https://plaid-merchant-logos.plaid.com/burger_king_155.png website: burgerking.com entity_id: mVrw538wamwdm22mK8jqpp7qd5br0eeV9o4a1 confidence_level: VERY_HIGH date: '2023-09-28' datetime: '2023-09-28T15:10:09Z' authorized_date: '2023-09-27' authorized_datetime: '2023-09-27T08:01:58Z' location: address: null city: null region: null postal_code: null country: null lat: null lon: null store_number: null name: Dd Doordash Burgerkin merchant_name: Burger King merchant_entity_id: mVrw538wamwdm22mK8jqpp7qd5br0eeV9o4a1 logo_url: https://plaid-merchant-logos.plaid.com/burger_king_155.png website: burgerking.com payment_meta: by_order_of: null payee: null payer: null payment_method: null payment_processor: null ppd_id: null reason: null reference_number: null payment_channel: online pending: true pending_transaction_id: null personal_finance_category: primary: FOOD_AND_DRINK detailed: FOOD_AND_DRINK_FAST_FOOD confidence_level: VERY_HIGH personal_finance_category_icon_url: https://plaid-category-icons.plaid.com/PFC_FOOD_AND_DRINK.png transaction_id: yhnUVvtcGGcCKU0bcz8PDQr5ZUxUXebUvbKC0 transaction_code: null transaction_type: digital - account_id: BxBXxLj1m4HMXBm9WZZmCWVbPjX16EHwv99vp account_owner: null amount: 72.1 iso_currency_code: USD unofficial_currency_code: null category: - Shops - Supermarkets and Groceries category_id: '19046000' check_number: null counterparties: - name: Walmart type: merchant logo_url: https://plaid-merchant-logos.plaid.com/walmart_1100.png website: walmart.com entity_id: O5W5j4dN9OR3E6ypQmjdkWZZRoXEzVMz2ByWM confidence_level: VERY_HIGH date: '2023-09-24' datetime: '2023-09-24T11:01:01Z' authorized_date: '2023-09-22' authorized_datetime: '2023-09-22T10:34:50Z' location: address: 13425 Community Rd city: Poway region: CA postal_code: '92064' country: US lat: 32.959068 lon: -117.037666 store_number: '1700' name: 'PURCHASE WM SUPERCENTER #1700' merchant_name: Walmart merchant_entity_id: O5W5j4dN9OR3E6ypQmjdkWZZRoXEzVMz2ByWM logo_url: https://plaid-merchant-logos.plaid.com/walmart_1100.png website: walmart.com payment_meta: by_order_of: null payee: null payer: null payment_method: null payment_processor: null ppd_id: null reason: null reference_number: null payment_channel: in store pending: false pending_transaction_id: no86Eox18VHMvaOVL7gPUM9ap3aR1LsAVZ5nc personal_finance_category: primary: GENERAL_MERCHANDISE detailed: GENERAL_MERCHANDISE_SUPERSTORES confidence_level: VERY_HIGH personal_finance_category_icon_url: https://plaid-category-icons.plaid.com/PFC_GENERAL_MERCHANDISE.png transaction_id: lPNjeW1nR6CDn5okmGQ6hEpMo4lLNoSrzqDje transaction_code: null transaction_type: place total_transactions: 1 request_id: Wvhy9PZHQLV8njG default: content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Error response description: 'The `/processor/transactions/get` endpoint allows developers to receive user-authorized transaction data for credit, depository, and some loan-type accounts (only those with account subtype `student`; coverage may be limited). Transaction data is standardized across financial institutions, and in many cases transactions are linked to a clean name, entity type, location, and category. Similarly, account data is standardized and returned with a clean name, number, balance, and other meta information where available. Transactions are returned in reverse-chronological order, and the sequence of transaction ordering is stable and will not shift. Transactions are not immutable and can also be removed altogether by the institution; a removed transaction will no longer appear in `/processor/transactions/get`. For more details, see [Pending and posted transactions](https://plaid.com/docs/transactions/transactions-data/#pending-and-posted-transactions). Due to the potentially large number of transactions associated with a processor token, results are paginated. Manipulate the `count` and `offset` parameters in conjunction with the `total_transactions` response body field to fetch all available transactions. Data returned by `/processor/transactions/get` will be the data available for the processor token as of the most recent successful check for new transactions. Plaid typically checks for new data multiple times a day, but these checks may occur less frequently, such as once a day, depending on the institution. To force Plaid to check for new transactions, you can use the `/processor/transactions/refresh` endpoint. Note that data may not be immediately available to `/processor/transactions/get`. Plaid will begin to prepare transactions data upon Item link, if Link was initialized with `transactions`, or upon the first call to `/processor/transactions/get`, if it wasn''t. If no transaction history is ready when `/processor/transactions/get` is called, it will return a `PRODUCT_NOT_READY` error. To receive Transactions webhooks for a processor token, set its webhook URL via the [`/processor/token/webhook/update`](https://plaid.com/docs/api/processor-partners/#processortokenwebhookupdate) endpoint.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ProcessorTransactionsGetRequest' examples: {} servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /processor/transactions/sync: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Get incremental transaction updates on a processor token externalDocs: url: /api/processor-partners/#processortransactionssync operationId: processorTransactionsSync responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ProcessorTransactionsSyncResponse' examples: example-1: value: account: account_id: BxBXxLj1m4HMXBm9WZZmCWVbPjX16EHwv99vp balances: available: 110.94 current: 110.94 iso_currency_code: USD limit: null unofficial_currency_code: null mask: '0000' name: Plaid Checking official_name: Plaid Gold Standard 0% Interest Checking subtype: checking type: depository added: - account_id: BxBXxLj1m4HMXBm9WZZmCWVbPjX16EHwv99vp account_owner: null amount: 72.1 iso_currency_code: USD unofficial_currency_code: null category: - Shops - Supermarkets and Groceries category_id: '19046000' check_number: null counterparties: - name: Walmart type: merchant logo_url: https://plaid-merchant-logos.plaid.com/walmart_1100.png website: walmart.com entity_id: O5W5j4dN9OR3E6ypQmjdkWZZRoXEzVMz2ByWM confidence_level: VERY_HIGH date: '2023-09-24' datetime: '2023-09-24T11:01:01Z' authorized_date: '2023-09-22' authorized_datetime: '2023-09-22T10:34:50Z' location: address: 13425 Community Rd city: Poway region: CA postal_code: '92064' country: US lat: 32.959068 lon: -117.037666 store_number: '1700' name: 'PURCHASE WM SUPERCENTER #1700' merchant_name: Walmart merchant_entity_id: O5W5j4dN9OR3E6ypQmjdkWZZRoXEzVMz2ByWM logo_url: https://plaid-merchant-logos.plaid.com/walmart_1100.png website: walmart.com payment_meta: by_order_of: null payee: null payer: null payment_method: null payment_processor: null ppd_id: null reason: null reference_number: null payment_channel: in store pending: false pending_transaction_id: no86Eox18VHMvaOVL7gPUM9ap3aR1LsAVZ5nc personal_finance_category: primary: GENERAL_MERCHANDISE detailed: GENERAL_MERCHANDISE_SUPERSTORES confidence_level: VERY_HIGH personal_finance_category_icon_url: https://plaid-category-icons.plaid.com/PFC_GENERAL_MERCHANDISE.png transaction_id: lPNjeW1nR6CDn5okmGQ6hEpMo4lLNoSrzqDje transaction_code: null transaction_type: place modified: - account_id: BxBXxLj1m4HMXBm9WZZmCWVbPjX16EHwv99vp account_owner: null amount: 28.34 iso_currency_code: USD unofficial_currency_code: null category: - Food and Drink - Restaurants - Fast Food category_id: '13005032' check_number: null counterparties: - name: DoorDash type: marketplace logo_url: https://plaid-counterparty-logos.plaid.com/doordash_1.png website: doordash.com entity_id: YNRJg5o2djJLv52nBA1Yn1KpL858egYVo4dpm confidence_level: HIGH - name: Burger King type: merchant logo_url: https://plaid-merchant-logos.plaid.com/burger_king_155.png website: burgerking.com entity_id: mVrw538wamwdm22mK8jqpp7qd5br0eeV9o4a1 confidence_level: VERY_HIGH date: '2023-09-28' datetime: '2023-09-28T15:10:09Z' authorized_date: '2023-09-27' authorized_datetime: '2023-09-27T08:01:58Z' location: address: null city: null region: null postal_code: null country: null lat: null lon: null store_number: null name: Dd Doordash Burgerkin merchant_name: Burger King merchant_entity_id: mVrw538wamwdm22mK8jqpp7qd5br0eeV9o4a1 logo_url: https://plaid-merchant-logos.plaid.com/burger_king_155.png website: burgerking.com payment_meta: by_order_of: null payee: null payer: null payment_method: null payment_processor: null ppd_id: null reason: null reference_number: null payment_channel: online pending: true pending_transaction_id: null personal_finance_category: primary: FOOD_AND_DRINK detailed: FOOD_AND_DRINK_FAST_FOOD confidence_level: VERY_HIGH personal_finance_category_icon_url: https://plaid-category-icons.plaid.com/PFC_FOOD_AND_DRINK.png transaction_id: yhnUVvtcGGcCKU0bcz8PDQr5ZUxUXebUvbKC0 transaction_code: null transaction_type: digital removed: - transaction_id: CmdQTNgems8BT1B7ibkoUXVPyAeehT3Tmzk0l account_id: BxBXxLj1m4HMXBm9WZZmCWVbPjX16EHwv99vp next_cursor: tVUUL15lYQN5rBnfDIc1I8xudpGdIlw9nsgeXWvhOfkECvUeR663i3Dt1uf/94S8ASkitgLcIiOSqNwzzp+bh89kirazha5vuZHBb2ZA5NtCDkkV has_more: false request_id: 45QSn transactions_update_status: HISTORICAL_UPDATE_COMPLETE default: content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Error response description: 'This endpoint replaces `/processor/transactions/get` and its associated webhooks for most common use-cases. The `/processor/transactions/sync` endpoint allows developers to subscribe to all transactions associated with a processor token and get updates synchronously in a stream-like manner, using a cursor to track which updates have already been seen. `/processor/transactions/sync` provides the same functionality as `/processor/transactions/get` and can be used instead of `/processor/transactions/get` to simplify the process of tracking transactions updates. This endpoint provides user-authorized transaction data for `credit`, `depository`, and some loan-type accounts (only those with account subtype `student`; coverage may be limited). For transaction history from `investments` accounts, use `/investments/transactions/get` instead. Returned transactions data is grouped into three types of update, indicating whether the transaction was added, removed, or modified since the last call to the API. In the first call to `/processor/transactions/sync` for a processor token, the endpoint will return all historical transactions data associated with that processor token up until the time of the API call (as "adds"), which then generates a `next_cursor` for that processor token. In subsequent calls, send the `next_cursor` to receive only the changes that have occurred since the previous call. Due to the potentially large number of transactions associated with a processor token, results are paginated. The `has_more` field specifies if additional calls are necessary to fetch all available transaction updates. Call `/processor/transactions/sync` with the new cursor, pulling all updates, until `has_more` is `false`. When retrieving paginated updates, track both the `next_cursor` from the latest response and the original cursor from the first call in which `has_more` was `true`; if a call to `/processor/transactions/sync` fails when retrieving a paginated update, which can occur as a result of the [`TRANSACTIONS_SYNC_MUTATION_DURING_PAGINATION`](https://plaid.com/docs/errors/transactions/#transactions_sync_mutation_during_pagination) error, the entire pagination request loop must be restarted beginning with the cursor for the first page of the update, rather than retrying only the single request that failed. Whenever new or updated transaction data becomes available, `/processor/transactions/sync` will provide these updates. Plaid typically checks for new data multiple times a day, but these checks may occur less frequently, such as once a day, depending on the institution. To force Plaid to check for new transactions, use the `/processor/transactions/refresh` endpoint. Note that for newly created processor tokens, data may not be immediately available to `/processor/transactions/sync`. Plaid begins preparing transactions data when the corresponding Item is created, but the process can take anywhere from a few seconds to several minutes to complete, depending on the number of transactions available. To receive Transactions webhooks for a processor token, set its webhook URL via the [`/processor/token/webhook/update`](https://plaid.com/docs/api/processor-partners/#processortokenwebhookupdate) endpoint.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ProcessorTransactionsSyncRequest' examples: {} servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /processor/transactions/refresh: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Refresh transaction data externalDocs: url: /api/processor-partners/#processortransactionsrefresh operationId: processorTransactionsRefresh responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ProcessorTransactionsRefreshResponse' examples: example-1: value: request_id: 1vwmF5TBQwiqfwP default: content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Error response description: '`/processor/transactions/refresh` is an optional endpoint for users of the Transactions product. It initiates an on-demand extraction to fetch the newest transactions for a processor token. This on-demand extraction takes place in addition to the periodic extractions that automatically occur one or more times per day for any Transactions-enabled processor token. If changes to transactions are discovered after calling `/processor/transactions/refresh`, Plaid will fire a webhook: for `/transactions/sync` users, [`SYNC_UPDATES_AVAILABLE`](https://plaid.com/docs/api/products/transactions/#sync_updates_available) will be fired if there are any transactions updated, added, or removed. For users of both `/processor/transactions/sync` and `/processor/transactions/get`, [`TRANSACTIONS_REMOVED`](https://plaid.com/docs/api/products/transactions/#transactions_removed) will be fired if any removed transactions are detected, and [`DEFAULT_UPDATE`](https://plaid.com/docs/api/products/transactions/#default_update) will be fired if any new transactions are detected. New transactions can be fetched by calling `/processor/transactions/get` or `/processor/transactions/sync`. Note that the `/processor/transactions/refresh` endpoint is not supported for Capital One (`ins_128026`) and will result in a `PRODUCTS_NOT_SUPPORTED` error if called on a processor token from that institution. As this endpoint triggers a synchronous request for fresh data, latency may be higher than for other Plaid endpoints (typically less than 10 seconds, but occasionally up to 30 seconds or more); if you encounter errors, you may find it necessary to adjust your timeout period when making requests. `/processor/transactions/refresh` is offered as an add-on to Transactions and has a separate [fee model](/docs/account/billing/#per-request-flat-fee). To request access to this endpoint, submit a [product access request](https://dashboard.plaid.com/team/products) or contact your Plaid account manager.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ProcessorTransactionsRefreshRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /processor/transactions/recurring/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Fetch recurring transaction streams externalDocs: url: /api/processor-partners/#processortransactionsrecurringget operationId: processorTransactionsRecurringGet responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ProcessorTransactionsRecurringGetResponse' examples: example-1: value: updated_datetime: '2022-05-01T00:00:00Z' inflow_streams: - account_id: lPNjeW1nR6CDn5okmGQ6hEpMo4lLNoSrzqDje stream_id: no86Eox18VHMvaOVL7gPUM9ap3aR1LsAVZ5nc category: - Transfer - Payroll category_id: '21009000' description: Platypus Payroll merchant_name: null personal_finance_category: primary: INCOME detailed: INCOME_WAGES confidence_level: UNKNOWN first_date: '2022-02-28' last_date: '2022-04-30' frequency: SEMI_MONTHLY transaction_ids: - nkeaNrDGrhdo6c4qZWDA8ekuIPuJ4Avg5nKfw - EfC5ekksdy30KuNzad2tQupW8WIPwvjXGbGHL - ozfvj3FFgp6frbXKJGitsDzck5eWQH7zOJBYd - QvdDE8AqVWo3bkBZ7WvCd7LskxVix8Q74iMoK - uQozFPfMzibBouS9h9tz4CsyvFll17jKLdPAF average_amount: amount: -800 iso_currency_code: USD unofficial_currency_code: null last_amount: amount: -1000 iso_currency_code: USD unofficial_currency_code: null is_active: true status: MATURE is_user_modified: true last_user_modified_datetime: '2023-01-19T10:34:50Z' outflow_streams: - account_id: lPNjeW1nR6CDn5okmGQ6hEpMo4lLNoSrzqDff stream_id: no86Eox18VHMvaOVL7gPUM9ap3aR1LsAVZ5nd category: - Service - Utilities - Electric category_id: '18068005' description: ConEd Bill Payment merchant_name: ConEd personal_finance_category: primary: RENT_AND_UTILITIES detailed: RENT_AND_UTILITIES_GAS_AND_ELECTRICITY confidence_level: UNKNOWN first_date: '2022-02-04' last_date: '2022-05-02' frequency: MONTHLY transaction_ids: - yhnUVvtcGGcCKU0bcz8PDQr5ZUxUXebUvbKC0 - HPDnUVgI5Pa0YQSl0rxwYRwVXeLyJXTWDAvpR - jEPoSfF8xzMClE9Ohj1he91QnvYoSdwg7IT8L - CmdQTNgems8BT1B7ibkoUXVPyAeehT3Tmzk0l average_amount: amount: 85 iso_currency_code: USD unofficial_currency_code: null last_amount: amount: 100 iso_currency_code: USD unofficial_currency_code: null is_active: true status: MATURE is_user_modified: false - account_id: lPNjeW1nR6CDn5okmGQ6hEpMo4lLNoSrzqDff stream_id: SrBNJZDuUMweodmPmSOeOImwsWt53ZXfJQAfC category: - Shops - Warehouses and Wholesale Stores category_id: '19051000' description: Costco Annual Membership merchant_name: Costco personal_finance_category: primary: GENERAL_MERCHANDISE detailed: GENERAL_MERCHANDISE_SUPERSTORES confidence_level: UNKNOWN first_date: '2022-01-23' last_date: '2023-01-22' frequency: ANNUALLY transaction_ids: - yqEBJ72cS4jFwcpxJcDuQr94oAQ1R1lMC33D4 - Kz5Hm3cZCgpn4tMEKUGAGD6kAcxMBsEZDSwJJ average_amount: amount: 120 iso_currency_code: USD unofficial_currency_code: null last_amount: amount: 120 iso_currency_code: USD unofficial_currency_code: null is_active: true status: MATURE is_user_modified: true last_user_modified_datetime: '2023-01-19T10:34:50Z' request_id: tbFyCEqkU775ZGG default: content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Error response description: 'The `/processor/transactions/recurring/get` endpoint allows developers to receive a summary of the recurring outflow and inflow streams (expenses and deposits) from a user’s checking, savings or credit card accounts. Additionally, Plaid provides key insights about each recurring stream including the category, merchant, last amount, and more. Developers can use these insights to build tools and experiences that help their users better manage cash flow, monitor subscriptions, reduce spend, and stay on track with bill payments. This endpoint is offered as an add-on to Transactions. To request access to this endpoint, submit a [product access request](https://dashboard.plaid.com/team/products) or contact your Plaid account manager. This endpoint can only be called on a processor token that has already been initialized with Transactions (either during Link, by specifying it in `/link/token/create`; or after Link, by calling `/processor/transactions/get` or `/processor/transactions/sync`). Once all historical transactions have been fetched, call `/processor/transactions/recurring/get` to receive the Recurring Transactions streams and subscribe to the [`RECURRING_TRANSACTIONS_UPDATE`](https://plaid.com/docs/api/products/transactions/#recurring_transactions_update) webhook. To know when historical transactions have been fetched, if you are using `/processor/transactions/sync` listen for the [`SYNC_UPDATES_AVAILABLE`](https://plaid.com/docs/api/products/transactions/#SyncUpdatesAvailableWebhook-historical-update-complete) webhook and check that the `historical_update_complete` field in the payload is `true`. If using `/processor/transactions/get`, listen for the [`HISTORICAL_UPDATE`](https://plaid.com/docs/api/products/transactions/#historical_update) webhook. After the initial call, you can call `/processor/transactions/recurring/get` endpoint at any point in the future to retrieve the latest summary of recurring streams. Listen to the [`RECURRING_TRANSACTIONS_UPDATE`](https://plaid.com/docs/api/products/transactions/#recurring_transactions_update) webhook to be notified when new updates are available. To receive Transactions webhooks for a processor token, set its webhook URL via the [`/processor/token/webhook/update`](https://plaid.com/docs/api/processor-partners/#processortokenwebhookupdate) endpoint.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ProcessorTransactionsRecurringGetRequest' examples: {} servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /processor/signal/evaluate: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Evaluate a planned ACH transaction externalDocs: url: /api/processor-partners/#processorsignalevaluate operationId: processorSignalEvaluate description: 'Use `/processor/signal/evaluate` to evaluate a planned ACH transaction as a processor to get a return risk assessment (such as a risk score and risk tier) and additional risk signals. In order to obtain a valid score for an ACH transaction, Plaid must have an access token for the account, and the Item must be healthy (receiving product updates) or have recently been in a healthy state. If the transaction does not meet eligibility requirements, an error will be returned corresponding to the underlying cause. If `/processor/signal/evaluate` is called on the same transaction multiple times within a 24-hour period, cached results may be returned. For more information please refer to our error documentation on [item errors](/docs/errors/item/) and [Link in Update Mode](/docs/link/update-mode/). Note: This request may take some time to complete if Signal is being added to an existing Item. This is because Plaid must communicate directly with the institution when retrieving the data for the first time. To reduce this latency, you can call `/signal/prepare` on the Item before you need to request Signal data.' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ProcessorSignalEvaluateResponse' examples: example-1: value: scores: customer_initiated_return_risk: score: 9 risk_tier: 1 bank_initiated_return_risk: score: 72 risk_tier: 7 core_attributes: days_since_first_plaid_connection: 510 plaid_connections_count_7d: 6 plaid_connections_count_30d: 7 total_plaid_connections_count: 15 is_savings_or_money_market_account: false warnings: [] request_id: mdqfuVxeoza6mhu default: description: Error response. content: application/json: schema: $ref: '#/components/schemas/PlaidError' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ProcessorSignalEvaluateRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /processor/signal/decision/report: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Report whether you initiated an ACH transaction externalDocs: url: /api/processor-partners/#processorsignaldecisionreport operationId: processorSignalDecisionReport description: 'After calling `/processor/signal/evaluate`, call `/processor/signal/decision/report` to report whether the transaction was initiated. If you are using the [Plaid Transfer product](https://www.plaid.com/docs/transfer) to create transfers, it is not necessary to use this endpoint, as Plaid already knows whether the transfer was initiated.' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ProcessorSignalDecisionReportResponse' examples: example-1: value: request_id: mdqfuVxeoza6mhu default: description: Error response. content: application/json: schema: $ref: '#/components/schemas/PlaidError' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ProcessorSignalDecisionReportRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /processor/signal/return/report: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Report a return for an ACH transaction externalDocs: url: /api/processor-partners/#processorsignalreturnreport operationId: processorSignalReturnReport description: 'Call the `/processor/signal/return/report` endpoint to report a returned transaction that was previously sent to the `/processor/signal/evaluate` endpoint. Your feedback will be used by the model to incorporate the latest risk trend in your portfolio. If you are using the [Plaid Transfer product](https://www.plaid.com/docs/transfer) to create transfers, it is not necessary to use this endpoint, as Plaid already knows whether the transfer was returned.' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ProcessorSignalReturnReportResponse' examples: example-1: value: request_id: mdqfuVxeoza6mhu default: description: Error response. content: application/json: schema: $ref: '#/components/schemas/PlaidError' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ProcessorSignalReturnReportRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /processor/signal/prepare: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Opt-in a processor token to Signal externalDocs: url: /api/processor-partners/#processorsignalprepare operationId: processorSignalPrepare description: 'When a processor token is not initialized with Signal, call `/processor/signal/prepare` to opt-in that processor token to the Signal data collection process, which will improve the accuracy of the Signal score. If this endpoint is called with a processor token that is already initialized with Signal, it will return a 200 response and will not modify the processor token.' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ProcessorSignalPrepareResponse' examples: example-1: value: request_id: mdqfuVxeoza6mhu default: description: Error response. content: application/json: schema: $ref: '#/components/schemas/PlaidError' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ProcessorSignalPrepareRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /processor/balance/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Retrieve Balance data externalDocs: url: /api/processor-partners/#processorbalanceget operationId: processorBalanceGet responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ProcessorBalanceGetResponse' examples: example-1: value: account: account_id: QKKzevvp33HxPWpoqn6rI13BxW4awNSjnw4xv balances: available: 100 current: 110 limit: null iso_currency_code: USD unofficial_currency_code: null mask: '0000' name: Plaid Checking official_name: Plaid Gold Checking subtype: checking type: depository request_id: 1zlMf description: 'The `/processor/balance/get` endpoint returns the real-time balance for each of an Item''s accounts. While other endpoints may return a balance object, only `/processor/balance/get` forces the available and current balance fields to be refreshed rather than cached. ' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ProcessorBalanceGetRequest' description: 'The `/processor/balance/get` endpoint returns the real-time balance for the account associated with a given `processor_token`. The current balance is the total amount of funds in the account. The available balance is the current balance less any outstanding holds or debits that have not yet posted to the account. Note that not all institutions calculate the available balance. In the event that available balance is unavailable from the institution, Plaid will return an available balance value of `null`.' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /webhook_verification_key/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Get webhook verification key externalDocs: url: /api/webhooks/webhook-verification/#get-webhook-verification-key operationId: webhookVerificationKeyGet responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/WebhookVerificationKeyGetResponse' examples: example-1: value: key: alg: ES256 created_at: 1560466150 crv: P-256 expired_at: null kid: bfbd5111-8e33-4643-8ced-b2e642a72f3c kty: EC use: sig x: hKXLGIjWvCBv-cP5euCTxl8g9GLG9zHo_3pO5NN1DwQ y: shhexqPB7YffGn6fR6h2UhTSuCtPmfzQJ6ENVIoO4Ys request_id: RZ6Omi1bzzwDaLo description: 'Plaid signs all outgoing webhooks and provides JSON Web Tokens (JWTs) so that you can verify the authenticity of any incoming webhooks to your application. A message signature is included in the `Plaid-Verification` header. The `/webhook_verification_key/get` endpoint provides a JSON Web Key (JWK) that can be used to verify a JWT.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/WebhookVerificationKeyGetRequest' description: '' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /payment_initiation/recipient/create: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Create payment recipient externalDocs: url: /api/products/payment-initiation/#payment_initiationrecipientcreate operationId: paymentInitiationRecipientCreate responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/PaymentInitiationRecipientCreateResponse' examples: example-1: value: recipient_id: recipient-id-sandbox-9b6b4679-914b-445b-9450-efbdb80296f6 request_id: 4zlKapIkTm8p5KM description: 'Create a payment recipient for payment initiation. The recipient must be in Europe, within a country that is a member of the Single Euro Payment Area (SEPA) or a non-Eurozone country [supported](https://plaid.com/global) by Plaid. For a standing order (recurring) payment, the recipient must be in the UK. It is recommended to use `bacs` in the UK and `iban` in EU. The endpoint is idempotent: if a developer has already made a request with the same payment details, Plaid will return the same `recipient_id`. ' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/PaymentInitiationRecipientCreateRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /payment_initiation/payment/reverse: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Reverse an existing payment externalDocs: url: /api/products/payment-initiation/#payment_initiationpaymentreverse operationId: paymentInitiationPaymentReverse responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/PaymentInitiationPaymentReverseResponse' examples: example-1: value: refund_id: wallet-transaction-id-production-c5f8cd31-6cae-4cad-9b0d-f7c10be9cc4b request_id: HtlKzBX0fMeF7mU status: INITIATED description: "Reverse a settled payment from a Plaid virtual account.\n\nThe original payment must be in a settled state to be refunded.\nTo refund partially, specify the amount as part of the request.\nIf the amount is not specified, the refund amount will be equal to all\nof the remaining payment amount that has not been refunded yet.\n\nThe refund will go back to the source account that initiated the payment.\nThe original payment must have been initiated to a Plaid virtual account\nso that this account can be used to initiate the refund.\n\nProviding counterparty information such as date of birth and address increases \nthe likelihood of refund being successful without human intervention.\n" requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/PaymentInitiationPaymentReverseRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /payment_initiation/recipient/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Get payment recipient externalDocs: url: /api/products/payment-initiation/#payment_initiationrecipientget operationId: paymentInitiationRecipientGet responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/PaymentInitiationRecipientGetResponse' examples: example-1: value: recipient_id: recipient-id-sandbox-9b6b4679-914b-445b-9450-efbdb80296f6 name: Wonder Wallet iban: GB29NWBK60161331926819 address: street: - 96 Guild Street - 9th Floor city: London postal_code: SE14 8JW country: GB request_id: 4zlKapIkTm8p5KM description: Get details about a payment recipient you have previously created. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/PaymentInitiationRecipientGetRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /payment_initiation/recipient/list: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid List payment recipients externalDocs: url: /api/products/payment-initiation/#payment_initiationrecipientlist operationId: paymentInitiationRecipientList responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/PaymentInitiationRecipientListResponse' examples: example-1: value: recipients: - recipient_id: recipient-id-sandbox-9b6b4679-914b-445b-9450-efbdb80296f6 name: Wonder Wallet iban: GB29NWBK60161331926819 address: street: - 96 Guild Street - 9th Floor city: London postal_code: SE14 8JW country: GB request_id: 4zlKapIkTm8p5KM description: The `/payment_initiation/recipient/list` endpoint list the payment recipients that you have previously created. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/PaymentInitiationRecipientListRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /payment_initiation/payment/create: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Create a payment externalDocs: url: /api/products/payment-initiation/#payment_initiationpaymentcreate operationId: paymentInitiationPaymentCreate responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/PaymentInitiationPaymentCreateResponse' examples: example-1: value: payment_id: payment-id-sandbox-feca8a7a-5591-4aef-9297-f3062bb735d3 status: PAYMENT_STATUS_INPUT_NEEDED request_id: 4ciYVmesrySiUAB description: 'After creating a payment recipient, you can use the `/payment_initiation/payment/create` endpoint to create a payment to that recipient. Payments can be one-time or standing order (recurring) and can be denominated in either EUR, GBP or other chosen [currency](https://plaid.com/docs/api/products/payment-initiation/#payment_initiation-payment-create-request-amount-currency). If making domestic GBP-denominated payments, your recipient must have been created with BACS numbers. In general, EUR-denominated payments will be sent via SEPA Credit Transfer, GBP-denominated payments will be sent via the Faster Payments network and for non-Eurozone markets typically via the local payment scheme, but the payment network used will be determined by the institution. Payments sent via Faster Payments will typically arrive immediately, while payments sent via SEPA Credit Transfer or other local payment schemes will typically arrive in one business day. Standing orders (recurring payments) must be denominated in GBP and can only be sent to recipients in the UK. Once created, standing order payments cannot be modified or canceled via the API. An end user can cancel or modify a standing order directly on their banking application or website, or by contacting the bank. Standing orders will follow the payment rules of the underlying rails (Faster Payments in UK). Payments can be sent Monday to Friday, excluding bank holidays. If the pre-arranged date falls on a weekend or bank holiday, the payment is made on the next working day. It is not possible to guarantee the exact time the payment will reach the recipient’s account, although at least 90% of standing order payments are sent by 6am. In the Development environment, payments must be below 5 GBP or other chosen [currency](https://plaid.com/docs/api/products/payment-initiation/#payment_initiation-payment-create-request-amount-currency). For details on any payment limits in Production, contact your Plaid Account Manager.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/PaymentInitiationPaymentCreateRequest' description: '' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /payment_initiation/payment/token/create: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid deprecated: true summary: Plaid Create payment token externalDocs: url: /link/maintain-legacy-integration/#creating-a-payment-token operationId: createPaymentToken responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/PaymentInitiationPaymentTokenCreateResponse' examples: example-1: value: payment_token: payment-token-sandbox-feca8a7a-5591-4aef-9297-f3062bb735d3 payment_token_expiration_time: '2020-01-01T00:00:00Z' request_id: 4ciYVmesrySiUAB description: 'The `/payment_initiation/payment/token/create` endpoint has been deprecated. New Plaid customers will be unable to use this endpoint, and existing customers are encouraged to migrate to the newer, `link_token`-based flow. The recommended flow is to provide the `payment_id` to `/link/token/create`, which returns a `link_token` used to initialize Link. The `/payment_initiation/payment/token/create` is used to create a `payment_token`, which can then be used in Link initialization to enter a payment initiation flow. You can only use a `payment_token` once. If this attempt fails, the end user aborts the flow, or the token expires, you will need to create a new payment token. Creating a new payment token does not require end user input.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/PaymentInitiationPaymentTokenCreateRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /payment_initiation/consent/create: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Create payment consent externalDocs: url: /api/products/payment-initiation/#payment_initiationconsentcreate operationId: paymentInitiationConsentCreate responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/PaymentInitiationConsentCreateResponse' examples: example-1: value: consent_id: consent-id-production-feca8a7a-5491-4444-9999-f3062bb735d3 status: UNAUTHORISED request_id: 4ciYmmesdqSiUAB description: 'The `/payment_initiation/consent/create` endpoint is used to create a payment consent, which can be used to initiate payments on behalf of the user. Payment consents are created with `UNAUTHORISED` status by default and must be authorised by the user before payments can be initiated. Consents can be limited in time and scope, and have constraints that describe limitations for payments.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/PaymentInitiationConsentCreateRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /payment_initiation/consent/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Get payment consent externalDocs: url: /api/products/payment-initiation/#payment_initiationconsentget operationId: paymentInitiationConsentGet responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/PaymentInitiationConsentGetResponse' examples: example-1: value: request_id: 4ciYuuesdqSiUAB consent_id: consent-id-production-feca8a7a-5491-4aef-9298-f3062bb735d3 status: AUTHORISED created_at: '2021-10-30T15:26:48Z' recipient_id: recipient-id-production-9b6b4679-914b-445b-9450-efbdb80296f6 reference: ref-00001 constraints: valid_date_time: from: '2021-12-25T11:12:13Z' to: '2022-12-31T15:26:48Z' max_payment_amount: currency: GBP value: 100 periodic_amounts: - amount: currency: GBP value: 300 interval: WEEK alignment: CALENDAR scopes: - ME_TO_ME description: The `/payment_initiation/consent/get` endpoint can be used to check the status of a payment consent, as well as to receive basic information such as recipient and constraints. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/PaymentInitiationConsentGetRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /payment_initiation/consent/revoke: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Revoke payment consent externalDocs: url: /api/products/payment-initiation/#payment_initiationconsentrevoke operationId: paymentInitiationConsentRevoke responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/PaymentInitiationConsentRevokeResponse' examples: example-1: value: request_id: 4ciYaaesdqSiUAB description: The `/payment_initiation/consent/revoke` endpoint can be used to revoke the payment consent. Once the consent is revoked, it is not possible to initiate payments using it. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/PaymentInitiationConsentRevokeRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /payment_initiation/consent/payment/execute: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Execute a single payment using consent externalDocs: url: /api/products/payment-initiation/#payment_initiationconsentpaymentexecute operationId: paymentInitiationConsentPaymentExecute responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/PaymentInitiationConsentPaymentExecuteResponse' examples: example-1: value: payment_id: payment-id-sandbox-feca8a7a-5591-4aef-9297-f3062bb735d3 request_id: 4ciYccesdqSiUAB status: PAYMENT_STATUS_INITIATED description: The `/payment_initiation/consent/payment/execute` endpoint can be used to execute payments using payment consent. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/PaymentInitiationConsentPaymentExecuteRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /user/create: x-plaid-business-unit-context: BUSINESS_UNIT_UNDETERMINED post: tags: - Plaid summary: Plaid Create user externalDocs: url: /api/products/income/#usercreate operationId: userCreate responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/UserCreateResponse' examples: example-1: value: user_token: user-sandbox-b0e2c4ee-a763-4df5-bfe9-46a46bce993d user_id: wz666MBjYWTp2PDzzggYhM6oWWmBb request_id: Aim3b description: 'This endpoint should be called for each of your end users before they begin a Plaid income flow. This provides you a single token to access all income data associated with the user. You should only create one per end user. If you call the endpoint multiple times with the same `client_user_id`, the first creation call will succeed and the rest will fail with an error message indicating that the user has been created for the given `client_user_id`. Ensure that you store the `user_token` along with your user''s identifier in your database, as it is not possible to retrieve a previously created `user_token`.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/UserCreateRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /user/update: x-plaid-business-unit-context: BUSINESS_UNIT_CRA x-hidden-from-docs: true post: tags: - Plaid summary: Plaid Update user information externalDocs: url: /api/products/income/#userupdate operationId: userUpdate responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/UserUpdateResponse' examples: example-1: value: request_id: Aim3b description: 'This endpoint is used to update user information associated with an existing `user_token`. The `user_token` should be in the response of `/user/create` call If you call the endpoint with a non-exist `user_token`, the call will fail with an error message indicating that the user token is not found.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/UserUpdateRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /payment_initiation/payment/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Get payment details externalDocs: url: /api/products/payment-initiation/#payment_initiationpaymentget operationId: paymentInitiationPaymentGet responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/PaymentInitiationPaymentGetResponse' examples: example-1: value: payment_id: payment-id-sandbox-feca8a7a-5591-4aef-9297-f3062bb735d3 payment_token: payment-token-sandbox-c6a26505-42b4-46fe-8ecf-bf9edcafbebb reference: Account Funding 99744 amount: currency: GBP value: 100 status: PAYMENT_STATUS_INPUT_NEEDED last_status_update: '2019-11-06T21:10:52Z' recipient_id: recipient-id-sandbox-9b6b4679-914b-445b-9450-efbdb80296f6 bacs: account: '31926819' account_id: vzeNDwK7KQIm4yEog683uElbp9GRLEFXGK98D sort_code: '601613' iban: null request_id: aEAQmewMzlVa1k6 description: The `/payment_initiation/payment/get` endpoint can be used to check the status of a payment, as well as to receive basic information such as recipient and payment amount. In the case of standing orders, the `/payment_initiation/payment/get` endpoint will provide information about the status of the overall standing order itself; the API cannot be used to retrieve payment status for individual payments within a standing order. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/PaymentInitiationPaymentGetRequest' description: '' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /payment_initiation/payment/list: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid List payments externalDocs: url: /api/products/payment-initiation/#payment_initiationpaymentlist operationId: paymentInitiationPaymentList responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/PaymentInitiationPaymentListResponse' examples: example-1: value: payments: - payment_id: payment-id-sandbox-feca8a7a-5591-4aef-9297-f3062bb735d3 reference: Account Funding 99744 amount: currency: GBP value: 100 status: PAYMENT_STATUS_INPUT_NEEDED last_status_update: '2019-11-06T21:10:52Z' recipient_id: recipient-id-sandbox-9b6b4679-914b-445b-9450-efbdb80296f6 bacs: account: '31926819' account_id: vzeNDwK7KQIm4yEog683uElbp9GRLEFXGK98D sort_code: '601613' iban: null next_cursor: '2020-01-01T00:00:00Z' request_id: aEAQmewMzlVa1k6 requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/PaymentInitiationPaymentListRequest' description: The `/payment_initiation/payment/list` endpoint can be used to retrieve all created payments. By default, the 10 most recent payments are returned. You can request more payments and paginate through the results using the optional `count` and `cursor` parameters. servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /processor/token/create: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Create processor token externalDocs: url: /api/processors/#processortokencreate responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ProcessorTokenCreateResponse' examples: example-1: value: processor_token: processor-sandbox-0asd1-a92nc request_id: xrQNYZ7Zoh6R7gV operationId: processorTokenCreate description: Used to create a token suitable for sending to one of Plaid's partners to enable integrations. Note that Stripe partnerships use bank account tokens instead; see `/processor/stripe/bank_account_token/create` for creating tokens for use with Stripe integrations. Once created, a processor token for a given Item cannot be modified or updated. If the account must be linked to a new or different partner resource, create a new Item by having the user go through the Link flow again; a new processor token can then be created from the new `access_token`. Processor tokens can also be revoked, using `/item/remove`. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ProcessorTokenCreateRequest' description: '' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /processor/token/permissions/set: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Control a processor's access to products externalDocs: url: /api/processors/#processortokenpermissionsset responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ProcessorTokenPermissionsSetResponse' examples: example-1: value: request_id: xrQNYZ7Zoh6R7gV operationId: processorTokenPermissionsSet description: Used to control a processor's access to products on the given processor token. By default, a processor will have access to all available products on the corresponding item. To restrict access to a particular set of products, call this endpoint with the desired products. To restore access to all available products, call this endpoint with an empty list. This endpoint can be called multiple times as your needs and your processor's needs change. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ProcessorTokenPermissionsSetRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /processor/token/permissions/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Get a processor token's product permissions externalDocs: url: /api/processors/#processortokenpermissionsget responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ProcessorTokenPermissionsGetResponse' examples: example-1: value: request_id: xrQNYZ7Zoh6R7gV products: - auth - balance - identity operationId: processorTokenPermissionsGet description: Used to get a processor token's product permissions. The `products` field will be an empty list if the processor can access all available products. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ProcessorTokenPermissionsGetRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /processor/token/webhook/update: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Update a processor token's webhook URL externalDocs: url: /api/processor-partners/#processortokenwebhookupdate operationId: processorTokenWebhookUpdate responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ProcessorTokenWebhookUpdateResponse' examples: example-1: value: request_id: vYK11LNTfRoAMbj description: This endpoint allows you, the processor, to update the webhook URL associated with a processor token. This request triggers a `WEBHOOK_UPDATE_ACKNOWLEDGED` webhook to the newly specified webhook URL. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ProcessorTokenWebhookUpdateRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /processor/stripe/bank_account_token/create: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Create Stripe bank account token externalDocs: url: /api/processors/#processorstripebank_account_tokencreate responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ProcessorStripeBankAccountTokenCreateResponse' examples: example-1: value: stripe_bank_account_token: btok_5oEetfLzPklE1fwJZ7SG request_id: xrQNYZ7Zoh6R7gV operationId: processorStripeBankAccountTokenCreate description: ' Used to create a token suitable for sending to Stripe to enable Plaid-Stripe integrations. For a detailed guide on integrating Stripe, see [Add Stripe to your app](https://plaid.com/docs/auth/partnerships/stripe/). Note that the Stripe bank account token is a one-time use token. To store bank account information for later use, you can use a Stripe customer object and create an associated bank account from the token, or you can use a Stripe Custom account and create an associated external bank account from the token. This bank account information should work indefinitely, unless the user''s bank account information changes or they revoke Plaid''s permissions to access their account. Stripe bank account information cannot be modified once the bank account token has been created. If you ever need to change the bank account details used by Stripe for a specific customer, have the user go through Link again and create a new bank account token from the new `access_token`. Bank account tokens can also be revoked, using `/item/remove`.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ProcessorStripeBankAccountTokenCreateRequest' description: '' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /processor/apex/processor_token/create: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Create Apex bank account token externalDocs: url: /none/ responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ProcessorTokenCreateResponse' operationId: processorApexProcessorTokenCreate description: Used to create a token suitable for sending to Apex to enable Plaid-Apex integrations. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ProcessorApexProcessorTokenCreateRequest' description: '' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /transfer/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Retrieve a transfer tags: - Plaid externalDocs: url: /api/products/transfer/reading-transfers/#transferget operationId: transferGet responses: '200': description: OK headers: {} content: application/json: schema: $ref: '#/components/schemas/TransferGetResponse' examples: example-1: value: transfer: account_id: 3gE5gnRzNyfXpBK5wEEKcymJ5albGVUqg77gr funding_account_id: 8945fedc-e703-463d-86b1-dc0607b55460 ach_class: ppd amount: '12.34' cancellable: true created: '2020-08-06T17:27:15Z' description: Desc guarantee_decision: null guarantee_decision_rationale: null failure_reason: ach_return_code: R13 description: Invalid ACH routing number id: 460cbe92-2dcc-8eae-5ad6-b37d0ec90fd9 authorization_id: c9f90aa1-2949-c799-e2b6-ea05c89bb586 metadata: key1: value1 key2: value2 network: ach origination_account_id: '' originator_client_id: null refunds: [] status: pending type: credit iso_currency_code: USD standard_return_window: '2020-08-07' unauthorized_return_window: '2020-10-07' expected_settlement_date: '2020-08-04' user: email_address: acharleston@email.com legal_name: Anne Charleston phone_number: 510-555-0128 address: street: 123 Main St. city: San Francisco region: CA postal_code: '94053' country: US recurring_transfer_id: null credit_funds_source: sweep facilitator_fee: '1.23' network_trace_id: null request_id: saKrIBuEB9qJZno default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: The `/transfer/get` endpoint fetches information about the transfer corresponding to the given `transfer_id`. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TransferGetRequest' examples: {} parameters: [] servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /transfer/recurring/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Retrieve a recurring transfer tags: - Plaid externalDocs: url: /api/products/transfer/recurring-transfers/#transferrecurringget operationId: transferRecurringGet responses: '200': description: OK headers: {} content: application/json: schema: $ref: '#/components/schemas/TransferRecurringGetResponse' examples: example-1: value: recurring_transfer: recurring_transfer_id: 460cbe92-2dcc-8eae-5ad6-b37d0ec90fd9 created: '2022-07-05T12:48:37Z' next_origination_date: '2022-10-28' test_clock_id: null status: active amount: '12.34' description: payment type: debit ach_class: ppd network: ach origination_account_id: '' account_id: 3gE5gnRzNyfXpBK5wEEKcymJ5albGVUqg77gr funding_account_id: 8945fedc-e703-463d-86b1-dc0607b55460 iso_currency_code: USD transfer_ids: - 271ef220-dbf8-caeb-a7dc-a2b3e8a80963 - c8dbaf75-2abb-e2dc-4171-12448e13b848 user: legal_name: Anne Charleston phone_number: 510-555-0128 email_address: acharleston@email.com address: street: 123 Main St. city: San Francisco region: CA postal_code: '94053' country: US schedule: start_date: '2022-10-01' end_date: '2023-10-01' interval_unit: week interval_count: 1 interval_execution_day: 5 request_id: saKrIBuEB9qJZno default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: The `/transfer/recurring/get` fetches information about the recurring transfer corresponding to the given `recurring_transfer_id`. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TransferRecurringGetRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /transfer/authorization/create: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Create a transfer authorization tags: - Plaid externalDocs: url: /api/products/transfer/initiating-transfers/#transferauthorizationcreate operationId: transferAuthorizationCreate responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/TransferAuthorizationCreateResponse' examples: example-1: value: authorization: id: 460cbe92-2dcc-8eae-5ad6-b37d0ec90fd9 created: '2020-08-06T17:27:15Z' decision: approved decision_rationale: null guarantee_decision: null guarantee_decision_rationale: null payment_risk: null proposed_transfer: ach_class: ppd account_id: 3gE5gnRzNyfXpBK5wEEKcymJ5albGVUqg77gr funding_account_id: 8945fedc-e703-463d-86b1-dc0607b55460 type: credit user: legal_name: Anne Charleston phone_number: 510-555-0128 email_address: acharleston@email.com address: street: 123 Main St. city: San Francisco region: CA postal_code: '94053' country: US amount: '12.34' network: ach iso_currency_code: USD origination_account_id: '' originator_client_id: null credit_funds_source: sweep request_id: saKrIBuEB9qJZno default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: "Use the `/transfer/authorization/create` endpoint to authorize a transfer. This endpoint must be called prior to calling `/transfer/create`.\n\nThere are three possible outcomes to calling this endpoint: If the `authorization.decision` in the response is `declined`, the proposed transfer has failed the risk check and you cannot proceed with the transfer. If the `authorization.decision` is `approved`, and the `authorization.rationale_code` is `null`, the transfer has passed the risk check and you can proceed to call `/transfer/create`. If the `authorization.decision` is `approved` and the `authorization.rationale_code` is non-`null`, the risk check could not be run: you may proceed with the transfer, but should perform your own risk evaluation. For more details, see the response schema.\n\nIn Plaid's Sandbox environment the decisions will be returned as follows:\n\n - To approve a transfer with `null` rationale code, make an authorization request with an `amount` less than the available balance in the account.\n\n - To approve a transfer with the rationale code `MANUALLY_VERIFIED_ITEM`, create an Item in Link through the [Same Day Micro-deposits flow](https://plaid.com/docs/auth/coverage/testing/#testing-same-day-micro-deposits).\n\n - To approve a transfer with the rationale code `ITEM_LOGIN_REQUIRED`, [reset the login for an Item](https://plaid.com/docs/sandbox/#item_login_required).\n\n - To decline a transfer with the rationale code `NSF`, the available balance on the account must be less than the authorization `amount`. See [Create Sandbox test data](https://plaid.com/docs/sandbox/user-custom/) for details on how to customize data in Sandbox.\n\n - To decline a transfer with the rationale code `RISK`, the available balance on the account must be exactly $0. See [Create Sandbox test data](https://plaid.com/docs/sandbox/user-custom/) for details on how to customize data in Sandbox." requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TransferAuthorizationCreateRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /transfer/authorization/cancel: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Cancel a transfer authorization tags: - Plaid externalDocs: url: /api/products/transfer/initiating-transfers/#transferauthorizationcancel operationId: transferAuthorizationCancel responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/TransferAuthorizationCancelResponse' examples: example-1: value: request_id: saKrIBuEB9qJZno default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Use the `/transfer/authorization/cancel` endpoint to cancel a transfer authorization. A transfer authorization is eligible for cancellation if it has not yet been used to create a transfer. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TransferAuthorizationCancelRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /transfer/balance/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: (Deprecated) Retrieve a balance held with Plaid deprecated: true tags: - Plaid externalDocs: url: /api/products/transfer/balance/#transferbalanceget operationId: transferBalanceGet responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/TransferBalanceGetResponse' examples: example-1: value: balance: available: '1721.70' type: prefunded_rtp_credits request_id: saKrIBuEB9qJZno default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: (Deprecated) Use the `/transfer/balance/get` endpoint to view a balance held with Plaid. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TransferBalanceGetRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /transfer/capabilities/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Get RTP eligibility information of a transfer tags: - Plaid externalDocs: url: /api/products/transfer/account-linking/#transfercapabilitiesget operationId: transferCapabilitiesGet responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/TransferCapabilitiesGetResponse' examples: example-1: value: institution_supported_networks: rtp: credit: true request_id: saKrIBuEB9qJZno default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Use the `/transfer/capabilities/get` endpoint to determine the RTP eligibility information of a transfer. To simulate RTP eligibility in Sandbox, log in using the username `user_good` and password `pass_good` and use the first two checking and savings accounts in the "First Platypus Bank" institution (ending in 0000 or 1111), which will return `true`. Any other account will return `false`. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TransferCapabilitiesGetRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /transfer/configuration/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Get transfer product configuration tags: - Plaid externalDocs: url: /api/products/transfer/metrics/#transferconfigurationget operationId: transferConfigurationGet responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/TransferConfigurationGetResponse' examples: example-1: value: max_single_transfer_amount: '' max_single_transfer_credit_amount: '1000.00' max_single_transfer_debit_amount: '1000.00' max_daily_credit_amount: '50000.00' max_daily_debit_amount: '50000.00' max_monthly_amount: '' max_monthly_credit_amount: '500000.00' max_monthly_debit_amount: '500000.00' iso_currency_code: USD request_id: saKrIBuEB9qJZno default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Use the `/transfer/configuration/get` endpoint to view your transfer product configurations. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TransferConfigurationGetRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /transfer/ledger/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Retrieve Plaid Ledger balance tags: - Plaid externalDocs: url: /api/products/transfer/ledger/#transferledgerget operationId: transferLedgerGet responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/TransferLedgerGetResponse' examples: example-1: value: balance: available: '1721.70' pending: '123.45' request_id: saKrIBuEB9qJZno default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Use the `/transfer/ledger/get` endpoint to view a balance on the ledger held with Plaid. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TransferLedgerGetRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /transfer/ledger/distribute: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Move available balance between the ledgers of the platform and one of its originators tags: - Plaid externalDocs: url: /api/products/transfer/ledger/#transferledgerdistribute operationId: transferLedgerDistribute responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/TransferLedgerDistributeResponse' examples: example-1: value: request_id: saKrIBuEB9qJZno default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Use the `/transfer/ledger/distribute` endpoint to move available balance between the ledgers of the platform and one of its originators. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TransferLedgerDistributeRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /transfer/ledger/deposit: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Deposit funds into a Plaid Ledger balance tags: - Plaid externalDocs: url: /api/products/transfer/ledger/#transferledgerdeposit operationId: transferLedgerDeposit responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/TransferLedgerDepositResponse' examples: example-1: value: sweep: id: 8c2fda9a-aa2f-4735-a00f-f4e0d2d2faee funding_account_id: 8945fedc-e703-463d-86b1-dc0607b55460 created: '2020-08-06T17:27:15Z' amount: '-12.34' iso_currency_code: USD settled: null status: pending trigger: manual description: deposit network_trace_id: null request_id: saKrIBuEB9qJZno default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Use the `/transfer/ledger/deposit` endpoint to deposit funds into Plaid Ledger. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TransferLedgerDepositRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /transfer/ledger/withdraw: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Withdraw funds from a Plaid Ledger balance tags: - Plaid externalDocs: url: /api/products/transfer/ledger/#transferledgerwithdraw operationId: transferLedgerWithdraw responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/TransferLedgerWithdrawResponse' examples: example-1: value: sweep: id: 8c2fda9a-aa2f-4735-a00f-f4e0d2d2faee funding_account_id: 8945fedc-e703-463d-86b1-dc0607b55460 created: '2020-08-06T17:27:15Z' amount: '12.34' iso_currency_code: USD settled: null status: pending trigger: manual description: withdraw network_trace_id: null request_id: saKrIBuEB9qJZno default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Use the `/transfer/ledger/withdraw` endpoint to withdraw funds from a Plaid Ledger balance. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TransferLedgerWithdrawRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /transfer/originator/funding_account/update: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Update the funding account associated with the originator tags: - Plaid externalDocs: url: /api/products/transfer/platform-payments/#transferoriginatorfunding_accountupdate operationId: transferOriginatorFundingAccountUpdate responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/TransferOriginatorFundingAccountUpdateResponse' examples: example-1: value: request_id: saKrIBuEB9qJZno default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Use the `/transfer/originator/funding_account/update` endpoint to update the funding account associated with the originator. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TransferOriginatorFundingAccountUpdateRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /transfer/metrics/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Get transfer product usage metrics tags: - Plaid externalDocs: url: /api/products/transfer/metrics/#transfermetricsget operationId: transferMetricsGet responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/TransferMetricsGetResponse' examples: example-1: value: daily_debit_transfer_volume: '1234.56' daily_credit_transfer_volume: '567.89' monthly_transfer_volume: '' monthly_debit_transfer_volume: '10000.00' monthly_credit_transfer_volume: '2345.67' iso_currency_code: USD request_id: saKrIBuEB9qJZno default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Use the `/transfer/metrics/get` endpoint to view your transfer product usage metrics. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TransferMetricsGetRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /transfer/create: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Create a transfer tags: - Plaid externalDocs: url: /api/products/transfer/initiating-transfers/#transfercreate operationId: transferCreate responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/TransferCreateResponse' examples: example-1: value: transfer: id: 460cbe92-2dcc-8eae-5ad6-b37d0ec90fd9 authorization_id: c9f90aa1-2949-c799-e2b6-ea05c89bb586 ach_class: ppd account_id: 3gE5gnRzNyfXpBK5wEEKcymJ5albGVUqg77gr funding_account_id: 8945fedc-e703-463d-86b1-dc0607b55460 type: credit user: legal_name: Anne Charleston phone_number: 510-555-0128 email_address: acharleston@email.com address: street: 123 Main St. city: San Francisco region: CA postal_code: '94053' country: US amount: '12.34' description: payment created: '2020-08-06T17:27:15Z' refunds: [] status: pending network: ach cancellable: true guarantee_decision: null guarantee_decision_rationale: null failure_reason: null metadata: key1: value1 key2: value2 origination_account_id: '' iso_currency_code: USD standard_return_window: '2023-08-07' unauthorized_return_window: '2023-10-07' expected_settlement_date: '2023-08-04' originator_client_id: 569ed2f36b3a3a021713abc1 recurring_transfer_id: null credit_funds_source: sweep facilitator_fee: '1.23' network_trace_id: null request_id: saKrIBuEB9qJZno default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Use the `/transfer/create` endpoint to initiate a new transfer. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TransferCreateRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /transfer/recurring/create: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Create a recurring transfer tags: - Plaid externalDocs: url: /api/products/transfer/recurring-transfers/#transferrecurringcreate operationId: transferRecurringCreate responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/TransferRecurringCreateResponse' examples: example-1: value: recurring_transfer: recurring_transfer_id: 460cbe92-2dcc-8eae-5ad6-b37d0ec90fd9 created: '2022-07-05T12:48:37Z' next_origination_date: '2022-10-28' test_clock_id: b33a6eda-5e97-5d64-244a-a9274110151c status: active amount: '12.34' description: payment type: debit ach_class: ppd network: ach origination_account_id: '' account_id: 3gE5gnRzNyfXpBK5wEEKcymJ5albGVUqg77gr funding_account_id: 8945fedc-e703-463d-86b1-dc0607b55460 iso_currency_code: USD transfer_ids: [] user: legal_name: Anne Charleston phone_number: 510-555-0128 email_address: acharleston@email.com address: street: 123 Main St. city: San Francisco region: CA postal_code: '94053' country: US schedule: start_date: '2022-10-01' end_date: '2023-10-01' interval_unit: week interval_count: 1 interval_execution_day: 5 decision: approved decision_rationale: null request_id: saKrIBuEB9qJZno default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Use the `/transfer/recurring/create` endpoint to initiate a new recurring transfer. This capability is not currently supported for Transfer UI or Platform Payments (beta) customers. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TransferRecurringCreateRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /transfer/list: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid List transfers tags: - Plaid externalDocs: url: /api/products/transfer/reading-transfers/#transferlist operationId: transferList responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/TransferListResponse' examples: example-1: value: transfers: - account_id: 3gE5gnRzNyfXpBK5wEEKcymJ5albGVUqg77gr funding_account_id: 8945fedc-e703-463d-86b1-dc0607b55460 ach_class: ppd amount: '12.34' cancellable: true created: '2019-12-09T17:27:15Z' description: Desc guarantee_decision: null guarantee_decision_rationale: null failure_reason: ach_return_code: R13 description: Invalid ACH routing number id: 460cbe92-2dcc-8eae-5ad6-b37d0ec90fd9 authorization_id: c9f90aa1-2949-c799-e2b6-ea05c89bb586 metadata: key1: value1 key2: value2 network: ach origination_account_id: '' originator_client_id: null refunds: [] status: pending type: credit iso_currency_code: USD standard_return_window: '2020-08-07' unauthorized_return_window: '2020-10-07' expected_settlement_date: '2020-08-04' user: email_address: acharleston@email.com legal_name: Anne Charleston phone_number: 510-555-0128 address: street: 123 Main St. city: San Francisco region: CA postal_code: '94053' country: US recurring_transfer_id: null credit_funds_source: sweep facilitator_fee: '1.23' network_trace_id: null request_id: saKrIBuEB9qJZno default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: 'Use the `/transfer/list` endpoint to see a list of all your transfers and their statuses. Results are paginated; use the `count` and `offset` query parameters to retrieve the desired transfers. ' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TransferListRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /transfer/recurring/list: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid List recurring transfers tags: - Plaid externalDocs: url: /api/products/transfer/recurring-transfers/#transferrecurringlist operationId: transferRecurringList responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/TransferRecurringListResponse' examples: example-1: value: recurring_transfers: - recurring_transfer_id: 460cbe92-2dcc-8eae-5ad6-b37d0ec90fd9 created: '2022-07-05T12:48:37Z' next_origination_date: '2022-10-28' test_clock_id: null status: active amount: '12.34' description: payment type: debit ach_class: ppd network: ach origination_account_id: '' account_id: 3gE5gnRzNyfXpBK5wEEKcymJ5albGVUqg77gr funding_account_id: 8945fedc-e703-463d-86b1-dc0607b55460 iso_currency_code: USD transfer_ids: - 4242fc8d-3ec6-fb38-fa0c-a8e37d03cd57 user: legal_name: Anne Charleston phone_number: 510-555-0128 email_address: acharleston@email.com address: street: 123 Main St. city: San Francisco region: CA postal_code: '94053' country: US schedule: start_date: '2022-10-01' end_date: '2023-10-01' interval_unit: week interval_count: 1 interval_execution_day: 5 request_id: saKrIBuEB9qJZno default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: 'Use the `/transfer/recurring/list` endpoint to see a list of all your recurring transfers and their statuses. Results are paginated; use the `count` and `offset` query parameters to retrieve the desired recurring transfers. ' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TransferRecurringListRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /transfer/cancel: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Cancel a transfer tags: - Plaid externalDocs: url: /api/products/transfer/initiating-transfers/#transfercancel operationId: transferCancel responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/TransferCancelResponse' examples: example-1: value: request_id: saKrIBuEB9qJZno default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Use the `/transfer/cancel` endpoint to cancel a transfer. A transfer is eligible for cancellation if the `cancellable` property returned by `/transfer/get` is `true`. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TransferCancelRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /transfer/recurring/cancel: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Cancel a recurring transfer. tags: - Plaid externalDocs: url: /api/products/transfer/recurring-transfers/#transferrecurringcancel operationId: transferRecurringCancel responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/TransferRecurringCancelResponse' examples: example-1: value: request_id: saKrIBuEB9qJZno default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Use the `/transfer/recurring/cancel` endpoint to cancel a recurring transfer. Scheduled transfer that hasn't been submitted to bank will be cancelled. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TransferRecurringCancelRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /transfer/event/list: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid List transfer events tags: - Plaid externalDocs: url: /api/products/transfer/reading-transfers/#transfereventlist operationId: transferEventList responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/TransferEventListResponse' examples: example-1: value: transfer_events: - account_id: 3gE5gnRzNyfXpBK5wEEKcymJ5albGVUqg77gr funding_account_id: 8945fedc-e703-463d-86b1-dc0607b55460 transfer_amount: '12.34' transfer_id: 460cbe92-2dcc-8eae-5ad6-b37d0ec90fd9 transfer_type: credit event_id: 1 event_type: posted failure_reason: null origination_account_id: '' originator_client_id: 569ed2f36b3a3a021713abc1 refund_id: null sweep_amount: null sweep_id: null timestamp: '2019-12-09T17:27:15Z' has_more: true request_id: mdqfuVxeoza6mhu default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Use the `/transfer/event/list` endpoint to get a list of transfer events based on specified filter criteria. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TransferEventListRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /transfer/event/sync: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Sync transfer events tags: - Plaid externalDocs: url: /api/products/transfer/reading-transfers/#transfereventsync operationId: transferEventSync responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/TransferEventSyncResponse' examples: example-1: value: transfer_events: - account_id: 3gE5gnRzNyfXpBK5wEEKcymJ5albGVUqg77gr funding_account_id: 8945fedc-e703-463d-86b1-dc0607b55460 transfer_amount: '12.34' transfer_id: 460cbe92-2dcc-8eae-5ad6-b37d0ec90fd9 transfer_type: credit event_id: 1 event_type: pending failure_reason: null origination_account_id: '' originator_client_id: null refund_id: null sweep_amount: null sweep_id: null timestamp: '2019-12-09T17:27:15Z' has_more: true request_id: mdqfuVxeoza6mhu default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TransferEventSyncRequest' description: '`/transfer/event/sync` allows you to request up to the next 25 transfer events that happened after a specific `event_id`. Use the `/transfer/event/sync` endpoint to guarantee you have seen all transfer events.' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /transfer/sweep/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Retrieve a sweep tags: - Plaid externalDocs: url: /api/products/transfer/reading-transfers/#transfersweepget operationId: transferSweepGet responses: '200': description: OK headers: {} content: application/json: schema: $ref: '#/components/schemas/TransferSweepGetResponse' examples: example-1: value: sweep: id: 8c2fda9a-aa2f-4735-a00f-f4e0d2d2faee funding_account_id: 8945fedc-e703-463d-86b1-dc0607b55460 created: '2020-08-06T17:27:15Z' amount: '12.34' iso_currency_code: USD settled: '2020-08-07' status: settled network_trace_id: '123456789012345' request_id: saKrIBuEB9qJZno default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: The `/transfer/sweep/get` endpoint fetches a sweep corresponding to the given `sweep_id`. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TransferSweepGetRequest' examples: {} parameters: [] servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /transfer/sweep/list: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid List sweeps tags: - Plaid externalDocs: url: /api/products/transfer/reading-transfers/#transfersweeplist operationId: transferSweepList responses: '200': description: OK headers: {} content: application/json: schema: $ref: '#/components/schemas/TransferSweepListResponse' examples: example-1: value: sweeps: - id: d5394a4d-0b04-4a02-9f4a-7ca5c0f52f9d funding_account_id: 8945fedc-e703-463d-86b1-dc0607b55460 created: '2019-12-09T17:27:15Z' amount: '-12.34' iso_currency_code: USD settled: '2019-12-10' status: settled originator_client_id: null request_id: saKrIBuEB9qJZno default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: The `/transfer/sweep/list` endpoint fetches sweeps matching the given filters. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TransferSweepListRequest' examples: {} parameters: [] servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /transfer/migrate_account: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Migrate account into Transfers tags: - Plaid externalDocs: url: /api/products/transfer/account-linking/#transfermigrate_account operationId: transferMigrateAccount responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/TransferMigrateAccountResponse' examples: example-1: value: access_token: access-sandbox-435beced-94e8-4df3-a181-1dde1cfa19f0 account_id: zvyDgbeeDluZ43AJP6m5fAxDlgoZXDuoy5gjN request_id: mdqfuVxeoza6mhu default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: As an alternative to adding Items via Link, you can also use the `/transfer/migrate_account` endpoint to migrate known account and routing numbers to Plaid Items. If you intend to create wire transfers on this account, you must provide `wire_routing_number`. Note that Items created in this way are not compatible with endpoints for other products, such as `/accounts/balance/get`, and can only be used with Transfer endpoints. If you require access to other endpoints, create the Item through Link instead. Access to `/transfer/migrate_account` is not enabled by default; to obtain access, contact your Plaid Account Manager. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TransferMigrateAccountRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /transfer/intent/create: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Create a transfer intent object to invoke the Transfer UI tags: - Plaid externalDocs: url: /api/products/transfer/account-linking/#transferintentcreate operationId: transferIntentCreate responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/TransferIntentCreateResponse' examples: example-1: value: transfer_intent: account_id: 3gE5gnRzNyfXpBK5wEEKcymJ5albGVUqg77gr funding_account_id: 9853defc-e703-463d-86b1-dc0607a45359 ach_class: ppd amount: '12.34' iso_currency_code: USD created: '2020-08-06T17:27:15Z' description: Desc id: 460cbe92-2dcc-8eae-5ad6-b37d0ec90fd9 metadata: key1: value1 key2: value2 mode: PAYMENT origination_account_id: 9853defc-e703-463d-86b1-dc0607a45359 status: PENDING user: address: street: 100 Market Street city: San Francisco region: CA postal_code: '94103' country: US email_address: acharleston@email.com legal_name: Anne Charleston phone_number: 123-456-7890 request_id: saKrIBuEB9qJZno default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Use the `/transfer/intent/create` endpoint to generate a transfer intent object and invoke the Transfer UI. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TransferIntentCreateRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /transfer/intent/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Retrieve more information about a transfer intent tags: - Plaid externalDocs: url: /api/products/transfer/account-linking/#transferintentget operationId: transferIntentGet responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/TransferIntentGetResponse' examples: example-1: value: transfer_intent: account_id: 3gE5gnRzNyfXpBK5wEEKcymJ5albGVUqg77gr funding_account_id: 9853defc-e703-463d-86b1-dc0607a45359 ach_class: ppd amount: '12.34' iso_currency_code: USD authorization_decision: APPROVED authorization_decision_rationale: null created: '2019-12-09T17:27:15Z' description: Desc failure_reason: null guarantee_decision: null guarantee_decision_rationale: null id: 460cbe92-2dcc-8eae-5ad6-b37d0ec90fd9 metadata: key1: value1 key2: value2 mode: DISBURSEMENT origination_account_id: 9853defc-e703-463d-86b1-dc0607a45359 status: SUCCEEDED transfer_id: 590ecd12-1dcc-7eae-4ad6-c28d1ec90df2 user: address: street: 123 Main St. city: San Francisco region: California postal_code: '94053' country: US email_address: acharleston@email.com legal_name: Anne Charleston phone_number: 510-555-0128 request_id: saKrIBuEB9qJZno default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Use the `/transfer/intent/get` endpoint to retrieve more information about a transfer intent. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TransferIntentGetRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /transfer/repayment/list: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Lists historical repayments tags: - Plaid externalDocs: url: /api/products/transfer/#transferrepaymentlist operationId: transferRepaymentList responses: '200': description: OK headers: {} content: application/json: schema: $ref: '#/components/schemas/TransferRepaymentListResponse' examples: example-1: value: repayments: - repayment_id: d4bfce70-2470-4298-ae87-5e9b3e18bfaf created: '2019-12-09T12:34:56Z' amount: '12.34' iso_currency_code: USD request_id: h0dvmW8g4r2Z0KX default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: The `/transfer/repayment/list` endpoint fetches repayments matching the given filters. Repayments are returned in reverse-chronological order (most recent first) starting at the given `start_time`. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TransferRepaymentListRequest' examples: example-1: value: start_time: '2022-01-10T12:34:56Z' count: 1 parameters: [] servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /transfer/repayment/return/list: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid List the returns included in a repayment tags: - Plaid externalDocs: url: /api/products/transfer/#transferrepaymentreturnlist operationId: transferRepaymentReturnList responses: '200': description: OK headers: {} content: application/json: schema: $ref: '#/components/schemas/TransferRepaymentReturnListResponse' examples: example-1: value: repayment_returns: - transfer_id: d4bfce70-2470-4298-ae87-5e9b3e18bfaf event_id: 5 amount: '12.34' iso_currency_code: USD request_id: Ay70UHyBmbY0wUf default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: The `/transfer/repayment/return/list` endpoint retrieves the set of returns that were batched together into the specified repayment. The sum of amounts of returns retrieved by this request equals the amount of the repayment. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TransferRepaymentReturnListRequest' examples: example-1: value: start_time: '2022-01-10T12:34:56Z' count: 1 repayment_id: d4bfce70-2470-4298-ae87-5e9b3e18bfaf parameters: [] servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /transfer/originator/create: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Create a new originator tags: - Plaid externalDocs: url: /api/products/transfer/platform-payments/#transferoriginatorcreate operationId: transferOriginatorCreate responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/TransferOriginatorCreateResponse' examples: example-1: value: originator_client_id: 6a65dh3d1h0d1027121ak184 company_name: Marketplace of Shannon request_id: 4zlKapIkTm8p5KM default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Use the `/transfer/originator/create` endpoint to create a new originator and return an `originator_client_id`. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TransferOriginatorCreateRequest' examples: {} parameters: [] servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /transfer/questionnaire/create: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Generate a Plaid-hosted onboarding UI URL. tags: - Plaid externalDocs: url: /api/products/transfer/platform-payments/#transferquestionnairecreate operationId: transferQuestionnaireCreate responses: '200': description: OK headers: {} content: application/json: schema: $ref: '#/components/schemas/TransferQuestionnaireCreateResponse' examples: example-1: value: onboarding_url: https://plaid.com/originator/hIFGXx1zM5pFerygu7lw request_id: saKrIBuEB9qJZno default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: The `/transfer/questionnaire/create` endpoint generates a Plaid-hosted onboarding UI URL. Redirect the originator to this URL to provide their due diligence information and agree to Plaid’s terms for ACH money movement. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TransferQuestionnaireCreateRequest' examples: {} parameters: [] servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /transfer/diligence/submit: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Submit transfer diligence on behalf of the originator tags: - Plaid externalDocs: url: /api/products/transfer/platform-payments/#transferdiligencesubmit operationId: transferDiligenceSubmit responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/TransferDiligenceSubmitResponse' examples: example-1: value: request_id: 4zlKapIkTm8p5KM default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Use the `/transfer/diligence/submit` endpoint to submit transfer diligence on behalf of the originator (i.e., the end customer). requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TransferDiligenceSubmitRequest' examples: {} parameters: [] servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /transfer/diligence/document/upload: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Upload transfer diligence document on behalf of the originator tags: - Plaid externalDocs: url: /api/products/transfer/platform-payments/#transferdiligencedocumentupload operationId: transferDiligenceDocumentUpload responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/TransferDiligenceDocumentUploadResponse' examples: example-1: value: request_id: 4zlKapIkTm8p5KM default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: 'Third-party sender customers can use `/transfer/diligence/document/upload` endpoint to upload a document on behalf of its end customer (i.e. originator) to Plaid. You’ll need to send a request of type multipart/form-data. You must provide the `client_id` in the `PLAID-CLIENT-ID` header and `secret` in the `PLAID-SECRET` header.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TransferDiligenceDocumentUploadRequest' examples: {} parameters: [] servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /transfer/originator/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Get status of an originator's onboarding tags: - Plaid externalDocs: url: /api/products/transfer/platform-payments/#transferoriginatorget operationId: transferOriginatorGet responses: '200': description: OK headers: {} content: application/json: schema: $ref: '#/components/schemas/TransferOriginatorGetResponse' examples: example-1: value: originator: client_id: 6a65dh3d1h0d1027121ak184 transfer_diligence_status: approved company_name: Plaid request_id: saKrIBuEB9qJZno default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: The `/transfer/originator/get` endpoint gets status updates for an originator's onboarding process. This information is also available via the Transfer page on the Plaid dashboard. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TransferOriginatorGetRequest' examples: {} parameters: [] servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /transfer/originator/list: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Get status of all originators' onboarding tags: - Plaid externalDocs: url: /api/products/transfer/platform-payments/#transferoriginatorlist operationId: transferOriginatorList responses: '200': description: OK headers: {} content: application/json: schema: $ref: '#/components/schemas/TransferOriginatorListResponse' examples: example-1: value: originators: - client_id: 6a65dh3d1h0d1027121ak184 transfer_diligence_status: approved - client_id: 8g89as4d2k1d9852938ba019 transfer_diligence_status: denied request_id: 4zlKapIkTm8p5KM default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: The `/transfer/originator/list` endpoint gets status updates for all of your originators' onboarding. This information is also available via the Plaid dashboard. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TransferOriginatorListRequest' examples: {} parameters: [] servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /transfer/refund/create: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Create a refund tags: - Plaid externalDocs: url: /api/products/transfer/refunds/#transferrefundcreate operationId: transferRefundCreate responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/TransferRefundCreateResponse' examples: example-1: value: refund: id: 667af684-9ee1-4f5f-862a-633ec4c545cc transfer_id: 460cbe92-2dcc-8eae-5ad6-b37d0ec90fd9 amount: '12.34' status: pending created: '2020-08-06T17:27:15Z' failure_reason: null network_trace_id: null request_id: saKrIBuEB9qJZno default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: 'Use the `/transfer/refund/create` endpoint to create a refund for a transfer. A transfer can be refunded if the transfer was initiated in the past 180 days. Processing of the refund will not occur until at least 4 business days following the transfer''s settlement date, plus any hold/settlement delays. This 3-day window helps better protect your business from regular ACH returns. Consumer initiated returns (unauthorized returns) could still happen for about 60 days from the settlement date. If the original transfer is canceled, returned or failed, all pending refunds will automatically be canceled. Processed refunds cannot be revoked.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TransferRefundCreateRequest' parameters: [] servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /transfer/refund/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Retrieve a refund tags: - Plaid externalDocs: url: /api/products/transfer/refunds/#transferrefundget operationId: transferRefundGet responses: '200': description: OK headers: {} content: application/json: schema: $ref: '#/components/schemas/TransferRefundGetResponse' examples: example-1: value: refund: id: 667af684-9ee1-4f5f-862a-633ec4c545cc transfer_id: 460cbe92-2dcc-8eae-5ad6-b37d0ec90fd9 amount: '12.34' status: pending created: '2020-08-06T17:27:15Z' failure_reason: null network_trace_id: null request_id: saKrIBuEB9qJZno default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: The `/transfer/refund/get` endpoint fetches information about the refund corresponding to the given `refund_id`. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TransferRefundGetRequest' examples: {} parameters: [] servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /transfer/refund/cancel: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Cancel a refund tags: - Plaid externalDocs: url: /api/products/transfer/refunds/#transferrefundcancel operationId: transferRefundCancel responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/TransferRefundCancelResponse' examples: example-1: value: request_id: saKrIBuEB9qJZno default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Use the `/transfer/refund/cancel` endpoint to cancel a refund. A refund is eligible for cancellation if it has not yet been submitted to the payment network. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TransferRefundCancelRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /sandbox/transfer/sweep/simulate: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Simulate creating a sweep tags: - Plaid externalDocs: url: /api/sandbox/#sandboxtransfersweepsimulate operationId: sandboxTransferSweepSimulate responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/SandboxTransferSweepSimulateResponse' examples: example-1: value: sweep: id: d5394a4d-0b04-4a02-9f4a-7ca5c0f52f9d funding_account_id: 8945fedc-e703-463d-86b1-dc0607b55460 created: '2020-08-06T17:27:15Z' amount: '12.34' iso_currency_code: USD settled: '2020-08-07' network_trace_id: null request_id: mdqfuVxeoza6mhu default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Use the `/sandbox/transfer/sweep/simulate` endpoint to create a sweep and associated events in the Sandbox environment. Upon calling this endpoint, all transfers with a sweep status of `swept` will become `swept_settled`, all `posted` or `pending` transfers with a sweep status of `unswept` will become `swept`, and all `returned` transfers with a sweep status of `swept` will become `return_swept`. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SandboxTransferSweepSimulateRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /sandbox/transfer/simulate: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Simulate a transfer event in Sandbox tags: - Plaid externalDocs: url: /api/sandbox/#sandboxtransfersimulate operationId: sandboxTransferSimulate responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/SandboxTransferSimulateResponse' examples: example-1: value: request_id: mdqfuVxeoza6mhu default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Use the `/sandbox/transfer/simulate` endpoint to simulate a transfer event in the Sandbox environment. Note that while an event will be simulated and will appear when using endpoints such as `/transfer/event/sync` or `/transfer/event/list`, no transactions will actually take place and funds will not move between accounts, even within the Sandbox. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SandboxTransferSimulateRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /sandbox/transfer/refund/simulate: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Simulate a refund event in Sandbox tags: - Plaid externalDocs: url: /api/sandbox/#sandboxtransferrefundsimulate operationId: sandboxTransferRefundSimulate responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/SandboxTransferRefundSimulateResponse' examples: example-1: value: request_id: mdqfuVxeoza6mhu default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Use the `/sandbox/transfer/refund/simulate` endpoint to simulate a refund event in the Sandbox environment. Note that while an event will be simulated and will appear when using endpoints such as `/transfer/event/sync` or `/transfer/event/list`, no transactions will actually take place and funds will not move between accounts, even within the Sandbox. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SandboxTransferRefundSimulateRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /sandbox/transfer/ledger/simulate_available: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Simulate converting pending balance to available balance tags: - Plaid externalDocs: url: /api/sandbox/#sandboxtransferledgersimulate_available operationId: sandboxTransferLedgerSimulateAvailable responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/SandboxTransferLedgerSimulateAvailableResponse' examples: example-1: value: request_id: mdqfuVxeoza6mhu default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Use the `/sandbox/transfer/ledger/simulate_available` endpoint to simulate converting pending balance to available balance for all originators in the Sandbox environment. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SandboxTransferLedgerSimulateAvailableRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /sandbox/transfer/ledger/deposit/simulate: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Simulate a ledger deposit event in Sandbox tags: - Plaid externalDocs: url: /api/sandbox/#sandboxtransferledgerdepositsimulate operationId: sandboxTransferLedgerDepositSimulate responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/SandboxTransferLedgerDepositSimulateResponse' examples: example-1: value: request_id: mdqfuVxeoza6mhu default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Use the `/sandbox/transfer/ledger/deposit/simulate` endpoint to simulate a ledger deposit event in the Sandbox environment. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SandboxTransferLedgerDepositSimulateRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /sandbox/transfer/ledger/withdraw/simulate: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Simulate a ledger withdraw event in Sandbox tags: - Plaid externalDocs: url: /api/sandbox/#sandboxtransferledgerwithdrawsimulate operationId: sandboxTransferLedgerWithdrawSimulate responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/SandboxTransferLedgerWithdrawSimulateResponse' examples: example-1: value: request_id: mdqfuVxeoza6mhu default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Use the `/sandbox/transfer/ledger/withdraw/simulate` endpoint to simulate a ledger withdraw event in the Sandbox environment. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SandboxTransferLedgerWithdrawSimulateRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /sandbox/transfer/repayment/simulate: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Trigger the creation of a repayment tags: - Plaid externalDocs: url: /api/sandbox/#sandboxtransferrepaymentsimulate operationId: sandboxTransferRepaymentSimulate responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/SandboxTransferRepaymentSimulateResponse' examples: example-1: value: request_id: 4vAbY6XyqqoPQLB default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Use the `/sandbox/transfer/repayment/simulate` endpoint to trigger the creation of a repayment. As a side effect of calling this route, a repayment is created that includes all unreimbursed returns of guaranteed transfers. If there are no such returns, an 400 error is returned. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SandboxTransferRepaymentSimulateRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /sandbox/transfer/fire_webhook: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Manually fire a Transfer webhook tags: - Plaid externalDocs: url: /api/sandbox/#sandboxtransferfire_webhook operationId: sandboxTransferFireWebhook responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/SandboxTransferFireWebhookResponse' examples: example-1: value: request_id: mdqfuVxeoza6mhu default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Use the `/sandbox/transfer/fire_webhook` endpoint to manually trigger a `TRANSFER_EVENTS_UPDATE` webhook in the Sandbox environment. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SandboxTransferFireWebhookRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /sandbox/transfer/test_clock/create: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Create a test clock tags: - Plaid externalDocs: url: /api/sandbox/#sandboxtransfertest_clockcreate operationId: sandboxTransferTestClockCreate responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/SandboxTransferTestClockCreateResponse' examples: example-1: value: test_clock: test_clock_id: b33a6eda-5e97-5d64-244a-a9274110151c virtual_time: '2006-01-02T15:04:05Z' request_id: mdqfuVxeoza6mhu default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: 'Use the `/sandbox/transfer/test_clock/create` endpoint to create a `test_clock` in the Sandbox environment. A test clock object represents an independent timeline and has a `virtual_time` field indicating the current timestamp of the timeline. Test clocks are used for testing recurring transfers in Sandbox. A test clock can be associated with up to 5 recurring transfers.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SandboxTransferTestClockCreateRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /sandbox/transfer/test_clock/advance: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Advance a test clock tags: - Plaid externalDocs: url: /api/sandbox/#sandboxtransfertest_clockadvance operationId: sandboxTransferTestClockAdvance responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/SandboxTransferTestClockAdvanceResponse' examples: example-1: value: request_id: mdqfuVxeoza6mhu default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: 'Use the `/sandbox/transfer/test_clock/advance` endpoint to advance a `test_clock` in the Sandbox environment. A test clock object represents an independent timeline and has a `virtual_time` field indicating the current timestamp of the timeline. A test clock can be advanced by incrementing `virtual_time`, but may never go back to a lower `virtual_time`. If a test clock is advanced, we will simulate the changes that ought to occur during the time that elapsed. For example, a client creates a weekly recurring transfer with a test clock set at t. When the client advances the test clock by setting `virtual_time` = t + 15 days, 2 new originations should be created, along with the webhook events. The advancement of the test clock from its current `virtual_time` should be limited such that there are no more than 20 originations resulting from the advance operation on each `recurring_transfer` associated with the `test_clock`. For example, if the recurring transfer associated with this test clock originates once every 4 weeks, you can advance the `virtual_time` up to 80 weeks on each API call.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SandboxTransferTestClockAdvanceRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /sandbox/transfer/test_clock/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Get a test clock tags: - Plaid externalDocs: url: /api/sandbox/#sandboxtransfertest_clockget operationId: sandboxTransferTestClockGet responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/SandboxTransferTestClockGetResponse' examples: example-1: value: test_clock: test_clock_id: b33a6eda-5e97-5d64-244a-a9274110151c virtual_time: '2006-01-02T15:04:05Z' request_id: mdqfuVxeoza6mhu default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Use the `/sandbox/transfer/test_clock/get` endpoint to get a `test_clock` in the Sandbox environment. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SandboxTransferTestClockGetRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /sandbox/transfer/test_clock/list: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid List test clocks tags: - Plaid externalDocs: url: /api/sandbox/#sandboxtransfertest_clocklist operationId: sandboxTransferTestClockList responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/SandboxTransferTestClockListResponse' examples: example-1: value: test_clocks: - test_clock_id: b33a6eda-5e97-5d64-244a-a9274110151c virtual_time: '2006-01-02T15:04:05Z' - test_clock_id: a33a6eda-5e97-5d64-244a-a9274110152d virtual_time: '2006-02-02T15:04:05Z' request_id: mdqfuVxeoza6mhu default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Use the `/sandbox/transfer/test_clock/list` endpoint to see a list of all your test clocks in the Sandbox environment, by ascending `virtual_time`. Results are paginated; use the `count` and `offset` query parameters to retrieve the desired test clocks. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SandboxTransferTestClockListRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /sandbox/payment_profile/reset_login: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: deprecated: true tags: - Plaid summary: Plaid Reset the login of a Payment Profile externalDocs: url: /api/sandbox/#sandboxpayment_profilereset_login operationId: sandboxPaymentProfileResetLogin responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/SandboxPaymentProfileResetLoginResponse' examples: example-1: value: reset_login: true request_id: m8MDnv9okwxFNBV description: "`/sandbox/payment_profile/reset_login/` forces a Payment Profile into a state where the login is no longer valid. This makes it easy to test update mode for Payment Profile in the Sandbox environment.\n\n After calling `/sandbox/payment_profile/reset_login`, calls to the `/transfer/authorization/create` with the Payment Profile will result in a `decision_rationale` `PAYMENT_PROFILE_LOGIN_REQUIRED`. You can then use update mode for Payment Profile to restore it into a good state.\n\n In order to invoke this endpoint, you must first [create a Payment Profile](https://plaid.com/docs/transfer/add-to-app/#create-a-payment-profile-optional) and [go through the Link flow](https://plaid.com/docs/transfer/add-to-app/#create-a-link-token)." requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SandboxPaymentProfileResetLoginRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /employment/verification/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: deprecated: true summary: Plaid (Deprecated) Retrieve a summary of an individual's employment information tags: - Plaid operationId: employmentVerificationGet externalDocs: url: /api/products/income/#employmentverificationget responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/EmploymentVerificationGetResponse' examples: example-1: value: employments: - status: EMPLOYMENT_STATUS_ACTIVE start_date: '2020-01-01' end_date: null employer: name: Plaid Inc title: Software Engineer platform_ids: employee_id: '1234567' position_id: '8888' payroll_id: '1234567' request_id: LhQf0THi8SH1yJm description: '`/employment/verification/get` returns a list of employments through a user payroll that was verified by an end user. This endpoint has been deprecated; new integrations should use `/credit/employment/get` instead.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/EmploymentVerificationGetRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /sandbox/bank_income/fire_webhook: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Manually fire a bank income webhook in sandbox tags: - Plaid externalDocs: url: /api/sandbox/#sandboxbankincomefire_webhook operationId: sandboxBankIncomeFireWebhook responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/SandboxBankIncomeFireWebhookResponse' examples: example-1: value: request_id: mdqfuVxeoza6mhu default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Use the `/sandbox/bank_income/fire_webhook` endpoint to manually trigger a Bank Income webhook in the Sandbox environment. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SandboxBankIncomeFireWebhookRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /sandbox/oauth/select_accounts: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: summary: Plaid Save the selected accounts when connecting to the Platypus Oauth institution description: Save the selected accounts when connecting to the Platypus Oauth institution tags: - Plaid operationId: sandboxOauthSelectAccounts responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/SandboxOauthSelectAccountsResponse' default: description: Error response. content: application/json: schema: $ref: '#/components/schemas/PlaidError' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SandboxOauthSelectAccountsRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /signal/evaluate: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Evaluate a planned ACH transaction externalDocs: url: /api/products/signal#signalevaluate operationId: signalEvaluate description: 'Use `/signal/evaluate` to evaluate a planned ACH transaction to get a return risk assessment (such as a risk score and risk tier) and additional risk signals. In order to obtain a valid score for an ACH transaction, Plaid must have an access token for the account, and the Item must be healthy (receiving product updates) or have recently been in a healthy state. If the transaction does not meet eligibility requirements, an error will be returned corresponding to the underlying cause. If `/signal/evaluate` is called on the same transaction multiple times within a 24-hour period, cached results may be returned. For more information please refer to the error documentation on [Item errors](/docs/errors/item/) and [Link in Update Mode](/docs/link/update-mode/). Note: This request may take some time to complete if Signal is being added to an existing Item. This is because Plaid must communicate directly with the institution when retrieving the data for the first time.' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/SignalEvaluateResponse' examples: example-1: value: scores: customer_initiated_return_risk: score: 9 risk_tier: 1 bank_initiated_return_risk: score: 72 risk_tier: 7 core_attributes: days_since_first_plaid_connection: 510 plaid_connections_count_7d: 6 plaid_connections_count_30d: 7 total_plaid_connections_count: 15 is_savings_or_money_market_account: false warnings: [] request_id: mdqfuVxeoza6mhu default: description: Error response. content: application/json: schema: $ref: '#/components/schemas/PlaidError' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SignalEvaluateRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /signal/decision/report: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Report whether you initiated an ACH transaction externalDocs: url: /api/products/signal#signaldecisionreport operationId: signalDecisionReport description: After calling `/signal/evaluate`, call `/signal/decision/report` to report whether the transaction was initiated. responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/SignalDecisionReportResponse' examples: example-1: value: request_id: mdqfuVxeoza6mhu default: description: Error response. content: application/json: schema: $ref: '#/components/schemas/PlaidError' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SignalDecisionReportRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /signal/return/report: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Report a return for an ACH transaction externalDocs: url: /api/products/signal#signalreturnreport operationId: signalReturnReport description: Call the `/signal/return/report` endpoint to report a returned transaction that was previously sent to the `/signal/evaluate` endpoint. Your feedback will be used by the model to incorporate the latest risk trend in your portfolio. responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/SignalReturnReportResponse' examples: example-1: value: request_id: mdqfuVxeoza6mhu default: description: Error response. content: application/json: schema: $ref: '#/components/schemas/PlaidError' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SignalReturnReportRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /signal/prepare: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Opt-in an Item to Signal externalDocs: url: /api/products/signal#signalprepare operationId: signalPrepare description: 'When Link is not initialized with Signal, call `/signal/prepare` to opt-in that Item to the Signal data collection process, developing a Signal score. If run on an Item that is already initialized with Signal, this endpoint will return a 200 response and will not modify the Item.' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/SignalPrepareResponse' examples: example-1: value: request_id: mdqfuVxeoza6mhu default: description: Error response. content: application/json: schema: $ref: '#/components/schemas/PlaidError' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SignalPrepareRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /wallet/create: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Create an e-wallet externalDocs: url: /api/products/virtual-accounts/#walletcreate operationId: walletCreate responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/WalletCreateResponse' examples: example-1: value: wallet_id: wallet-id-production-53e58b32-fc1c-46fe-bbd6-e584b27a88 recipient_id: recipient-id-production-9b6b4679-914b-445b-9450-efbdb80296f6 balance: iso_currency_code: GBP current: 123.12 available: 100.96 request_id: 4zlKapIkTm8p5KM numbers: bacs: account: '12345678' sort_code: '123456' status: ACTIVE description: Create an e-wallet. The response is the newly created e-wallet object. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/WalletCreateRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /wallet/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Fetch an e-wallet externalDocs: url: /api/products/virtual-accounts/#walletget operationId: walletGet responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/WalletGetResponse' examples: example-1: value: wallet_id: wallet-id-production-53e58b32-fc1c-46fe-bbd6-e584b27a88 recipient_id: recipient-id-production-9b6b4679-914b-445b-9450-efbdb80296f6 balance: iso_currency_code: GBP current: 123.12 available: 100.96 request_id: 4zlKapIkTm8p5KM numbers: bacs: account: '12345678' sort_code: '123456' international: iban: GB33BUKB20201555555555 bic: BUKBGB22 status: ACTIVE example-2: value: wallet_id: wallet-id-production-53e58b32-fc1c-46fe-bbd6-e584b27a88 recipient_id: recipient-id-production-9b6b4679-914b-445b-9450-efbdb80296f6 balance: iso_currency_code: EUR current: 123.12 available: 100.96 request_id: 4zlKapIkTm8p5KM numbers: international: iban: NL91ABNA0417164300 bic: ABNANL2A status: ACTIVE description: Fetch an e-wallet. The response includes the current balance. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/WalletGetRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /wallet/list: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Fetch a list of e-wallets externalDocs: url: /api/products/virtual-accounts/#walletlist operationId: walletList responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/WalletListResponse' examples: example-1: value: wallets: - wallet_id: wallet-id-production-53e58b32-fc1c-46fe-bbd6-e584b27a88 recipient_id: recipient-id-production-9b6b4679-914b-445b-9450-efbdb80296f6 balance: iso_currency_code: GBP current: 123.12 available: 100.96 numbers: bacs: account: '12345678' sort_code: '123456' status: ACTIVE - wallet_id: wallet-id-production-53e58b32-fc1c-46fe-bbd6-e584b27a999 recipient_id: recipient-id-production-9b6b4679-914b-445b-9450-efbdb80296f7 balance: iso_currency_code: EUR current: 456.78 available: 100.96 numbers: international: iban: GB22HBUK40221241555626 bic: HBUKGB4B status: ACTIVE request_id: 4zlKapIkTm8p5KM description: This endpoint lists all e-wallets in descending order of creation. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/WalletListRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /wallet/transaction/execute: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Execute a transaction using an e-wallet externalDocs: url: /api/products/virtual-accounts/#wallettransactionexecute operationId: walletTransactionExecute responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/WalletTransactionExecuteResponse' examples: example-1: value: transaction_id: wallet-transaction-id-production-53e58b32-fc1c-46fe-bbd6-e584b27a88 status: EXECUTED request_id: 4zlKapIkTm8p5KM description: 'Execute a transaction using the specified e-wallet. Specify the e-wallet to debit from, the counterparty to credit to, the idempotency key to prevent duplicate transactions, the amount and reference for the transaction. Transactions will settle in seconds to several days, depending on the underlying payment rail.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/WalletTransactionExecuteRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /wallet/transaction/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Fetch an e-wallet transaction externalDocs: url: /api/products/virtual-accounts/#wallettransactionget operationId: walletTransactionGet responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/WalletTransactionGetResponse' examples: example-1: value: transaction_id: wallet-transaction-id-sandbox-feca8a7a-5591-4aef-9297-f3062bb735d3 wallet_id: wallet-id-production-53e58b32-fc1c-46fe-bbd6-e584b27a88 type: PAYOUT reference: Payout 99744 amount: iso_currency_code: GBP value: 123.12 status: EXECUTED created_at: '2020-12-02T21:14:54Z' last_status_update: '2020-12-02T21:15:01Z' counterparty: numbers: bacs: account: '31926819' sort_code: '601613' name: John Smith request_id: 4zlKapIkTm8p5KM example-2: value: transaction_id: wallet-transaction-id-sandbox-feca8a7a-5591-4aef-9297-f3062bb735d3 wallet_id: wallet-id-production-53e58b32-fc1c-46fe-bbd6-e584b27a88 type: PAYOUT reference: Payout 99744 amount: iso_currency_code: EUR value: 456.78 status: EXECUTED created_at: '2020-12-02T21:14:54Z' last_status_update: '2020-12-02T21:15:01Z' counterparty: numbers: international: iban: GB33BUKB20201555555555 name: John Smith request_id: 4zlKapIkTm8p5KM description: Fetch a specific e-wallet transaction requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/WalletTransactionGetRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /wallet/transaction/list: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid List e-wallet transactions externalDocs: url: /api/products/virtual-accounts/#wallettransactionlist operationId: walletTransactionList responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/WalletTransactionListResponse' examples: example-1: value: next_cursor: YWJjMTIzIT8kKiYoKSctPUB transactions: - transaction_id: wallet-transaction-id-sandbox-feca8a7a-5591-4aef-9297-f3062bb735d3 wallet_id: wallet-id-production-53e58b32-fc1c-46fe-bbd6-e584b27a88 type: PAYOUT reference: Payout 99744 amount: iso_currency_code: GBP value: 123.12 status: EXECUTED created_at: '2020-12-02T21:14:54Z' last_status_update: '2020-12-02T21:15:01Z' counterparty: numbers: bacs: account: '31926819' sort_code: '601613' name: John Smith - transaction_id: wallet-transaction-id-sandbox-feca8a7a-5591-4aef-9297-f3062bb735d3 wallet_id: wallet-id-production-53e58b32-fc1c-46fe-bbd6-e584b27a88 type: PAYOUT reference: Payout 99744 amount: iso_currency_code: EUR value: 456.78 status: EXECUTED created_at: '2020-12-02T21:14:54Z' last_status_update: '2020-12-02T21:15:01Z' counterparty: numbers: international: iban: GB33BUKB20201555555555 name: John Smith request_id: 4zlKapIkTm8p5KM description: This endpoint lists the latest transactions of the specified e-wallet. Transactions are returned in descending order by the `created_at` time. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/WalletTransactionListRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /payment_profile/create: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: deprecated: true tags: - Plaid summary: Plaid Create payment profile externalDocs: url: /api/products/transfer/#payment_profilecreate operationId: paymentProfileCreate responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/PaymentProfileCreateResponse' examples: example-1: value: payment_profile_token: payment-profile-sandbox-eda0b25e-8ef3-4ebb-9ef7-1ef3db3c5ee8 request_id: 4ciYmmesdqSiUAB default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: 'Use `/payment_profile/create` endpoint to create a new payment profile. To initiate the account linking experience, call `/link/token/create` and provide the `payment_profile_token` in the `transfer.payment_profile_token` field. You can then use the `payment_profile_token` when creating transfers using `/transfer/authorization/create` and `/transfer/create`.' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/PaymentProfileCreateRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /payment_profile/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: deprecated: true tags: - Plaid summary: Plaid Get payment profile externalDocs: url: /api/products/transfer/#payment_profileget operationId: paymentProfileGet responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/PaymentProfileGetResponse' examples: example-1: value: status: READY updated_at: '2022-07-07T12:48:37Z' created_at: '2022-07-05T12:48:37Z' deleted_at: null request_id: 4ciYmmesdqSiUAB default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Use `/payment_profile/get` endpoint to get the status of a given Payment Profile. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/PaymentProfileGetRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /payment_profile/remove: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: deprecated: true tags: - Plaid summary: Plaid Remove payment profile externalDocs: url: /api/products/transfer/#payment_profileremove operationId: paymentProfileRemove responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/PaymentProfileRemoveResponse' examples: example-1: value: request_id: 4ciYmmesdqSiUAB default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' description: Use the `/payment_profile/remove` endpoint to remove a given Payment Profile. Once it’s removed, it can no longer be used to create transfers. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/PaymentProfileRemoveRequest' servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /partner/customer/create: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Creates a new end customer for a Plaid reseller. externalDocs: url: /api/partner/#partnercustomercreate description: The `/partner/customer/create` endpoint is used by reseller partners to create end customers. operationId: partnerCustomerCreate responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/PartnerCustomerCreateResponse' examples: example-1: value: end_customer: client_id: 7f57eb3d2a9j6480121fx361 company_name: Plaid status: ACTIVE secrets: sandbox: b60b5201d006ca5a7081d27c824d77 development: 95e56a510204f293d3bebd4b9cf5c7 request_id: 4zlKapIkTm8p5KM default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/PartnerCustomerCreateRequest' examples: example-1: value: client_id: 7f57eb3d2a9j6480121fx361 secret: 79g03eoofwl8240v776r2h667442119 company_name: Plaid is_diligence_attested: true products: - auth - identity create_link_customization: true legal_entity_name: Plaid website: plaid.com application_name: Plaid technical_contact: given_name: Alice family_name: Smith email: alice.smith@example.com billing_contact: given_name: Bob family_name: Jones email: bob.jones@example.com address: city: New York street: 123 Main St region: NY postal_code: '12345' country_code: US is_bank_addendum_completed: true customer_support_info: email: support@example.com phone_number: '1234567890' contact_url: example.com/contact link_update_url: example.com/update redirect_uris: - http://localhost/oauth.html - https://www.example.com/oauth.html - https://*.example.com/oauth.html servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /partner/customer/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Returns a Plaid reseller's end customer. externalDocs: url: /api/partner/#partnercustomerget description: The `/partner/customer/get` endpoint is used by reseller partners to retrieve data about a single end customer. operationId: partnerCustomerGet responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/PartnerCustomerGetResponse' examples: example-1: value: end_customer: client_id: 7f57eb3d2a9j6480121fx361 company_name: Plaid status: ACTIVE request_id: 4zlKapIkTm8p5KM default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/PartnerCustomerGetRequest' examples: example-1: value: client_id: 7f57eb3d2a9j6480121fx361 secret: 79g03eoofwl8240v776r2h667442119 end_customer_client_id: 7f57eb3d2a9j6480121fx361 servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /partner/customer/enable: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Enables a Plaid reseller's end customer in the Production environment. externalDocs: url: /api/partner/#partnercustomerenable description: The `/partner/customer/enable` endpoint is used by reseller partners to enable an end customer in the Production environment. operationId: partnerCustomerEnable responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/PartnerCustomerEnableResponse' examples: example-1: value: production_secret: 79g03eoofwl8240v776r2h667442119 request_id: 4zlKapIkTm8p5KM default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/PartnerCustomerEnableRequest' examples: example-1: value: client_id: 7f57eb3d2a9j6480121fx361 secret: 79g03eoofwl8240v776r2h667442119 end_customer_client_id: 7f57eb3d2a9j6480121fx361 servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /partner/customer/remove: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Removes a Plaid reseller's end customer. externalDocs: url: /api/partner/#partnercustomerremove description: The `/partner/customer/remove` endpoint is used by reseller partners to remove an end customer. Removing an end customer will remove it from view in the Plaid Dashboard and deactivate its API keys. This endpoint can only be used to remove an end customer that has not yet been enabled in Production. operationId: partnerCustomerRemove responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/PartnerCustomerRemoveResponse' examples: example-1: value: request_id: 4zlKapIkTm8p5KM default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/PartnerCustomerRemoveRequest' examples: example-1: value: client_id: 7f57eb3d2a9j6480121fx361 secret: 79g03eoofwl8240v776r2h667442119 end_customer_client_id: 7f57eb3d2a9j6480121fx361 servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com /partner/customer/oauth_institutions/get: x-plaid-business-unit-context: BUSINESS_UNIT_PLAID post: tags: - Plaid summary: Plaid Returns OAuth-institution registration information for a given end customer. externalDocs: url: /api/partner/#partnercustomeroauth_institutionsget description: The `/partner/customer/oauth_institutions/get` endpoint is used by reseller partners to retrieve OAuth-institution registration information about a single end customer. To learn how to set up a webhook to listen to status update events, visit the [reseller documentation](https://plaid.com/docs/account/resellers/#enabling-end-customers). operationId: partnerCustomerOauthInstitutionsGet responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/PartnerCustomerOAuthInstitutionsGetResponse' examples: example-1: value: flowdown_status: COMPLETE questionnaire_status: COMPLETE institutions: - name: Chase institution_id: ins_56 environments: production: PROCESSING development: PROCESSING production_enablement_date: null classic_disablement_date: '2022-06-30' - name: Capital One institution_id: ins_128026 environments: production: ENABLED development: ENABLED production_enablement_date: '2022-12-19' classic_disablement_date: null request_id: 4zlKapIkTm8p5KM default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PlaidError' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/PartnerCustomerOAuthInstitutionsGetRequest' examples: example-1: value: client_id: 7f57eb3d2a9j6480121fx361 secret: 79g03eoofwl8240v776r2h667442119 end_customer_client_id: 7f57eb3d2a9j6480121fx361 servers: - description: Production url: https://production.plaid.com - description: Development url: https://development.plaid.com - description: Sandbox url: https://sandbox.plaid.com components: schemas: PlaidError: 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.' type: - object - 'null' additionalProperties: true title: Error properties: error_type: $ref: '#/components/schemas/PlaidErrorType' error_code: description: The particular error code. Safe for programmatic use. type: string error_message: description: A developer-friendly representation of the error code. This may change over time and is not safe for programmatic use. type: string display_message: description: 'A user-friendly representation of the error code. `null` if the error is not related to user action. This may change over time and is not safe for programmatic use.' type: - string - 'null' request_id: type: string description: A unique ID identifying the request, to be used for troubleshooting purposes. This field will be omitted in errors provided by webhooks. causes: type: array description: 'In the Assets product, a request can pertain to more than one Item. If an error is returned for such a request, `causes` will return an array of errors containing a breakdown of these errors on the individual Item level, if any can be identified. `causes` will only be provided for the `error_type` `ASSET_REPORT_ERROR`. `causes` will also not be populated inside an error nested within a `warning` object.' items: {} status: type: - integer - 'null' description: 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. documentation_url: type: string description: The URL of a Plaid documentation page with more information about the error suggested_action: type: - string - 'null' description: Suggested steps for resolving the error required: - error_type - error_code - error_message - display_message AccountsGetResponse: type: object additionalProperties: true description: AccountsGetResponse defines the response schema for `/accounts/get` and `/accounts/balance/get`. properties: accounts: type: array description: 'An array of financial institution accounts associated with the Item. If `/accounts/balance/get` was called, each account will include real-time balance information.' items: $ref: '#/components/schemas/AccountBase' item: $ref: '#/components/schemas/Item' payment_risk_assessment: $ref: '#/components/schemas/AccountsBalanceGetResponsePaymentRiskAssessment' request_id: $ref: '#/components/schemas/RequestID' required: - accounts - item - request_id ApplicationGetResponse: description: ApplicationGetResponse defines the response schema for `/application/get` additionalProperties: true type: object properties: request_id: $ref: '#/components/schemas/RequestID' application: $ref: '#/components/schemas/Application' required: - request_id - application ItemApplicationScopesUpdateResponse: description: ItemApplicationScopesUpdateResponse defines the response schema for `/item/application/scopes/update` additionalProperties: true type: object properties: request_id: $ref: '#/components/schemas/RequestID' required: - request_id ItemApplicationUnlinkResponse: description: ItemApplicationUnlinkResponse defines the response schema for `/item/application/unlink` additionalProperties: true type: object properties: request_id: $ref: '#/components/schemas/RequestID' required: - request_id ItemApplicationListResponse: description: Describes the connected application for a particular end user. additionalProperties: true type: object properties: request_id: $ref: '#/components/schemas/RequestID' applications: type: array description: A list of connected applications. items: $ref: '#/components/schemas/ConnectedApplication' required: - applications AssetReportFilterResponse: type: object additionalProperties: true description: AssetReportFilterResponse defines the response schema for `/asset_report/filter` properties: asset_report_token: $ref: '#/components/schemas/AssetReportToken' asset_report_id: $ref: '#/components/schemas/AssetReportId' request_id: $ref: '#/components/schemas/RequestID' required: - asset_report_token - asset_report_id - request_id AssetReportAuditCopyCreateResponse: type: object additionalProperties: true description: AssetReportAuditCopyCreateResponse defines the response schema for `/asset_report/audit_copy/get` properties: audit_copy_token: type: string description: A token that can be shared with a third party auditor to allow them to obtain access to the Asset Report. This token should be stored securely. request_id: $ref: '#/components/schemas/RequestID' required: - audit_copy_token - request_id AssetReportCreateResponse: type: object additionalProperties: true description: AssetReportCreateResponse defines the response schema for `/asset_report/create` properties: asset_report_token: $ref: '#/components/schemas/AssetReportToken' asset_report_id: $ref: '#/components/schemas/AssetReportId' request_id: $ref: '#/components/schemas/RequestID' required: - asset_report_token - asset_report_id - request_id AssetReportGetResponse: type: object additionalProperties: true description: AssetReportGetResponse defines the response schema for `/asset_report/get` properties: report: $ref: '#/components/schemas/AssetReport' warnings: type: array description: If the Asset Report generation was successful but identity information cannot be returned, this array will contain information about the errors causing identity information to be missing items: $ref: '#/components/schemas/Warning' request_id: $ref: '#/components/schemas/RequestID' required: - report - warnings - request_id AssetReportAuditCopyRemoveResponse: type: object additionalProperties: true description: AssetReportAuditCopyRemoveResponse defines the response schema for `/asset_report/audit_copy/remove` properties: removed: type: boolean description: '`true` if the Audit Copy was successfully removed.' request_id: $ref: '#/components/schemas/RequestID' required: - removed - request_id AssetReportRefreshResponse: type: object additionalProperties: true description: AssetReportRefreshResponse defines the response schema for `/asset_report/refresh` properties: asset_report_id: $ref: '#/components/schemas/AssetReportId' asset_report_token: $ref: '#/components/schemas/AssetReportToken' request_id: $ref: '#/components/schemas/RequestID' required: - asset_report_id - asset_report_token - request_id AssetReportFreddieGetResponse: title: AssetReportFreddieGetResponse type: object additionalProperties: true description: AssetReportFreddieGetResponse defines the response schema for `/asset_report/get` properties: DEAL: $ref: '#/components/schemas/AssetReportFreddie' request_id: $ref: '#/components/schemas/RequestID' SchemaVersion: type: number description: The Verification Of Assets (aka VOA or Freddie Mac Schema) schema version. required: - DEAL - request_id - SchemaVersion AssetReportRemoveResponse: type: object additionalProperties: true description: AssetReportRemoveResponse defines the response schema for `/asset_report/remove` properties: removed: type: boolean description: '`true` if the Asset Report was successfully removed.' request_id: $ref: '#/components/schemas/RequestID' required: - removed - request_id InvestmentsAuthGetResponse: type: object additionalProperties: true x-hidden-from-docs: true description: InvestmentsAuthGetResponse defines the response schema for `/investments/auth/get` properties: accounts: type: array description: The accounts for which data is being retrieved items: $ref: '#/components/schemas/AccountBase' holdings: type: array description: 'The holdings belonging to investment accounts associated with the Item. Details of the securities in the holdings are provided in the `securities` field. ' items: $ref: '#/components/schemas/Holding' securities: description: 'Objects describing the securities held in the accounts associated with the Item. ' type: array items: $ref: '#/components/schemas/Security' owners: description: 'Information about the account owners for the accounts associated with the Item. ' type: array items: $ref: '#/components/schemas/InvestmentsAuthOwner' numbers: $ref: '#/components/schemas/InvestmentsAuthGetNumbers' item: $ref: '#/components/schemas/Item' request_id: $ref: '#/components/schemas/RequestID' required: - accounts - holdings - securities - item - numbers - owners - request_id AuthGetResponse: type: object additionalProperties: true description: AuthGetResponse defines the response schema for `/auth/get` properties: accounts: type: array description: The `accounts` for which numbers are being retrieved. items: $ref: '#/components/schemas/AccountBase' numbers: $ref: '#/components/schemas/AuthGetNumbers' item: $ref: '#/components/schemas/Item' request_id: $ref: '#/components/schemas/RequestID' required: - accounts - numbers - item - request_id ProcessorAuthGetResponse: type: object additionalProperties: true description: ProcessorAuthGetResponse defines the response schema for `/processor/auth/get` properties: request_id: $ref: '#/components/schemas/RequestID' numbers: $ref: '#/components/schemas/ProcessorNumber' account: $ref: '#/components/schemas/AccountBase' required: - request_id - numbers - account BankTransferGetResponse: title: BankTransferGetResponse type: object additionalProperties: true description: Defines the response schema for `/bank_transfer/get` properties: bank_transfer: $ref: '#/components/schemas/BankTransfer' request_id: $ref: '#/components/schemas/RequestID' required: - bank_transfer - request_id ProcessorBankTransferCreateResponse: title: ProcessorBankTransferCreateResponse type: object additionalProperties: true description: Defines the response schema for `/processor/bank_transfer/create` properties: bank_transfer: $ref: '#/components/schemas/BankTransfer' request_id: $ref: '#/components/schemas/RequestID' required: - bank_transfer - request_id BankTransferMigrateAccountResponse: title: BankTransferMigrateAccountResponse type: object additionalProperties: true description: Defines the response schema for `/bank_transfer/migrate_account` properties: access_token: type: string description: The Plaid `access_token` for the newly created Item. account_id: type: string description: The Plaid `account_id` for the newly created Item. request_id: $ref: '#/components/schemas/RequestID' required: - access_token - account_id - request_id BankTransferListResponse: title: BankTransferListResponse type: object additionalProperties: true description: Defines the response schema for `/bank_transfer/list` properties: bank_transfers: type: array items: $ref: '#/components/schemas/BankTransfer' request_id: $ref: '#/components/schemas/RequestID' required: - bank_transfers - request_id BankTransferSweepListResponse: title: BankTransferSweepListResponse type: object additionalProperties: true description: BankTransferSweepListResponse defines the response schema for `/bank_transfer/sweep/list` properties: sweeps: type: array items: $ref: '#/components/schemas/BankTransferSweep' request_id: $ref: '#/components/schemas/RequestID' required: - sweeps - request_id BankTransferEventSyncResponse: title: BankTransferEventSyncResponse type: object additionalProperties: true description: Defines the response schema for `/bank_transfer/event/sync` properties: bank_transfer_events: type: array items: $ref: '#/components/schemas/BankTransferEvent' request_id: $ref: '#/components/schemas/RequestID' required: - bank_transfer_events - request_id BankTransferCancelResponse: title: BankTransferCancelResponse type: object additionalProperties: true description: Defines the response schema for `/bank_transfer/cancel` properties: request_id: $ref: '#/components/schemas/RequestID' required: - request_id BankTransferBalanceGetResponse: title: BankTransferBalanceGetResponse type: object additionalProperties: true description: Defines the response schema for `/bank_transfer/balance/get` properties: balance: $ref: '#/components/schemas/BankTransferBalance' origination_account_id: type: - string - 'null' description: The ID of the origination account that this balance belongs to. request_id: $ref: '#/components/schemas/RequestID' required: - balance - origination_account_id - request_id SandboxBankTransferSimulateResponse: title: SandboxBankTransferSimulateResponse type: object additionalProperties: true description: Defines the response schema for `/sandbox/bank_transfer/simulate` properties: request_id: $ref: '#/components/schemas/RequestID' required: - request_id SandboxBankTransferFireWebhookResponse: title: SandboxBankTransferFireWebhookResponse additionalProperties: true type: object description: Defines the response schema for `/sandbox/bank_transfer/fire_webhook` properties: request_id: $ref: '#/components/schemas/RequestID' required: - request_id BankTransferCreateResponse: title: BankTransferCreateResponse type: object additionalProperties: true description: Defines the response schema for `/bank_transfer/create` properties: bank_transfer: $ref: '#/components/schemas/BankTransfer' request_id: $ref: '#/components/schemas/RequestID' required: - bank_transfer - request_id BankTransferEventListResponse: title: BankTransferEventListResponse type: object additionalProperties: true description: Defines the response schema for `/bank_transfer/event/list` properties: bank_transfer_events: type: array items: $ref: '#/components/schemas/BankTransferEvent' request_id: $ref: '#/components/schemas/RequestID' required: - bank_transfer_events - request_id BankTransferSweepGetResponse: title: BankTransferSweepGetResponse type: object additionalProperties: true description: BankTransferSweepGetResponse defines the response schema for `/bank_transfer/sweep/get` properties: sweep: $ref: '#/components/schemas/BankTransferSweep' request_id: $ref: '#/components/schemas/RequestID' required: - sweep - request_id BeaconReportSyndicationGetResponse: description: 'A Beacon Report Syndication represents a Beacon Report created either by your organization or another Beacon customer that matches a specific Beacon User you''ve created. The `analysis` field in the response indicates which fields matched between the originally reported Beacon User and the Beacon User that the report was syndicated to. The `report` field in the response contains a subset of information from the original report.' additionalProperties: true properties: id: $ref: '#/components/schemas/BeaconReportSyndicationID' report: $ref: '#/components/schemas/BeaconReportSyndicationOriginalReport' analysis: $ref: '#/components/schemas/BeaconReportSyndicationAnalysis' request_id: $ref: '#/components/schemas/RequestID' required: - id - report - analysis - request_id type: object BeaconReportSyndicationListResponse: description: The response schema for `/beacon/report_syndication/list` additionalProperties: true properties: beacon_report_syndications: type: array items: $ref: '#/components/schemas/BeaconReportSyndication' next_cursor: $ref: '#/components/schemas/Cursor' request_id: $ref: '#/components/schemas/RequestID' required: - beacon_report_syndications - next_cursor - request_id type: object BeaconUserUpdateResponse: description: A Beacon User represents an end user that has been scanned against the Beacon Network. additionalProperties: true properties: id: $ref: '#/components/schemas/BeaconUserID' version: type: integer description: The `version` field begins with 1 and increments each time the user is updated. example: 1 created_at: $ref: '#/components/schemas/Timestamp' updated_at: $ref: '#/components/schemas/UpdatedAtTimestamp' status: $ref: '#/components/schemas/BeaconUserStatus' program_id: $ref: '#/components/schemas/BeaconProgramID' client_user_id: $ref: '#/components/schemas/ClientUserID' user: $ref: '#/components/schemas/BeaconUserData' audit_trail: $ref: '#/components/schemas/BeaconAuditTrail' request_id: $ref: '#/components/schemas/RequestID' required: - id - version - created_at - updated_at - status - program_id - client_user_id - user - audit_trail - request_id type: object BeaconAccountRiskEvaluateResponse: title: BeaconAccountRiskEvaluateResponse description: BeaconAccountRiskEvaluateResponse defines the response schema for `/beacon/account_risk/v1/evaluate` type: object x-hidden-from-docs: true additionalProperties: true properties: request_id: $ref: '#/components/schemas/RequestID' accounts: type: array description: The accounts for which a risk evaluation has been requested. items: $ref: '#/components/schemas/BeaconAccountRiskEvaluateAccount' required: - request_id - accounts BeaconReportCreateResponse: description: 'A Beacon Report describes the type of fraud committed by a user as well as the date the fraud was committed and the total amount of money lost due to the fraud incident. This information is used to block similar fraud attempts on your platform as well as alert other companies who screen a user with matching identity information. Other companies will not receive any new identity information, just what matched, plus information such as industry, type of fraud, and date of fraud. You can manage your fraud reports by adding, deleting, or editing reports as you get additional information on fraudulent users.' additionalProperties: true properties: id: $ref: '#/components/schemas/BeaconReportID' beacon_user_id: $ref: '#/components/schemas/BeaconUserID' created_at: $ref: '#/components/schemas/Timestamp' type: $ref: '#/components/schemas/BeaconReportType' fraud_date: $ref: '#/components/schemas/ISO8601Date' fraud_amount: $ref: '#/components/schemas/FraudAmount' audit_trail: $ref: '#/components/schemas/BeaconAuditTrail' request_id: $ref: '#/components/schemas/RequestID' required: - id - beacon_user_id - created_at - type - fraud_date - fraud_amount - audit_trail - request_id type: object BeaconReportGetResponse: description: 'A Beacon Report describes the type of fraud committed by a user as well as the date the fraud was committed and the total amount of money lost due to the fraud incident. This information is used to block similar fraud attempts on your platform as well as alert other companies who screen a user with matching identity information. Other companies will not receive any new identity information, just what matched, plus information such as industry, type of fraud, and date of fraud. You can manage your fraud reports by adding, deleting, or editing reports as you get additional information on fraudulent users.' additionalProperties: true properties: id: $ref: '#/components/schemas/BeaconReportID' beacon_user_id: $ref: '#/components/schemas/BeaconUserID' created_at: $ref: '#/components/schemas/Timestamp' type: $ref: '#/components/schemas/BeaconReportType' fraud_date: $ref: '#/components/schemas/ISO8601Date' fraud_amount: $ref: '#/components/schemas/FraudAmount' audit_trail: $ref: '#/components/schemas/BeaconAuditTrail' request_id: $ref: '#/components/schemas/RequestID' required: - id - beacon_user_id - created_at - type - fraud_date - fraud_amount - audit_trail - request_id type: object BeaconDuplicateGetResponse: description: A Beacon Duplicate represents a pair of matching Beacon Users and an analysis of the fields they matched on. additionalProperties: true properties: id: $ref: '#/components/schemas/BeaconDuplicateID' beacon_user1: $ref: '#/components/schemas/BeaconUserRevision' beacon_user2: $ref: '#/components/schemas/BeaconUserRevision' analysis: $ref: '#/components/schemas/BeaconMatchSummaryAnalysis' request_id: $ref: '#/components/schemas/RequestID' required: - id - beacon_user1 - beacon_user2 - analysis - request_id type: object BeaconUserCreateResponse: description: A Beacon User represents an end user that has been scanned against the Beacon Network. additionalProperties: true properties: id: $ref: '#/components/schemas/BeaconUserID' version: type: integer description: The `version` field begins with 1 and increments each time the user is updated. example: 1 created_at: $ref: '#/components/schemas/Timestamp' updated_at: $ref: '#/components/schemas/UpdatedAtTimestamp' status: $ref: '#/components/schemas/BeaconUserStatus' program_id: $ref: '#/components/schemas/BeaconProgramID' client_user_id: $ref: '#/components/schemas/ClientUserID' user: $ref: '#/components/schemas/BeaconUserData' audit_trail: $ref: '#/components/schemas/BeaconAuditTrail' request_id: $ref: '#/components/schemas/RequestID' required: - id - version - created_at - updated_at - status - program_id - client_user_id - user - audit_trail - request_id type: object BeaconUserGetResponse: description: A Beacon User represents an end user that has been scanned against the Beacon Network. additionalProperties: true properties: id: $ref: '#/components/schemas/BeaconUserID' version: type: integer description: The `version` field begins with 1 and increments each time the user is updated. example: 1 created_at: $ref: '#/components/schemas/Timestamp' updated_at: $ref: '#/components/schemas/UpdatedAtTimestamp' status: $ref: '#/components/schemas/BeaconUserStatus' program_id: $ref: '#/components/schemas/BeaconProgramID' client_user_id: $ref: '#/components/schemas/ClientUserID' user: $ref: '#/components/schemas/BeaconUserData' audit_trail: $ref: '#/components/schemas/BeaconAuditTrail' request_id: $ref: '#/components/schemas/RequestID' required: - id - version - created_at - updated_at - status - program_id - client_user_id - user - audit_trail - request_id type: object BeaconReportListResponse: description: The response schema for `/beacon/report/list` additionalProperties: true properties: beacon_reports: type: array items: $ref: '#/components/schemas/BeaconReport' next_cursor: $ref: '#/components/schemas/Cursor' request_id: $ref: '#/components/schemas/RequestID' required: - beacon_reports - next_cursor - request_id type: object BeaconUserHistoryListResponse: description: The response schema for `/beacon/user/history/list` additionalProperties: true properties: beacon_users: type: array items: $ref: '#/components/schemas/BeaconUser' next_cursor: $ref: '#/components/schemas/Cursor' request_id: $ref: '#/components/schemas/RequestID' required: - beacon_users - next_cursor - request_id type: object CreditBankEmploymentGetResponse: title: CreditBankEmploymentGetResponse additionalProperties: true type: object description: CreditBankEmploymentGetResponse defines the response schema for `/beta/credit/v1/bank_employment/get`. properties: bank_employment_reports: type: array description: Bank Employment data. Each entry in the array will be a distinct bank employment report. items: $ref: '#/components/schemas/CreditBankEmploymentReport' request_id: $ref: '#/components/schemas/RequestID' required: - request_id - bank_employment_reports TransactionsEnhanceGetResponse: type: object description: TransactionsEnhanceGetResponse defines the response schema for `/beta/transactions/v1/enhance`. x-examples: {} additionalProperties: true properties: enhanced_transactions: type: array description: An array of enhanced transactions. items: $ref: '#/components/schemas/ClientProvidedEnhancedTransaction' required: - enhanced_transactions TransactionsRulesCreateResponse: type: object additionalProperties: true description: TransactionsRulesCreateResponse defines the response schema for `/beta/transactions/rules/v1/create` properties: rule: $ref: '#/components/schemas/TransactionsCategoryRule' request_id: $ref: '#/components/schemas/RequestID' required: - rule - request_id TransactionsRulesRemoveResponse: type: object additionalProperties: true description: TransactionsRulesRemoveResponse defines the response schema for `/beta/transactions/rules/v1/remove` properties: request_id: $ref: '#/components/schemas/RequestID' required: - request_id TransactionsUserInsightsGetResponse: type: object description: TransactionsUserInsightsGetResponse defines the response schema for `/beta/transactions/user_insights/v1/get`. additionalProperties: true properties: user_data_overview: $ref: '#/components/schemas/UserDataOverview' counterparty_insights: $ref: '#/components/schemas/CounterpartyInsights' category_insights: $ref: '#/components/schemas/CategoryInsights' recurring_transactions: $ref: '#/components/schemas/RecurringTransactions' required: - user_data_overview TransactionsRulesListResponse: type: object additionalProperties: true description: TransactionsRulesListResponse defines the response schema for `/beta/transactions/rules/v1/list` properties: rules: type: array description: A list of the Item's transaction rules items: $ref: '#/components/schemas/TransactionsCategoryRule' request_id: $ref: '#/components/schemas/RequestID' required: - rules - request_id CategoriesGetResponse: type: object additionalProperties: true description: CategoriesGetResponse defines the response schema for `/categories/get` properties: categories: type: array description: An array of all of the transaction categories used by Plaid. items: $ref: '#/components/schemas/Category' request_id: $ref: '#/components/schemas/RequestID' required: - categories - request_id CraPartnerInsightsGetResponse: title: CraPartnerInsightsGetResponse additionalProperties: true type: object description: CraPartnerInsightsGetResponse defines the response schema for `/cra/partner_insights/get`. properties: report: type: array items: $ref: '#/components/schemas/CraPartnerInsights' request_id: $ref: '#/components/schemas/RequestID' required: - request_id CraLoanUnregisterResponse: title: CraLoanUnregisterResponse additionalProperties: true type: object description: CraLoanUnregisterResponse defines the response schema for `/cra/loans/unregister`. properties: request_id: $ref: '#/components/schemas/RequestID' required: - request_id CraLoansApplicationsRegisterResponse: title: CraLoansApplicationsRegisterResponse additionalProperties: true type: object description: CraLoansApplicationsRegisterResponse defines the response schema for `/cra/loans/applications/register`. properties: request_id: $ref: '#/components/schemas/RequestID' required: - request_id CraBankIncomeCreateResponse: title: CraBankIncomeCreateResponse additionalProperties: true type: object description: CraBankIncomeCreateRequest defines the response schema for `/cra/bank_income/create`. properties: request_id: $ref: '#/components/schemas/RequestID' BaseReportCreateResponse: type: object x-hidden-from-docs: true additionalProperties: true description: BaseReportCreateResponse defines the response schema for `cra/base_report/create` properties: request_id: $ref: '#/components/schemas/RequestID' required: - request_id BaseReportGetResponse: type: object x-hidden-from-docs: true additionalProperties: true description: BaseReportGetResponse defines the response schema for `/cra/base_report/get` properties: report: $ref: '#/components/schemas/BaseReport' warnings: type: array description: If the Base Report generation was successful but identity information cannot be returned, this array will contain information about the errors causing identity information to be missing items: $ref: '#/components/schemas/BaseReportWarning' request_id: $ref: '#/components/schemas/RequestID' required: - report - request_id CraLoansUpdateResponse: title: CraLoansUpdateResponse additionalProperties: true type: object description: CraLoansUpdateResponse defines the response schema for `/cra/loans/update`. properties: request_id: $ref: '#/components/schemas/RequestID' required: - request_id CraLoansRegisterResponse: title: CraLoansRegisterResponse additionalProperties: true type: object description: CraLoansRegisterResponse defines the response schema for `/cra/loans/register`. properties: request_id: $ref: '#/components/schemas/RequestID' required: - request_id CraBankIncomeGetResponse: title: CraBankIncomeGetResponse additionalProperties: true type: object description: CraBankIncomeGetResponse defines the response schema for `/cra/bank_income/get`. properties: bank_income: type: array items: $ref: '#/components/schemas/CraBankIncome' request_id: $ref: '#/components/schemas/RequestID' required: - request_id CreditSessionsGetResponse: type: object additionalProperties: true description: CreditSessionsGetResponse defines the response schema for `/credit/sessions/get` properties: sessions: type: array description: A list of Link sessions for the user. Sessions will be sorted in reverse chronological order. items: $ref: '#/components/schemas/CreditSession' request_id: $ref: '#/components/schemas/RequestID' required: - request_id CreditPayrollIncomeParsingConfigUpdateResponse: title: CreditPayrollIncomeParsingConfigUpdateResponse type: object additionalProperties: true description: CreditPayrollIncomeParsingConfigUpdateResponse defines the response schema for `/credit/payroll_income/documents/update`. properties: request_id: $ref: '#/components/schemas/RequestID' required: - request_id CreditRelayRefreshResponse: type: object additionalProperties: true description: CreditRelayRefreshResponse defines the response schema for `/credit/relay/refresh` properties: relay_token: type: string asset_report_id: $ref: '#/components/schemas/AssetReportId' request_id: $ref: '#/components/schemas/RequestID' required: - relay_token - request_id CreditBankIncomeRefreshResponse: title: CreditBankIncomeRefreshResponse type: object additionalProperties: true description: CreditBankIncomeRefreshResponse defines the response schema for `/credit/bank_income/refresh`. properties: request_id: $ref: '#/components/schemas/RequestID' required: - request_id CreditPayrollIncomeGetResponse: title: CreditPayrollIncomeGetResponse type: object additionalProperties: true description: Defines the response body for `/credit/payroll_income/get`. properties: items: description: Array of payroll items. type: array items: $ref: '#/components/schemas/PayrollItem' error: $ref: '#/components/schemas/PlaidError' request_id: $ref: '#/components/schemas/RequestID' required: - items - request_id CreditAuditCopyTokenRemoveResponse: type: object additionalProperties: true description: CreditAuditCopyTokenRemoveResponse defines the response schema for `/credit/audit_copy_token/remove` properties: removed: type: boolean description: '`true` if the Audit Copy was successfully removed.' request_id: $ref: '#/components/schemas/RequestID' required: - removed - request_id CreditAuditCopyTokenUpdateResponse: type: object additionalProperties: true description: CreditAuditCopyTokenUpdateResponse defines the response schema for `/credit/audit_copy_token/update` properties: request_id: $ref: '#/components/schemas/RequestID' updated: type: boolean description: '`true` if the Audit Copy Token was successfully updated.' required: - request_id - updated CreditBankIncomeGetResponse: title: CreditBankIncomeGetResponse additionalProperties: true type: object description: CreditBankIncomeGetResponse defines the response schema for `/credit/bank_income/get` properties: bank_income: type: array items: $ref: '#/components/schemas/CreditBankIncome' request_id: $ref: '#/components/schemas/RequestID' required: - request_id CreditRelayRemoveResponse: type: object additionalProperties: true description: CreditRelayRemoveResponse defines the response schema for `/credit/relay/remove` properties: removed: type: boolean description: '`true` if the relay token was successfully removed.' request_id: $ref: '#/components/schemas/RequestID' required: - removed - request_id CreditBankStatementsUploadsGetResponse: title: CreditBankStatementsUploadsGetResponse type: object additionalProperties: true description: CreditBankStatementsUploadsGetResponse defines the response schema for `/credit/bank_statements/uploads/get` properties: items: description: Array of bank statement upload items. type: array items: $ref: '#/components/schemas/CreditBankStatementUploadItem' request_id: $ref: '#/components/schemas/RequestID' required: - items - request_id CreditEmploymentGetResponse: title: CreditEmploymentGetResponse type: object additionalProperties: true description: CreditEmploymentGetResponse defines the response schema for `/credit/employment/get`. properties: items: description: Array of employment items. type: array items: $ref: '#/components/schemas/CreditEmploymentItem' request_id: $ref: '#/components/schemas/RequestID' required: - items - request_id CreditFreddieMacReportsGetResponse: title: CreditFreddieMacReportsGetResponse type: object additionalProperties: true description: CreditFreddieMacReportsGetResponse defines the response schema for `/credit/freddie_mac/reports/get` properties: DEAL: $ref: '#/components/schemas/CreditFreddieMacVerificationOfAssetsDeal' request_id: $ref: '#/components/schemas/RequestID' SchemaVersion: type: number description: The Verification Of Assets (VOA) schema version. required: - request_id - DEAL - SchemaVersion CreditPayrollIncomeRiskSignalsGetResponse: title: CreditPayrollIncomeRiskSignalsGetReponse type: object additionalProperties: true description: CreditPayrollIncomeRiskSignalsGetRequest defines the response schema for `/credit/payroll_income/risk_signals/get` properties: items: description: Array of payroll items. type: array items: $ref: '#/components/schemas/PayrollRiskSignalsItem' error: $ref: '#/components/schemas/PlaidError' request_id: $ref: '#/components/schemas/RequestID' required: - items - request_id CreditAuditCopyTokenCreateResponse: type: object additionalProperties: true description: CreditAuditCopyTokenCreateResponse defines the response schema for `/credit/audit_copy_token/get` properties: audit_copy_token: type: string description: A token that can be shared with a third party auditor, which allows them to fetch the Asset Reports attached to the token. This token should be stored securely. request_id: $ref: '#/components/schemas/RequestID' required: - audit_copy_token - request_id CreditPayrollIncomePrecheckResponse: title: CreditPayrollIncomePrecheckResponse additionalProperties: true type: object description: Defines the response schema for `/credit/payroll_income/precheck`. properties: request_id: $ref: '#/components/schemas/RequestID' confidence: $ref: '#/components/schemas/IncomeVerificationPrecheckConfidence' required: - confidence - request_id CreditBankIncomeWebhookUpdateResponse: title: CreditBankIncomeWebhookUpdateResponse type: object additionalProperties: true description: CreditBankIncomeWebhookUpdateResponse defines the response schema for `/credit/bank_income/webhook/update`. properties: request_id: $ref: '#/components/schemas/RequestID' required: - request_id CreditRelayCreateResponse: type: object additionalProperties: true description: CreditRelayCreateResponse defines the response schema for `/credit/relay/create` properties: relay_token: type: string description: A token that can be shared with a third party to allow them to access the Asset Report. This token should be stored securely. request_id: $ref: '#/components/schemas/RequestID' required: - relay_token - request_id CreditPayrollIncomeRefreshResponse: title: CreditPayrollIncomeRefreshResponse type: object additionalProperties: true description: CreditPayrollIncomeRefreshResponse defines the response schema for `/credit/payroll_income/refresh` properties: request_id: $ref: '#/components/schemas/RequestID' verification_refresh_status: $ref: '#/components/schemas/CreditPayrollIncomeRefreshStatus' required: - request_id - verification_refresh_status DashboardUserListResponse: description: Paginated list of dashboard users additionalProperties: true properties: dashboard_users: description: List of dashboard users type: array items: $ref: '#/components/schemas/DashboardUser' next_cursor: $ref: '#/components/schemas/Cursor' request_id: $ref: '#/components/schemas/RequestID' required: - dashboard_users - next_cursor - request_id type: object DashboardUserGetResponse: description: Account information associated with a team member with access to the Plaid dashboard. additionalProperties: true properties: id: $ref: '#/components/schemas/DashboardUserID' created_at: $ref: '#/components/schemas/Timestamp' email_address: $ref: '#/components/schemas/EmailAddress' status: $ref: '#/components/schemas/DashboardUserStatus' request_id: $ref: '#/components/schemas/RequestID' required: - id - created_at - email_address - status - request_id type: object DepositSwitchGetResponse: title: DepositSwitchGetResponse type: object additionalProperties: true description: DepositSwitchGetResponse defines the response schema for `/deposit_switch/get` properties: deposit_switch_id: type: string description: The ID of the deposit switch. target_account_id: type: - string - 'null' description: The ID of the bank account the direct deposit was switched to. target_item_id: type: - string - 'null' description: The ID of the Item the direct deposit was switched to. state: type: string enum: - initialized - processing - completed - error description: ' The state, or status, of the deposit switch. - `initialized` – The deposit switch has been initialized with the user entering the information required to submit the deposit switch request. - `processing` – The deposit switch request has been submitted and is being processed. - `completed` – The user''s employer has fulfilled the deposit switch request. - `error` – There was an error processing the deposit switch request.' switch_method: type: - string - 'null' enum: - instant - mail - pdf - null description: 'The method used to make the deposit switch. - `instant` – User instantly switched their direct deposit to a new or existing bank account by connecting their payroll or employer account. - `mail` – User requested that Plaid contact their employer by mail to make the direct deposit switch. - `pdf` – User generated a PDF or email to be sent to their employer with the information necessary to make the deposit switch.''' account_has_multiple_allocations: type: - boolean - 'null' description: When `true`, user’s direct deposit goes to multiple banks. When false, user’s direct deposit only goes to the target account. Always `null` if the deposit switch has not been completed. is_allocated_remainder: type: - boolean - 'null' description: When `true`, the target account is allocated the remainder of direct deposit after all other allocations have been deducted. When `false`, user’s direct deposit is allocated as a percent or amount. Always `null` if the deposit switch has not been completed. percent_allocated: type: - number - 'null' format: double description: The percentage of direct deposit allocated to the target account. Always `null` if the target account is not allocated a percentage or if the deposit switch has not been completed or if `is_allocated_remainder` is true. amount_allocated: type: - number - 'null' format: double description: The dollar amount of direct deposit allocated to the target account. Always `null` if the target account is not allocated an amount or if the deposit switch has not been completed. employer_name: type: - string - 'null' description: The name of the employer selected by the user. If the user did not select an employer, the value returned is `null`. employer_id: type: - string - 'null' description: The ID of the employer selected by the user. If the user did not select an employer, the value returned is `null`. institution_name: type: - string - 'null' description: The name of the institution selected by the user. If the user did not select an institution, the value returned is `null`. institution_id: type: - string - 'null' description: The ID of the institution selected by the user. If the user did not select an institution, the value returned is `null`. date_created: description: '[ISO 8601](https://wikipedia.org/wiki/ISO_8601) date the deposit switch was created. ' type: string format: date date_completed: type: - string - 'null' format: date description: '[ISO 8601](https://wikipedia.org/wiki/ISO_8601) date the deposit switch was completed. Always `null` if the deposit switch has not been completed. ' request_id: $ref: '#/components/schemas/RequestID' required: - deposit_switch_id - target_account_id - target_item_id - state - account_has_multiple_allocations - is_allocated_remainder - percent_allocated - amount_allocated - date_created - date_completed - request_id DepositSwitchTokenCreateResponse: type: object additionalProperties: true description: DepositSwitchTokenCreateResponse defines the response schema for `/deposit_switch/token/create` properties: deposit_switch_token: type: string description: Deposit switch token, used to initialize Link for the Deposit Switch product deposit_switch_token_expiration_time: type: string description: Expiration time of the token, in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format request_id: $ref: '#/components/schemas/RequestID' required: - deposit_switch_token - deposit_switch_token_expiration_time - request_id DepositSwitchCreateResponse: type: object additionalProperties: true description: DepositSwitchCreateResponse defines the response schema for `/deposit_switch/create` properties: deposit_switch_id: type: string description: ID of the deposit switch. This ID is persisted throughout the lifetime of the deposit switch. request_id: $ref: '#/components/schemas/RequestID' required: - deposit_switch_id - request_id DepositSwitchAltCreateResponse: title: DepositSwitchAltCreateResponse type: object additionalProperties: true properties: deposit_switch_id: type: string description: ID of the deposit switch. This ID is persisted throughout the lifetime of the deposit switch. request_id: $ref: '#/components/schemas/RequestID' required: - deposit_switch_id - request_id description: DepositSwitchAltCreateResponse defines the response schema for `/deposit_switch/alt/create` EmployersSearchResponse: title: EmployersSearchResponse type: object additionalProperties: true description: EmployersSearchResponse defines the response schema for `/employers/search`. properties: employers: type: array description: A list of employers matching the search criteria. items: $ref: '#/components/schemas/Employer' request_id: $ref: '#/components/schemas/RequestID' required: - employers - request_id ProcessorIdentityMatchResponse: type: object additionalProperties: true description: ProcessorIdentityMatchResponse defines the response schema for `/processor/identity/match` properties: account: $ref: '#/components/schemas/AccountIdentityMatchScore' request_id: $ref: '#/components/schemas/RequestID' required: - account - request_id ProcessorIdentityGetResponse: type: object additionalProperties: true description: ProcessorIdentityGetResponse defines the response schema for `/processor/identity/get` properties: account: $ref: '#/components/schemas/AccountIdentity' request_id: $ref: '#/components/schemas/RequestID' required: - account - request_id IdentityRefreshResponse: type: object additionalProperties: true description: IdentityRefreshResponse defines the response schema for `/identity/refresh` properties: request_id: $ref: '#/components/schemas/RequestID' required: - request_id IdentityGetResponse: type: object additionalProperties: true description: IdentityGetResponse defines the response schema for `/identity/get` properties: accounts: type: array description: The accounts for which Identity data has been requested items: $ref: '#/components/schemas/AccountIdentity' item: $ref: '#/components/schemas/Item' request_id: $ref: '#/components/schemas/RequestID' required: - accounts - item - request_id IdentityMatchResponse: type: object additionalProperties: true description: IdentityMatchResponse defines the response schema for `/identity/match` properties: accounts: type: array description: The accounts for which Identity match has been requested items: $ref: '#/components/schemas/AccountIdentityMatchScore' item: $ref: '#/components/schemas/Item' request_id: $ref: '#/components/schemas/RequestID' required: - accounts - item - request_id IdentityDocumentsUploadsGetResponse: type: object additionalProperties: true description: IdentityDocumentsUploadsGetResponse defines the response schema for `/identity/documents/uploads/get` properties: accounts: type: array description: The accounts for which Identity data has been requested items: $ref: '#/components/schemas/AccountIdentityDocumentUpload' item: $ref: '#/components/schemas/Item' request_id: $ref: '#/components/schemas/RequestID' required: - accounts - item - request_id IdentityVerificationAutofillCreateResponse: description: Autofill represents unverified customer information. This needs to be confirmed by the customer before using. additionalProperties: true properties: status: $ref: '#/components/schemas/IdentityVerificationAutofillStatus' user: $ref: '#/components/schemas/IdentityVerificationAutofillUserData' request_id: $ref: '#/components/schemas/RequestID' required: - status - user - request_id type: object IdentityVerificationCreateResponse: description: A identity verification attempt represents a customer's attempt to verify their identity, reflecting the required steps for completing the session, the results for each step, and information collected in the process. additionalProperties: true properties: id: $ref: '#/components/schemas/IdentityVerificationID' client_user_id: $ref: '#/components/schemas/ClientUserID' created_at: $ref: '#/components/schemas/Timestamp' completed_at: $ref: '#/components/schemas/TimestampNullable' previous_attempt_id: $ref: '#/components/schemas/PreviousIdentityVerificationAttemptID' shareable_url: $ref: '#/components/schemas/ShareableURL' template: $ref: '#/components/schemas/IdentityVerificationTemplateReference' user: $ref: '#/components/schemas/IdentityVerificationUserData' status: $ref: '#/components/schemas/IdentityVerificationStatus' steps: $ref: '#/components/schemas/IdentityVerificationStepSummary' documentary_verification: $ref: '#/components/schemas/DocumentaryVerification' selfie_check: $ref: '#/components/schemas/SelfieCheck' kyc_check: $ref: '#/components/schemas/KYCCheckDetails' risk_check: $ref: '#/components/schemas/RiskCheckDetails' watchlist_screening_id: $ref: '#/components/schemas/WatchlistScreeningIndividualIDNullable' redacted_at: $ref: '#/components/schemas/TimestampNullable' request_id: $ref: '#/components/schemas/RequestID' required: - id - client_user_id - created_at - completed_at - previous_attempt_id - shareable_url - template - user - status - steps - documentary_verification - selfie_check - kyc_check - risk_check - watchlist_screening_id - redacted_at - request_id type: object IdentityVerificationListResponse: description: Paginated list of Plaid sessions. additionalProperties: true properties: identity_verifications: description: List of Plaid sessions type: array items: $ref: '#/components/schemas/IdentityVerification' next_cursor: $ref: '#/components/schemas/Cursor' request_id: $ref: '#/components/schemas/RequestID' required: - identity_verifications - next_cursor - request_id type: object IdentityVerificationRetryResponse: description: A identity verification attempt represents a customer's attempt to verify their identity, reflecting the required steps for completing the session, the results for each step, and information collected in the process. additionalProperties: true properties: id: $ref: '#/components/schemas/IdentityVerificationID' client_user_id: $ref: '#/components/schemas/ClientUserID' created_at: $ref: '#/components/schemas/Timestamp' completed_at: $ref: '#/components/schemas/TimestampNullable' previous_attempt_id: $ref: '#/components/schemas/PreviousIdentityVerificationAttemptID' shareable_url: $ref: '#/components/schemas/ShareableURL' template: $ref: '#/components/schemas/IdentityVerificationTemplateReference' user: $ref: '#/components/schemas/IdentityVerificationUserData' status: $ref: '#/components/schemas/IdentityVerificationStatus' steps: $ref: '#/components/schemas/IdentityVerificationStepSummary' documentary_verification: $ref: '#/components/schemas/DocumentaryVerification' selfie_check: $ref: '#/components/schemas/SelfieCheck' kyc_check: $ref: '#/components/schemas/KYCCheckDetails' risk_check: $ref: '#/components/schemas/RiskCheckDetails' watchlist_screening_id: $ref: '#/components/schemas/WatchlistScreeningIndividualIDNullable' redacted_at: $ref: '#/components/schemas/TimestampNullable' request_id: $ref: '#/components/schemas/RequestID' required: - id - client_user_id - created_at - completed_at - previous_attempt_id - shareable_url - template - user - status - steps - documentary_verification - selfie_check - kyc_check - risk_check - watchlist_screening_id - redacted_at - request_id type: object IdentityVerificationGetResponse: description: A identity verification attempt represents a customer's attempt to verify their identity, reflecting the required steps for completing the session, the results for each step, and information collected in the process. additionalProperties: true properties: id: $ref: '#/components/schemas/IdentityVerificationID' client_user_id: $ref: '#/components/schemas/ClientUserID' created_at: $ref: '#/components/schemas/Timestamp' completed_at: $ref: '#/components/schemas/TimestampNullable' previous_attempt_id: $ref: '#/components/schemas/PreviousIdentityVerificationAttemptID' shareable_url: $ref: '#/components/schemas/ShareableURL' template: $ref: '#/components/schemas/IdentityVerificationTemplateReference' user: $ref: '#/components/schemas/IdentityVerificationUserData' status: $ref: '#/components/schemas/IdentityVerificationStatus' steps: $ref: '#/components/schemas/IdentityVerificationStepSummary' documentary_verification: $ref: '#/components/schemas/DocumentaryVerification' selfie_check: $ref: '#/components/schemas/SelfieCheck' kyc_check: $ref: '#/components/schemas/KYCCheckDetails' risk_check: $ref: '#/components/schemas/RiskCheckDetails' watchlist_screening_id: $ref: '#/components/schemas/WatchlistScreeningIndividualIDNullable' redacted_at: $ref: '#/components/schemas/TimestampNullable' request_id: $ref: '#/components/schemas/RequestID' required: - id - client_user_id - created_at - completed_at - previous_attempt_id - shareable_url - template - user - status - steps - documentary_verification - selfie_check - kyc_check - risk_check - watchlist_screening_id - redacted_at - request_id type: object SandboxIncomeFireWebhookResponse: title: SandboxIncomeFireWebhookResponse additionalProperties: true type: object description: SandboxIncomeFireWebhookResponse defines the response schema for `/sandbox/income/fire_webhook` properties: request_id: $ref: '#/components/schemas/RequestID' required: - request_id IncomeVerificationPaystubsGetResponse: title: IncomeVerificationPaystubsGetResponse type: object additionalProperties: true description: IncomeVerificationPaystubsGetResponse defines the response schema for `/income/verification/paystubs/get`. properties: document_metadata: description: Metadata for an income document. type: array items: $ref: '#/components/schemas/DocumentMetadata' paystubs: type: array items: $ref: '#/components/schemas/Paystub' error: $ref: '#/components/schemas/PlaidError' request_id: $ref: '#/components/schemas/RequestID' required: - paystubs - request_id IncomeVerificationTaxformsGetResponse: title: IncomeVerificationTaxformsGetResponse type: object additionalProperties: true description: IncomeVerificationTaxformsGetResponse defines the response schema for `/income/verification/taxforms/get` properties: request_id: $ref: '#/components/schemas/RequestID' document_metadata: type: array items: $ref: '#/components/schemas/DocumentMetadata' taxforms: type: array description: A list of forms. items: $ref: '#/components/schemas/Taxform' error: $ref: '#/components/schemas/PlaidError' required: - taxforms - document_metadata IncomeVerificationPrecheckResponse: title: IncomeVerificationPrecheckResponse additionalProperties: true type: object description: IncomeVerificationPrecheckResponse defines the response schema for `/income/verification/precheck`. properties: precheck_id: type: string description: ID of the precheck. Provide this value when calling `/link/token/create` in order to optimize Link conversion. request_id: $ref: '#/components/schemas/RequestID' confidence: $ref: '#/components/schemas/IncomeVerificationPrecheckConfidence' required: - precheck_id - confidence - request_id IncomeVerificationCreateResponse: title: IncomeVerificationCreateResponse type: object additionalProperties: true description: IncomeVerificationCreateResponse defines the response schema for `/income/verification/create`. properties: income_verification_id: type: string description: ID of the verification. This ID is persisted throughout the lifetime of the verification. request_id: $ref: '#/components/schemas/RequestID' required: - income_verification_id - request_id InstitutionsGetByIdResponse: type: object additionalProperties: true description: InstitutionsGetByIdResponse defines the response schema for `/institutions/get_by_id` properties: institution: $ref: '#/components/schemas/Institution' request_id: $ref: '#/components/schemas/RequestID' required: - institution - request_id InstitutionsSearchResponse: type: object additionalProperties: true description: InstitutionsSearchResponse defines the response schema for `/institutions/search` properties: institutions: type: array description: An array of institutions matching the search criteria items: $ref: '#/components/schemas/Institution' request_id: $ref: '#/components/schemas/RequestID' required: - institutions - request_id InstitutionsGetResponse: type: object additionalProperties: true description: InstitutionsGetResponse defines the response schema for `/institutions/get` properties: institutions: type: array description: A list of Plaid institutions items: $ref: '#/components/schemas/Institution' total: type: integer description: The total number of institutions available via this endpoint request_id: $ref: '#/components/schemas/RequestID' required: - institutions - total - request_id InvestmentsHoldingsGetResponse: type: object additionalProperties: true description: InvestmentsHoldingsGetResponse defines the response schema for `/investments/holdings/get` properties: accounts: type: array description: The accounts associated with the Item items: $ref: '#/components/schemas/AccountBase' holdings: type: array description: 'The holdings belonging to investment accounts associated with the Item. Details of the securities in the holdings are provided in the `securities` field. ' items: $ref: '#/components/schemas/Holding' securities: description: 'Objects describing the securities held in the accounts associated with the Item. ' type: array items: $ref: '#/components/schemas/Security' item: $ref: '#/components/schemas/Item' request_id: $ref: '#/components/schemas/RequestID' is_investments_fallback_item: type: boolean description: When true, this field indicates that the Item's portfolio was manually created with the Investments Fallback flow. required: - accounts - holdings - securities - item - request_id InvestmentsRefreshResponse: x-hidden-from-docs: true type: object additionalProperties: true description: InvestmentsRefreshResponse defines the response schema for `/investments/refresh` properties: request_id: $ref: '#/components/schemas/RequestID' required: - request_id InvestmentsTransactionsGetResponse: type: object additionalProperties: true description: InvestmentsTransactionsGetResponse defines the response schema for `/investments/transactions/get` properties: item: $ref: '#/components/schemas/Item' accounts: type: array description: The accounts for which transaction history is being fetched. items: $ref: '#/components/schemas/AccountBase' securities: type: array description: All securities for which there is a corresponding transaction being fetched. items: $ref: '#/components/schemas/Security' investment_transactions: type: array description: The transactions being fetched items: $ref: '#/components/schemas/InvestmentTransaction' total_investment_transactions: type: integer description: The total number of transactions available within the date range specified. If `total_investment_transactions` is larger than the size of the `transactions` array, more transactions are available and can be fetched via manipulating the `offset` parameter. request_id: $ref: '#/components/schemas/RequestID' is_investments_fallback_item: type: boolean description: When true, this field indicates that the Item's portfolio was manually created with the Investments Fallback flow. required: - item - accounts - securities - investment_transactions - total_investment_transactions - request_id ItemPublicTokenExchangeResponse: type: object additionalProperties: true description: ItemPublicTokenExchangeResponse defines the response schema for `/item/public_token/exchange` properties: access_token: $ref: '#/components/schemas/AccessToken' item_id: type: string description: The `item_id` value of the Item associated with the returned `access_token` request_id: $ref: '#/components/schemas/RequestID' required: - access_token - item_id - request_id ItemRemoveResponse: type: object additionalProperties: true description: ItemRemoveResponse defines the response schema for `/item/remove` properties: request_id: $ref: '#/components/schemas/RequestID' required: - request_id SandboxItemResetLoginResponse: type: object additionalProperties: true description: SandboxItemResetLoginResponse defines the response schema for `/sandbox/item/reset_login` properties: reset_login: type: boolean description: '`true` if the call succeeded' request_id: $ref: '#/components/schemas/RequestID' required: - reset_login - request_id ItemActivityListResponse: description: Describes a historical log of user consent events. additionalProperties: true type: object properties: request_id: $ref: '#/components/schemas/RequestID' activities: type: array description: A list of activities. items: $ref: '#/components/schemas/Activity' last_data_access_times: type: array description: An array of objects containing timestamps for the last time each data type was accessed per application. items: $ref: '#/components/schemas/LastDataAccessTimes' cursor: type: string description: Cursor used for pagination. required: - activities - last_data_access_times - request_id ItemImportResponse: type: object additionalProperties: true description: ItemImportResponse defines the response schema for `/item/import` properties: access_token: $ref: '#/components/schemas/AccessToken' request_id: $ref: '#/components/schemas/RequestID' required: - access_token - request_id ItemPublicTokenCreateResponse: type: object additionalProperties: true description: ItemPublicTokenCreateResponse defines the response schema for `/item/public_token/create` properties: public_token: type: string description: A `public_token` for the particular Item corresponding to the specified `access_token` expiration: type: string format: date-time request_id: $ref: '#/components/schemas/RequestID' required: - public_token - request_id ItemAccessTokenInvalidateResponse: type: object additionalProperties: true description: ItemAccessTokenInvalidateResponse defines the response schema for `/item/access_token/invalidate` properties: new_access_token: $ref: '#/components/schemas/AccessToken' request_id: $ref: '#/components/schemas/RequestID' required: - new_access_token - request_id SandboxItemFireWebhookResponse: type: object additionalProperties: true description: SandboxItemFireWebhookResponse defines the response schema for `/sandbox/item/fire_webhook` properties: webhook_fired: type: boolean description: Value is `true` if the test` webhook_code` was successfully fired. request_id: $ref: '#/components/schemas/RequestID' required: - webhook_fired - request_id SandboxItemSetVerificationStatusResponse: type: object additionalProperties: true description: SandboxItemSetVerificationStatusResponse defines the response schema for `/sandbox/item/set_verification_status` properties: request_id: $ref: '#/components/schemas/RequestID' required: - request_id ItemGetResponse: type: object additionalProperties: true description: ItemGetResponse defines the response schema for `/item/get` and `/item/webhook/update` properties: item: $ref: '#/components/schemas/Item' status: $ref: '#/components/schemas/ItemStatusNullable' request_id: $ref: '#/components/schemas/RequestID' required: - item - request_id ItemWebhookUpdateResponse: type: object additionalProperties: true description: ItemWebhookUpdateResponse defines the response schema for `/item/webhook/update` properties: item: $ref: '#/components/schemas/Item' request_id: $ref: '#/components/schemas/RequestID' required: - item - request_id LiabilitiesGetResponse: type: object additionalProperties: true description: LiabilitiesGetResponse defines the response schema for `/liabilities/get` properties: accounts: type: array description: An array of accounts associated with the Item items: $ref: '#/components/schemas/AccountBase' item: $ref: '#/components/schemas/Item' liabilities: $ref: '#/components/schemas/LiabilitiesObject' request_id: $ref: '#/components/schemas/RequestID' required: - accounts - item - liabilities - request_id ProcessorLiabilitiesGetResponse: type: object additionalProperties: true description: ProcessorLiabilitiesGetResponse defines the response schema for `/processor/liabilities/get` properties: account: $ref: '#/components/schemas/AccountBase' liabilities: $ref: '#/components/schemas/LiabilitiesObject' request_id: $ref: '#/components/schemas/RequestID' required: - account - liabilities - request_id LinkTokenGetResponse: type: object additionalProperties: true description: LinkTokenGetResponse defines the response schema for `/link/token/get` properties: link_token: type: string description: A `link_token`, which can be supplied to Link in order to initialize it and receive a `public_token`, which can be exchanged for an `access_token`. created_at: type: - string - 'null' format: date-time description: The creation timestamp for the `link_token`, in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format. expiration: type: - string - 'null' format: date-time description: The expiration timestamp for the `link_token`, in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format. link_sessions: type: array description: Information about Link sessions created using this `link_token`. This field will only be present if your client is enabled for Backend Handoff. Session data will be provided for up to six hours after the session has ended. items: $ref: '#/components/schemas/LinkTokenGetSessionsResponse' metadata: $ref: '#/components/schemas/LinkTokenGetMetadataResponse' request_id: $ref: '#/components/schemas/RequestID' required: - link_token - created_at - expiration - metadata - request_id LinkProfileEligibilityCheckResponse: type: object x-hidden-from-docs: true additionalProperties: true description: LinkProfileEligibilityCheckResponse defines the response schema for `/link/profile/eligibility/check` properties: profile_matches: type: boolean description: Indicates whether Plaid has a profile matching the customer's eligibility requirements for this user request_id: $ref: '#/components/schemas/RequestID' required: - profile_matches - request_id LinkTokenCreateResponse: type: object additionalProperties: true description: LinkTokenCreateResponse defines the response schema for `/link/token/create` properties: link_token: type: string description: A `link_token`, which can be supplied to Link in order to initialize it and receive a `public_token`, which can be exchanged for an `access_token`. expiration: type: string format: date-time description: The expiration date for the `link_token`, in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format. A `link_token` created to generate a `public_token` that will be exchanged for a new `access_token` expires after 4 hours. A `link_token` created for an existing Item (such as when updating an existing `access_token` by launching Link in update mode) expires after 30 minutes. request_id: $ref: '#/components/schemas/RequestID' hosted_link_url: type: string description: A URL of a Plaid-hosted Link flow that will use the Link token returned by this request. Only present if the client is enabled for Hosted Link. required: - link_token - expiration - request_id LinkOAuthCorrelationIdExchangeResponse: type: object additionalProperties: true description: LinkOAuthCorrelationIdExchangeResponse defines the response schema for `/link/oauth/correlation_id/exchange` properties: link_token: type: string description: The `link_token` associated to the given `link_correlation_id`, which can be used to re-initialize Link. request_id: $ref: '#/components/schemas/RequestID' required: - link_token - request_id LinkDeliveryCreateResponse: type: object additionalProperties: true description: LinkDeliveryCreateResponse defines the response schema for `/link_delivery/create` properties: link_delivery_url: type: string description: The URL to the Hosted Link session, which will be delivered by the specified delivery method. link_delivery_session_id: type: string description: The ID for the Hosted Link session. Same as the `link_token` string excluding the "link-{env}-" prefix. request_id: $ref: '#/components/schemas/RequestID' required: - link_delivery_url - link_delivery_session_id - request_id LinkDeliveryGetResponse: type: object additionalProperties: true description: LinkDeliveryGetRequest defines the response schema for `/link_delivery/get` properties: status: $ref: '#/components/schemas/LinkDeliverySessionStatus' created_at: type: string format: date-time description: Timestamp in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format (`YYYY-MM-DDTHH:mm:ssZ`) indicating the time the given Hosted Link session was created at. completed_at: type: - string - 'null' format: date-time description: Timestamp in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format (`YYYY-MM-DDTHH:mm:ssZ`) indicating the time the given Hosted Link session was completed at. request_id: $ref: '#/components/schemas/RequestID' access_tokens: type: - array - 'null' items: $ref: '#/components/schemas/AccessToken' description: An array of access tokens associated with the Hosted Link session. item_ids: type: - array - 'null' items: $ref: '#/components/schemas/ItemId' description: An array of `item_id`s associated with the Hosted Link session. required: - status - created_at - request_id Services: title: Services type: object additionalProperties: true description: A collection of objects that describe requests and responses for services. properties: SERVICE: $ref: '#/components/schemas/Service' required: - SERVICE CategoriesGetRequest: type: object description: CategoriesGetRequest defines the request schema for `/categories/get` LinkTokenCreateRequestTransfer: type: object description: Specifies options for initializing Link for use with the Transfer product. properties: intent_id: type: string description: The `id` returned by the `/transfer/intent/create` endpoint. payment_profile_token: x-hidden-from-docs: true type: string description: The `payment_profile_token` returned by the `/payment_profile/create` endpoint. SandboxPublicTokenCreateRequestOptionsTransactions: type: object description: An optional set of parameters corresponding to transactions options. properties: start_date: type: string format: date description: The earliest date for which to fetch transaction history. Dates should be formatted as YYYY-MM-DD. end_date: type: string format: date description: The most recent date for which to fetch transaction history. Dates should be formatted as YYYY-MM-DD. days_requested: description: The maximum number of days of transaction history to request for the Transactions product. type: integer minimum: 1 maximum: 730 default: 90 x-hidden-from-docs: true title: SandboxPublicTokenCreateRequestOptionsTransactions IndividualWatchlistProgram: type: object description: A program that configures the active lists, search parameters, and other behavior for initial and ongoing screening of individuals. title: IndividualWatchlistProgram properties: id: $ref: '#/components/schemas/WatchlistProgramID' created_at: $ref: '#/components/schemas/Timestamp' is_rescanning_enabled: description: Indicator specifying whether the program is enabled and will perform daily rescans. type: boolean example: true lists_enabled: description: Watchlists enabled for the associated program type: array example: - US_SDN uniqueItems: true items: $ref: '#/components/schemas/IndividualWatchlistCode' name: $ref: '#/components/schemas/IndividualWatchlistScreeningProgramName' name_sensitivity: $ref: '#/components/schemas/ProgramNameSensitivity' audit_trail: $ref: '#/components/schemas/WatchlistScreeningAuditTrail' is_archived: $ref: '#/components/schemas/ProgramArchived' required: - id - created_at - is_rescanning_enabled - lists_enabled - name - name_sensitivity - audit_trail - is_archived additionalProperties: true CreditFreddieMacVerificationOfAssetResponse: title: VerificationOfAssetResponse type: object additionalProperties: true description: Documentation not found in the MISMO model viewer and not provided by Freddie Mac. properties: ASSETS: $ref: '#/components/schemas/CreditFreddieMacAssets' required: - ASSETS SandboxIncomeFireWebhookRequest: title: SandboxIncomeFireWebhookRequest type: object description: SandboxIncomeFireWebhookRequest defines the request schema for `/sandbox/income/fire_webhook` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' item_id: type: string description: The Item ID associated with the verification. user_id: $ref: '#/components/schemas/UserId' webhook: type: string description: The URL to which the webhook should be sent. verification_status: type: string enum: - VERIFICATION_STATUS_PROCESSING_COMPLETE - VERIFICATION_STATUS_PROCESSING_FAILED - VERIFICATION_STATUS_PENDING_APPROVAL description: '`VERIFICATION_STATUS_PROCESSING_COMPLETE`: The income verification status processing has completed. If the user uploaded multiple documents, this webhook will fire when all documents have finished processing. Call the `/income/verification/paystubs/get` endpoint and check the document metadata to see which documents were successfully parsed. `VERIFICATION_STATUS_PROCESSING_FAILED`: A failure occurred when attempting to process the verification documentation. `VERIFICATION_STATUS_PENDING_APPROVAL`: (deprecated) The income verification has been sent to the user for review.' webhook_code: $ref: '#/components/schemas/SandboxIncomeWebhookFireRequestWebhookCode' required: - item_id - webhook - webhook_code PaymentInitiationPaymentListRequest: type: object description: PaymentInitiationPaymentListRequest defines the request schema for `/payment_initiation/payment/list` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' count: type: - integer - 'null' minimum: 1 maximum: 200 default: 10 description: The maximum number of payments to return. If `count` is not specified, a maximum of 10 payments will be returned, beginning with the most recent payment before the cursor (if specified). cursor: type: - string - 'null' description: A string in RFC 3339 format (i.e. "2019-12-06T22:35:49Z"). Only payments created before the cursor will be returned. format: date-time consent_id: type: - string - 'null' description: The consent ID. If specified, only payments, executed using this consent, will be returned. AssetHolder: title: AssetHolder type: object additionalProperties: true description: Documentation not found in the MISMO model viewer and not provided by Freddie Mac. properties: NAME: $ref: '#/components/schemas/AssetHolderName' required: - NAME ProcessorSignalPrepareResponse: title: ProcessorSignalPrepareResponse description: ProcessorSignalPrepareResponse defines the response schema for `/processor/signal/prepare` additionalProperties: true type: object properties: request_id: $ref: '#/components/schemas/RequestID' required: - request_id SandboxItemResetLoginRequest: type: object description: SandboxItemResetLoginRequest defines the request schema for `/sandbox/item/reset_login` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' access_token: $ref: '#/components/schemas/AccessToken' required: - access_token BankTransferUser: title: BankTransferUser type: object additionalProperties: true description: The legal name and other information for the account holder. properties: legal_name: type: string description: The account holder’s full legal name. If the transfer `ach_class` is `ccd`, this should be the business name of the account holder. email_address: type: - string - 'null' description: The account holder’s email. routing_number: type: string description: The account holder's routing number. This field is only used in response data. Do not provide this field when making requests. readOnly: true required: - legal_name NumbersEFTNullable: description: Identifying information for transferring money to or from a Canadian bank account via EFT. allOf: - $ref: '#/components/schemas/NumbersEFT' - type: object additionalProperties: true SandboxItemFireWebhookRequest: type: object description: SandboxItemFireWebhookRequest defines the request schema for `/sandbox/item/fire_webhook` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' access_token: $ref: '#/components/schemas/AccessToken' webhook_type: $ref: '#/components/schemas/WebhookType' webhook_code: type: string enum: - DEFAULT_UPDATE - NEW_ACCOUNTS_AVAILABLE - AUTH_DATA_UPDATE - SMS_MICRODEPOSITS_VERIFICATION - AUTHORIZATION_GRANTED - RECURRING_TRANSACTIONS_UPDATE - SYNC_UPDATES_AVAILABLE - PRODUCT_READY - ERROR description: The webhook codes that can be fired by this test endpoint. required: - access_token - webhook_code StreetNullable: type: - string - 'null' example: 123 Main St. title: Street description: The primary street portion of an address. If an address is provided, this field will always be filled. A string with at least one non-whitespace alphabetical character, with a max length of 80 characters. TransferNetworkTraceID: title: TransferNetworkTraceID type: - string - 'null' description: 'The trace identifier for the transfer based on its network. This will only be set after the transfer has posted. For `ach` or `same-day-ach` transfers, this is the ACH trace number. For `rtp` transfers, this is the Transaction Identification number. For `wire` transfers, this is the IMAD (Input Message Accountability Data) number.' WalletTransaction: title: WalletTransaction type: object additionalProperties: true properties: transaction_id: type: string description: A unique ID identifying the transaction wallet_id: type: string description: The EMI (E-Money Institution) wallet that this payment is associated with, if any. This wallet is used as an intermediary account to enable Plaid to reconcile the settlement of funds for Payment Initiation requests. reference: type: string description: A reference for the transaction type: type: string enum: - BANK_TRANSFER - PAYOUT - PIS_PAY_IN - REFUND - FUNDS_SWEEP - RETURN description: 'The type of the transaction. The supported transaction types that are returned are: `BANK_TRANSFER:` a transaction which credits an e-wallet through an external bank transfer. `PAYOUT:` a transaction which debits an e-wallet by disbursing funds to a counterparty. `PIS_PAY_IN:` a payment which credits an e-wallet through Plaid''s Payment Initiation Services (PIS) APIs. For more information see the [Payment Initiation endpoints](https://plaid.com/docs/api/products/payment-initiation/). `REFUND:` a transaction which debits an e-wallet by refunding a previously initiated payment made through Plaid''s [PIS APIs](https://plaid.com/docs/api/products/payment-initiation/). `FUNDS_SWEEP`: an automated transaction which debits funds from an e-wallet to a designated client-owned account. `RETURN`: an automated transaction where a debit transaction was reversed and money moved back to originating account.' scheme: $ref: '#/components/schemas/WalletPaymentScheme' amount: $ref: '#/components/schemas/WalletTransactionAmount' counterparty: $ref: '#/components/schemas/WalletTransactionCounterparty' status: $ref: '#/components/schemas/WalletTransactionStatus' created_at: type: string description: Timestamp when the transaction was created, in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format. format: date-time last_status_update: format: date-time type: string description: The date and time of the last time the `status` was updated, in IS0 8601 format payment_id: type: - string - 'null' description: The payment id that this transaction is associated with, if any. This is present only for transaction types `PIS_PAY_IN` and `REFUND`. failure_reason: $ref: '#/components/schemas/WalletTransactionFailureReason' required: - transaction_id - wallet_id - reference - type - amount - counterparty - status - created_at - last_status_update description: The transaction details TransactionsCategoryRule: title: TransactionsCategoryRule type: object description: A representation of a transactions category rule. x-examples: {} properties: id: type: string description: A unique identifier of the rule created item_id: type: string description: A unique identifier of the Item the rule was created for. created_at: type: string format: date-time description: 'Date and time when a rule was created in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format ( `YYYY-MM-DDTHH:mm:ssZ` ). ' personal_finance_category: type: string description: 'Personal finance category unique identifier. In the personal finance category taxonomy, this field is represented by the detailed category field. ' rule_details: $ref: '#/components/schemas/TransactionsRuleDetails' SandboxTransferFireWebhookResponse: title: SandboxTransferFireWebhookResponse additionalProperties: true type: object description: Defines the response schema for `/sandbox/transfer/fire_webhook` properties: request_id: $ref: '#/components/schemas/RequestID' required: - request_id ServiceProductFulfillmentIdentifier: title: ServiceProductFulfillmentIdentifier type: string description: Documentation not found in the MISMO model viewer and not provided by Freddie Mac. enum: - VOA - VOE PartnerEndCustomerQuestionnaireStatus: type: string enum: - NOT_STARTED - RECEIVED - COMPLETE description: The status of the end customer's security questionnaire. TransferIntentAuthorizationDecision: type: - string - 'null' enum: - APPROVED - DECLINED description: ' A decision regarding the proposed transfer. `APPROVED` – The proposed transfer has received the end user''s consent and has been approved for processing by Plaid. The `decision_rationale` field is set if Plaid was unable to fetch the account information. You may proceed with the transfer, but further review is recommended (i.e., use Link in update mode to re-authenticate your user when `decision_rationale.code` is `ITEM_LOGIN_REQUIRED`). Refer to the `code` field in the `decision_rationale` object for details. `DECLINED` – Plaid reviewed the proposed transfer and declined processing. Refer to the `code` field in the `decision_rationale` object for details.' W2: title: W2 type: object additionalProperties: true description: W2 is an object that represents income data taken from a W2 tax document. properties: employer: $ref: '#/components/schemas/PaystubEmployer' employee: $ref: '#/components/schemas/Employee' tax_year: type: - string - 'null' description: The tax year of the W2 document. employer_id_number: type: - string - 'null' description: An employee identification number or EIN. wages_tips_other_comp: type: - string - 'null' description: Wages from tips and other compensation. federal_income_tax_withheld: type: - string - 'null' description: Federal income tax withheld for the tax year. social_security_wages: type: - string - 'null' description: Wages from social security. social_security_tax_withheld: type: - string - 'null' description: Social security tax withheld for the tax year. medicare_wages_and_tips: type: - string - 'null' description: Wages and tips from medicare. medicare_tax_withheld: type: - string - 'null' description: Medicare tax withheld for the tax year. social_security_tips: type: - string - 'null' description: Tips from social security. allocated_tips: type: - string - 'null' description: Allocated tips. box_9: type: - string - 'null' description: Contents from box 9 on the W2. dependent_care_benefits: type: - string - 'null' description: Dependent care benefits. nonqualified_plans: type: - string - 'null' description: Nonqualified plans. box_12: type: array items: $ref: '#/components/schemas/W2Box12' statutory_employee: type: - string - 'null' description: Statutory employee. retirement_plan: type: - string - 'null' description: Retirement plan. third_party_sick_pay: type: - string - 'null' description: Third party sick pay. other: type: - string - 'null' description: Other. state_and_local_wages: type: array items: $ref: '#/components/schemas/W2StateAndLocalWages' CRALoansRegisterRequest: type: object description: CraLoansRegisterRequest defines the request schema for `/cra/loans/register` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' loans: type: array description: A list of loans to register. items: $ref: '#/components/schemas/CraLoanRegister' required: - loans UserAddress: type: - object - 'null' properties: street: $ref: '#/components/schemas/StreetNullable' street2: $ref: '#/components/schemas/Street2' city: $ref: '#/components/schemas/CityNullable' region: $ref: '#/components/schemas/Region' postal_code: $ref: '#/components/schemas/PostalCode' country: $ref: '#/components/schemas/GenericCountryCode' required: - country description: 'Home address for the user. Supported values are: not provided, address with only country code or full address. For more context on this field, see [Input Validation by Country](https://plaid.com/docs/identity-verification/hybrid-input-validation/#input-validation-by-country).' additionalProperties: true PaymentConsentValidDateTime: type: - object - 'null' title: PaymentConsentValidDateTime description: Life span for the payment consent. After the `to` date the payment consent expires and can no longer be used for payment initiation. properties: from: type: - string - 'null' format: date-time description: The date and time from which the consent should be active, in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format. to: type: - string - 'null' format: date-time description: The date and time at which the consent expires, in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format. ReportType: title: ReportType type: string description: The report type. It can be `asset`. Income report types are not yet supported. enum: - asset RiskCheckSyntheticIdentity: description: 'Field containing the data used in determining the outcome of the synthetic identity risk check. Contains the following fields: `score` - A score from 0 to 100 indicating the likelihood that the user is a synthetic identity.' type: - object - 'null' properties: score: description: A score from 0 to 100 indicating the likelihood that the user is a synthetic identity. type: integer example: 0 required: - score additionalProperties: true AssetReportFreddieGetRequest: title: AssetReportFreddieGetRequest type: object additionalProperties: true description: AssetReportFreddieGetRequest defines the request schema for `credit/asset_report/freddie_mac/get` properties: audit_copy_token: type: string description: A token that can be shared with a third party auditor to allow them to obtain access to the Asset Report. This token should be stored securely. client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' required: - audit_copy_token WalletGetResponse: type: object additionalProperties: true description: WalletGetResponse defines the response schema for `/wallet/get` allOf: - $ref: '#/components/schemas/Wallet' - type: object properties: request_id: $ref: '#/components/schemas/RequestID' required: - wallet_id - balance - request_id PaystubPayFrequency: type: - string - 'null' description: 'The frequency at which the employee is paid. Possible values: `MONTHLY`, `BI-WEEKLY`, `WEEKLY`, `SEMI-MONTHLY`.' enum: - MONTHLY - BI-WEEKLY - WEEKLY - SEMI-MONTHLY - null CraLoanApplicationID: type: string description: "A unique identifier for the loan application. \nPersonally identifiable information, such as an email address or phone number, should not be used in the `application_id`." IdentityVerificationUserPhoneNumber: type: - string - 'null' description: A phone number in E.164 format. example: '+19876543212' title: PhoneNumber TransferRecurringCancelRequest: title: TransferRecurringCancelRequest type: object description: Defines the request schema for `/transfer/recurring/cancel` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' recurring_transfer_id: $ref: '#/components/schemas/RecurringTransferID' required: - recurring_transfer_id CreditBankStatementUploadItem: title: CreditBankStatementUploadItem type: object description: An object containing information about the bank statement upload Item. properties: item_id: $ref: '#/components/schemas/ItemId' bank_statements: type: array items: $ref: '#/components/schemas/CreditBankStatementUploadObject' status: $ref: '#/components/schemas/PayrollItemStatus' updated_at: type: - string - 'null' format: date-time description: Timestamp in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format (YYYY-MM-DDTHH:mm:ssZ) indicating the last time that the Item was updated. required: - item_id - bank_statements - status - updated_at InvestmentsAuthGetRequestOptions: type: object x-hidden-from-docs: true description: An optional object to filter `/investments/auth/get` results. properties: account_ids: type: array description: An array of `account_id`s to retrieve for the Item. An error will be returned if a provided `account_id` is not associated with the Item. items: type: string ClientProvidedEnrichedTransaction: title: ClientProvidedEnrichedTransaction type: object description: A client-provided transaction that Plaid has enriched. x-examples: {} additionalProperties: true properties: id: type: string description: The unique ID for the transaction as provided by you in the request. client_user_id: x-hidden-from-docs: true type: string description: A unique user id used to group transactions for a given user, as a unique identifier from your application. Personally identifiable information, such as an email address or phone number, should not be used in the client_user_id. client_account_id: x-hidden-from-docs: true type: string description: A unique account id used to group transactions for a given account, as a unique identifier from your application. Personally identifiable information, such as an email address or phone number, should not be used in the client_account_id. account_type: x-hidden-from-docs: true type: string description: The account type associated with the transaction. For a full list of valid types and subtypes, see the [Account schema](https://plaid.com/docs/api/accounts#account-type-schema). account_subtype: x-hidden-from-docs: true type: string description: The account subtype associated with the transaction. For a full list of valid types and subtypes, see the [Account schema](https://plaid.com/docs/api/accounts#account-type-schema). description: type: string description: The raw description of the transaction. amount: type: number format: double description: The absolute value of the transaction (>= 0) direction: $ref: '#/components/schemas/EnrichTransactionDirection' iso_currency_code: type: string description: The ISO-4217 currency code of the transaction e.g. USD. enrichments: $ref: '#/components/schemas/Enrichments' required: - id - description - amount - iso_currency_code - enrichments WatchlistScreeningEntityGetResponse: description: 'The entity screening object allows you to represent an entity in your system, update its profile, and search for it on various watchlists. Note: Rejected entity screenings will not receive new hits, regardless of entity program configuration.' additionalProperties: true properties: id: $ref: '#/components/schemas/EntityWatchlistScreeningID' search_terms: $ref: '#/components/schemas/EntityWatchlistScreeningSearchTerms' assignee: $ref: '#/components/schemas/DashboardUserIDNullable' status: $ref: '#/components/schemas/WatchlistScreeningStatus' client_user_id: $ref: '#/components/schemas/ClientUserIDNullable' audit_trail: $ref: '#/components/schemas/WatchlistScreeningAuditTrail' request_id: $ref: '#/components/schemas/RequestID' required: - id - search_terms - assignee - status - client_user_id - audit_trail - request_id type: object APR: title: APR type: object additionalProperties: true description: Information about the APR on the account. properties: apr_percentage: type: number format: double description: 'Annual Percentage Rate applied. ' apr_type: type: string enum: - balance_transfer_apr - cash_apr - purchase_apr - special description: The type of balance to which the APR applies. balance_subject_to_apr: type: - number - 'null' format: double description: 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. interest_charge_amount: type: - number - 'null' format: double description: Amount of money charged due to interest from last statement. required: - apr_percentage - apr_type - balance_subject_to_apr - interest_charge_amount PreviousIdentityVerificationAttemptID: type: - string - 'null' example: idv_42cF1MNo42r9Xj description: The ID for the Identity Verification preceding this session. This field will only be filled if the current Identity Verification is a retry of a previous attempt. TransferCapabilitiesGetRTP: title: TransferCapabilitiesGetRTP type: object additionalProperties: true description: Contains the supported service types in RTP properties: credit: type: boolean default: false description: When `true`, the linked Item's institution supports RTP credit transfer. BaseReportAccountBalances: title: BaseReportAccountBalances description: Base Report information about an account's balances x-hidden-from-docs: true type: object additionalProperties: true allOf: - $ref: '#/components/schemas/AccountBalance' - type: object additionalProperties: true properties: average_balance: type: - number - 'null' format: double description: The average historical balance for the entire report average_monthly_balances: type: array description: The average historical balance of each calendar month items: $ref: '#/components/schemas/BaseReportAverageMonthlyBalances' most_recent_thirty_day_average_balance: type: - number - 'null' format: double description: The average historical balance from the most recent 30 days CraLoansUnregisterRequest: type: object description: CraLoansUnregisterRequest defines the request schema for `/cra/loans/unregister` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' loans: type: array description: A list of loans to unregister. items: $ref: '#/components/schemas/CraLoanUnregister' required: - loans SandboxPublicTokenCreateRequestIncomeVerificationBankIncome: type: object description: Specifies options for Bank Income. This field is required if `income_verification` is included in the `initial_products` array and `bank` is specified in `income_source_types`. properties: days_requested: type: integer description: The number of days of data to request for the Bank Income product MatchSummaryCode: description: 'An enum indicating the match type between data provided by user and data checked against an external data source. `match` indicates that the provided input data was a strong match against external data. `partial_match` indicates the data approximately matched against external data. For example, "Knope" vs. "Knope-Wyatt" for last name. `no_match` indicates that Plaid was able to perform a check against an external data source and it did not match the provided input data. `no_data` indicates that Plaid was unable to find external data to compare against the provided input data. `no_input` indicates that Plaid was unable to perform a check because no information was provided for this field by the end user.' type: string title: MatchSummaryCode enum: - match - partial_match - no_match - no_data - no_input example: match PaymentProfileCreateRequest: type: object description: PaymentProfileCreateRequest defines the request schema for `/payment_profile/create` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' BeaconReportType: type: string title: BeaconReportType description: 'The type of Beacon Report. `first_party`: If this is the same individual as the one who submitted the KYC. `stolen`: If this is a different individual from the one who submitted the KYC. `synthetic`: If this is an individual using fabricated information. `account_takeover`: If this individual''s account was compromised. `unknown`: If you aren''t sure who committed the fraud.' enum: - first_party - stolen - synthetic - account_takeover - unknown Service: title: Service type: object additionalProperties: true description: A collection of details related to a fulfillment service or product in terms of request, process and result. properties: VERIFICATION_OF_ASSET: $ref: '#/components/schemas/VerificationOfAsset' STATUSES: $ref: '#/components/schemas/Statuses' required: - VERIFICATION_OF_ASSET - STATUSES CreditBankIncomeAccountType: type: string description: The account type. This will always be `depository`. enum: - depository ExternalPaymentScheduleGet: title: ExternalPaymentScheduleGet description: The schedule that the payment will be executed on. If a schedule is provided, the payment is automatically set up as a standing order. If no schedule is specified, the payment will be executed only once. allOf: - $ref: '#/components/schemas/ExternalPaymentScheduleBase' - type: object required: - adjusted_start_date - end_date - interval - interval_execution_day - start_date PayPeriodDetailsPayFrequency: title: PayPeriodDetailsPayFrequency type: - string - 'null' description: The frequency at which an individual is paid. enum: - PAY_FREQUENCY_UNKNOWN - PAY_FREQUENCY_WEEKLY - PAY_FREQUENCY_BIWEEKLY - PAY_FREQUENCY_SEMIMONTHLY - PAY_FREQUENCY_MONTHLY - null Address: title: Address type: object additionalProperties: true description: A physical mailing address. properties: data: $ref: '#/components/schemas/AddressData' primary: type: boolean description: When `true`, identifies the address as the primary address on an account. required: - data TransferIntentCreateMode: title: TransferIntentCreateMode type: string enum: - PAYMENT - DISBURSEMENT description: 'The direction of the flow of transfer funds. `PAYMENT`: Transfers funds from an end user''s account to your business account. `DISBURSEMENT`: Transfers funds from your business account to an end user''s account.' PrismInsights: type: - object - 'null' additionalProperties: true description: The data from the Insights product returned by Prism. properties: version: type: integer description: The version of Prism's insights model used. result: $ref: '#/components/schemas/PrismInsightsResult' required: - version ReviewComment: description: A comment submitted by a team member as part of reviewing a watchlist screening. type: - string - 'null' title: ReviewComment minLength: 1 example: These look like legitimate matches, rejecting the customer. TransactionsRulesCreateRequest: type: object description: TransactionsRulesCreateRequest defines the request schema for `beta/transactions/rules/v1/create` properties: client_id: $ref: '#/components/schemas/APIClientID' access_token: $ref: '#/components/schemas/AccessToken' secret: $ref: '#/components/schemas/APISecret' personal_finance_category: type: string description: 'Personal finance detailed category. All implementations are encouraged to use this field instead of `category`, as it provides more meaningful and accurate categorization. See the [`taxonomy csv file`](https://plaid.com/documents/transactions-personal-finance-category-taxonomy.csv) for a full list of personal finance categories. ' rule_details: $ref: '#/components/schemas/TransactionsRuleDetails' required: - access_token - personal_finance_category - rule_details TransferRefund: title: TransferRefund type: object additionalProperties: true description: Represents a refund within the Transfers API. properties: id: $ref: '#/components/schemas/TransferRefundID' transfer_id: $ref: '#/components/schemas/TransferIDForRefund' amount: $ref: '#/components/schemas/TransferRefundAmount' status: $ref: '#/components/schemas/TransferRefundStatus' failure_reason: $ref: '#/components/schemas/TransferRefundFailure' created: type: string format: date-time description: The datetime when this refund was created. This will be of the form `2006-01-02T15:04:05Z` network_trace_id: $ref: '#/components/schemas/TransferNetworkTraceID' required: - id - transfer_id - amount - status - created - failure_reason LiabilitiesGetRequestOptions: type: object description: An optional object to filter `/liabilities/get` results. If provided, `options` cannot be null. properties: account_ids: type: array description: 'A list of accounts to retrieve for the Item. An error will be returned if a provided `account_id` is not associated with the Item' items: type: string VerificationOfAssetResponse: title: VerificationOfAssetResponse type: object additionalProperties: true description: Documentation not found in the MISMO model viewer and not provided by Freddie Mac. properties: ASSETS: $ref: '#/components/schemas/Assets' required: - ASSETS StudentLoanStatus: title: StudentLoanStatus type: object additionalProperties: true description: An object representing the status of the student loan properties: end_date: type: - string - 'null' format: date description: 'The date until which the loan will be in its current status. Dates are returned in an [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format (YYYY-MM-DD). ' type: type: - string - 'null' enum: - cancelled - charged off - claim - consolidated - deferment - delinquent - discharged - extension - forbearance - in grace - in military - in school - not fully disbursed - other - paid in full - refunded - repayment - transferred - pending idr description: The status type of the student loan required: - end_date - type FDXNotificationPriority: type: string title: Notification Priority description: Priority of notification enum: - HIGH - MEDIUM - LOW CreditRelayPDFGetRequest: title: CreditRelayPDFGetRequest type: object description: CreditRelayPDFGetRequest defines the request schema for `/credit/relay/pdf/get` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' relay_token: type: string description: The `relay_token` granting access to the report you would like to get. report_type: $ref: '#/components/schemas/ReportType' required: - relay_token - report_type CreditBankIncomeWarningType: type: string description: The warning type which will always be `BANK_INCOME_WARNING`. enum: - BANK_INCOME_WARNING APIClientID: title: ClientID type: string description: Your Plaid API `client_id`. The `client_id` is required and may be provided either in the `PLAID-CLIENT-ID` header or as part of a request body. TransactionsSyncResponse: type: object additionalProperties: true description: TransactionsSyncResponse defines the response schema for `/transactions/sync` properties: transactions_update_status: $ref: '#/components/schemas/TransactionsUpdateStatus' accounts: type: array description: An array of accounts at a financial institution associated with the transactions in this response. items: $ref: '#/components/schemas/AccountBase' added: type: array description: Transactions that have been added to the Item since `cursor` ordered by ascending last modified time. items: $ref: '#/components/schemas/Transaction' modified: type: array description: Transactions that have been modified on the Item since `cursor` ordered by ascending last modified time. items: $ref: '#/components/schemas/Transaction' removed: type: array description: Transactions that have been removed from the Item since `cursor` ordered by ascending last modified time. items: $ref: '#/components/schemas/RemovedTransaction' next_cursor: type: string description: Cursor used for fetching any future updates after the latest update provided in this response. The cursor obtained after all pages have been pulled (indicated by `has_more` being `false`) will be valid for at least 1 year. This cursor should be persisted for later calls. If transactions are not yet available, this will be an empty string. has_more: type: boolean description: Represents if more than requested count of transaction updates exist. If true, the additional updates can be fetched by making an additional request with `cursor` set to `next_cursor`. If `has_more` is true, it’s important to pull all available pages, to make it less likely for underlying data changes to conflict with pagination. request_id: $ref: '#/components/schemas/RequestID' required: - accounts - added - modified - removed - next_cursor - has_more - request_id - transactions_update_status BankTransferDirection: type: - string - 'null' title: BankTransferDirection description: 'Indicates the direction of the transfer: `outbound` for API-initiated transfers, or `inbound` for payments received by the FBO account.' enum: - outbound - inbound - null WalletStatus: type: string enum: - UNKNOWN - ACTIVE - CLOSED description: 'The status of the wallet. `UNKNOWN`: The wallet status is unknown. `ACTIVE`: The wallet is active and ready to send money to and receive money from. `CLOSED`: The wallet is closed. Any transactions made to or from this wallet will error.' SandboxItemSetVerificationStatusRequest: type: object description: SandboxItemSetVerificationStatusRequest defines the request schema for `/sandbox/item/set_verification_status` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' access_token: $ref: '#/components/schemas/AccessToken' account_id: type: string description: The `account_id` of the account whose verification status is to be modified verification_status: enum: - automatically_verified - verification_expired type: string description: The verification status to set the account to. required: - access_token - account_id - verification_status RiskCheckEmail: type: - object - 'null' description: Result summary object specifying values for `email` attributes of risk check. properties: is_deliverable: $ref: '#/components/schemas/RiskCheckEmailIsDeliverableStatus' breach_count: example: 1 description: Count of all known breaches of this email address if known. type: - integer - 'null' first_breached_at: $ref: '#/components/schemas/ISO8601DateNullable' last_breached_at: $ref: '#/components/schemas/ISO8601DateNullable' domain_registered_at: $ref: '#/components/schemas/ISO8601DateNullable' domain_is_free_provider: $ref: '#/components/schemas/RiskCheckEmailDomainIsFreeProvider' domain_is_custom: $ref: '#/components/schemas/RiskCheckEmailDomainIsCustom' domain_is_disposable: $ref: '#/components/schemas/RiskCheckEmailDomainIsDisposable' top_level_domain_is_suspicious: $ref: '#/components/schemas/RiskCheckEmailTopLevelDomainIsSuspicious' linked_services: description: A list of online services where this email address has been detected to have accounts or other activity. type: array example: - facebook uniqueItems: true items: $ref: '#/components/schemas/RiskCheckLinkedService' required: - is_deliverable - breach_count - first_breached_at - last_breached_at - domain_registered_at - domain_is_free_provider - domain_is_custom - domain_is_disposable - top_level_domain_is_suspicious - linked_services additionalProperties: true ReportingInformation: title: ReportingInformation type: object additionalProperties: true description: Information about an report identifier and a report name. properties: ReportingInformationIdentifier: type: string description: Documentation not found in the MISMO model viewer and not provided by Freddie Mac. required: - ReportingInformationIdentifier SandboxTransferSweepSimulateRequest: title: SandboxTransferSweepSimulateRequest type: object description: Defines the request schema for `/sandbox/transfer/sweep/simulate` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' test_clock_id: type: - string - 'null' description: Plaid’s unique identifier for a test clock. If provided, the sweep to be simulated is created on the day of the `virtual_time` on the `test_clock`. If the date of `virtual_time` is on weekend or a federal holiday, the next available banking day is used. LinkTokenCreateRequestUser: type: object description: An object specifying information about the end user who will be linking their account. properties: client_user_id: type: string description: A unique ID representing the end user. Typically this will be a user ID number from your application. Personally identifiable information, such as an email address or phone number, should not be used in the `client_user_id`. It is currently used as a means of searching logs for the given user in the Plaid Dashboard. minLength: 1 legal_name: type: string description: The user's full legal name, used for [micro-deposit based verification flows](https://plaid.com/docs/auth/coverage/). For a small number of customers on legacy flows, providing this field is required to enable micro-deposit-based flows. For all other customers, this field is optional. Providing the user's name in this field when using micro-deposit-based verification will streamline the end user experience, as the user will not be prompted to enter their name during the Link flow; Plaid will use the provided legal name instead. name: allOf: - $ref: '#/components/schemas/IdentityVerificationRequestUserName' - description: The user's full name. Optional if using the [Identity Verification](https://plaid.com/docs/api/products/identity-verification) product; if not using Identity Verification, this field is not allowed. Users will not be asked for their name when this field is provided. phone_number: type: string description: The user's phone number in [E.164](https://en.wikipedia.org/wiki/E.164) format. If supplied, will be used when applicable to prefill phone number fields in Link for the [returning user flow](https://www.plaid.com/docs/link/returning/user) and the [Identity Verification flow](https://www.plaid.com/docs/identity-verification). phone_number_verified_time: format: date-time type: - string - 'null' deprecated: true x-hidden-from-docs: true description: "The date and time the phone number was verified in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format (`YYYY-MM-DDThh:mm:ssZ`). This was previously an optional field used in the [returning user experience](https://plaid.com/docs/link/returning-user). This field is no longer required to enable the returning user experience.\n\n Only pass a verification time for a phone number that you have verified. If you have performed verification but don’t have the time, you may supply a signal value of the start of the UNIX epoch.\n\n Example: `2020-01-01T00:00:00Z`\n" email_address: type: string description: The user's email address. Can be used to prefill Link fields when used with [Identity Verification](https://www.plaid.com/docs/identity-verification). email_address_verified_time: type: - string - 'null' format: date-time deprecated: true x-hidden-from-docs: true description: "The date and time the email address was verified in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format (`YYYY-MM-DDThh:mm:ssZ`). This was previously an optional field used in the [returning user experience](https://plaid.com/docs/link/returning-user). This field is no longer required to enable the returning user experience.\n\n Only pass a verification time for an email address that you have verified. If you have performed verification but don’t have the time, you may supply a signal value of the start of the UNIX epoch.\n\n Example: `2020-01-01T00:00:00Z`" ssn: type: string deprecated: true description: Deprecated and not currently used, use the `id_number` field instead. x-hidden-from-docs: true date_of_birth: type: - string - 'null' format: date description: To be provided in the format "yyyy-mm-dd". Can be used to prefill Link fields when used with Identity Verification. address: allOf: - $ref: '#/components/schemas/UserAddress' - description: The user's address. Used only for Identity Verification. If provided, the user will not be shown fields to enter their address in the Identity Verification flow. May be omitted, but if not omitted, all fields marked as required must be provided. id_number: allOf: - $ref: '#/components/schemas/UserIDNumber' - description: The user's ID number. Used only for Identity Verification. If provided, the user will not be shown fields to enter their ID number in the Identity Verification flow. May be omitted, but if not omitted, all fields marked as required must be provided. required: - client_user_id RiskSignalDocumentReference: title: RiskSignalDocumentReference type: object additionalProperties: true description: Object containing metadata for the document properties: document_id: type: - string - 'null' description: An identifier of the document referenced by the document metadata. document_name: type: string description: The name of the document status: $ref: '#/components/schemas/RiskSignalDocumentStatus' IdentityVerificationRetryRequestStepsObject: type: - object - 'null' description: 'Instructions for the `custom` retry strategy specifying which steps should be required or skipped. Note: This field must be provided when the retry strategy is `custom` and must be omitted otherwise. Custom retries override settings in your Plaid Template. For example, if your Plaid Template has `verify_sms` disabled, a custom retry with `verify_sms` enabled will still require the step. The `selfie_check` step is currently not supported on the sandbox server. Sandbox requests will silently disable the `selfie_check` step when provided.' properties: verify_sms: description: A boolean field specifying whether the new session should require or skip the `verify_sms` step. type: boolean kyc_check: description: A boolean field specifying whether the new session should require or skip the `kyc_check` step. type: boolean documentary_verification: description: A boolean field specifying whether the new session should require or skip the `documentary_verification` step. type: boolean selfie_check: description: A boolean field specifying whether the new session should require or skip the `selfie_check` step. type: boolean required: - verify_sms - kyc_check - documentary_verification - selfie_check SignalScores: title: SignalEvaluateScores description: Risk scoring details broken down by risk category. type: object additionalProperties: true properties: customer_initiated_return_risk: $ref: '#/components/schemas/CustomerInitiatedReturnRisk' bank_initiated_return_risk: $ref: '#/components/schemas/BankInitiatedReturnRisk' WatchlistScreeningHitStatus: type: string title: WatchlistScreeningHitStatus enum: - confirmed - pending_review - dismissed example: pending_review description: The current state of review. All watchlist screening hits begin in a `pending_review` state but can be changed by creating a review. When a hit is in the `pending_review` state, it will always show the latest version of the watchlist data Plaid has available and be compared against the latest customer information saved in the watchlist screening. Once a hit has been marked as `confirmed` or `dismissed` it will no longer be updated so that the state is as it was when the review was first conducted. TransferDiligenceSubmitRequest: title: TransferDiligenceSubmitRequest type: object description: Defines the request schema for `/transfer/diligence/submit` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' originator_client_id: type: string description: Client ID of the the originator whose diligence that you want to submit. originator_diligence: $ref: '#/components/schemas/TransferOriginatorDiligence' required: - originator_client_id - originator_diligence TaxpayerIdentifiers: title: TaxpayerIdentifiers type: object additionalProperties: true description: The collection of TAXPAYER_IDENTIFICATION elements properties: TAXPAYER_IDENTIFIER: $ref: '#/components/schemas/TaxpayerIdentifier' required: - TAXPAYER_IDENTIFIER StatementsDownloadRequest: title: StatementsDownloadRequest type: object description: StatementsDownloadRequest defines the request schema for `/statements/download` properties: access_token: $ref: '#/components/schemas/AccessToken' client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' statement_id: description: Plaid's unique identifier for the statements. type: string required: - access_token - statement_id LinkTokenCreateRequestCreditPartnerInsights: title: LinkTokenCreateRequestCreditPartnerInsights type: object x-hidden-from-docs: true description: Specifies options for initializing Link for use with the Credit Partner Insights product. properties: days_requested: type: integer description: The maximum integer number of days of history to compute Crdit Partner Insights. Defaults to 180 if not specified minimum: 1 maximum: 730 prism_products: type: array description: The specific prism products to return. If none are passed in, then all products will be returned. items: $ref: '#/components/schemas/PrismProduct' ItemImportRequestOptions: type: object description: An optional object to configure `/item/import` request. properties: webhook: type: string description: 'Specifies a webhook URL to associate with an Item. Plaid fires a webhook if credentials fail. ' WalletTransactionGetRequest: type: object description: WalletTransactionGetRequest defines the request schema for `/wallet/transaction/get` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' transaction_id: type: string description: The ID of the transaction to fetch minLength: 1 required: - transaction_id CreditSessionDocumentIncomeResult: type: - object - 'null' description: The details of a document income verification in Link properties: num_paystubs_uploaded: type: integer description: The number of paystubs uploaded by the user. num_w2s_uploaded: type: integer description: The number of w2s uploaded by the user. num_bank_statements_uploaded: type: integer description: The number of bank statements uploaded by the user. num_1099s_uploaded: type: integer description: The number of 1099s uploaded by the user required: - num_paystubs_uploaded - num_w2s_uploaded - num_bank_statements_uploaded - num_1099s_uploaded CreditPayStubEmployee: title: CreditPayStubEmployee type: object additionalProperties: true description: Data about the employee. properties: address: $ref: '#/components/schemas/CreditPayStubAddress' name: type: - string - 'null' description: The name of the employee. marital_status: type: - string - 'null' description: Marital status of the employee - either `SINGLE` or `MARRIED` or `NOT LISTED`. x-override-enum-values-shown: - SINGLE - MARRIED - NOT LISTED - null taxpayer_id: $ref: '#/components/schemas/PayStubTaxpayerID' required: - name - address - marital_status - taxpayer_id ProcessorTokenPermissionsSetRequest: type: object description: ProcessorTokenPermissionsSetRequest defines the request schema for `/processor/token/permissions/set` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' processor_token: $ref: '#/components/schemas/ProcessorToken' products: type: array description: A list of products the processor token should have access to. An empty list will grant access to all products. items: $ref: '#/components/schemas/Products' required: - processor_token - products StatementsListRequest: title: StatementsListRequest type: object description: StatementsListRequest defines the request schema for `/statements/list` properties: access_token: $ref: '#/components/schemas/AccessToken' client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' required: - access_token BankTransferEventListDirection: type: - string - 'null' title: BankTransferDirection description: 'Indicates the direction of the transfer: `outbound`: for API-initiated transfers `inbound`: for payments received by the FBO account.' enum: - inbound - outbound - null TransferRefundCancelRequest: title: TransferRefundCancelRequest type: object description: Defines the request schema for `/transfer/refund/cancel` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' refund_id: $ref: '#/components/schemas/TransferRefundID' required: - refund_id PaymentInitiationPaymentCreateStatus: type: string enum: - PAYMENT_STATUS_INPUT_NEEDED description: 'For a payment returned by this endpoint, there is only one possible value: `PAYMENT_STATUS_INPUT_NEEDED`: The initial phase of the payment' TransferConfigurationGetRequest: title: TransferConfigurationGetRequest type: object description: Defines the request schema for `/transfer/configuration/get` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' originator_client_id: type: - string - 'null' description: The Plaid client ID of the transfer originator. Should only be present if `client_id` is a [Platform customer](https://plaid.com/docs/transfer/application/#originators-vs-platforms). WalletNumbers: title: WalletNumbers type: object additionalProperties: true description: An object representing the e-wallet account numbers properties: bacs: $ref: '#/components/schemas/RecipientBACS' international: $ref: '#/components/schemas/NumbersInternationalIBAN' AssetTransactionDescription: title: AssetTransactionDescription type: object additionalProperties: true description: Documentation not found in the MISMO model viewer and not provided by Freddie Mac. properties: AssetTransactionDescription: type: string description: Asset Transaction Description String up to 3 occurances 1 required. required: - AssetTransactionDescription ProcessorTransactionsGetRequestOptions: type: object description: An optional object to be used with the request. If specified, `options` must not be `null`. properties: count: type: integer default: 100 description: The number of transactions to fetch. minimum: 1 maximum: 500 offset: type: integer default: 0 description: The number of transactions to skip. The default value is 0. minimum: 0 include_original_description: type: - boolean - 'null' default: false description: Include the raw unparsed transaction description from the financial institution. include_personal_finance_category_beta: type: boolean default: false description: Personal finance categories are now returned by default. deprecated: true x-hidden-from-docs: true include_personal_finance_category: type: boolean default: false description: Personal finance categories are now returned by default. deprecated: true x-hidden-from-docs: true include_logo_and_counterparty_beta: type: boolean default: false description: Counterparties and extra merchant fields are now returned by default. deprecated: true x-hidden-from-docs: true PaymentInitiationConsent: type: object additionalProperties: true description: PaymentInitiationConsent defines a payment initiation consent. properties: consent_id: type: string description: The consent ID. minLength: 1 status: $ref: '#/components/schemas/PaymentInitiationConsentStatus' created_at: type: string format: date-time description: Consent creation timestamp, in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format. recipient_id: type: string description: The ID of the recipient the payment consent is for. minLength: 1 reference: type: string description: A reference for the payment consent. constraints: $ref: '#/components/schemas/PaymentInitiationConsentConstraints' scopes: type: array description: An array of payment consent scopes. items: $ref: '#/components/schemas/PaymentInitiationConsentScope' required: - consent_id - status - created_at - recipient_id - reference - constraints - scopes TransactionsEnrichResponse: type: object description: TransactionsEnrichResponse defines the response schema for `/transactions/enrich`. x-examples: {} additionalProperties: true properties: enriched_transactions: type: array description: A list of enriched transactions. items: $ref: '#/components/schemas/ClientProvidedEnrichedTransaction' request_id: $ref: '#/components/schemas/RequestID' required: - enriched_transactions WatchlistScreeningEntityHistoryListRequest: description: Request input for listing changes to entity watchlist screenings type: object properties: secret: $ref: '#/components/schemas/APISecret' client_id: $ref: '#/components/schemas/APIClientID' entity_watchlist_screening_id: $ref: '#/components/schemas/EntityWatchlistScreeningID' cursor: $ref: '#/components/schemas/Cursor' required: - entity_watchlist_screening_id WatchlistScreeningIndividualHitListRequest: description: Request input for listing hits for an individual watchlist screening type: object properties: secret: $ref: '#/components/schemas/APISecret' client_id: $ref: '#/components/schemas/APIClientID' watchlist_screening_id: $ref: '#/components/schemas/WatchlistScreeningIndividualID' cursor: $ref: '#/components/schemas/Cursor' required: - watchlist_screening_id PartyRoleType: title: PartyRoleType type: string description: A value from a MISMO defined list that identifies the role that the party plays in the transaction. Parties may be either a person or legal entity. A party may play multiple roles in a transaction.A value from a MISMO defined list that identifies the role that the party plays in the transaction. Parties may be either a person or legal entity. A party may play multiple roles in a transaction. enum: - Borrower IdentityVerificationGetRequest: description: Request input for fetching an Identity Verification type: object properties: identity_verification_id: $ref: '#/components/schemas/IdentityVerificationID' secret: $ref: '#/components/schemas/APISecret' client_id: $ref: '#/components/schemas/APIClientID' required: - identity_verification_id TransferRefundAmount: title: TransferRefundAmount type: string description: The amount of the refund (decimal string with two digits of precision e.g. "10.00"). SandboxPublicTokenCreateRequestOptions: type: object description: An optional set of options to be used when configuring the Item. If specified, must not be `null`. properties: webhook: type: string description: Specify a webhook to associate with the new Item. override_username: $ref: '#/components/schemas/SandboxOverrideUsername' override_password: $ref: '#/components/schemas/SandboxOverridePassword' transactions: $ref: '#/components/schemas/SandboxPublicTokenCreateRequestOptionsTransactions' statements: $ref: '#/components/schemas/SandboxPublicTokenCreateRequestOptionsStatements' income_verification: $ref: '#/components/schemas/SandboxPublicTokenCreateRequestOptionsIncomeVerification' WatchlistScreeningEntityReviewListResponse: description: Paginated list of entity watchlist screening reviews additionalProperties: true properties: entity_watchlist_screening_reviews: description: List of entity watchlist screening reviews type: array items: $ref: '#/components/schemas/EntityWatchlistScreeningReview' next_cursor: $ref: '#/components/schemas/Cursor' request_id: $ref: '#/components/schemas/RequestID' required: - entity_watchlist_screening_reviews - next_cursor - request_id type: object DistributionBreakdown: title: DistributionBreakdown type: object description: Information about the accounts that the payment was distributed to. additionalProperties: true properties: account_name: type: - string - 'null' description: Name of the account for the given distribution. bank_name: type: - string - 'null' description: The name of the bank that the payment is being deposited to. current_amount: type: - number - 'null' format: double description: The amount distributed to this account. iso_currency_code: type: - string - 'null' description: The ISO-4217 currency code of the net pay. Always `null` if `unofficial_currency_code` is non-null. mask: type: - string - 'null' description: The last 2-4 alphanumeric characters of an account's official account number. type: type: - string - 'null' description: Type of the account that the paystub was sent to (e.g. 'checking'). unofficial_currency_code: type: - string - 'null' description: 'The unofficial currency code associated with the net pay. Always `null` if `iso_currency_code` is non-`null`. Unofficial currency codes are used for currencies that do not have official ISO currency codes, such as cryptocurrencies and the currencies of certain countries. See the [currency code schema](https://plaid.com/docs/api/accounts#currency-code-schema) for a full listing of supported `iso_currency_code`s.' current_pay: $ref: '#/components/schemas/Pay' TransferRepaymentListResponse: title: TransferRepaymentListResponse type: object additionalProperties: true description: Defines the response schema for `/transfer/repayments/list` properties: repayments: type: array items: $ref: '#/components/schemas/TransferRepayment' request_id: $ref: '#/components/schemas/RequestID' required: - repayments - request_id IdentityVerificationUserData: type: object properties: phone_number: $ref: '#/components/schemas/IdentityVerificationUserPhoneNumber' date_of_birth: $ref: '#/components/schemas/ISO8601DateNullable' ip_address: $ref: '#/components/schemas/IPAddress' email_address: $ref: '#/components/schemas/EmailAddressNullable' name: $ref: '#/components/schemas/IdentityVerificationResponseUserName' address: $ref: '#/components/schemas/IdentityVerificationUserAddress' id_number: $ref: '#/components/schemas/UserIDNumber' required: - date_of_birth - email_address - ip_address - name - address - id_number description: The identity data that was either collected from the user or provided via API in order to perform an Identity Verification. additionalProperties: true SandboxBankTransferSimulateRequest: title: SandboxBankTransferSimulateRequest type: object description: Defines the request schema for `/sandbox/bank_transfer/simulate` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' bank_transfer_id: $ref: '#/components/schemas/BankTransferID' event_type: type: string description: 'The asynchronous event to be simulated. May be: `posted`, `failed`, or `reversed`. An error will be returned if the event type is incompatible with the current transfer status. Compatible status --> event type transitions include: `pending` --> `failed` `pending` --> `posted` `posted` --> `reversed` ' failure_reason: $ref: '#/components/schemas/BankTransferFailure' required: - bank_transfer_id - event_type BankTransferBalance: title: BankTransferBalance description: Information about the balance of a bank transfer type: object additionalProperties: true properties: available: type: string description: The total available balance - the sum of all successful debit transfer amounts minus all credit transfer amounts. transactable: type: string description: The transactable balance shows the amount in your account that you are able to use for transfers, and is essentially your available balance minus your minimum balance. required: - available - transactable UpdateIndividualScreeningRequestSearchTerms: type: - object - 'null' description: Search terms for editing an individual watchlist screening properties: watchlist_program_id: $ref: '#/components/schemas/WatchlistProgramID' legal_name: $ref: '#/components/schemas/WatchlistScreeningIndividualName' date_of_birth: $ref: '#/components/schemas/ISO8601Date' document_number: $ref: '#/components/schemas/WatchlistScreeningDocumentValue' country: $ref: '#/components/schemas/GenericCountryCode' IdentityDocumentUploadRiskSignal: title: IdentityDocumentUploadRiskSignal type: object additionalProperties: true description: Risk signals tied to the document properties: type: type: - string - 'null' has_fraud_risk: type: - boolean - 'null' signal_description: type: - string - 'null' page_number: type: - integer - 'null' TransferUserInRequest: title: TransferUserInRequest type: object description: The legal name and other information for the account holder. properties: legal_name: type: string description: The user's legal name. phone_number: type: string description: The user's phone number. email_address: type: string description: The user's email address. address: $ref: '#/components/schemas/TransferUserAddressInRequest' required: - legal_name TransactionCounterparty: type: object title: Counterparty additionalProperties: true description: The counterparty, such as the merchant or financial institution, is extracted by Plaid from the raw description. properties: name: type: string description: The name of the counterparty, such as the merchant or the financial institution, as extracted by Plaid from the raw description. entity_id: type: - string - 'null' description: A unique, stable, Plaid-generated ID that maps to the counterparty. type: $ref: '#/components/schemas/CounterpartyType' website: type: - string - 'null' description: The website associated with the counterparty. logo_url: type: - string - 'null' description: The URL of a logo associated with the counterparty, if available. The logo will always be 100×100 pixel PNG file. confidence_level: type: - string - 'null' description: 'A description of how confident we are that the provided counterparty is involved in the transaction. `VERY_HIGH`: We recognize this counterparty and we are more than 98% confident that it is involved in this transaction. `HIGH`: We recognize this counterparty and we are more than 90% confident that it is involved in this transaction. `MEDIUM`: We are moderately confident that this counterparty was involved in this transaction, but some details may differ from our records. `LOW`: We didn’t find a matching counterparty in our records, so we are returning a cleansed name parsed out of the request description. `UNKNOWN`: We don’t know the confidence level for this counterparty.' required: - name - type - logo_url - website SandboxBankIncomeFireWebhookRequest: title: SandboxBankIncomeFireWebhookRequest type: object description: SandboxBankIncomeFireWebhookRequest defines the request schema for `/sandbox/bank_income/fire_webhook` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' webhook_override: type: string description: The URL to which the webhook should be sent. If provided, this will override the URL set in the dashboard. webhook_code: $ref: '#/components/schemas/SandboxBankIncomeWebhookFireRequestWebhookCode' webhook_fields: $ref: '#/components/schemas/SandboxBankIncomeWebhookFireRequestWebhookFields' required: - webhook_code - webhook_fields TransferDiligenceSubmitResponse: title: TransferDiligenceSubmitResponse type: object additionalProperties: true description: Defines the response schema for `/transfer/diligence/submit` properties: request_id: $ref: '#/components/schemas/RequestID' required: - request_id PaymentInitiationPaymentCreateResponse: type: object additionalProperties: true description: PaymentInitiationPaymentCreateResponse defines the response schema for `/payment_initiation/payment/create` properties: payment_id: type: string description: A unique ID identifying the payment status: $ref: '#/components/schemas/PaymentInitiationPaymentCreateStatus' request_id: $ref: '#/components/schemas/RequestID' required: - payment_id - status - request_id TransferCancelResponse: title: TransferCancelResponse type: object additionalProperties: true description: Defines the response schema for `/transfer/cancel` properties: request_id: $ref: '#/components/schemas/RequestID' required: - request_id ProcessorToken: title: ProcessorToken type: string description: 'The processor token obtained from the Plaid integration partner. Processor tokens are in the format: `processor--`' IncomeVerificationPrecheckRequest: title: IncomeVerificationPrecheckRequest type: object description: IncomeVerificationPrecheckRequest defines the request schema for `/income/verification/precheck` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' user: $ref: '#/components/schemas/IncomeVerificationPrecheckUser' employer: $ref: '#/components/schemas/IncomeVerificationPrecheckEmployer' payroll_institution: $ref: '#/components/schemas/IncomeVerificationPrecheckPayrollInstitution' transactions_access_token: deprecated: true allOf: - $ref: '#/components/schemas/AccessTokenNullable' transactions_access_tokens: type: array description: An array of access tokens corresponding to Items belonging to the user whose eligibility is being checked. Note that if the Items specified here are not already initialized with `transactions`, providing them in this field will cause these Items to be initialized with (and billed for) the Transactions product. items: $ref: '#/components/schemas/AccessToken' us_military_info: $ref: '#/components/schemas/IncomeVerificationPrecheckMilitaryInfo' IncomeVerificationPrecheckPayrollInstitution: title: IncomeVerificationPrecheckPayrollInstitution type: - object - 'null' description: Information about the end user's payroll institution properties: name: type: - string - 'null' description: The name of payroll institution GivenNameField: type: string example: Leslie title: GivenName description: A string with at least one non-whitespace character, with a max length of 100 characters. TransferSweepAmount: title: TransferSweepAmount type: - string - 'null' description: A signed amount of how much was `swept` or `return_swept` for this transfer (decimal string with two digits of precision e.g. "-5.50"). WatchlistScreeningIndividualIDNullable: type: - string - 'null' example: scr_52xR9LKo77r1Np title: WatchlistScreeningIndividualID description: ID of the associated screening. NameMatchScore: title: NameMatchScore type: - object - 'null' additionalProperties: true description: Score found by matching name provided by the API with the name on the account at the financial institution. If the account contains multiple owners, the maximum match score is filled. properties: score: type: - integer - 'null' description: Match score for name. 100 is a perfect score, 99-85 means a strong match, 84-70 is a partial match, any score less than 70 is a mismatch. Typically, the match threshold should be set to a score of 70 or higher. If the name is missing from either the API or financial institution, this is null. is_first_name_or_last_name_match: type: - boolean - 'null' description: first or last name completely matched, likely a family member is_nickname_match: type: - boolean - 'null' description: nickname matched, example Jennifer and Jenn. is_business_name_detected: type: - boolean - 'null' deprecated: true description: Is `true` if the name on either of the names that was matched for the score contained strings indicative of a business name, such as "CORP", "LLC", "INC", or "LTD". A `true` result generally indicates the entity is a business. However, a `false` result does not mean the entity is not a business, as some businesses do not use these strings in the names used for their financial institution accounts. TransferAuthorizationDecisionRationale: title: TransferAuthorizationDecisionRationale type: - object - 'null' additionalProperties: true description: The rationale for Plaid's decision regarding a proposed transfer. It is always set for `declined` decisions, and may or may not be null for `approved` decisions. properties: code: $ref: '#/components/schemas/TransferAuthorizationDecisionRationaleCode' description: type: string description: A human-readable description of the code associated with a transfer approval or transfer decline. required: - code - description BeaconReportSyndicationGetRequest: description: Request input for getting a Beacon Report Syndication type: object properties: beacon_report_syndication_id: $ref: '#/components/schemas/BeaconReportSyndicationID' client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' required: - beacon_report_syndication_id CreditPayStubAddress: title: CreditPayStubAddress description: Address on the pay stub. type: object additionalProperties: true properties: city: type: - string - 'null' description: The full city name. country: type: - string - 'null' description: The ISO 3166-1 alpha-2 country code. postal_code: type: - string - 'null' description: The postal code of the address. region: type: - string - 'null' description: 'The region or state. Example: `"NC"`' street: type: - string - 'null' description: The full street address. required: - city - country - postal_code - region - street OwnershipType: description: 'How an asset is owned. `association`: Ownership by a corporation, partnership, or unincorporated association, including for-profit and not-for-profit organizations. `individual`: Ownership by an individual. `joint`: Joint ownership by multiple parties. `trust`: Ownership by a revocable or irrevocable trust.' type: - string - 'null' enum: - null - individual - joint - association - trust CreditSessionPayrollIncomeResult: type: object description: The details of a digital payroll income verification in Link properties: num_paystubs_retrieved: type: integer description: The number of paystubs retrieved from a payroll provider. num_w2s_retrieved: type: integer description: The number of w2s retrieved from a payroll provider. institution_id: type: string description: The Plaid Institution ID associated with the Item. institution_name: type: string description: The Institution Name associated with the Item. BankTransferEventListBankTransferType: type: - string - 'null' title: BankTransferType description: The type of bank transfer. This will be either `debit` or `credit`. A `debit` indicates a transfer of money into your origination account; a `credit` indicates a transfer of money out of your origination account. enum: - debit - credit - null TransferStatus: type: string title: TransferStatus description: 'The status of the transfer. `pending`: A new transfer was created; it is in the pending state. `posted`: The transfer has been successfully submitted to the payment network. `settled`: Credits are available to be withdrawn or debits have been deducted from the Plaid linked account. `funds_available`: Funds from the transfer have been released from hold and applied to the ledger''s available balance. (Only applicable to ACH debits.) `cancelled`: The transfer was cancelled by the client. `failed`: The transfer failed, no funds were moved. `returned`: A posted transfer was returned.' enum: - pending - posted - settled - funds_available - cancelled - failed - returned CreditPayrollIncomeGetRequestOptions: description: An optional object for `/credit/payroll_income/get` request options. type: object properties: item_ids: type: array description: An array of `item_id`s whose payroll information is returned. Each `item_id` should uniquely identify a payroll income item. If this field is not provided, all `item_id`s associated with the `user_token` will returned in the response. items: type: string BeaconAccountRiskEvaluateAccountAttributes: title: BeaconAccountRiskEvaluateAccountAttributes type: object description: 'The attributes object contains data that can be used to assess account risk. Examples of data include: `days_since_first_plaid_connection`: The number of days since the first time the Item was connected to an application via Plaid `plaid_connections_count_7d`: The number of times the Item has been connected to applications via Plaid over the past 7 days `plaid_connections_count_30d`: The number of times the Item has been connected to applications via Plaid over the past 30 days `total_plaid_connections_count`: The number of times the Item has been connected to applications via Plaid For the full list and detailed documentation of core attributes available, or to request that core attributes not be returned, contact Sales or your Plaid account manager' properties: days_since_first_plaid_connection: type: - integer - 'null' description: The number of days since the first time the Item was connected to an application via Plaid is_account_closed: type: - boolean - 'null' description: Indicates if the account has been closed by the financial institution or the consumer, or is at risk of being closed is_account_frozen_or_restricted: type: - boolean - 'null' description: Indicates whether the account has withdrawals and transfers disabled or if access to the account is restricted. This could be due to a freeze by the credit issuer, legal restrictions (e.g., sanctions), or regulatory requirements limiting monthly withdrawals, among other reasons total_plaid_connections_count: type: - integer - 'null' description: The total number of times the item has been connected to applications via Plaid plaid_connections_count_7d: type: - integer - 'null' description: The number of times the Item has been connected to applications via Plaid over the past 7 days plaid_connections_count_30d: type: - integer - 'null' description: The number of times the Item has been connected to applications via Plaid over the past 30 days failed_plaid_non_oauth_authentication_attempts_count_3d: type: - integer - 'null' description: The number of failed non-OAuth authentication attempts via Plaid for this bank account over the past 3 days plaid_non_oauth_authentication_attempts_count_3d: type: - integer - 'null' description: The number of non-OAuth authentication attempts via Plaid for this bank account over the past 3 days failed_plaid_non_oauth_authentication_attempts_count_7d: type: - integer - 'null' description: The number of failed non-OAuth authentication attempts via Plaid for this bank account over the past 7 days plaid_non_oauth_authentication_attempts_count_7d: type: - integer - 'null' description: The number of non-OAuth authentication attempts via Plaid for this bank account over the past 7 days failed_plaid_non_oauth_authentication_attempts_count_30d: type: - integer - 'null' description: The number of failed non-OAuth authentication attempts via Plaid for this bank account over the past 30 days plaid_non_oauth_authentication_attempts_count_30d: type: - integer - 'null' description: The number of non-OAuth authentication attempts via Plaid for this bank account over the past 30 days distinct_ip_addresses_count_3d: type: - integer - 'null' description: The number of distinct IP addresses linked to the same bank account during Plaid authentication in the last 3 days distinct_ip_addresses_count_7d: type: - integer - 'null' description: The number of distinct IP addresses linked to the same bank account during Plaid authentication in the last 7 days distinct_ip_addresses_count_30d: type: - integer - 'null' description: The number of distinct IP addresses linked to the same bank account during Plaid authentication in the last 30 days distinct_ip_addresses_count_90d: type: - integer - 'null' description: The number of distinct IP addresses linked to the same bank account during Plaid authentication in the last 90 days distinct_user_agents_count_3d: type: - integer - 'null' description: The number of distinct user agents linked to the same bank account during Plaid authentication in the last 3 days distinct_user_agents_count_7d: type: - integer - 'null' description: The number of distinct user agents linked to the same bank account during Plaid authentication in the last 7 days distinct_user_agents_count_30d: type: - integer - 'null' description: The number of distinct user agents linked to the same bank account during Plaid authentication in the last 30 days distinct_user_agents_count_90d: type: - integer - 'null' description: The number of distinct user agents linked to the same bank account during Plaid authentication in the last 90 days address_change_count_28d: type: - integer - 'null' description: The number of times the account's addresses on file have changed over the past 28 days email_change_count_28d: type: - integer - 'null' description: The number of times the account's email addresses on file have changed over the past 28 days phone_change_count_28d: type: - integer - 'null' description: The number of times the account's phone numbers on file have changed over the past 28 days address_change_count_90d: type: - integer - 'null' description: The number of times the account's addresses on file have changed over the past 90 days email_change_count_90d: type: - integer - 'null' description: The number of times the account's email addresses on file have changed over the past 90 days phone_change_count_90d: type: - integer - 'null' description: The number of times the account's phone numbers on file have changed over the past 90 days days_since_account_opening: type: - integer - 'null' description: The number of days since the bank account was opened, as reported by the financial institution days_since_first_observed_transaction: type: - integer - 'null' description: The number of days since the oldest transaction available to Plaid for this account. This measure, combined with Plaid connection history, can be used to infer the age of the account WatchlistScreeningIndividualHistoryListResponse: description: Paginated list of individual watchlist screenings. additionalProperties: true properties: watchlist_screenings: description: List of individual watchlist screenings type: array items: $ref: '#/components/schemas/WatchlistScreeningIndividual' next_cursor: $ref: '#/components/schemas/Cursor' request_id: $ref: '#/components/schemas/RequestID' required: - watchlist_screenings - next_cursor - request_id type: object TransferLedgerBalance: title: TransferLedgerBalance description: Information about the balance of the ledger held with Plaid. type: object additionalProperties: true properties: available: type: string description: The amount of this balance available for use (decimal string with two digits of precision e.g. "10.00"). pending: type: string description: The amount of pending funds that are in processing (decimal string with two digits of precision e.g. "10.00"). required: - available - pending PaymentInitiationConsentCreateResponse: type: object additionalProperties: true description: PaymentInitiationConsentCreateResponse defines the response schema for `/payment_initiation/consent/create` properties: consent_id: type: string description: A unique ID identifying the payment consent. status: $ref: '#/components/schemas/PaymentInitiationConsentStatus' request_id: $ref: '#/components/schemas/RequestID' required: - consent_id - status - request_id TransferOriginatorListRequest: title: TransferOriginatorListRequest type: object description: Defines the request schema for `/transfer/originator/list` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' count: type: - integer - 'null' description: The maximum number of originators to return. maximum: 25 minimum: 1 default: 25 offset: type: - integer - 'null' description: The number of originators to skip before returning results. minimum: 0 default: 0 BaseReportTransaction: title: BaseReportTransaction description: A transaction on the Base Report x-hidden-from-docs: true type: object additionalProperties: true properties: amount: type: number format: double description: The settled value of the transaction, denominated in the transaction's currency, as stated in `iso_currency_code` or `unofficial_currency_code`. 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. iso_currency_code: type: - string - 'null' description: The ISO-4217 currency code of the transaction. Always `null` if `unofficial_currency_code` is non-null. unofficial_currency_code: type: - string - 'null' description: 'The unofficial currency code associated with the transaction. Always `null` if `iso_currency_code` is non-`null`. Unofficial currency codes are used for currencies that do not have official ISO currency codes, such as cryptocurrencies and the currencies of certain countries. See the [currency code schema](https://plaid.com/docs/api/accounts#currency-code-schema) for a full listing of supported `unofficial_currency_code`s.' original_description: type: - string - 'null' description: The string returned by the financial institution to describe the transaction. credit_category: $ref: '#/components/schemas/CreditCategory' check_number: type: - string - 'null' description: The check number of the transaction. This field is only populated for check transactions. date: type: string format: date description: 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](https://wikipedia.org/wiki/ISO_8601) format ( `YYYY-MM-DD` ). date_transacted: type: - string - 'null' description: The date on which the transaction took place, in IS0 8601 format. location: $ref: '#/components/schemas/Location' merchant_name: type: - string - 'null' description: 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`. pending: type: boolean description: When `true`, identifies the transaction as pending or unsettled. Pending transaction details (name, type, amount, category ID) may change before they are settled. account_owner: type: - string - 'null' description: The name of the account owner. This field is not typically populated and only relevant when dealing with sub-accounts. transaction_type: $ref: '#/components/schemas/BaseReportTransactionType' category: type: - array - 'null' x-hidden-from-docs: true description: A hierarchical array of the categories to which this transaction belongs. For a full list of categories, see [`/categories/get`](https://plaid.com/docs/api/products/transactions/#categoriesget). items: type: string category_id: x-hidden-from-docs: true description: The ID of the category to which this transaction belongs. For a full list of categories, see [`/categories/get`](https://plaid.com/docs/api/products/transactions/#categoriesget). required: - pending - date - unofficial_currency_code - iso_currency_code - amount - original_description FraudAmount: type: - object - 'null' title: FraudAmount description: 'The amount and currency of the fraud or attempted fraud. `fraud_amount` should be omitted to indicate an unknown fraud amount.' properties: iso_currency_code: $ref: '#/components/schemas/ISOCurrencyCode' value: type: number format: double example: 100 description: 'The amount value. This value can be 0 to indicate no money was lost. Must not contain more than two digits of precision (e.g., `1.23`).' required: - iso_currency_code - value additionalProperties: true CreditPayStubDeductions: title: CreditPayStubDeductions type: object description: An object with the deduction information found on a pay stub. additionalProperties: true properties: breakdown: type: array items: $ref: '#/components/schemas/PayStubDeductionsBreakdown' total: $ref: '#/components/schemas/PayStubDeductionsTotal' required: - breakdown - total SandboxOverrideUsername: type: - string - 'null' default: user_good description: Test username to use for the creation of the Sandbox Item. Default value is `user_good`. DetectedAccount: type: object description: A possible account detected to be associated with a transaction user. additionalProperties: true properties: account_type: type: - string - 'null' description: The detected account type (depository, credit, loan, investment etc.). account_subtype: type: - string - 'null' description: The detected subtype of the account, based on the transactions to/from the institution. transaction_count: type: integer description: The number of transactions associated with this detected account type at this financial institution. oldest_transaction_date: type: string format: date description: The date of the oldest transaction associated with this detected account type at this financial institution. newest_transaction_date: type: string format: date description: The date of the newest transaction associated with this detected account type at this financial institution. newest_transaction_amount: type: number format: double description: Amount of the most recent transaction associated with this detected account type at this financial institution. total_outflows: type: number format: double description: Sum of outflow amounts associated with this detected account type at this financial institution. total_inflows: type: number format: double description: Sum of inflow amounts associated with this detected account type at this financial institution. required: - account_type - account_subtype - transaction_count - total_outflows - total_inflows ItemPublicTokenExchangeRequest: type: object description: ItemPublicTokenExchangeRequest defines the request schema for `/item/public_token/exchange` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' public_token: type: string description: Your `public_token`, obtained from the Link `onSuccess` callback or `/sandbox/item/public_token/create`. required: - public_token W2Box12: title: W2Box12 description: Data on the W2 Box 12 type: object additionalProperties: true properties: code: type: - string - 'null' description: W2 Box 12 code. amount: type: - string - 'null' description: W2 Box 12 amount. TransferFundingAccountIDResponseNullable: type: - string - 'null' description: The id of the associated funding account, available in the Plaid Dashboard. If present, this indicates which of your business checking accounts will be credited or debited. TransferScheduleIntervalCount: type: integer title: TransferScheduleIntervalCount description: 'The number of recurring `interval_units` between originations. The recurring interval (before holiday adjustment) is calculated by multiplying `interval_unit` and `interval_count`. For example, to schedule a recurring transfer which originates once every two weeks, set `interval_unit` = `week` and `interval_count` = 2.' Loan: title: Loan type: object additionalProperties: true description: Information specific to a mortgage loan agreement between one or more borrowers and a mortgage lender. properties: LOAN_IDENTIFIERS: $ref: '#/components/schemas/LoanIdentifiers' required: - LOAN_IDENTIFIERS RecipientBACSNullable: description: An object containing a BACS account number and sort code. If an IBAN is not provided or if this recipient needs to accept domestic GBP-denominated payments, BACS data is required. allOf: - $ref: '#/components/schemas/RecipientBACS' - type: object additionalProperties: true description: The account number and sort code of the recipient's account. City: type: string example: Pawnee title: CityName description: City from the end user's address. A string with at least one non-whitespace alphabetical character, with a max length of 100 characters." HealthIncident: title: HealthIncident description: A status health incident type: object additionalProperties: true properties: start_date: type: string format: date-time description: The start date of the incident, in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format, e.g. `"2020-10-30T15:26:48Z"`. end_date: type: - string - 'null' format: date-time description: The end date of the incident, in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format, e.g. `"2020-10-30T15:26:48Z"`. title: type: string description: The title of the incident incident_updates: type: array description: Updates on the health incident. items: $ref: '#/components/schemas/IncidentUpdate' required: - start_date - title - incident_updates LinkTokenGetRequest: type: object description: LinkTokenGetRequest defines the request schema for `/link/token/get` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' link_token: type: string description: A `link_token` from a previous invocation of `/link/token/create` required: - link_token CreditEmployerVerification: title: CreditEmployerVerification type: object additionalProperties: true description: An object containing employer data. properties: name: type: - string - 'null' description: Name of employer. required: - name TransferRepaymentReturn: title: TransferRepaymentReturn type: object additionalProperties: true description: Represents a return on a Guaranteed ACH transfer that is included in the specified repayment. properties: transfer_id: type: string description: The unique identifier of the guaranteed transfer that was returned. event_id: type: integer description: The unique identifier of the corresponding `returned` transfer event. minimum: 0 amount: type: string description: The value of the returned transfer. iso_currency_code: type: string description: The currency of the repayment, e.g. "USD". required: - transfer_id - event_id - amount - iso_currency_code WatchlistScreeningIndividualUpdateRequestResettableField: type: string enum: - assignee description: The name of a field that can be reset back to null TransferRefundID: type: string title: TransferRefundID description: Plaid’s unique identifier for a refund. FDXHateoasLinkAction: type: string enum: - GET - POST - PATCH - DELETE - PUT description: HTTP Method to use for the request InvestmentsTransactionsGetRequestOptions: description: An optional object to filter `/investments/transactions/get` results. If provided, must be non-`null`. type: object properties: account_ids: type: array description: An array of `account_ids` to retrieve for the Item. items: type: string count: type: integer default: 100 minimum: 1 maximum: 500 description: 'The number of transactions to fetch. ' offset: type: integer description: The number of transactions to skip when fetching transaction history default: 0 minimum: 0 async_update: type: boolean description: If the Item was not initialized with the investments product via the `products` array when calling `/link/token/create`, and `async_update` is set to true, the initial Investments extraction will happen asynchronously. Plaid will subsequently fire a `HISTORICAL_UPDATE` webhook when the extraction completes. When `false`, Plaid will wait to return a response until extraction completion and no `HISTORICAL_UPDATE` webhook will fire. Note that while the extraction is happening asynchronously, calls to `/investments/transactions/get` and `/investments/refresh` will return `PRODUCT_NOT_READY` errors until the extraction completes. default: false WatchlistScreeningHitID: type: string example: scrhit_52xR9LKo77r1Np title: WatchlistScreeningHitID description: ID of the associated screening hit. TransferQuestionnaireCreateResponse: title: TransferQuestionnaireCreateResponse type: object additionalProperties: true description: Defines the response schema for `/transfer/questionnaire/create` properties: onboarding_url: type: string description: Plaid-hosted onboarding URL that you will redirect the end customer to. request_id: $ref: '#/components/schemas/RequestID' required: - onboarding_url - request_id TransferRepaymentReturnListRequest: title: TransferRepaymentReturnListRequest type: object description: Defines the request schema for `/transfer/repayment/return/list` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' repayment_id: type: string description: Identifier of the repayment to query. count: type: - integer - 'null' minimum: 1 maximum: 25 default: 25 description: The maximum number of repayments to return. offset: type: integer default: 0 minimum: 0 description: The number of repayments to skip before returning results. required: - repayment_id WalletCreateRequest: type: object description: WalletCreateRequest defines the request schema for `/wallet/create` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' iso_currency_code: $ref: '#/components/schemas/WalletISOCurrencyCode' required: - iso_currency_code LinkDeliveryRecipient: type: object description: Metadata related to the recipient. If the information required to populate this field is not available, leave it blank. properties: communication_methods: type: array items: $ref: '#/components/schemas/LinkDeliveryCommunicationMethod' description: The list of communication methods to send the Hosted Link session URL to. If delivery is not required, leave this field blank. first_name: type: string description: First name of the recipient. Will be used in the body of the email / text (if configured). If this information is not available, leave this field blank. WatchlistScreeningIndividualHitListResponse: description: Paginated list of individual watchlist screening hits additionalProperties: true properties: watchlist_screening_hits: description: List of individual watchlist screening hits type: array items: $ref: '#/components/schemas/WatchlistScreeningHit' next_cursor: $ref: '#/components/schemas/Cursor' request_id: $ref: '#/components/schemas/RequestID' required: - watchlist_screening_hits - next_cursor - request_id type: object LinkEventMetadata: type: object title: LinkEventMetadata description: Metadata about an event that occured while the user was going through Link x-hidden-from-docs: true additionalProperties: true properties: error_code: type: string description: The error code that the user encountered. Emitted by `ERROR`, `EXIT`. error_message: type: string description: 'The error message that the user encountered. Emitted by: `ERROR`, `EXIT`.' error_type: type: string description: 'The error type that the user encountered. Emitted by: `ERROR`, `EXIT`.' exit_status: type: string description: 'The status key indicates the point at which the user exited the Link flow. Emitted by: `EXIT`.' institution_id: type: string description: 'The ID of the selected institution. Emitted by: all events.' institution_name: type: string description: 'The name of the selected institution. Emitted by: all events.' institution_search_query: type: string description: 'The query used to search for institutions. Emitted by: `SEARCH_INSTITUTION`.' request_id: type: string description: 'The request ID for the last request made by Link. This can be shared with Plaid Support to expedite investigation. Emitted by: all events.' mfa_type: type: string description: 'If set, the user has encountered one of the following MFA types: code, device, questions, selections. Emitted by: `SUBMIT_MFA` and `TRANSITION_VIEW` when view_name is `MFA`.' view_name: type: string description: 'The name of the view that is being transitioned to. Emitted by: `TRANSITION_VIEW`.' selection: type: string description: 'Either the verification method for a matched institution selected by the user or the Auth Type Select flow type selected by the user. If selection is used to describe selected verification method, then possible values are `phoneotp` or `password`; if selection is used to describe the selected Auth Type Select flow, then possible values are `flow_type_manual` or `flow_type_instant`. Emitted by: `MATCHED_SELECT_VERIFY_METHOD` and `SELECT_AUTH_TYPE`.' brand_name: type: string description: The name of the selected brand. match_reason: type: string description: 'The reason this institution was matched, which will be either `returning_user` or `routing_number`. Emitted by: `MATCHED_SELECT_INSTITUTION`.' routing_number: type: string description: The routing number submitted by user at the micro-deposits routing number pane. Emitted by `SUBMIT_ROUTING_NUMBER`. account_number_mask: type: string description: The account number mask extracted from the user-provided account number. If the user-inputted account number is four digits long, `account_number_mask` is empty. Emitted by `SUBMIT_ACCOUNT_NUMBER`. required: - request_id APISecret: title: APISecret type: string description: Your Plaid API `secret`. The `secret` is required and may be provided either in the `PLAID-SECRET` header or as part of a request body. TransferAuthorizationGuaranteeDecisionRationaleCode: type: string x-hidden-from-docs: true description: 'A code representing the reason Plaid declined to guarantee this transfer: `RETURN_BANK`: The risk of a bank-initiated return (for example, an R01/NSF) is too high to guarantee this transfer. `RETURN_CUSTOMER`: The risk of a customer-initiated return (for example, a R10/Unauthorized) is too high to guarantee this transfer. `GUARANTEE_LIMIT_REACHED`: This transfer is low-risk, but Guarantee has exhausted an internal limit on the number or rate of guarantees that applies to this transfer. `RISK_ESTIMATE_UNAVAILABLE`: A risk estimate is unavailable for this Item. `REQUIRED_PARAM_MISSING`: Required fields are missing.' enum: - RETURN_BANK - RETURN_CUSTOMER - GUARANTEE_LIMIT_REACHED - RISK_ESTIMATE_UNAVAILABLE - REQUIRED_PARAM_MISSING SandboxPublicTokenCreateRequestOptionsStatements: title: SandboxPublicTokenCreateRequestOptionsStatements type: - object - 'null' description: An optional set of parameters corresponding to statements options. properties: start_date: type: string format: date description: The earliest date for which to fetch statements history. Dates should be formatted as YYYY-MM-DD. end_date: type: string format: date description: The most recent date for which to fetch statements history. Dates should be formatted as YYYY-MM-DD. required: - start_date - end_date AssetReportAddOns: title: AssetReportAddOns enum: - investments - fast_assets description: 'A list of add-ons that should be included in the Asset Report. `fast_assets`: When Fast Assets is requested, Plaid will create two versions of the Asset Report: the Fast Asset Report, which will contain only Identity and Balance information, and the Full Asset Report, which will also contain Transactions information. A `PRODUCT_READY` webhook will be fired for each Asset Report when it is ready, and the `report_type` field will indicate whether the webhook is firing for the `full` or `fast` Asset Report. To retrieve the Fast Asset Report, call `/asset_report/get` with `fast_report` set to `true`. There is no additional charge for using Fast Assets. To create a Fast Asset Report, Plaid must successfully retrieve both Identity and Balance data; if Plaid encounters an error obtaining this data, the Fast Asset Report will not be created. However, as long as Plaid can obtain Transactions data, the Full Asset Report will still be available. `investments`: Request an Asset Report with Investments. This add-on is in closed beta and not generally available.' type: string PaymentInitiationPaymentGetResponse: additionalProperties: true description: PaymentInitiationPaymentGetResponse defines the response schema for `/payment_initation/payment/get` allOf: - $ref: '#/components/schemas/PaymentInitiationPayment' - type: object properties: request_id: $ref: '#/components/schemas/RequestID' required: - request_id - payment_id - amount - status - recipient_id - reference - last_status_update - bacs - iban IncomeVerificationTaxformsGetRequest: title: IncomeVerificationTaxformsGetRequest type: object description: IncomeVerificationTaxformsGetRequest defines the request schema for `/income/verification/taxforms/get` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' income_verification_id: type: - string - 'null' description: The ID of the verification. deprecated: true access_token: $ref: '#/components/schemas/AccessTokenNullable' PaymentInitiationPaymentTokenCreateResponse: type: object additionalProperties: true description: PaymentInitiationPaymentTokenCreateResponse defines the response schema for `/payment_initiation/payment/token/create` properties: payment_token: type: string description: A `payment_token` that can be provided to Link initialization to enter the payment initiation flow payment_token_expiration_time: format: date-time type: string description: The date and time at which the token will expire, in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format. A `payment_token` expires after 15 minutes. request_id: $ref: '#/components/schemas/RequestID' required: - payment_token - payment_token_expiration_time - request_id CreditFilter: title: CreditFilter description: A filter to apply to `credit`-type accounts type: object additionalProperties: true properties: account_subtypes: $ref: '#/components/schemas/CreditAccountSubtypes' required: - account_subtypes PartnerCustomerEnableResponse: description: Response schema for `/partner/customer/enable`. type: object additionalProperties: true properties: production_secret: description: The end customer's secret key for the Production environment. type: string request_id: $ref: '#/components/schemas/RequestID' Cause: title: Cause type: object additionalProperties: true allOf: - $ref: '#/components/schemas/PlaidError' - type: object properties: item_id: $ref: '#/components/schemas/ItemId' required: - item_id - error_type - error_code - error_message - display_message description: An error object and associated `item_id` used to identify a specific Item and error when a batch operation operating on multiple Items has encountered an error in one of the Items. BeaconUserStatus: type: string title: BeaconUserStatus description: 'A status of a Beacon User. `rejected`: The Beacon User has been rejected for fraud. Users can be automatically or manually rejected. `pending_review`: The Beacon User has been marked for review. `cleared`: The Beacon User has been cleared of fraud.' enum: - rejected - pending_review - cleared example: cleared EmploymentVerificationStatus: type: - string - 'null' description: Current employment status. enum: - EMPLOYMENT_STATUS_ACTIVE - EMPLOYMENT_STATUS_INACTIVE - null PaymentAmount: title: PaymentAmount type: object properties: currency: $ref: '#/components/schemas/PaymentAmountCurrency' value: type: number format: double description: The amount of the payment. Must contain at most two digits of precision e.g. `1.23`. Minimum accepted value is `1`. required: - currency - value description: The amount and currency of a payment PaymentInitiationPaymentGetRequest: type: object description: PaymentInitiationPaymentGetRequest defines the request schema for `/payment_initiation/payment/get` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' payment_id: type: string description: The `payment_id` returned from `/payment_initiation/payment/create`. required: - payment_id ConsumerReportPermissiblePurpose: x-hidden-from-docs: true type: string title: ConsumerReportPermissiblePurpose enum: - ACCOUNT_REVIEW_CREDIT - ACCOUNT_REVIEW_NON_CREDIT - EMPLOYMENT - EXTENSION_OF_CREDIT - LEGITIMATE_BUSINESS_NEED_TENANT_SCREENING - LEGITIMATE_BUSINESS_NEED_OTHER - WRITTEN_INSTRUCTION_PREQUALIFICATION - WRITTEN_INSTRUCTION_OTHER description: 'This enum describes the reason a consumer report is created for `ACCOUNT_REVIEW_CREDIT`: In connection with a consumer credit transaction for the review or collection of an account pursuant to FCRA Section 604(a)(3)(A). `ACCOUNT_REVIEW_NON_CREDIT`: For a legitimate business need of the information to review a non-credit account provided primarily for personal, family, or household purposes to determine whether the consumer continues to meet the terms of the account pursuant to FCRA Section 604(a)(3)(F)(2). `EMPLOYMENT`: For employment purposes pursuant to FCRA 604(a)(3)(B), including hiring, retention and promotion purposes. `EXTENSION_OF_CREDIT`: In connection with a credit transaction initiated by and involving the consumer pursuant to FCRA Section 604(a)(3)(A). `LEGITIMATE_BUSINESS_NEED_TENANT_SCREENING`: For a legitimate business need in connection with a business transaction initiated by the consumer primarily for personal, family, or household purposes in connection with a property rental assessment pursuant to FCRA Section 604(a)(3)(F)(i). `LEGITIMATE_BUSINESS_NEED_OTHER`: For a legitimate business need in connection with a business transaction made primarily for personal, family, or household initiated by the consumer pursuant to FCRA Section 604(a)(3)(F)(i). `WRITTEN_INSTRUCTION_PREQUALIFICATION`: In accordance with the written instructions of the consumer pursuant to FCRA Section 604(a)(2), to evaluate an application’s profile to make an offer to the consumer. `WRITTEN_INSTRUCTION_OTHER`: In accordance with the written instructions of the consumer pursuant to FCRA Section 604(a)(2), such as when an individual agrees to act as a guarantor or assumes personal liability for a consumer, business, or commercial loan.' Owner: title: Owner type: object additionalProperties: true description: Data returned from the financial institution about the owner or owners of an account. Only the `names` array must be non-empty. properties: names: description: '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 `names` array.' type: array items: type: string phone_numbers: type: array description: 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. items: $ref: '#/components/schemas/PhoneNumber' emails: type: array description: 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. items: $ref: '#/components/schemas/Email' addresses: type: array description: 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. items: $ref: '#/components/schemas/Address' document_id: type: - string - 'null' description: document_id is the id of the document that this identity belongs to x-hidden-from-docs: true required: - names - phone_numbers - emails - addresses ProcessorTransactionsGetRequest: type: object description: ProcessorTransactionsGetRequest defines the request schema for `/processor/transactions/get` properties: client_id: $ref: '#/components/schemas/APIClientID' options: $ref: '#/components/schemas/ProcessorTransactionsGetRequestOptions' processor_token: $ref: '#/components/schemas/ProcessorToken' secret: $ref: '#/components/schemas/APISecret' start_date: type: string format: date description: The earliest date for which data should be returned. Dates should be formatted as YYYY-MM-DD. end_date: type: string format: date description: The latest date for which data should be returned. Dates should be formatted as YYYY-MM-DD. required: - processor_token - start_date - end_date AssetReportFilterRequest: type: object description: AssetReportFilterRequest defines the request schema for `/asset_report/filter` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' asset_report_token: $ref: '#/components/schemas/AssetReportToken' account_ids_to_exclude: type: array description: The accounts to exclude from the Asset Report, identified by `account_id`. items: type: string required: - asset_report_token - account_ids_to_exclude ProductStatusBreakdown: title: StatusBreakdown type: object additionalProperties: true description: A detailed breakdown of the institution's performance for a request type. The values for `success`, `error_plaid`, and `error_institution` sum to 1. The time range used for calculating the breakdown may range from the most recent few minutes to the past six hours. In general, smaller institutions will show status that was calculated over a longer period of time. For Investment updates, which are refreshed less frequently, the period assessed may be 24 hours or more. For more details, see [Institution status details](https://plaid.com/docs/account/activity/#institution-status-details). properties: success: description: The percentage of login attempts that are successful, expressed as a decimal. type: number format: double error_plaid: description: 'The percentage of logins that are failing due to an internal Plaid issue, expressed as a decimal. ' type: number format: double error_institution: description: The percentage of logins that are failing due to an issue in the institution's system, expressed as a decimal. type: number format: double refresh_interval: type: string enum: - NORMAL - DELAYED - STOPPED description: The `refresh_interval` may be `DELAYED` or `STOPPED` even when the success rate is high. This value is only returned for Transactions status breakdowns. required: - success - error_plaid - error_institution PhoneNumber: title: PhoneNumber type: object additionalProperties: true description: A phone number properties: data: type: string description: The phone number. primary: type: boolean description: When `true`, identifies the phone number as the primary number on an account. type: type: string enum: - home - work - office - mobile - mobile1 - other description: The type of phone number. required: - data - primary - type CreditBankIncomeTransaction: type: object description: The transactions data for the end user's income source(s). additionalProperties: true properties: amount: type: number description: 'The settled value of the transaction, denominated in the transactions''s currency as stated in `iso_currency_code` or `unofficial_currency_code`. Positive values when money moves out of the account; negative values when money moves in. For example, credit card purchases are positive; credit card payment, direct deposits, and refunds are negative.' date: type: string format: date description: '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).' name: type: string description: The merchant name or transaction description. original_description: type: - string - 'null' description: The string returned by the financial institution to describe the transaction. pending: type: boolean description: 'When true, identifies the transaction as pending or unsettled. Pending transaction details (name, type, amount, category ID) may change before they are settled.' transaction_id: type: string description: The unique ID of the transaction. Like all Plaid identifiers, the `transaction_id` is case sensitive. check_number: type: - string - 'null' description: The check number of the transaction. This field is only populated for check transactions. iso_currency_code: $ref: '#/components/schemas/CreditIsoCurrencyCode' unofficial_currency_code: $ref: '#/components/schemas/CreditUnofficialCurrencyCode' ProcessorStripeBankAccountTokenCreateRequest: type: object description: ProcessorStripeBankAccountTokenCreateRequest defines the request schema for `/processor/stripe/bank_account/create` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' access_token: $ref: '#/components/schemas/AccessToken' account_id: type: string description: The `account_id` value obtained from the `onSuccess` callback in Link required: - access_token - account_id PartnerCustomerRemoveRequest: description: Request schema for `/partner/customer/remove`. properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' end_customer_client_id: type: string description: The `client_id` of the end customer to be removed. required: - end_customer_client_id MortgageInterestRate: title: MortgageInterestRate type: object additionalProperties: true description: Object containing metadata about the interest rate for the mortgage. properties: percentage: type: - number - 'null' format: double description: Percentage value (interest rate of current mortgage, not APR) of interest payable on a loan. type: type: - string - 'null' description: The type of interest charged (fixed or variable). required: - percentage - type RiskCheckEmailDomainIsCustom: description: Indicates whether the email address domain is custom if known, i.e. a company domain and not free or disposable. example: 'yes' type: string enum: - 'yes' - 'no' - no_data AssetType: title: AssetType type: string description: A value from a MISMO prescribed list that specifies financial assets in a mortgage loan transaction. Assets may be either liquid or fixed and are associated with a corresponding asset amount. enum: - CheckingAccount - SavingsAccount - Investment - MoneyMarketFund - Other JWKPublicKey: type: object additionalProperties: true description: A JSON Web Key (JWK) that can be used in conjunction with [JWT libraries](https://jwt.io/#libraries-io) to verify Plaid webhooks properties: alg: type: string description: The alg member identifies the cryptographic algorithm family used with the key. crv: type: string description: The crv member identifies the cryptographic curve used with the key. kid: type: string description: The kid (Key ID) member can be used to match a specific key. This can be used, for instance, to choose among a set of keys within the JWK during key rollover. kty: type: string description: The kty (key type) parameter identifies the cryptographic algorithm family used with the key, such as RSA or EC. use: type: string description: The use (public key use) parameter identifies the intended use of the public key. x: type: string description: The x member contains the x coordinate for the elliptic curve point, provided as a base64url-encoded string of the coordinate's big endian representation. y: type: string description: The y member contains the y coordinate for the elliptic curve point, provided as a base64url-encoded string of the coordinate's big endian representation. created_at: type: integer description: The timestamp when the key was created, in Unix time. expired_at: type: - integer - 'null' description: The timestamp when the key expired, in Unix time. required: - alg - kid - kty - crv - x - y - use - created_at - expired_at URL: type: string format: uri title: URL example: https://example.com description: An 'http' or 'https' URL (must begin with either of those). PayStubEarningsBreakdown: title: PayStubEarningsBreakdown type: object additionalProperties: true description: An object representing the earnings line items for the pay period. properties: canonical_description: $ref: '#/components/schemas/PayStubEarningsBreakdownCanonicalDescription' current_amount: type: - number - 'null' format: double description: Raw amount of the earning line item. description: type: - string - 'null' description: Description of the earning line item. hours: type: - number - 'null' description: Number of hours applicable for this earning. iso_currency_code: type: - string - 'null' description: The ISO-4217 currency code of the line item. Always `null` if `unofficial_currency_code` is non-null. rate: type: - number - 'null' format: double description: Hourly rate applicable for this earning. unofficial_currency_code: type: - string - 'null' description: 'The unofficial currency code associated with the line item. Always `null` if `iso_currency_code` is non-`null`. Unofficial currency codes are used for currencies that do not have official ISO currency codes, such as cryptocurrencies and the currencies of certain countries. See the [currency code schema](https://plaid.com/docs/api/accounts#currency-code-schema) for a full listing of supported `iso_currency_code`s.' ytd_amount: type: - number - 'null' format: double description: The year-to-date amount of the deduction. required: - canonical_description - current_amount - description - hours - iso_currency_code - rate - unofficial_currency_code - ytd_amount ProcessorStripeBankAccountTokenCreateResponse: type: object additionalProperties: true description: ProcessorStripeBankAccountTokenCreateResponse defines the response schema for `/processor/stripe/bank_account/create` properties: stripe_bank_account_token: type: string description: A token that can be sent to Stripe for use in making API calls to Plaid request_id: $ref: '#/components/schemas/RequestID' required: - stripe_bank_account_token - request_id ConsumerReportUserIdentity: type: - object - 'null' additionalProperties: true x-hidden-from-docs: true description: ConsumerReportUserIdentity defines the user identity data collected for consumer report purpose. This field is required to be set if you later use the created user for consumer report purpose. properties: first_name: type: string description: The user's first name last_name: type: string description: The user's last name phone_numbers: description: The user's phone numbers. The format of phone number will be validated and for better normalization, it is expected to be in E.164 format +{countrycode}{number}, for example `+14151234567`. type: array items: type: string emails: description: The user's emails type: array items: type: string primary_address: $ref: '#/components/schemas/AddressData' required: - first_name - last_name - phone_numbers - emails - primary_address CreditBankEmployer: type: object description: Object containing employer data. properties: name: type: string description: Name of the employer. required: - name ISOCurrencyCode: type: string title: ISOCurrencyCode enum: - USD description: An ISO-4217 currency code. minLength: 3 BeaconReportIDNullable: type: - string - 'null' title: BeaconReportID example: becrpt_11111111111111 description: ID of the associated Beacon Report. PartnerEndCustomerBillingContact: description: The billing contact for the end customer. Defaults to partner's billing contact if omitted. type: object additionalProperties: true properties: given_name: type: string family_name: type: string email: type: string CreditSession: type: object description: Metadata and results for a Link session properties: link_session_id: type: string description: The unique identifier associated with the Link session. This identifier matches the `link_session_id` returned in the onSuccess/onExit callbacks. session_start_time: type: string description: The time when the Link session started format: date-time results: $ref: '#/components/schemas/CreditSessionResults' errors: type: array description: The set of errors that occurred during the Link session. items: $ref: '#/components/schemas/CreditSessionError' SandboxTransferTestClockCreateRequest: title: SandboxTransferTestClockCreateRequest type: object description: Defines the request schema for `/sandbox/transfer/test_clock/create` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' virtual_time: type: - string - 'null' title: VirtualTime format: date-time description: The virtual timestamp on the test clock. If not provided, the current timestamp will be used. This will be of the form `2006-01-02T15:04:05Z`. WalletTransactionAmount: title: WalletTransactionAmount type: object additionalProperties: true properties: iso_currency_code: $ref: '#/components/schemas/WalletISOCurrencyCode' value: type: number format: double minimum: 0.01 description: The amount of the transaction. Must contain at most two digits of precision e.g. `1.23`. required: - iso_currency_code - value description: The amount and currency of a transaction RiskCheckPhone: type: - object - 'null' description: Result summary object specifying values for `phone` attributes of risk check. properties: linked_services: description: A list of online services where this phone number has been detected to have accounts or other activity. type: array example: - facebook uniqueItems: true items: $ref: '#/components/schemas/RiskCheckLinkedService' required: - linked_services additionalProperties: true EntityScreeningHitDocumentsItems: type: object description: Analyzed documents for the associated hit properties: analysis: $ref: '#/components/schemas/MatchSummary' data: $ref: '#/components/schemas/EntityDocument' additionalProperties: true PaymentAmountRefunded: description: The amount and currency of a payment allOf: - $ref: '#/components/schemas/PaymentAmountNullable' - type: object additionalProperties: true description: The amount that has been refunded already. Subtract this from the payment amount to calculate the amount still available to refund. PaymentConsentPeriodicInterval: type: string description: Payment consent periodic interval. enum: - DAY - WEEK - MONTH - YEAR AssetReportAccountBalance: title: AssetReportAccountBalance type: object additionalProperties: true 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`. properties: available: type: - number - 'null' format: double description: 'The amount of funds available to be withdrawn from the account, as determined by the financial institution. For `credit`-type accounts, the `available` balance typically equals the `limit` less the `current` balance, less any pending outflows plus any pending inflows. For `depository`-type accounts, the `available` balance typically equals the `current` balance less any pending outflows plus any pending inflows. For `depository`-type accounts, the `available` balance does not include the overdraft limit. For `investment`-type accounts (or `brokerage`-type accounts for API versions 2018-05-22 and earlier), the `available` balance is the total cash available to withdraw as presented by the institution. Note that not all institutions calculate the `available` balance. In the event that `available` balance is unavailable, Plaid will return an `available` balance value of `null`. Available balance may be cached and is not guaranteed to be up-to-date in realtime unless the value was returned by `/accounts/balance/get`. If `current` is `null` this field is guaranteed not to be `null`.' current: type: - number - 'null' format: double description: 'The total amount of funds in or owed by the account. For `credit`-type accounts, a positive balance indicates the amount owed; a negative amount indicates the lender owing the account holder. For `loan`-type accounts, the current balance is the principal remaining on the loan, except in the case of student loan accounts at Sallie Mae (`ins_116944`). For Sallie Mae student loans, the account''s balance includes both principal and any outstanding interest. For `investment`-type accounts (or `brokerage`-type accounts for API versions 2018-05-22 and earlier), the current balance is the total value of assets as presented by the institution. Note that balance information may be cached unless the value was returned by `/accounts/balance/get`; if the Item is enabled for Transactions, the balance will be at least as recent as the most recent Transaction update. If you require realtime balance information, use the `available` balance as provided by `/accounts/balance/get`. When returned by `/accounts/balance/get`, this field may be `null`. When this happens, `available` is guaranteed not to be `null`.' limit: type: - number - 'null' format: double description: 'For `credit`-type accounts, this represents the credit limit. For `depository`-type accounts, this represents the pre-arranged overdraft limit, which is common for current (checking) accounts in Europe. In North America, this field is typically only available for `credit`-type accounts.' margin_loan_amount: type: - number - 'null' format: double description: 'The total amount of borrowed funds in the account, as determined by the financial institution. For investment-type accounts, the margin balance is the total value of borrowed assets in the account, as presented by the institution. This is commonly referred to as margin or a loan.' iso_currency_code: type: - string - 'null' description: The ISO-4217 currency code of the balance. Always null if `unofficial_currency_code` is non-null. unofficial_currency_code: type: - string - 'null' description: 'The unofficial currency code associated with the balance. Always null if `iso_currency_code` is non-null. Unofficial currency codes are used for currencies that do not have official ISO currency codes, such as cryptocurrencies and the currencies of certain countries. See the [currency code schema](https://plaid.com/docs/api/accounts#currency-code-schema) for a full listing of supported `unofficial_currency_code`s.' last_updated_datetime: type: - string - 'null' format: date-time description: 'Timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format (`YYYY-MM-DDTHH:mm:ssZ`) indicating the oldest acceptable balance when making a request to `/accounts/balance/get`. This field is only used and expected when the institution is `ins_128026` (Capital One) and the Item contains one or more accounts with a non-depository account type, in which case a value must be provided or an `INVALID_REQUEST` error with the code of `INVALID_FIELD` will be returned. For Capital One depository accounts as well as all other account types on all other institutions, this field is ignored. See [account type schema](https://en.wikipedia.org/wiki/ISO_8601) for a full list of account types. If the balance that is pulled is older than the given timestamp for Items with this field required, an `INVALID_REQUEST` error with the code of `LAST_UPDATED_DATETIME_OUT_OF_RANGE` will be returned with the most recent timestamp for the requested account contained in the response.' required: - available - current - limit - margin_loan_amount - iso_currency_code - unofficial_currency_code TransferRefundCreateResponse: title: TransferRefundCreateResponse type: object additionalProperties: true description: Defines the response schema for `/transfer/refund/create` properties: refund: $ref: '#/components/schemas/TransferRefund' request_id: $ref: '#/components/schemas/RequestID' required: - refund - request_id IdentityMatchUser: title: IdentityMatchUser type: object additionalProperties: true description: The user's legal name, phone number, email address and address used to perform fuzzy match. If Financial Account Matching is enabled in the Identity Verification product, leave this field empty to automatically match against PII collected from the Identity Verification checks. properties: legal_name: type: - string - 'null' description: The user's full legal name. phone_number: type: - string - 'null' description: 'The user''s phone number, in E.164 format: +{countrycode}{number}. For example: "+14151234567". Phone numbers provided in other formats will be parsed on a best-effort basis.' email_address: type: - string - 'null' description: The user's email address. address: $ref: '#/components/schemas/AddressDataNullableNoRequiredFields' TransferUserInRequestDeprecated: title: TransferUserInRequestDeprecated type: - object - 'null' description: The legal name and other information for the account holder. deprecated: true x-hidden-from-docs: true properties: legal_name: type: string description: The user's legal name. phone_number: type: string description: The user's phone number. email_address: type: string description: The user's email address. address: $ref: '#/components/schemas/TransferUserAddressInRequest' UTCOffset: type: - string - 'null' description: UTC offset of the timezone associated with the IP address. example: +06:00:00 CraBankIncomeCreateRequest: title: CraBankIncomeCreateRequest type: object description: CraBankIncomeCreateRequest defines the request schema for `/cra/bank_income/create`. properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' user_token: $ref: '#/components/schemas/UserToken' webhook: type: string description: 'The destination URL to which webhooks will be sent ' days_requested: type: integer description: The number of days of data to request for the Bank Income product minimum: 1 maximum: 731 consumer_report_permissible_purpose: $ref: '#/components/schemas/ConsumerReportPermissiblePurpose' BankTransferBalanceGetRequest: title: BankTransferBalanceGetRequest type: object description: Defines the request schema for `/bank_transfer/balance/get` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' origination_account_id: type: - string - 'null' description: If multiple origination accounts are available, `origination_account_id` must be used to specify the account for which balance will be returned. CreditBankIncomeWebhookUpdateRequest: title: CreditBankIncomeWebhookUpdateRequest type: object description: CreditBankIncomeWebhookUpdateRequest defines the request schema for `/credit/bank_income/webhook/update`. properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' user_token: $ref: '#/components/schemas/UserToken' enable_webhooks: description: Whether the user should be enabled for proactive webhook notifications when their income changes type: boolean required: - user_token - enable_webhooks SignalAddressData: title: AddressData type: - object - 'null' additionalProperties: true description: Data about the components comprising an address. properties: city: type: string description: The full city name region: type: - string - 'null' description: 'The region or state Example: `"NC"`' street: type: string description: 'The full street address Example: `"564 Main Street, APT 15"`' postal_code: type: - string - 'null' description: The postal code country: type: - string - 'null' description: The ISO 3166-1 alpha-2 country code SelfieStatus: type: string enum: - success - failed example: success description: An outcome status for this specific selfie. Distinct from the overall `selfie_check.status` that summarizes the verification outcome from one or more selfies. AssetOwners: title: AssetOwners type: object additionalProperties: true description: Documentation not found in the MISMO model viewer and not provided by Freddie Mac. properties: ASSET_OWNER: type: array items: $ref: '#/components/schemas/AssetOwner' description: Multiple Occurances of Account Owners Full Name up to 4. required: - ASSET_OWNER BankIncomeRefreshCompleteResult: type: string enum: - SUCCESS - FAILURE description: 'The result of the bank income refresh report generation `SUCCESS`: The refreshed report was successfully generated and can be retrieved via `/credit/bank_income/get`. `FAILURE`: The refreshed report failed to be generated' ProgramNameSensitivity: type: string enum: - coarse - balanced - strict - exact example: balanced description: 'The valid name matching sensitivity configurations for a screening program. Note that while certain matching techniques may be more prevalent on less strict settings, all matching algorithms are enabled for every sensitivity. `coarse` - See more potential matches. This sensitivity will see more broad phonetic matches across alphabets that make missing a potential hit very unlikely. This setting is noisier and will require more manual review. `balanced` - A good default for most companies. This sensitivity is balanced to show high quality hits with reduced noise. `strict` - Aggressive false positive reduction. This sensitivity will require names to be more similar than `coarse` and `balanced` settings, relying less on phonetics, while still accounting for character transpositions, missing tokens, and other common permutations. `exact` - Matches must be nearly exact. This sensitivity will only show hits with exact or nearly exact name matches with only basic correction such as extraneous symbols and capitalization. This setting is generally not recommended unless you have a very specific use case.' title: ProgramNameSensitivity WalletTransactionCounterpartyBACS: description: The account number and sort code of the counterparty's account allOf: - $ref: '#/components/schemas/RecipientBACS' - type: object additionalProperties: true TransferRecurringStatus: type: string title: TransferRecurringStatus description: 'The status of the recurring transfer. `active`: The recurring transfer is currently active. `cancelled`: The recurring transfer was cancelled by the client or Plaid. `expired`: The recurring transfer has completed all originations according to its recurring schedule.' enum: - active - cancelled - expired PayStubEarningsBreakdownCanonicalDescription: type: - string - 'null' description: Commonly used term to describe the earning line item. x-override-enum-values-shown: - BONUS - COMMISSION - OVERTIME - PAID_TIME_OFF - REGULAR_PAY - VACATION - BASIC_ALLOWANCE_HOUSING - BASIC_ALLOWANCE_SUBSISTENCE - OTHER - ALLOWANCE - BEREAVEMENT - HOLIDAY_PAY - JURY_DUTY - LEAVE - LONG_TERM_DISABILITY_PAY - MILITARY_PAY - PER_DIEM - REFERRAL_BONUS - REIMBURSEMENTS - RETENTION_BONUS - RETROACTIVE_PAY - SEVERANCE_PAY - SHIFT_DIFFERENTIAL - SHORT_TERM_DISABILITY_PAY - SICK_PAY - SIGNING_BONUS - TIPS_INCOME - null ItemApplicationScopesUpdateRequest: description: ItemApplicationScopesUpdateRequest defines the request schema for `/item/application/scopes/update` type: object properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' access_token: $ref: '#/components/schemas/AccessToken' application_id: $ref: '#/components/schemas/ApplicationID' scopes: $ref: '#/components/schemas/Scopes' state: $ref: '#/components/schemas/ScopesState' context: $ref: '#/components/schemas/ScopesContext' required: - application_id - access_token - scopes - context PaymentInitiationStandingOrderMetadata: title: PaymentInitiationStandingOrderMetadata type: - object - 'null' additionalProperties: true description: Metadata specifically related to valid Payment Initiation standing order configurations for the institution. properties: supports_standing_order_end_date: type: boolean description: Indicates whether the institution supports closed-ended standing orders by providing an end date. supports_standing_order_negative_execution_days: type: boolean description: This is only applicable to `MONTHLY` standing orders. Indicates whether the institution supports negative integers (-1 to -5) for setting up a `MONTHLY` standing order relative to the end of the month. valid_standing_order_intervals: type: array description: A list of the valid standing order intervals supported by the institution. items: $ref: '#/components/schemas/PaymentScheduleInterval' required: - supports_standing_order_end_date - supports_standing_order_negative_execution_days - valid_standing_order_intervals BankTransferCreateRequest: title: BankTransferCreateRequest type: object description: Defines the request schema for `/bank_transfer/create` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' idempotency_key: $ref: '#/components/schemas/BankTransferIdempotencyKey' access_token: $ref: '#/components/schemas/BankTransferAccessToken' account_id: type: string description: The Plaid `account_id` for the account that will be debited or credited. type: $ref: '#/components/schemas/BankTransferType' network: $ref: '#/components/schemas/BankTransferNetwork' amount: $ref: '#/components/schemas/BankTransferAmount' iso_currency_code: type: string description: The currency of the transfer amount – should be set to "USD". description: type: string description: The transfer description. Maximum of 10 characters. maxLength: 10 ach_class: $ref: '#/components/schemas/ACHClass' user: $ref: '#/components/schemas/BankTransferUser' custom_tag: type: - string - 'null' maxLength: 100 description: An arbitrary string provided by the client for storage with the bank transfer. May be up to 100 characters. metadata: $ref: '#/components/schemas/BankTransferMetadata' origination_account_id: type: - string - 'null' description: Plaid’s unique identifier for the origination account for this transfer. If you have more than one origination account, this value must be specified. Otherwise, this field should be left blank. required: - idempotency_key - access_token - account_id - type - network - amount - iso_currency_code - description - user TransferRefundGetRequest: title: TransferRefundGetRequest type: object description: Defines the request schema for `/transfer/refund/get` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' refund_id: $ref: '#/components/schemas/TransferRefundID' required: - refund_id IdentityVerificationCreateRequestUser: description: 'User information collected outside of Link, most likely via your own onboarding process. Each of the following identity fields are optional: `email_address` `phone_number` `date_of_birth` `name` `address` `id_number` Specifically, these fields are optional in that they can either be fully provided (satisfying every required field in their subschema) or omitted from the request entirely by not providing the key or value. Providing these fields via the API will result in Link skipping the data collection process for the associated user. All verification steps enabled in the associated Identity Verification Template will still be run. Verification steps will either be run immediately, or once the user completes the `accept_tos` step, depending on the value provided to the `gave_consent` field. If you are not using the shareable URL feature, you can optionally provide these fields via `/link/token/create` instead; both `/identity_verification/create` and `/link/token/create` are valid ways to provide this information. Note that if you provide a non-`null` user data object via `/identity_verification/create`, any user data fields entered via `/link/token/create` for the same `client_user_id` will be ignored when prefilling Link.' properties: email_address: $ref: '#/components/schemas/EmailAddress' phone_number: $ref: '#/components/schemas/IdentityVerificationUserPhoneNumber' date_of_birth: $ref: '#/components/schemas/ISO8601Date' name: $ref: '#/components/schemas/IdentityVerificationRequestUserName' address: $ref: '#/components/schemas/UserAddress' id_number: $ref: '#/components/schemas/UserIDNumber' client_user_id: $ref: '#/components/schemas/DeprecatedClientUserID' type: - object - 'null' IdentityVerificationAutofillAddress: description: 'Even if an address has been autofilled, some fields may be null depending on the region''s addressing system. For example: Addresses from the United Kingdom will not include a region Addresses from Hong Kong will not include postal code' type: - object - 'null' properties: street: $ref: '#/components/schemas/Street' street2: $ref: '#/components/schemas/Street2' city: $ref: '#/components/schemas/CityNullable' region: $ref: '#/components/schemas/Region' postal_code: $ref: '#/components/schemas/PostalCode' country: $ref: '#/components/schemas/GenericCountryCode' po_box: $ref: '#/components/schemas/POBoxStatus' type: $ref: '#/components/schemas/AddressPurposeLabel' required: - street - street2 - city - region - postal_code - country - po_box - type additionalProperties: true Taxform: title: Taxform type: object description: Data about an official document used to report the user's income to the IRS. additionalProperties: true properties: doc_id: type: string description: An identifier of the document referenced by the document metadata. document_type: type: string description: The type of tax document. Currently, the only supported value is `w2`. w2: $ref: '#/components/schemas/W2' required: - document_type DashboardUserListRequest: description: Request input for listing dashboard users type: object properties: secret: $ref: '#/components/schemas/APISecret' client_id: $ref: '#/components/schemas/APIClientID' cursor: $ref: '#/components/schemas/Cursor' TransactionsRecurringGetRequest: type: object description: TransactionsRecurringGetRequest defines the request schema for `/transactions/recurring/get` properties: client_id: $ref: '#/components/schemas/APIClientID' access_token: $ref: '#/components/schemas/AccessToken' secret: $ref: '#/components/schemas/APISecret' options: $ref: '#/components/schemas/TransactionsRecurringGetRequestOptions' account_ids: type: array description: 'An optional list of `account_ids` to retrieve for the Item. Retrieves all active accounts on item if no `account_id`s are provided. Note: An error will be returned if a provided `account_id` is not associated with the Item.' items: type: string required: - access_token LinkSessionSuccess: deprecated: true type: - object - 'null' description: An object representing an [onSuccess](https://plaid.com/docs/link/web/#onsuccess) callback from Link. properties: public_token: type: string description: Displayed once a user has successfully linked their Item. metadata: $ref: '#/components/schemas/LinkSessionSuccessMetadata' required: - public_token - metadata KYCCheckIDNumberSummary: description: Result summary object specifying how the `id_number` field matched. type: object properties: summary: $ref: '#/components/schemas/MatchSummaryCode' required: - summary additionalProperties: true PartnerCustomerRemoveResponse: description: Response schema for `/partner/customer/remove`. type: object additionalProperties: true properties: request_id: $ref: '#/components/schemas/RequestID' DocumentImage__Face: type: - string - 'null' example: https://example.plaid.com/verifications/idv_52xR9LKo77r1Np/documents/1/face.jpeg description: Temporary URL that expires after 60 seconds for downloading a crop of just the user's face from the document image. Might be null if the document does not contain a face photo. LinkEvent: type: object title: LinkEvent x-hidden-from-docs: true description: An event that occurred while the user was going through Link additionalProperties: true properties: event_name: type: string description: Event name timestamp: type: string description: Timestamp in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format. event_id: type: string description: UUID that can be used to deduplicate events event_metadata: $ref: '#/components/schemas/LinkEventMetadata' required: - event_id - timestamp - event_name - event_metadata TransferExpectedSweepSettlementScheduleItem: title: TransferExpectedSweepSettlementScheduleItem type: object additionalProperties: true description: Defines an expected sweep date and amount. properties: sweep_settlement_date: type: string description: The settlement date of a sweep for this transfer. format: date swept_settled_amount: type: string description: The accumulated amount that has been swept by `sweep_settlement_date`. required: - sweep_settlement_date - swept_settled_amount IncomeVerificationPrecheckEmployerAddress: title: IncomeVerificationPrecheckEmployerAddress description: The address of the employer type: - object - 'null' allOf: - $ref: '#/components/schemas/IncomeVerificationPrecheckEmployerAddressData' - type: object additionalProperties: true TransferIDForRefund: type: string title: TransferID description: The ID of the transfer to refund. WatchlistScreeningEntityUpdateRequestResettableFieldList: type: - array - 'null' items: $ref: '#/components/schemas/WatchlistScreeningEntityUpdateRequestResettableField' description: A list of fields to reset back to null TransferBalanceGetResponse: title: TransferBalanceGetResponse type: object additionalProperties: true description: Defines the response schema for `/transfer/balance/get` properties: balance: $ref: '#/components/schemas/TransferBalance' request_id: $ref: '#/components/schemas/RequestID' required: - balance - request_id IdentityVerificationTemplateReference: type: object properties: id: $ref: '#/components/schemas/IdentityVerificationTemplateID' version: $ref: '#/components/schemas/IdentityVerificationTemplateVersion' required: - id - version description: The resource ID and version number of the template configuring the behavior of a given Identity Verification. additionalProperties: true PartnerEndCustomerSecrets: description: The secrets for the newly created end customer in non-Production environments. type: object additionalProperties: true properties: sandbox: description: The end customer's secret key for the Sandbox environment. type: string development: description: The end customer's secret key for the Development environment. type: string SignalDevice: title: SignalEvaluateDevice type: object description: Details about the end user's device. When calling `/signal/evaluate` or `/signal/processor/evaluate`, this field is optional, but strongly recommended to increase the accuracy of Signal results. properties: ip_address: type: - string - 'null' description: The IP address of the device that initiated the transaction user_agent: type: - string - 'null' description: The user agent of the device that initiated the transaction (e.g. "Mozilla/5.0") PaymentInitiationConsentConstraints: type: object title: PaymentInitiationConsentConstraints description: Limitations that will be applied to payments initiated using the payment consent. properties: valid_date_time: $ref: '#/components/schemas/PaymentConsentValidDateTime' max_payment_amount: $ref: '#/components/schemas/PaymentConsentMaxPaymentAmount' periodic_amounts: type: array description: A list of amount limitations per period of time. minItems: 1 items: $ref: '#/components/schemas/PaymentConsentPeriodicAmount' required: - max_payment_amount - periodic_amounts InvestmentAccountSubtypes: title: InvestmentAccountSubtypes type: array description: 'An array of account subtypes to display in Link. If not specified, all account subtypes will be shown. For a full list of valid types and subtypes, see the [Account schema](https://plaid.com/docs/api/accounts#account-type-schema). ' items: $ref: '#/components/schemas/InvestmentAccountSubtype' PSLFStatus: title: PSLFStatus type: object additionalProperties: true 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`). ' properties: estimated_eligibility_date: type: - string - 'null' format: date description: The estimated date borrower will have completed 120 qualifying monthly payments. Returned in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format (YYYY-MM-DD). payments_made: type: - integer - 'null' description: The number of qualifying payments that have been made. payments_remaining: type: - integer - 'null' description: The number of qualifying payments remaining. required: - estimated_eligibility_date - payments_made - payments_remaining TransferTestClockID: type: string title: TransferTestClockID description: Plaid’s unique identifier for a test clock. TransferIntentStatus: type: string enum: - PENDING - SUCCEEDED - FAILED description: 'The status of the transfer intent. `PENDING`: The transfer intent is pending. `SUCCEEDED`: The transfer intent was successfully created. `FAILED`: The transfer intent was unable to be created.' CraLoanPaymentSchedule: type: string description: 'The frequency of a loan''s payment schedule. `BIWEEKLY` represents one payment every two weeks.' enum: - DAILY - WEEKLY - BIWEEKLY - MONTHLY - QUARTERLY - ANNUALLY - OTHER TransactionsRuleField: title: TransactionsRuleField type: string enum: - TRANSACTION_ID - NAME description: Transaction field for which the rule is defined. Wallet: title: Wallet type: object additionalProperties: true description: An object representing the e-wallet properties: wallet_id: type: string description: A unique ID identifying the e-wallet balance: $ref: '#/components/schemas/WalletBalance' numbers: $ref: '#/components/schemas/WalletNumbers' recipient_id: type: string description: The ID of the recipient that corresponds to the e-wallet account numbers status: $ref: '#/components/schemas/WalletStatus' required: - wallet_id - balance - numbers - status IdentityVerificationListRequest: description: Request input for listing Identity Verifications type: object properties: secret: $ref: '#/components/schemas/APISecret' client_id: $ref: '#/components/schemas/APIClientID' template_id: $ref: '#/components/schemas/IdentityVerificationTemplateID' client_user_id: $ref: '#/components/schemas/ClientUserID' cursor: $ref: '#/components/schemas/Cursor' required: - template_id - client_user_id PhysicalDocumentIDNumber: type: - string - 'null' description: Alpha-numeric ID number extracted via OCR from the user's document image. example: AB123456 ProcessorSignalReturnReportRequest: title: ProcessorSignalReturnReportRequest description: ProcessorSignalReturnReportRequest defines the request schema for `/processor/signal/return/report` type: object properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' processor_token: $ref: '#/components/schemas/ProcessorToken' client_transaction_id: type: string description: Must be the same as the `client_transaction_id` supplied when calling `/processor/signal/evaluate` minLength: 1 maxLength: 36 return_code: type: string description: 'Must be a valid ACH return code (e.g. "R01") If formatted incorrectly, this will result in an [`INVALID_FIELD`](/docs/errors/invalid-request/#invalid_field) error.' returned_at: type: - string - 'null' format: date-time description: Date and time when you receive the returns from your payment processors, in ISO 8601 format (`YYYY-MM-DDTHH:mm:ssZ`). required: - processor_token - client_transaction_id - return_code TransactionsRulesRemoveRequest: type: object description: TransactionsRulesRemoveRequest defines the request schema for `/beta/transactions/rules/v1/remove` properties: client_id: $ref: '#/components/schemas/APIClientID' access_token: $ref: '#/components/schemas/AccessToken' secret: $ref: '#/components/schemas/APISecret' rule_id: type: string description: A rule's unique identifier required: - access_token - rule_id CountryCode: type: string title: CountryCode enum: - US - GB - ES - NL - FR - IE - CA - DE - IT - PL - DK - 'NO' - SE - EE - LT - LV - PT - BE description: ISO-3166-1 alpha-2 country code standard. CreditBankEmploymentWarningType: type: string description: The warning type which will always be `BANK_EMPLOYMENT_WARNING`. enum: - BANK_EMPLOYMENT_WARNING TransferOriginatorCreateResponse: title: TransferOriginatorCreateResponse type: object additionalProperties: true description: Defines the response schema for `/transfer/originator/create` properties: originator_client_id: type: string description: Client ID of the originator. This identifier will be used when creating transfers and should be stored associated with end user information. company_name: type: string description: The company name of the end customer. request_id: $ref: '#/components/schemas/RequestID' required: - originator_client_id - company_name - request_id CraLoanStatusHistoryUpdate: type: object description: Contains the status and date of an update to the loan. additionalProperties: true properties: status: $ref: '#/components/schemas/CraLoanStatus' date: $ref: '#/components/schemas/CraLoanStatusEffectiveDate' required: - status - date TransactionCode: type: - string - 'null' title: transaction_code description: '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 `null`. `adjustment:` Bank adjustment `atm:` Cash deposit or withdrawal via an automated teller machine `bank charge:` Charge or fee levied by the institution `bill payment`: Payment of a bill `cash:` Cash deposit or withdrawal `cashback:` Cash withdrawal while making a debit card purchase `cheque:` Document ordering the payment of money to another person or organization `direct debit:` Automatic withdrawal of funds initiated by a third party at a regular interval `interest:` Interest earned or incurred `purchase:` Purchase made with a debit or credit card `standing order:` Payment instructed by the account holder to a third party at a regular interval `transfer:` Transfer of money between accounts' enum: - adjustment - atm - bank charge - bill payment - cash - cashback - cheque - direct debit - interest - purchase - standing order - transfer - null ItemApplicationUnlinkRequest: description: ItemApplicationUnlinkRequest defines the request schema for `/item/application/unlink/` type: object properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' access_token: $ref: '#/components/schemas/AccessToken' application_id: $ref: '#/components/schemas/ApplicationID' required: - application_id - access_token ProcessorTransactionsSyncRequest: type: object description: ProcessorTransactionsSyncRequest defines the request schema for `/processor/transactions/sync` properties: client_id: $ref: '#/components/schemas/APIClientID' processor_token: $ref: '#/components/schemas/ProcessorToken' secret: $ref: '#/components/schemas/APISecret' cursor: type: string description: 'The cursor value represents the last update requested. Providing it will cause the response to only return changes after this update. If omitted, the entire history of updates will be returned, starting with the first-added transactions on the item. Note: The upper-bound length of this cursor is 256 characters of base64.' count: type: integer default: 100 description: The number of transaction updates to fetch. minimum: 1 maximum: 500 options: $ref: '#/components/schemas/TransactionsSyncRequestOptions' required: - processor_token SourceUID: description: The identifier provided by the source sanction or watchlist. When one is not provided by the source, this is `null`. type: - string - 'null' minLength: 1 example: 26192ABC TransferRecurringSchedule: title: TransferRecurringSchedule type: object description: The schedule that the recurring transfer will be executed on. properties: interval_unit: $ref: '#/components/schemas/TransferScheduleIntervalUnit' interval_count: $ref: '#/components/schemas/TransferScheduleIntervalCount' interval_execution_day: description: 'The day of the interval on which to schedule the transfer. If the `interval_unit` is `week`, `interval_execution_day` should be an integer from 1 (Monday) to 5 (Friday). If the `interval_unit` is `month`, `interval_execution_day` should be an integer indicating which day of the month to make the transfer on. Integers from 1 to 28 can be used to make a transfer on that day of the month. Negative integers from -1 to -5 can be used to make a transfer relative to the end of the month. To make a transfer on the last day of the month, use -1; to make the transfer on the second-to-last day, use -2, and so on. The transfer will be originated on the next available banking day if the designated day is a non banking day.' type: integer start_date: format: date type: string description: 'A date in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format (YYYY-MM-DD). The recurring transfer will begin on the first `interval_execution_day` on or after the `start_date`. For `rtp` recurring transfers, `start_date` must be in the future. Otherwise, if the first `interval_execution_day` on or after the start date is also the same day that `/transfer/recurring/create` was called, the bank *may* make the first payment on that day, but it is not guaranteed to do so.' end_date: format: date type: - string - 'null' description: 'A date in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format (YYYY-MM-DD). The recurring transfer will end on the last `interval_execution_day` on or before the `end_date`. If the `interval_execution_day` between the start date and the end date (inclusive) is also the same day that `/transfer/recurring/create` was called, the bank *may* make a payment on that day, but it is not guaranteed to do so.' required: - interval_unit - interval_count - interval_execution_day - start_date CreditFreddieMacReportsGetRequest: title: CreditFreddieMacReportsGetRequest type: object description: CreditFreddieMacReportsGetRequest defines the request schema for `credit/asset_report/freddie_mac/get` properties: audit_copy_token: type: string description: A token that can be shared with a third party auditor to allow them to obtain access to the Asset Report. This token should be stored securely. client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' required: - audit_copy_token AssetTransactionCategoryType: title: AssetTransactionCategoryType type: - string - 'null' description: Asset Transaction Category Type Enumerated derived by Vendor. enum: - ATMFee - Advertising - AirTravel - AlcoholBars - Allowance - Amusement - Arts - AutoTransport - AutoInsurance - AutoPayment - BabySupplies - BabysitterDaycare - BankFee - BillsUtilities - Bonus - BooksSupplies - Business Services - Buy - CashATM - Charity - Check - ChildSupport - Clothing - CoffeeShops - CreditCardPayment - Dentist - Doctor - Education - ElectronicsSoftware - Entertainment - Eyecare - FastFood - FederalTax - FeesCharges - FinanceCharge - Financial - FinancialAdvisor - FoodDining - Furnishings - GasFuel - GiftsDonations - Groceries - Gym - Hair - HealthFitness - HealthInsurance - Hobbies - Home - HomeImprovement - HomeInsurance - HomePhone - HomeServices - HomeSupplies - Hotel - Income - InterestIncome - Internet - Investments - Kids - KidsActivities - LateFee - Laundry - LawnGarden - Legal - LifeInsurance - LoanInsurance - LoanPayment - Loans - MobilePhone - MortgageRent - MoviesDVDs - Music - NewspapersMagazines - OfficeSupplies - Parking - Paycheck - PersonalCare - PetFoodSupplies - PetGrooming - Pets - Pharmacy - Printing - Property Tax - Public Transportation - Reimbursement - RentalCarTaxi - Restaurants - SalesTax - ServiceParts - ServiceFee - Shipping - Shopping - SpaMassage - SportingGoods - Sports - StateTax - Student Loan - Taxes - Television - Toys - Transfer - Travel - Tuition - Uncategorized - Utilities - Vacation - Veterinary PartnerEndCustomerAddress: description: The end customer's address. type: object additionalProperties: true properties: city: type: string street: type: string region: type: string postal_code: type: string country_code: description: ISO-3166-1 alpha-2 country code standard. type: string BeaconUserGetRequest: description: Request input for fetching a Beacon User type: object properties: beacon_user_id: $ref: '#/components/schemas/BeaconUserID' client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' required: - beacon_user_id WatchlistScreeningReview: title: WatchlistScreeningReview type: object description: 'A review submitted by a team member for an individual watchlist screening. A review can be either a comment on the current screening state, actions taken against hits attached to the watchlist screening, or both.' properties: id: $ref: '#/components/schemas/WatchlistScreeningReviewID' confirmed_hits: type: array description: Hits marked as a true positive after thorough manual review. These hits will never recur or be updated once dismissed. In most cases, confirmed hits indicate that the customer should be rejected. items: $ref: '#/components/schemas/WatchlistScreeningHitID' dismissed_hits: type: array description: Hits marked as a false positive after thorough manual review. These hits will never recur or be updated once dismissed. items: $ref: '#/components/schemas/WatchlistScreeningHitID' comment: $ref: '#/components/schemas/ReviewComment' audit_trail: $ref: '#/components/schemas/WatchlistScreeningAuditTrail' required: - id - confirmed_hits - dismissed_hits - comment - audit_trail additionalProperties: true TransferLedgerGetRequest: title: TransferLedgerGetRequest type: object description: Defines the request schema for `/transfer/ledger/get` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' originator_client_id: type: - string - 'null' description: Client ID of the end customer. PartyIndividual: title: INDIVIDUAL type: object additionalProperties: true description: Documentation not found in the MISMO model viewer and not provided by Freddie Mac. properties: NAME: $ref: '#/components/schemas/IndividualName' required: - NAME AuthMetadata: title: AuthMetadata type: - object - 'null' additionalProperties: true description: Metadata that captures information about the Auth features of an institution. properties: supported_methods: $ref: '#/components/schemas/AuthSupportedMethods' required: - supported_methods AssetReportAuditCopyGetRequest: title: AssetReportAuditCopyGetRequest type: object description: AssetReportAuditCopyGetRequest defines the request schema for `/asset_report/audit_copy/get` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' audit_copy_token: type: string description: The `audit_copy_token` granting access to the Audit Copy you would like to get. required: - audit_copy_token HistoricalBalance: title: HistoricalBalance type: object additionalProperties: true description: An object representing a balance held by an account in the past properties: date: type: string format: date description: The date of the calculated historical balance, in an [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format (YYYY-MM-DD) current: type: number format: double description: 'The total amount of funds in the account, calculated from the `current` balance in the `balance` object by subtracting inflows and adding back outflows according to the posted date of each transaction. If the account has any pending transactions, historical balance amounts on or after the date of the earliest pending transaction may differ if retrieved in subsequent Asset Reports as a result of those pending transactions posting.' iso_currency_code: type: - string - 'null' description: The ISO-4217 currency code of the balance. Always `null` if `unofficial_currency_code` is non-`null`. unofficial_currency_code: type: - string - 'null' description: 'The unofficial currency code associated with the balance. Always `null` if `iso_currency_code` is non-`null`. See the [currency code schema](https://plaid.com/docs/api/accounts#currency-code-schema) for a full listing of supported `unofficial_currency_code`s.' required: - date - current - iso_currency_code - unofficial_currency_code ProcessorSignalDecisionReportRequest: title: ProcessorSignalDecisionReportRequest description: ProcessorSignalDecisionReportRequest defines the request schema for `/processor/signal/decision/report` type: object properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' processor_token: $ref: '#/components/schemas/ProcessorToken' client_transaction_id: type: string description: Must be the same as the `client_transaction_id` supplied when calling `/signal/evaluate` minLength: 1 maxLength: 36 initiated: type: boolean description: '`true` if the ACH transaction was initiated, `false` otherwise. This field must be returned as a boolean. If formatted incorrectly, this will result in an [`INVALID_FIELD`](/docs/errors/invalid-request/#invalid_field) error.' days_funds_on_hold: type: - integer - 'null' description: 'The actual number of days (hold time) since the ACH debit transaction that you wait before making funds available to your customers. The holding time could affect the ACH return rate. For example, use 0 if you make funds available to your customers instantly or the same day following the debit transaction, or 1 if you make funds available the next day following the debit initialization.' minimum: 0 decision_outcome: $ref: '#/components/schemas/SignalDecisionOutcome' payment_method: $ref: '#/components/schemas/SignalPaymentMethod' amount_instantly_available: type: - number - 'null' format: double description: 'The amount (in USD) made available to your customers instantly following the debit transaction. It could be a partial amount of the requested transaction (example: 102.05).' required: - processor_token - client_transaction_id - initiated PersonalFinanceCategory: title: PersonalFinanceCategory type: - object - 'null' additionalProperties: true 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`](https://plaid.com/documents/transactions-personal-finance-category-taxonomy.csv) 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`](https://plaid.com/docs/transactions/pfc-migration/).' properties: primary: type: string description: A high level category that communicates the broad category of the transaction. detailed: type: string description: A granular category conveying the transaction's intent. This field can also be used as a unique identifier for the category. confidence_level: type: - string - 'null' description: 'A description of how confident we are that the provided categories accurately describe the transaction intent. `VERY_HIGH`: We are more than 98% confident that this category reflects the intent of the transaction. `HIGH`: We are more than 90% confident that this category reflects the intent of the transaction. `MEDIUM`: We are moderately confident that this category reflects the intent of the transaction. `LOW`: This category may reflect the intent, but there may be other categories that are more accurate. `UNKNOWN`: We don’t know the confidence level for this category.' required: - primary - detailed SignalPrepareRequest: title: SignalPrepareRequest description: SignalPrepareRequest defines the request schema for `/signal/prepare` type: object properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' access_token: $ref: '#/components/schemas/AccessToken' required: - access_token TransferQuestionnaireCreateRequest: title: TransferQuestionnaireCreateRequest type: object description: Defines the request schema for `/transfer/questionnaire/create` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' originator_client_id: type: string description: Client ID of the end customer. redirect_uri: type: string description: URL the end customer will be redirected to after completing questions in Plaid-hosted onboarding flow. required: - originator_client_id - redirect_uri RemovedTransaction: title: RemovedTransaction type: object additionalProperties: true description: A representation of a removed transaction x-examples: {} properties: transaction_id: type: string description: The ID of the removed transaction. account_id: type: string description: The ID of the account of the removed transaction. required: - transaction_id - account_id MultiDocumentRiskSignal: title: MultiDocumentRiskSignal type: object additionalProperties: true description: Object containing risk signals and relevant metadata for a set of uploaded documents properties: document_references: type: array description: Array of objects containing attributes that could indicate if a document is fraudulent items: $ref: '#/components/schemas/RiskSignalDocumentReference' risk_signals: type: array description: Array of attributes that indicate whether or not there is fraud risk with a set of documents items: $ref: '#/components/schemas/DocumentRiskSignal' required: - document_references - risk_signals TransferAuthorizationRiskLevel: type: - string - 'null' description: Comprises five risk categories (high risk, medium-high risk, medium risk, medium-low risk, low risk) based on the probability of return enum: - HIGH_RISK - MEDIUM_HIGH_RISK - MEDIUM_RISK - MEDIUM_LOW_RISK - LOW_RISK TransferListRequest: title: TransferListRequest type: object description: Defines the request schema for `/transfer/list` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' start_date: type: - string - 'null' format: date-time description: The start datetime of transfers to list. This should be in RFC 3339 format (i.e. `2019-12-06T22:35:49Z`) end_date: type: - string - 'null' format: date-time description: The end datetime of transfers to list. This should be in RFC 3339 format (i.e. `2019-12-06T22:35:49Z`) count: type: integer minimum: 1 maximum: 25 default: 25 description: The maximum number of transfers to return. offset: type: integer default: 0 minimum: 0 description: The number of transfers to skip before returning results. origination_account_id: type: - string - 'null' description: Filter transfers to only those originated through the specified origination account. deprecated: true x-hidden-from-docs: true originator_client_id: type: - string - 'null' description: Filter transfers to only those with the specified originator client. funding_account_id: type: - string - 'null' description: Filter transfers to only those with the specified `funding_account_id`. TransferOriginatorGetResponse: title: TransferOriginatorGetResponse type: object additionalProperties: true description: Defines the response schema for `/transfer/originator/get` properties: originator: $ref: '#/components/schemas/DetailedOriginator' request_id: $ref: '#/components/schemas/RequestID' required: - originator - request_id CreditPayrollIncomeRefreshRequestOptions: description: An optional object for `/credit/payroll_income/refresh` request options. type: object properties: item_ids: type: array items: type: string description: An array of `item_id`s to be refreshed. Each `item_id` should uniquely identify a payroll income item. If this field is not provided, all `item_id`s associated with the `user_token` will be refreshed. webhook: type: string description: The URL where Plaid will send the payroll income refresh webhook. TransferNetwork: type: string title: TransferNetwork description: 'The network or rails used for the transfer. For transfers submitted as `ach`, the next-day cutoff is 5:30 PM Eastern Time. For transfers submitted as `same-day-ach`, the same-day cutoff is 3:30 PM Eastern Time. If the transfer is submitted after this cutoff but before the next-day cutoff, it will be sent over next-day rails and will not incur same-day charges; this will apply to both legs of the transfer if applicable. For transfers submitted as `rtp`, Plaid will automatically route between Real Time Payment rail by TCH or FedNow rails as necessary. If a transfer is submitted as `rtp` and the counterparty account is not eligible for RTP, the `/transfer/authorization/create` request will fail with an `INVALID_FIELD` error code. To pre-check to determine whether a counterparty account can support RTP, call `/transfer/capabilities/get` before calling `/transfer/authorization/create`.' enum: - ach - same-day-ach - rtp - wire SignalUser: title: SignalUser type: object description: Details about the end user initiating the transaction (i.e., the account holder). When calling `/signal/evaluate` or `/signal/processor/evaluate`, this field is optional, but strongly recommended to increase the accuracy of Signal results. properties: name: $ref: '#/components/schemas/SignalPersonName' phone_number: type: - string - 'null' description: 'The user''s phone number, in E.164 format: +{countrycode}{number}. For example: "+14151234567"' email_address: type: - string - 'null' description: The user's email address. address: $ref: '#/components/schemas/SignalAddressData' CreditRelayRefreshRequest: type: object description: CreditRelayRefreshRequest defines the request schema for `/credit/relay/refresh` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' relay_token: type: string description: The `relay_token` granting access to the report you would like to refresh. report_type: $ref: '#/components/schemas/ReportType' webhook: type: - string - 'null' description: The URL registered to receive webhooks when the report of a relay token has been refreshed. required: - relay_token - report_type LinkTokenCreateIdentity: type: object description: Identity object used to specify document upload properties: is_document_upload: type: boolean description: Used to specify whether the Link session is Identity Document Upload account_ids: type: array description: An array of `account_ids` items: type: string ItemId: title: ItemId type: string description: The `item_id` of the Item associated with this webhook, warning, or error BeaconReportGetRequest: description: Request input for getting a Beacon Report type: object properties: beacon_report_id: $ref: '#/components/schemas/BeaconReportID' client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' required: - beacon_report_id TransferOriginatorGetRequest: title: TransferOriginatorGetRequest type: object description: Defines the request schema for `/transfer/originator/get` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' originator_client_id: type: string description: Client ID of the end customer (i.e. the originator). required: - originator_client_id LinkSessionExitMetadata: type: - object - 'null' description: Displayed if a user exits Link without successfully linking an Item. properties: institution: $ref: '#/components/schemas/LinkSessionExitMetadataInstitution' status: type: string description: The point at which the user exited the Link flow. One of the following values. properties: requires_questions: description: User prompted to answer security questions requires_selections: description: User prompted to answer multiple choice question(s) requires_code: description: User prompted to provide a one-time passcode choose_device: description: User prompted to select a device on which to receive a one-time passcode requires_credentials: description: User prompted to provide credentials for the selected financial institution or has not yet selected a financial institution requires_account_selection: description: User prompted to select one or more financial accounts to share requires_oauth: description: User prompted to enter an OAuth flow institution_not_found: description: User exited the Link flow after unsuccessfully (no results returned) searching for a financial institution institution_not_supported: description: User exited the Link flow after discovering their selected institution is no longer supported by Plaid link_session_id: type: string description: A unique identifier associated with a user's actions and events through the Link flow. Include this identifier when opening a support ticket for faster turnaround. request_id: type: string description: The request ID for the last request made by Link. This can be shared with Plaid Support to expedite investigation. TransferEventType: type: string title: TransferEventType description: 'The type of event that this transfer represents. Event types with prefix `sweep` represents events for Plaid Ledger sweeps. `pending`: A new transfer was created; it is in the pending state. `cancelled`: The transfer was cancelled by the client. `failed`: The transfer failed, no funds were moved. `posted`: The transfer has been successfully submitted to the payment network. `settled`: Credits are available to be withdrawn or debits have been deducted from the Plaid linked account. `funds_available`: Funds from the transfer have been released from hold and applied to the ledger''s available balance. (Only applicable to ACH debits.) `returned`: A posted transfer was returned. `swept`: The transfer was swept to / from the sweep account. `swept_settled`: Credits are available to be withdrawn or debits have been deducted from the customer’s business checking account. `return_swept`: Due to the transfer being returned, funds were pulled from or pushed back to the sweep account. `sweep.pending`: A new ledger sweep was created; it is in the pending state. `sweep.posted`: The ledger sweep has been successfully submitted to the payment network. `sweep.settled`: The transaction has settled in the funding account. This means that funds withdrawn from Plaid Ledger balance have reached the funding account, or funds to be deposited into the Plaid Ledger Balance have been pulled, and the hold period has begun. `sweep.returned`: A posted ledger sweep was returned. `sweep.failed`: The ledger sweep failed, no funds were moved. `refund.pending`: A new refund was created; it is in the pending state. `refund.cancelled`: The refund was cancelled. `refund.failed`: The refund failed, no funds were moved. `refund.posted`: The refund has been successfully submitted to the payment network. `refund.settled`: The refund transaction has settled in the Plaid linked account. `refund.returned`: A posted refund was returned. `refund.swept`: The refund was swept from the sweep account. `refund.return_swept`: Due to the refund being returned, funds were pushed back to the sweep account.' enum: - pending - cancelled - failed - posted - settled - funds_available - returned - swept - swept_settled - return_swept - sweep.pending - sweep.posted - sweep.settled - sweep.returned - sweep.failed AssetReportTokenNullable: title: AssetReportTokenNullable type: string description: A token that can be provided to endpoints such as `/asset_report/get` or `/asset_report/pdf/get` to fetch or update an Asset Report. BankTransferMetadata: type: - object - 'null' additionalProperties: type: string title: BankTransferMetadata maxProperties: 50 description: 'The Metadata object is a mapping of client-provided string fields to any string value. The following limitations apply: The JSON values must be Strings (no nested JSON objects allowed) Only ASCII characters may be used Maximum of 50 key/value pairs Maximum key length of 40 characters Maximum value length of 500 characters ' CreditBankStatementUploadObject: title: CreditBankStatementUploadObject type: object additionalProperties: true description: An object containing data that has been parsed from a user-uploaded bank statement. properties: transactions: type: array description: An array of transactions appearing on the bank statement. items: $ref: '#/components/schemas/CreditBankStatementUploadTransaction' document_metadata: $ref: '#/components/schemas/CreditDocumentMetadata' document_id: type: - string - 'null' description: An identifier of the document referenced by the document metadata. bank_accounts: type: array description: An array of bank accounts associated with the uploaded bank statement. items: $ref: '#/components/schemas/CreditBankStatementUploadBankAccount' required: - transactions - document_metadata - document_id - bank_accounts HostedLinkCompletionRedirectURI: type: string description: 'URI that Hosted Link will redirect to upon completion of the Link flow. This will only occur in Hosted Link sessions, not in other implementation methods. ' TransferOriginatorFundingAccountUpdateRequest: title: TransferOriginatorFundingAccountUpdateRequest type: object description: Defines the request schema for `/transfer/originator/funding_account/update` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' originator_client_id: type: string description: The Plaid client ID of the transfer originator. funding_account: $ref: '#/components/schemas/TransferFundingAccount' required: - funding_account - originator_client_id AssetReportInvestments: title: AssetReportInvestments type: object additionalProperties: true description: A transaction within an investment account. properties: investment_transaction_id: type: string description: The ID of the Investment transaction, unique across all Plaid transactions. Like all Plaid identifiers, the `investment_transaction_id` is case sensitive. account_id: type: string description: The `account_id` of the account against which this transaction posted. security_id: type: - string - 'null' description: The `security_id` to which this transaction is related. date: type: string format: date description: The [ISO 8601](https://wikipedia.org/wiki/ISO_8601) posting date for the transaction. name: type: string description: The institution’s description of the transaction. quantity: type: number format: double description: The number of units of the security involved in this transaction. Positive for buy transactions; negative for sell transactions. vested_quantity: type: number format: double description: The total quantity of vested assets held, as reported by the financial institution. Vested assets are only associated with [equities](https://plaid.com/docs/api/products/investments/#investments-holdings-get-response-securities-type). vested_value: type: number format: double description: The value of the vested holdings as reported by the institution. amount: description: 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. type: number format: double price: description: The price of the security at which this transaction occurred. type: number format: double fees: type: - number - 'null' format: double description: The combined value of all fees applied to this transaction type: $ref: '#/components/schemas/InvestmentTransactionType' subtype: $ref: '#/components/schemas/InvestmentTransactionSubtype' iso_currency_code: type: - string - 'null' description: The ISO-4217 currency code of the transaction. Always `null` if `unofficial_currency_code` is non-`null`. unofficial_currency_code: type: - string - 'null' description: 'The unofficial currency code associated with the holding. Always `null` if `iso_currency_code` is non-`null`. Unofficial currency codes are used for currencies that do not have official ISO currency codes, such as cryptocurrencies and the currencies of certain countries. See the [currency code schema](https://plaid.com/docs/api/accounts#currency-code-schema) for a full listing of supported `iso_currency_code`s.' required: - investment_transaction_id - account_id - security_id - date - name - quantity - vested_quantity - vested_value - amount - price - fees - type - subtype - iso_currency_code - unofficial_currency_code BeaconReportListRequest: description: Request input for listing Beacon Reports type: object properties: beacon_user_id: $ref: '#/components/schemas/BeaconUserID' cursor: $ref: '#/components/schemas/Cursor' client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' required: - beacon_user_id Asset: title: Asset type: object additionalProperties: true description: Documentation not found in the MISMO model viewer and not provided by Freddie Mac. properties: ASSET_DETAIL: $ref: '#/components/schemas/AssetDetail' ASSET_OWNERS: $ref: '#/components/schemas/AssetOwners' ASSET_HOLDER: $ref: '#/components/schemas/AssetHolder' ASSET_TRANSACTIONS: $ref: '#/components/schemas/AssetTransactions' VALIDATION_SOURCES: $ref: '#/components/schemas/ValidationSources' required: - ASSET_DETAIL - ASSET_OWNERS - ASSET_HOLDER - ASSET_TRANSACTIONS - VALIDATION_SOURCES GenericScreeningHitLocationItems: type: object description: Analyzed location information for the associated hit properties: analysis: $ref: '#/components/schemas/MatchSummary' data: $ref: '#/components/schemas/WatchlistScreeningHitLocations' additionalProperties: true CreditPayStubNetPay: title: CreditPayStubNetPay type: object description: An object representing information about the net pay amount on the pay stub. additionalProperties: true properties: current_amount: type: - number - 'null' format: double description: Raw amount of the net pay for the pay period. description: type: - string - 'null' description: Description of the net pay. iso_currency_code: type: - string - 'null' description: The ISO-4217 currency code of the net pay. Always `null` if `unofficial_currency_code` is non-null. unofficial_currency_code: type: - string - 'null' description: 'The unofficial currency code associated with the net pay. Always `null` if `iso_currency_code` is non-`null`. Unofficial currency codes are used for currencies that do not have official ISO currency codes, such as cryptocurrencies and the currencies of certain countries. See the [currency code schema](https://plaid.com/docs/api/accounts#currency-code-schema) for a full listing of supported `iso_currency_code`s.' ytd_amount: type: - number - 'null' format: double description: The year-to-date amount of the net pay. required: - current_amount - description - iso_currency_code - unofficial_currency_code - ytd_amount WatchlistScreeningIndividualListResponse: description: Paginated list of individual watchlist screenings. additionalProperties: true properties: watchlist_screenings: description: List of individual watchlist screenings type: array items: $ref: '#/components/schemas/WatchlistScreeningIndividual' next_cursor: $ref: '#/components/schemas/Cursor' request_id: $ref: '#/components/schemas/RequestID' required: - watchlist_screenings - next_cursor - request_id type: object EnrichTransactionDirection: title: EnrichTransactionDirection type: string enum: - INFLOW - OUTFLOW description: 'The direction of the transaction from the perspective of the account holder: `OUTFLOW` - Includes outgoing transfers, purchases, and fees. (Typically represented as a negative value on checking accounts and debit cards and a positive value on credit cards.) `INFLOW` - Includes incoming transfers, refunds, and income. (Typically represented as a positive value on checking accounts and debit cards and a negative value on credit cards.)' IPAddress: description: An IPv4 or IPV6 address. type: - string - 'null' example: 192.0.2.42 title: IPAddress TotalCanonicalDescription: type: - string - 'null' description: Commonly used term to describe the line item. enum: - BONUS - COMMISSION - OVERTIME - PAID TIME OFF - REGULAR PAY - VACATION - EMPLOYEE MEDICARE - FICA - SOCIAL SECURITY EMPLOYEE TAX - MEDICAL - VISION - DENTAL - NET PAY - TAXES - NOT_FOUND - OTHER - null Strategy: description: 'An instruction specifying what steps the new Identity Verification attempt should require the user to complete: `reset` - Restart the user at the beginning of the session, regardless of whether they successfully completed part of their previous session. `incomplete` - Start the new session at the step that the user failed in the previous session, skipping steps that have already been successfully completed. `infer` - If the most recent Identity Verification attempt associated with the given `client_user_id` has a status of `failed` or `expired`, retry using the `incomplete` strategy. Otherwise, use the `reset` strategy. `custom` - Start the new session with a custom configuration, specified by the value of the `steps` field Note: The `incomplete` strategy cannot be applied if the session''s failing step is `screening` or `risk_check`. The `infer` strategy cannot be applied if the session''s status is still `active`' type: string enum: - reset - incomplete - infer - custom SandboxTransferLedgerSimulateAvailableRequest: title: SandboxTransferLedgerSimulateAvailableRequest type: object description: Defines the request schema for `/sandbox/transfer/ledger/simulate_available` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' test_clock_id: type: - string - 'null' description: Plaid’s unique identifier for a test clock. If provided, only the pending balance that is due before the `virtual_timestamp` on the test clock will be converted. PartnerCustomerOAuthInstitutionsGetResponse: description: Response schema for `/partner/customer/oauth_institutions/get`. type: object additionalProperties: true properties: flowdown_status: $ref: '#/components/schemas/PartnerEndCustomerFlowdownStatus' questionnaire_status: $ref: '#/components/schemas/PartnerEndCustomerQuestionnaireStatus' institutions: type: array description: The OAuth institutions with which the end customer's application is being registered. items: $ref: '#/components/schemas/PartnerEndCustomerOAuthInstitution' request_id: $ref: '#/components/schemas/RequestID' DocumentRiskSignalsObject: title: DocumentRiskSignalsObject type: object additionalProperties: true description: Object containing fraud risk data for a set of income documents. properties: account_id: type: - string - 'null' description: ID of the payroll provider account. single_document_risk_signals: type: array description: Array of document metadata and associated risk signals per document items: $ref: '#/components/schemas/SingleDocumentRiskSignal' multi_document_risk_signals: type: array description: Array of risk signals computed from a set of uploaded documents and the associated documents' metadata items: $ref: '#/components/schemas/MultiDocumentRiskSignal' required: - account_id - single_document_risk_signals - multi_document_risk_signals CategoryInsightDetails: type: object description: Insights object for categories. additionalProperties: true properties: name: type: string description: Category name. transaction_count: type: integer description: The number of transactions associated with this category. total_outflows: type: number format: double description: Sum of outflow amounts. total_inflows: type: number format: double description: Sum of inflow amounts. top_counterparties: type: array description: The most common counterparties associated with this category sorted by outflow. items: type: string required: - name - transaction_count - total_outflows - total_inflows ClientProvidedTransaction: title: ClientProvidedTransaction type: object description: A client-provided transaction for Plaid to enrich. additionalProperties: true properties: id: type: string description: A unique ID for the transaction used to help you tie data back to your systems. client_user_id: x-hidden-from-docs: true type: string description: A unique user id used to group transactions for a given user, as a unique identifier from your application. Personally identifiable information, such as an email address or phone number, should not be used in the client_user_id. client_account_id: x-hidden-from-docs: true type: string description: A unique account id used to group transactions for a given account, as a unique identifier from your application. Personally identifiable information, such as an email address or phone number, should not be used in the client_account_id. account_type: x-hidden-from-docs: true type: string description: The account type associated with the transaction. For a full list of valid types and subtypes, see the [Account schema](https://plaid.com/docs/api/accounts#account-type-schema). account_subtype: x-hidden-from-docs: true type: string description: The account subtype associated with the transaction. For a full list of valid types and subtypes, see the [Account schema](https://plaid.com/docs/api/accounts#account-type-schema). description: type: string description: The raw description of the transaction. If you have location data in available an unstructured format, it may be appended to the `description` field. amount: type: number format: double description: The absolute value of the transaction (>= 0). When testing Enrich, note that `amount` data should be realistic. Unrealistic or inaccurate `amount` data may result in reduced quality output. direction: $ref: '#/components/schemas/EnrichTransactionDirection' iso_currency_code: type: string description: The ISO-4217 currency code of the transaction e.g. USD. location: $ref: '#/components/schemas/ClientProvidedTransactionLocation' mcc: type: string description: Merchant category codes (MCCs) are four-digit numbers that describe a merchant's primary business activities. date_posted: type: string format: date description: The date the transaction posted, in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) (YYYY-MM-DD) format. required: - id - description - amount - direction - iso_currency_code Scopes: description: The scopes object type: object properties: product_access: $ref: '#/components/schemas/ProductAccess' accounts: type: array items: $ref: '#/components/schemas/AccountAccess' new_accounts: description: Allow access to newly opened accounts as they are opened. If unset, defaults to `true`. type: - boolean - 'null' default: true FDXFiAttribute: title: FI Attribute entity description: Financial Institution provider-specific attribute type: object additionalProperties: false properties: name: type: string description: Name of attribute value: type: string description: Value of attribute required: - name - value WalletTransactionCounterpartyNumbers: title: WalletTransactionCounterpartyNumbers additionalProperties: true type: object description: The counterparty's bank account numbers. Exactly one of IBAN or BACS data is required. properties: bacs: $ref: '#/components/schemas/WalletTransactionCounterpartyBACS' international: $ref: '#/components/schemas/WalletTransactionCounterpartyInternational' BeaconReportCreateRequest: description: Request input for creating a Beacon Report type: object properties: beacon_user_id: $ref: '#/components/schemas/BeaconUserID' type: $ref: '#/components/schemas/BeaconReportType' fraud_date: $ref: '#/components/schemas/ISO8601Date' fraud_amount: $ref: '#/components/schemas/FraudAmount' client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' required: - beacon_user_id - type - fraud_date EntityWatchlistScreeningSearchTerms: type: object description: Search terms associated with an entity used for searching against watchlists properties: entity_watchlist_program_id: $ref: '#/components/schemas/EntityWatchlistProgramID' legal_name: $ref: '#/components/schemas/EntityWatchlistScreeningName' document_number: $ref: '#/components/schemas/WatchlistScreeningDocumentValueNullable' email_address: $ref: '#/components/schemas/EmailAddressNullable' country: $ref: '#/components/schemas/GenericCountryCodeNullable' phone_number: $ref: '#/components/schemas/WatchlistScreeningPhoneNumberNullable' url: $ref: '#/components/schemas/URLNullable' version: type: integer description: The current version of the search terms. Starts at `1` and increments with each edit to `search_terms`. example: 1 required: - entity_watchlist_program_id - legal_name - document_number - email_address - country - phone_number - url - version additionalProperties: true CreditAuditCopyTokenCreateRequest: type: object description: CreditAuditCopyTokenCreateRequest defines the request schema for `/credit/audit_copy_token/create` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' report_tokens: type: array description: List of report tokens; can include at most one VOA/standard Asset Report tokens and one VOE Asset Report Token. items: type: string description: The report token. It can be an VOA Asset Report token or a VOE Asset Report token. required: - report_tokens InvestmentsAuthGetNumbers: x-hidden-from-docs: true type: object additionalProperties: true description: Identifying information for transferring holdings to an investments account. properties: acats: type: array items: $ref: '#/components/schemas/NumbersACATS' aton: type: array items: $ref: '#/components/schemas/NumbersATON' TransferDebitUsageConfiguration: description: Specifies the originator's expected usage of debits. For all dollar amounts, use a decimal string with two digits of precision e.g. "10.00". This field is required if the originator is expected to process debit transfers. type: - object - 'null' properties: expected_frequency: $ref: '#/components/schemas/OriginatorExpectedTransferFrequency' expected_highest_amount: description: The originator’s expected highest amount for a single debit transfer. type: string expected_average_amount: description: The originator’s expected average amount per debit. type: string expected_monthly_amount: description: The originator’s monthly expected ACH debit processing amount for the next 6-12 months. type: string sec_codes: description: 'Specifies the expected use cases for the originator’s debit transfers. This should be a list that contains one or more of the following codes: `"ccd"` - Corporate Credit or Debit - fund transfer between two corporate bank accounts `"ppd"` - Prearranged Payment or Deposit - the transfer is part of a pre-existing relationship with a consumer, eg. bill payment `"tel"` - Telephone-Initiated Entry `"web"` - Internet-Initiated Entry - debits from a consumer’s account where their authorization is obtained over the Internet' type: array items: $ref: '#/components/schemas/ACHClass' required: - expected_frequency - expected_highest_amount - expected_average_amount - expected_monthly_amount - sec_codes IdentityDocumentUploadMetadata: title: IdentityDocumentUploadMetadata type: object additionalProperties: true description: In closed beta. Object representing metadata pertaining to the document. properties: document_type: type: - string - 'null' description: String enumeration of the submitted document type. is_account_number_match: type: - boolean - 'null' description: Boolean field indicating if the uploaded document's account number matches the account number we have on file page_count: type: - integer - 'null' last_updated: type: string format: date-time uploaded_at: type: string format: date-time x-hidden-from-docs: true CreditFreddieMacLoans: title: CreditFreddieMacLoans type: object additionalProperties: true description: A collection of loans that are part of a single deal. properties: LOAN: $ref: '#/components/schemas/CreditFreddieMacLoan' required: - LOAN TransferSweepListResponse: title: TransferSweepListResponse type: object additionalProperties: true description: Defines the response schema for `/transfer/sweep/list` properties: sweeps: type: array items: $ref: '#/components/schemas/TransferSweep' request_id: $ref: '#/components/schemas/RequestID' required: - sweeps - request_id ConsentPaymentIdempotencyKey: title: ConsentPaymentIdempotencyKey type: string maxLength: 128 minLength: 1 description: 'A random key provided by the client, per unique consent payment. Maximum of 128 characters. The API supports idempotency for safely retrying requests without accidentally performing the same operation twice. If a request to execute a consent payment fails due to a network connection error, you can retry the request with the same idempotency key to guarantee that only a single payment is created. If the request was successfully processed, it will prevent any payment that uses the same idempotency key, and was received within 24 hours of the first request, from being processed.' LedgerDepositIdempotencyKey: title: LedgerDepositIdempotencyKey type: string maxLength: 50 description: 'A unique key provided by the client, per unique ledger deposit. Maximum of 50 characters. The API supports idempotency for safely retrying the request without accidentally performing the same operation twice. For example, if a request to create a ledger deposit fails due to a network connection error, you can retry the request with the same idempotency key to guarantee that only a single deposit is created.' ProcessorLiabilitiesGetRequest: type: object description: ProcessorLiabilitiesGetRequest defines the request schema for `/processor/liabilities/get` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' processor_token: $ref: '#/components/schemas/ProcessorToken' required: - processor_token SandboxTransferLedgerSimulateAvailableResponse: title: SandboxTransferLedgerSimulateAvailableResponse type: object additionalProperties: true description: Defines the response schema for `/sandbox/transfer/ledger/simulate_available` properties: request_id: $ref: '#/components/schemas/RequestID' required: - request_id CreditEmploymentItem: title: CreditEmploymentItem type: object additionalProperties: true description: The object containing employment items. properties: item_id: $ref: '#/components/schemas/ItemId' employments: type: array items: $ref: '#/components/schemas/CreditEmploymentVerification' employment_report_token: title: EmploymentReportToken type: string description: Token to represent the underlying Employment data x-hidden-from-docs: true required: - item_id - employments DocumentRiskSignal: title: DocumentRiskSignal description: Details about a certain reason as to why a document could potentially be fraudulent. type: - object - 'null' additionalProperties: true properties: type: title: DocumentRiskSignalResultType type: - string - 'null' description: The result from the risk signal check. x-override-enum-values-shown: - FONT - MASKING - OVERLAID_TEXT - EDITED_TEXT - TEXT_COMPRESSION - ADDRESS_FORMAT_ANOMALY - DATE_FORMAT_ANOMALY - FONT_ANOMALY - NAME_FORMAT_ANOMALY - PDF_ALIGNMENT - BRUSH_DETECTION - METADATA_DATES_OUTSIDE_WINDOW - METADATA_DATES_INSIDE_WINDOW - METADATA_DATES_MISSING - METADATA_DATES_MATCH - ADOBE_FONTS - ANNOTATION_DATES - ANNOTATIONS - EDITED_WHILE_SCANNED - EXIF_DATA_MODIFIED - HIGH_USER_ACCESS - MALFORMED_DATE - QPDF - TEXT_LAYER_TEXT - TOUCHUP_TEXT - FLATTENED_PDF - BLACKLISTS - COPYCAT_IMAGE - COPYCAT_TEXT - REJECTED_CUSTOMER - TEMPLATES - SOFTWARE_BLACKLIST field: title: DocumentRiskSignalField type: - string - 'null' description: The field which the risk signal was computed for has_fraud_risk: title: DocumentRiskSignalHasFraudRisk type: - boolean - 'null' description: A flag used to quickly identify if the signal indicates that this field is authentic or fraudulent institution_metadata: $ref: '#/components/schemas/DocumentRiskSignalInstitutionMetadata' expected_value: title: DocumentRiskSignalExpectedValue type: - string - 'null' description: The expected value of the field, as seen on the document actual_value: title: DocumentRiskSignalActualValue type: - string - 'null' description: The derived value obtained in the risk signal calculation process for this field signal_description: title: DocumentRiskSignalDescription type: - string - 'null' description: A human-readable explanation providing more detail into the particular risk signal page_number: title: DocumentRiskPageNumber type: - integer - 'null' description: The relevant page associated with the risk signal required: - type - field - has_fraud_risk - institution_metadata - expected_value - actual_value - signal_description - page_number ISO8601Date: type: string format: date title: ISO8601Date example: '1990-05-29' description: A date in the format YYYY-MM-DD (RFC 3339 Section 5.6). LinkSessionItemAddResult: type: object description: The details of an Item add in Link. additionalProperties: true properties: public_token: description: Returned once a user has successfully linked their Item. type: string accounts: type: array description: A list of accounts attached to the connected Item. If Account Select is enabled via the developer dashboard, `accounts` will only include selected accounts. items: $ref: '#/components/schemas/LinkSessionSuccessMetadataAccount' institution: $ref: '#/components/schemas/LinkSessionSuccessMetadataInstitution' required: - public_token - accounts - institution CustomerInitiatedRiskTier: description: "A tier corresponding to the projected likelihood that the transaction, if initiated, will be subject to a return.\n\nIn the `customer_initiated_return_risk` object, there are five risk tiers corresponding to the scores:\n 1: Predicted customer-initiated return incidence rate between 0.00% - 0.02%\n 2: Predicted customer-initiated return incidence rate between 0.02% - 0.05%\n 3: Predicted customer-initiated return incidence rate between 0.05% - 0.1%\n 4: Predicted customer-initiated return incidence rate between 0.1% - 0.5%\n 5: Predicted customer-initiated return incidence rate greater than 0.5%\n" type: integer minimum: 1 maximum: 5 AssetReportUser: title: AssetReportUser type: object additionalProperties: true description: The user object allows you to provide additional information about the user to be appended to the Asset Report. All fields are optional. The `first_name`, `last_name`, and `ssn` fields are required if you would like the Report to be eligible for Fannie Mae’s Day 1 Certainty™ program. properties: client_user_id: type: - string - 'null' description: An identifier you determine and submit for the user. first_name: type: - string - 'null' description: The user's first name. Required for the Fannie Mae Day 1 Certainty™ program. middle_name: type: - string - 'null' description: The user's middle name last_name: type: - string - 'null' description: The user's last name. Required for the Fannie Mae Day 1 Certainty™ program. ssn: type: - string - 'null' description: 'The user''s Social Security Number. Required for the Fannie Mae Day 1 Certainty™ program. Format: "ddd-dd-dddd"' phone_number: type: - string - 'null' description: 'The user''s phone number, in E.164 format: +{countrycode}{number}. For example: "+14151234567". Phone numbers provided in other formats will be parsed on a best-effort basis.' email: type: - string - 'null' description: The user's email address. RecurringFrequency: type: - string - 'null' title: RecurringFrequency x-hidden-from-docs: true enum: - UNKNOWN - WEEKLY - BIWEEKLY - SEMI_MONTHLY - MONTHLY - ANNUALLY - DAILY - DYNAMIC - null description: 'Describes the frequency of the transaction stream. `WEEKLY`: Assigned to a transaction stream that occurs approximately every week. `BIWEEKLY`: Assigned to a transaction stream that occurs approximately every 2 weeks. `SEMI_MONTHLY`: Assigned to a transaction stream that occurs approximately twice per month. This frequency is typically seen for inflow transaction streams. `MONTHLY`: Assigned to a transaction stream that occurs approximately every month. `ANNUALLY`: Assigned to a transaction stream that occurs approximately every year. `DAILY`: Assigned to a transaction stream that occurs approximately every day. `DYNAMIC`: Assigned to a transaction stream that varies in recurrence frequency. This frequency is typically seen for inflow streams in the gig economy. `UNKNOWN`: Assigned to a transaction stream that isn''t recurring in nature.' AssetReportPDFGetResponse: format: binary type: string description: AssetReportPDFGetResponse defines the response schema for `/asset_report/pdf/get` Security: title: Security type: object additionalProperties: true description: Contains details about a security properties: security_id: type: string description: 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. isin: type: - string - 'null' description: 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](https://docs.google.com/forms/d/e/1FAIpQLSd9asHEYEfmf8fxJTHZTAfAzW4dugsnSu-HS2J51f1mxwd6Sw/viewform). cusip: type: - string - 'null' description: 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](https://docs.google.com/forms/d/e/1FAIpQLSd9asHEYEfmf8fxJTHZTAfAzW4dugsnSu-HS2J51f1mxwd6Sw/viewform). sedol: type: - string - 'null' description: 7-character SEDOL, an identifier assigned to securities in the UK. institution_security_id: type: - string - 'null' description: An identifier given to the security by the institution institution_id: type: - string - 'null' description: If `institution_security_id` is present, this field indicates the Plaid `institution_id` of the institution to whom the identifier belongs. proxy_security_id: type: - string - 'null' description: 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. name: type: - string - 'null' description: A descriptive name for the security, suitable for display. ticker_symbol: type: - string - 'null' description: The security’s trading symbol for publicly traded securities, and otherwise a short identifier if available. is_cash_equivalent: type: - boolean - 'null' description: Indicates that a security is a highly liquid asset and can be treated like cash. type: type: - string - 'null' description: '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: `cash`: Cash, currency, and money market funds `cryptocurrency`: Digital or virtual currencies `derivative`: Options, warrants, and other derivative instruments `equity`: Domestic and foreign equities `etf`: Multi-asset exchange-traded investment funds `fixed income`: Bonds and certificates of deposit (CDs) `loan`: Loans and loan receivables `mutual fund`: Open- and closed-end vehicles pooling funds of multiple investors `other`: Unknown or other investment types' close_price: type: - number - 'null' format: double description: '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 `update_datetime` with the time when the price was last updated. ' close_price_as_of: type: - string - 'null' format: date description: Date for which `close_price` is accurate. Always `null` if `close_price` is `null`. update_datetime: type: - string - 'null' format: date-time description: 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`. iso_currency_code: type: - string - 'null' description: The ISO-4217 currency code of the price given. Always `null` if `unofficial_currency_code` is non-`null`. unofficial_currency_code: type: - string - 'null' description: 'The unofficial currency code associated with the security. Always `null` if `iso_currency_code` is non-`null`. Unofficial currency codes are used for currencies that do not have official ISO currency codes, such as cryptocurrencies and the currencies of certain countries. See the [currency code schema](https://plaid.com/docs/api/accounts#currency-code-schema) for a full listing of supported `iso_currency_code`s.' market_identifier_code: type: - string - 'null' description: The ISO-10383 Market Identifier Code of the exchange or market in which the security is being traded. option_contract: $ref: '#/components/schemas/OptionContract' required: - cusip - sedol - isin - institution_security_id - institution_id - proxy_security_id - name - ticker_symbol - is_cash_equivalent - close_price - close_price_as_of - iso_currency_code - unofficial_currency_code - security_id - type - market_identifier_code - option_contract Warning: title: Warning type: object additionalProperties: true description: It is possible for an Asset Report to be returned with missing account owner information. In such cases, the Asset Report will contain warning data in the response, indicating why obtaining the owner information failed. properties: warning_type: type: string description: The warning type, which will always be `ASSET_REPORT_WARNING` warning_code: type: string enum: - OWNERS_UNAVAILABLE - INVESTMENTS_UNAVAILABLE - TRANSACTIONS_UNAVAILABLE description: The warning code identifies a specific kind of warning. `OWNERS_UNAVAILABLE` indicates that account-owner information is not available.`INVESTMENTS_UNAVAILABLE` indicates that Investments specific information is not available. `TRANSACTIONS_UNAVAILABLE` indicates that transactions information associated with Credit and Depository accounts are unavailable. cause: $ref: '#/components/schemas/Cause' required: - warning_type - warning_code - cause x-examples: example-1: warning_type: ASSET_REPORT_WARNING warning_code: OWNERS_UNAVAILABLE cause: error_type: ITEM_ERROR http_code: 400 error_code: PRODUCTS_NOT_SUPPORTED error_message: 'The following products are not supported by this institution: Identity' display_message: null request_id: s32PXYOyplhGTHd CreditBankIncomePDFGetResponse: title: CreditBankIncomePDFGetResponse format: binary type: string description: CreditBankIncomePDFGetResponse defines the response schema for `/credit/bank_income/pdf/get` PaymentInitiationRecipientListRequest: type: object description: PaymentInitiationRecipientListRequest defines the request schema for `/payment_initiation/recipient/list` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' EntityScreeningHitNames: type: object description: Name information for the associated entity watchlist hit properties: full: type: string example: Al Qaida description: The full name of the entity. is_primary: type: boolean example: false description: Primary names are those most commonly used to refer to this entity. Only one name will ever be marked as primary. weak_alias_determination: $ref: '#/components/schemas/WeakAliasDetermination' required: - full - is_primary - weak_alias_determination additionalProperties: true EntityScreeningHitAnalysis: type: object description: Analysis information describing why a screening hit matched the provided entity information properties: documents: $ref: '#/components/schemas/MatchSummaryCode' email_addresses: $ref: '#/components/schemas/MatchSummaryCode' locations: $ref: '#/components/schemas/MatchSummaryCode' names: $ref: '#/components/schemas/MatchSummaryCode' phone_numbers: $ref: '#/components/schemas/MatchSummaryCode' urls: $ref: '#/components/schemas/MatchSummaryCode' search_terms_version: type: integer description: The version of the entity screening's `search_terms` that were compared when the entity screening hit was added. entity screening hits are immutable once they have been reviewed. If changes are detected due to updates to the entity screening's `search_terms`, the associated entity program, or the list's source data prior to review, the entity screening hit will be updated to reflect those changes. example: 1 required: - search_terms_version additionalProperties: true BaseReportGetRequest: type: object x-hidden-from-docs: true description: BaseReportGetRequest defines the request schema for `/cra/base_report/get` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' user_token: $ref: '#/components/schemas/UserToken' required: - user_token Credit1099: title: Credit1099 type: object additionalProperties: true description: An object representing an end user's 1099 tax form properties: document_id: type: - string - 'null' description: An identifier of the document referenced by the document metadata. document_metadata: $ref: '#/components/schemas/CreditDocumentMetadata' form_1099_type: $ref: '#/components/schemas/Form1099Type' recipient: $ref: '#/components/schemas/Credit1099Recipient' payer: $ref: '#/components/schemas/Credit1099Payer' filer: $ref: '#/components/schemas/Credit1099Filer' tax_year: type: - string - 'null' description: Tax year of the tax form. rents: type: - number - 'null' format: double description: Amount in rent by payer. royalties: type: - number - 'null' format: double description: Amount in royalties by payer. other_income: type: - number - 'null' format: double description: Amount in other income by payer. federal_income_tax_withheld: type: - number - 'null' format: double description: Amount of federal income tax withheld from payer. fishing_boat_proceeds: type: - number - 'null' format: double description: Amount of fishing boat proceeds from payer. medical_and_healthcare_payments: type: - number - 'null' format: double description: Amount of medical and healthcare payments from payer. nonemployee_compensation: type: - number - 'null' format: double description: Amount of nonemployee compensation from payer. substitute_payments_in_lieu_of_dividends_or_interest: type: - number - 'null' format: double description: Amount of substitute payments made by payer. payer_made_direct_sales_of_5000_or_more_of_consumer_products_to_buyer: type: - string - 'null' description: Whether or not payer made direct sales over $5000 of consumer products. crop_insurance_proceeds: type: - number - 'null' format: double description: Amount of crop insurance proceeds. excess_golden_parachute_payments: type: - number - 'null' format: double description: Amount of golden parachute payments made by payer. gross_proceeds_paid_to_an_attorney: type: - number - 'null' format: double description: Amount of gross proceeds paid to an attorney by payer. section_409a_deferrals: type: - number - 'null' format: double description: Amount of 409A deferrals earned by payer. section_409a_income: type: - number - 'null' format: double description: Amount of 409A income earned by payer. state_tax_withheld: type: - number - 'null' format: double description: Amount of state tax withheld of payer for primary state. state_tax_withheld_lower: type: - number - 'null' format: double description: Amount of state tax withheld of payer for secondary state. payer_state_number: type: - string - 'null' description: Primary state ID. payer_state_number_lower: type: - string - 'null' description: Secondary state ID. state_income: type: - number - 'null' format: double description: State income reported for primary state. state_income_lower: type: - number - 'null' format: double description: State income reported for secondary state. transactions_reported: type: - string - 'null' description: One of the values will be provided Payment card Third party network x-override-enum-values-shown: - Payment card - Third party network pse_name: type: - string - 'null' description: Name of the PSE (Payment Settlement Entity). pse_telephone_number: type: - string - 'null' description: Formatted (XXX) XXX-XXXX. Phone number of the PSE (Payment Settlement Entity). gross_amount: type: - number - 'null' format: double description: Gross amount reported. card_not_present_transaction: type: - number - 'null' format: double description: Amount in card not present transactions. merchant_category_code: type: - string - 'null' description: Merchant category of filer. number_of_payment_transactions: type: - string - 'null' description: Number of payment transactions made. january_amount: type: - number - 'null' format: double description: Amount reported for January. february_amount: type: - number - 'null' format: double description: Amount reported for February. march_amount: type: - number - 'null' format: double description: Amount reported for March. april_amount: type: - number - 'null' format: double description: Amount reported for April. may_amount: type: - number - 'null' format: double description: Amount reported for May. june_amount: type: - number - 'null' format: double description: Amount reported for June. july_amount: type: - number - 'null' format: double description: Amount reported for July. august_amount: type: - number - 'null' format: double description: Amount reported for August. september_amount: type: - number - 'null' format: double description: Amount reported for September. october_amount: type: - number - 'null' format: double description: Amount reported for October. november_amount: type: - number - 'null' format: double description: Amount reported for November. december_amount: type: - number - 'null' format: double description: Amount reported for December. primary_state: type: - string - 'null' description: Primary state of business. secondary_state: type: - string - 'null' description: Secondary state of business. primary_state_id: type: - string - 'null' description: Primary state ID. secondary_state_id: type: - string - 'null' description: Secondary state ID. primary_state_income_tax: type: - number - 'null' format: double description: State income tax reported for primary state. secondary_state_income_tax: type: - number - 'null' format: double description: State income tax reported for secondary state. required: - document_id TransferMigrateAccountRequest: title: TransferMigrateAccountRequest type: object description: Defines the request schema for `/transfer/migrate_account` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' account_number: type: string description: The user's account number. routing_number: type: string description: The user's routing number. wire_routing_number: type: string description: The user's wire transfer routing number. This is the ABA number; for some institutions, this may differ from the ACH number used in `routing_number`. This field must be set for the created item to be eligible for wire transfers. account_type: type: string description: The type of the bank account (`checking` or `savings`). required: - account_number - routing_number - account_type CraLoanApplicationDecision: type: string description: The decision of the loan application. enum: - APPROVED - DECLINED - OTHER EntityWatchlistScreening: type: object properties: id: $ref: '#/components/schemas/EntityWatchlistScreeningID' search_terms: $ref: '#/components/schemas/EntityWatchlistScreeningSearchTerms' assignee: $ref: '#/components/schemas/DashboardUserIDNullable' status: $ref: '#/components/schemas/WatchlistScreeningStatus' client_user_id: $ref: '#/components/schemas/ClientUserIDNullable' audit_trail: $ref: '#/components/schemas/WatchlistScreeningAuditTrail' required: - id - search_terms - assignee - status - client_user_id - audit_trail title: EntityWatchlistScreening description: 'The entity screening object allows you to represent an entity in your system, update its profile, and search for it on various watchlists. Note: Rejected entity screenings will not receive new hits, regardless of entity program configuration.' additionalProperties: true WebhookVerificationKeyGetResponse: type: object additionalProperties: true description: WebhookVerificationKeyGetResponse defines the response schema for `/webhook_verification_key/get` properties: key: $ref: '#/components/schemas/JWKPublicKey' request_id: $ref: '#/components/schemas/RequestID' required: - key - request_id BeaconAccountRiskEvaluateAccount: title: BeaconAccountRiskEvaluateAccount description: An account in the `/beacon/account_risk/v1/evaluate` response. type: object properties: account_id: type: string description: The account ID. type: $ref: '#/components/schemas/AccountType' subtype: $ref: '#/components/schemas/AccountSubtype' attributes: $ref: '#/components/schemas/BeaconAccountRiskEvaluateAccountAttributes' AccountIdentity: description: Identity information about an account title: AccountIdentity allOf: - $ref: '#/components/schemas/AccountBase' - type: object additionalProperties: true properties: owners: type: array description: Data returned by the financial institution about the account owner or owners. Only returned by Identity or Assets endpoints. For business accounts, the name reported may be either the name of the individual or the name of the business, depending on the institution; detecting whether the linked account is a business account is not currently supported. Multiple owners on a single account will be represented in the same `owner` object, not in multiple owner objects within the array. In API versions 2018-05-22 and earlier, the `owners` object is not returned, and instead identity information is returned in the top level `identity` object. For more details, see [Plaid API versioning](https://plaid.com/docs/api/versioning/#version-2019-05-29) items: $ref: '#/components/schemas/Owner' documents: type: array description: Array of documents that identity data is dervied from. This array will be empty if none of the account identity is from a document. items: $ref: '#/components/schemas/IdentityDocument' x-hidden-from-docs: true required: - owners ProfileIdentityName: type: - object - 'null' additionalProperties: true x-hidden-from-docs: true description: ProfileIdentityName defines the user's first name and last name. properties: first_name: type: string last_name: type: string LinkTokenCreateHostedLink: description: Configuration parameters for Hosted Link. To request access to Hosted Link, contact your account manager. additionalProperties: true type: object properties: delivery_method: $ref: '#/components/schemas/HostedLinkDeliveryMethod' completion_redirect_uri: $ref: '#/components/schemas/HostedLinkCompletionRedirectURI' url_lifetime_seconds: $ref: '#/components/schemas/HostedLinkURLLifetimeSeconds' is_mobile_app: $ref: '#/components/schemas/HostedLinkIsMobileApp' WatchlistScreeningEntityCreateResponse: description: 'The entity screening object allows you to represent an entity in your system, update its profile, and search for it on various watchlists. Note: Rejected entity screenings will not receive new hits, regardless of entity program configuration.' additionalProperties: true properties: id: $ref: '#/components/schemas/EntityWatchlistScreeningID' search_terms: $ref: '#/components/schemas/EntityWatchlistScreeningSearchTerms' assignee: $ref: '#/components/schemas/DashboardUserIDNullable' status: $ref: '#/components/schemas/WatchlistScreeningStatus' client_user_id: $ref: '#/components/schemas/ClientUserIDNullable' audit_trail: $ref: '#/components/schemas/WatchlistScreeningAuditTrail' request_id: $ref: '#/components/schemas/RequestID' required: - id - search_terms - assignee - status - client_user_id - audit_trail - request_id type: object BeaconAccountRiskEvaluateRequest: title: BeaconAccountRiskEvaluateRequest description: BeaconAccountRiskEvaluateRequest defines the request schema for `/v1/beacon/account_risk/risk/evaluate` type: object x-hidden-from-docs: true properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' access_token: $ref: '#/components/schemas/AccessToken' options: $ref: '#/components/schemas/BeaconAccountRiskEvaluateRequestOptions' client_user_id: type: string description: A unique ID that identifies the end user in your system. This ID is used to correlate requests by a user with multiple evaluations and/or multiple linked accounts. Personally identifiable information, such as an email address or phone number, should not be used in the client_user_id. minLength: 1 maxLength: 36 client_evaluation_id: type: string description: Unique identifier of what you are looking to evaluate (account add, information change, etc.) to allow us to tie the activity to the decisions and possible fraud outcome sent via our feedback endpoints. You can use your internal request ID or similar. evaluation_reason: $ref: '#/components/schemas/BeaconAccountRiskEvaluateEvaluationReason' device: $ref: '#/components/schemas/SignalDevice' evaluate_time: type: string description: The time the event for evaluation has occurred. Populate this field for backfilling data. If you don’t populate this field, we’ll use the timestamp at the time of receipt. Use ISO 8601 format (YYYY-MM-DDTHH:mm:ssZ). Credit1099Payer: title: Credit1099Payer type: object additionalProperties: true description: An object representing a payer used by 1099-MISC tax documents. properties: address: $ref: '#/components/schemas/CreditPayStubAddress' name: type: - string - 'null' description: Name of payer. tin: type: - string - 'null' description: Tax identification number of payer. telephone_number: type: - string - 'null' description: Telephone number of payer. LinkDeliveryOptions: type: object description: Optional metadata related to the Hosted Link session properties: recipient: $ref: '#/components/schemas/LinkDeliveryRecipient' SignalReturnReportResponse: title: SignalReturnReportResponse description: SignalReturnReportResponse defines the response schema for `/signal/return/report` additionalProperties: true type: object properties: request_id: $ref: '#/components/schemas/RequestID' required: - request_id EmploymentVerification: title: EmploymentVerification type: object additionalProperties: true description: An object containing proof of employment data for an individual properties: status: $ref: '#/components/schemas/EmploymentVerificationStatus' start_date: format: date type: - string - 'null' description: Start of employment in ISO 8601 format (YYYY-MM-DD). end_date: format: date type: - string - 'null' description: End of employment, if applicable. Provided in ISO 8601 format (YYY-MM-DD). employer: $ref: '#/components/schemas/EmployerVerification' title: type: - string - 'null' description: Current title of employee. platform_ids: $ref: '#/components/schemas/PlatformIds' TransferEventListResponse: title: TransferEventListResponse type: object additionalProperties: true description: Defines the response schema for `/transfer/event/list` properties: transfer_events: type: array items: $ref: '#/components/schemas/TransferEvent' has_more: type: boolean description: Whether there are more events to be pulled from the endpoint that have not already been returned request_id: $ref: '#/components/schemas/RequestID' required: - transfer_events - has_more - request_id IdentityMatchRequestOptions: type: object description: An optional object to filter /identity/match results properties: account_ids: type: array description: An array of `account_ids` to perform fuzzy match items: type: string ProcessorSignalEvaluateResponse: title: ProcessorSignalEvaluateResponse description: ProcessorSignalEvaluateResponse defines the response schema for `/processor/signal/evaluate` type: object additionalProperties: true properties: request_id: $ref: '#/components/schemas/RequestID' scores: $ref: '#/components/schemas/SignalScores' core_attributes: $ref: '#/components/schemas/SignalEvaluateCoreAttributes' warnings: type: array description: If bank information was not available to be used in the Signal model, this array contains warnings describing why bank data is missing. If you want to receive an API error instead of Signal scores in the case of missing bank data, file a support ticket or contact your Plaid account manager. items: $ref: '#/components/schemas/SignalWarning' required: - request_id - scores WalletCreateResponse: type: object additionalProperties: true description: WalletCreateResponse defines the response schema for `/wallet/create` allOf: - $ref: '#/components/schemas/Wallet' - type: object properties: request_id: $ref: '#/components/schemas/RequestID' required: - wallet_id - balance - request_id PaymentInitiationRecipientGetResponse: additionalProperties: true description: PaymentInitiationRecipientGetResponse defines the response schema for `/payment_initiation/recipient/get` allOf: - $ref: '#/components/schemas/PaymentInitiationRecipient' - type: object properties: request_id: $ref: '#/components/schemas/RequestID' required: - recipient_id - name - request_id CreditBankStatementUploadBankAccountPeriod: title: CreditBankStatementUploadBankAccountPeriod type: object description: An object containing data on the overall period of the statement. properties: start_date: type: - string - 'null' format: date description: The start date of the statement period in ISO 8601 format (YYYY-MM-DD). end_date: type: - string - 'null' format: date description: The end date of the statement period in ISO 8601 format (YYYY-MM-DD). starting_balance: type: - number - 'null' description: The starting balance of the bank account for the period. ending_balance: type: - number - 'null' description: The ending balance of the bank account for the period. required: - start_date - end_date - starting_balance - ending_balance LinkTokenCreateRequestStatements: type: object description: Specifies options for initializing Link for use with the Statements product. This field is required for the statements product. properties: start_date: type: string format: date description: The start date for statements, in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) “YYYY-MM-DD” format, e.g. "2020-10-30". end_date: type: string format: date description: The end date for statements, in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) “YYYY-MM-DD” format, e.g. "2020-10-30". You can request up to two years of data. required: - start_date - end_date CraPartnerInsights: type: object additionalProperties: true description: The partner insights report of the bank data for an end user. properties: report_id: type: string description: A unique identifier associated with the Partner Insights object. generated_time: type: string description: The time when the partner insights report was generated. format: date-time prism: $ref: '#/components/schemas/CraPartnerInsightsPrism' items: type: array description: The list of Items used in the report along with the associated metadata about the Item. items: $ref: '#/components/schemas/CraPartnerInsightsItem' TransferDiligenceStatus: type: string title: TransferDiligenceStatus description: Originator’s diligence status. enum: - not_submitted - submitted - under_review - approved - denied TransactionsSyncRequestOptions: type: object description: An optional object to be used with the request. If specified, `options` must not be `null`. properties: include_original_description: type: - boolean - 'null' default: false description: Include the raw unparsed transaction description from the financial institution. include_personal_finance_category: type: boolean default: false description: Personal finance categories are now returned by default. deprecated: true x-hidden-from-docs: true include_logo_and_counterparty_beta: type: boolean default: false description: Counterparties and extra merchant fields are now returned by default. deprecated: true x-hidden-from-docs: true days_requested: description: 'This option only applies to calls for Items that were not initialized with Transactions during Link and are now adding the Transactions product to the Item for the first time. In these cases, this option controls the maximum number of days of transaction history that Plaid will request from the financial institution. For developer accounts created after December 3, 2023, if no value is specified, this will default to 90 days. For developer accounts created on December 3, 2023 or earlier, if no value is specified, this will default to 730 days until June 24, 2024, at which point it will default to 90 days. If Transactions has already been added to the Item prior to this call, this field will have no effect. We strongly recommend that customers utilizing [Recurring Transactions](https://plaid.com/docs/api/products/transactions/#transactionsrecurringget) request at least 180 days of history for optimal results.' type: integer minimum: 1 maximum: 730 default: 90 InternalUID: type: string title: InternalUID description: A universal identifier for a watchlist individual that is stable across searches and updates. example: uid_3NggckTimGSJHS ItemAccessTokenInvalidateRequest: type: object description: ItemAccessTokenInvalidateRequest defines the request schema for `/item/access_token/invalidate` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' access_token: $ref: '#/components/schemas/AccessToken' required: - access_token CreditBankStatementUploadAccountOwnerAddress: title: CreditBankStatementUploadAccountOwnerAddress description: Address on the uploaded bank statement type: object additionalProperties: true properties: city: type: - string - 'null' description: The full city name. country: type: - string - 'null' description: The ISO 3166-1 alpha-2 country code. postal_code: type: - string - 'null' description: The postal code of the address. region: type: - string - 'null' description: 'The region or state. Example: `"NC"`' street: type: - string - 'null' description: The full street address. required: - city - country - postal_code - region - street CreditEmploymentEmployeeType: type: - string - 'null' title: CreditEmploymentEmployeeType description: 'The type of employment for the individual. `"FULL_TIME"`: A full-time employee. `"PART_TIME"`: A part-time employee. `"CONTRACTOR"`: An employee typically hired externally through a contracting group. `"TEMPORARY"`: A temporary employee. `"OTHER"`: The employee type is not one of the above defined types.' x-override-enum-values-shown: - FULL_TIME - PART_TIME - CONTRACTOR - TEMPORARY - OTHER - null DocumentRiskSignalInstitutionMetadata: title: DocumentRiskSignalInstitutionMetadata type: - object - 'null' additionalProperties: true description: An object which contains additional metadata about the institution used to compute the verification attribute properties: item_id: $ref: '#/components/schemas/ItemId' required: - item_id CraBankIncomeWarningCode: type: string description: 'The warning code identifies a specific kind of warning. `IDENTITY_UNAVAILABLE`: Unable to extract identity for the Item `TRANSACTIONS_UNAVAILABLE`: Unable to extract transactions for the Item `REPORT_DELETED`: Report deleted due to customer or consumer request `DATA_UNAVAILABLE`: No relevant data was found for the Item' enum: - IDENTITY_UNAVAILABLE - TRANSACTIONS_UNAVAILABLE - REPORT_DELETED - DATA_UNAVAILABLE AssetReport: title: AssetReport type: object additionalProperties: true description: An object representing an Asset Report properties: asset_report_id: $ref: '#/components/schemas/AssetReportId' client_report_id: type: - string - 'null' description: An identifier you determine and submit for the Asset Report. date_generated: type: string format: date-time description: The date and time when the Asset Report was created, in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format (e.g. "2018-04-12T03:32:11Z"). days_requested: type: number description: The duration of transaction history you requested user: $ref: '#/components/schemas/AssetReportUser' items: type: array description: Data returned by Plaid about each of the Items included in the Asset Report. items: $ref: '#/components/schemas/AssetReportItem' required: - asset_report_id - client_report_id - date_generated - days_requested - user - items ItemStatusInvestments: description: Information about the last successful and failed investments update for the Item. type: - object - 'null' additionalProperties: true properties: last_successful_update: description: '[ISO 8601](https://wikipedia.org/wiki/ISO_8601) timestamp of the last successful investments update for the Item. The status will update each time Plaid successfully connects with the institution, regardless of whether any new data is available in the update.' type: - string - 'null' format: date-time last_failed_update: description: '[ISO 8601](https://wikipedia.org/wiki/ISO_8601) timestamp of the last failed investments update for the Item. The status will update each time Plaid fails an attempt to connect with the institution, regardless of whether any new data is available in the update.' type: - string - 'null' format: date-time IncomeVerificationDocParsingConfig: title: IncomeVerificationDocParsingConfig enum: - ocr - risk_signals description: Analysis options to enable for document parsing type: string CreditFreddieMacIndividualName: title: CreditFreddieMacIndividualName type: object additionalProperties: true description: Documentation not found in the MISMO model viewer and not provided by Freddie Mac. properties: FirstName: type: string description: The first name of the individual represented by the parent object. LastName: type: string description: The last name of the individual represented by the parent object. MiddleName: type: string description: The middle name of the individual represented by the parent object. required: - FirstName - LastName - MiddleName AssetReportCreateRequestOptions: type: object description: An optional object to filter `/asset_report/create` results. If provided, must be non-`null`. The optional `user` object is required for the report to be eligible for Fannie Mae's Day 1 Certainty program. properties: client_report_id: type: - string - 'null' description: Client-generated identifier, which can be used by lenders to track loan applications. webhook: type: - string - 'null' description: URL to which Plaid will send Assets webhooks, for example when the requested Asset Report is ready. include_fast_report: deprecated: true type: - boolean - 'null' description: true to return balance and identity earlier as a fast report. Defaults to false if omitted. x-hidden-from-docs: true products: deprecated: true type: array description: 'Additional information that can be included in the asset report. Possible values: `"investments"`' x-hidden-from-docs: true items: type: string add_ons: type: array description: 'Use this field to request a `fast_asset` report. When Fast Assets is requested, Plaid will create two versions of the Asset Report: first, the Fast Asset Report, which will contain only current identity and balance information, and later, the Full Asset Report, which will also contain historical balance information and transaction data. A `PRODUCT_READY` webhook will be fired for each Asset Report when it is ready, and the `report_type` field will indicate whether the webhook is firing for the `full` or `fast` Asset Report. To retrieve the Fast Asset Report, call `/asset_report/get` with `fast_report` set to `true`. There is no additional charge for using Fast Assets.' items: $ref: '#/components/schemas/AssetReportAddOns' user: $ref: '#/components/schemas/AssetReportUser' TransferIntentGetRequest: title: TransferIntentGetRequest type: object description: Defines the request schema for `/transfer/intent/get` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' transfer_intent_id: type: string description: Plaid's unique identifier for a transfer intent object. required: - transfer_intent_id IdentityDocument: title: IdentityDocument type: object description: Document object with metadata of the document uploaded properties: metadata: $ref: '#/components/schemas/IdentityDocumentMetadata' document_id: type: string x-hidden-from-docs: true PaymentConsentPeriodicAmountAmount: description: Maximum cumulative amount for all payments in the specified interval. allOf: - $ref: '#/components/schemas/PaymentAmount' OmittableTransferType: type: string title: OmittableTransferType description: The type of transfer. Valid values are `debit` or `credit`. A `debit` indicates a transfer of money into the origination account; a `credit` indicates a transfer of money out of the origination account. This field is omitted for Plaid Ledger Sweep events. enum: - debit - credit AssetTransactionType: title: AssetTransactionType type: string description: Asset Transaction Type. enum: - Credit - Debit PaymentInitiationConsentScope: type: string title: PaymentInitiationConsentScope enum: - ME_TO_ME - EXTERNAL description: 'Payment consent scope. Defines possible directions for payments made with the given consent. `ME_TO_ME`: Allows moving money between accounts owned by the same user. `EXTERNAL`: Allows initiating payments from the user''s account to third parties.' ConsumerReportPDFGetRequest: type: object description: ConsumerReportPDFGetRequest defines the request schema for `/consumer_report/pdf/get` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' user_token: $ref: '#/components/schemas/UserToken' required: - user_token PlatformIds: title: PlatformIds type: object additionalProperties: true description: An object containing a set of ids related to an employee properties: employee_id: type: - string - 'null' description: The ID of an employee as given by their employer payroll_id: type: - string - 'null' description: The ID of an employee as given by their payroll position_id: type: - string - 'null' description: The ID of the position of the employee IdentityDocumentUpload: title: IdentityDocumentUpload type: object description: Document object with metadata of the uploaded document properties: document_id: type: string metadata: $ref: '#/components/schemas/IdentityDocumentUploadMetadata' risk_insights: $ref: '#/components/schemas/IdentityDocumentUploadRiskInsights' x-hidden-from-docs: true IncomeVerificationSourceType: title: IncomeVerificationSourceType enum: - bank - payroll description: The types of source income data that users should be able to share type: string PaymentInitiationPaymentCreateRequest: type: object description: PaymentInitiationPaymentCreateRequest defines the request schema for `/payment_initiation/payment/create` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' recipient_id: type: string description: The ID of the recipient the payment is for. reference: type: string description: 'A reference for the payment. This must be an alphanumeric string with at most 18 characters and must not contain any special characters (since not all institutions support them). In order to track settlement via Payment Confirmation, each payment must have a unique reference. If the reference provided through the API is not unique, Plaid will adjust it. Some institutions may limit the reference to less than 18 characters. If necessary, Plaid will adjust the reference by truncating it to fit the institution''s requirements. Both the originally provided and automatically adjusted references (if any) can be found in the `reference` and `adjusted_reference` fields, respectively.' minLength: 1 maxLength: 18 amount: $ref: '#/components/schemas/PaymentAmount' schedule: $ref: '#/components/schemas/ExternalPaymentScheduleRequest' options: $ref: '#/components/schemas/ExternalPaymentOptions' required: - recipient_id - reference - amount WatchlistScreeningIndividualReviewListRequest: description: Request input for listing reviews for an individual watchlist screening type: object properties: secret: $ref: '#/components/schemas/APISecret' client_id: $ref: '#/components/schemas/APIClientID' watchlist_screening_id: $ref: '#/components/schemas/WatchlistScreeningIndividualID' cursor: $ref: '#/components/schemas/Cursor' required: - watchlist_screening_id CraLoansApplicationsRegisterRequest: type: object description: CraLoansApplicationsRegisterRequest defines the request schema for `/cra/loans/applications/register`. properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' applications: type: array description: A list of loan applications to register. items: $ref: '#/components/schemas/CraLoanApplication' required: - applications CraLoanClosedStatus: type: object description: Contains the status and date information of the loan when unregistering. additionalProperties: true properties: status: $ref: '#/components/schemas/CraLoanStatus' date: $ref: '#/components/schemas/CraLoanStatusEffectiveDate' required: - status - date SignalPersonName: title: SignalPersonName type: - object - 'null' description: The user's legal name properties: prefix: type: - string - 'null' description: The user's name prefix (e.g. "Mr.") given_name: type: - string - 'null' description: The user's given name. If the user has a one-word name, it should be provided in this field. middle_name: type: - string - 'null' description: The user's middle name family_name: type: - string - 'null' description: The user's family name / surname suffix: type: - string - 'null' description: The user's name suffix (e.g. "II") CreditBankIncomeHistoricalSummary: type: object description: The end user's monthly summary for the income source(s). additionalProperties: true properties: total_amount: type: number description: 'Total amount of earnings for the income source(s) of the user for the month in the summary. This may return an incorrect value if the summary includes income sources in multiple currencies. Please use [`total_amounts`](https://plaid.com/docs/api/products/income/#credit-bank_income-get-response-bank-income-items-bank-income-sources-historical-summary-total-amounts) instead.' deprecated: true iso_currency_code: type: - string - 'null' description: 'The ISO 4217 currency code of the amount or balance. Please use [`total_amounts`](https://plaid.com/docs/api/products/income/#credit-bank_income-get-response-bank-income-items-bank-income-sources-historical-summary-total-amounts) instead.' deprecated: true unofficial_currency_code: type: - string - 'null' description: 'The unofficial currency code associated with the amount or balance. Always `null` if `iso_currency_code` is non-null. Unofficial currency codes are used for currencies that do not have official ISO currency codes, such as cryptocurrencies and the currencies of certain countries. Please use [`total_amounts`](https://plaid.com/docs/api/products/income/#credit-bank_income-get-response-bank-income-items-bank-income-sources-historical-summary-total-amounts) instead.' deprecated: true total_amounts: type: array description: 'Total amount of earnings for the income source(s) of the user for the month in the summary. This can contain multiple amounts, with each amount denominated in one unique currency.' items: $ref: '#/components/schemas/CreditAmountWithCurrency' start_date: type: string format: date description: 'The start date of the period covered in this monthly summary. This date will be the first day of the month, unless the month being covered is a partial month because it is the first month included in the summary and the date range being requested does not begin with the first day of the month. The date will be returned in an ISO 8601 format (YYYY-MM-DD).' end_date: type: string format: date description: 'The end date of the period included in this monthly summary. This date will be the last day of the month, unless the month being covered is a partial month because it is the last month included in the summary and the date range being requested does not end with the last day of the month. The date will be returned in an ISO 8601 format (YYYY-MM-DD).' transactions: type: array items: $ref: '#/components/schemas/CreditBankIncomeTransaction' WatchlistScreeningIndividualHistoryListRequest: description: Request input for listing changes to watchlist screenings for individuals type: object properties: secret: $ref: '#/components/schemas/APISecret' client_id: $ref: '#/components/schemas/APIClientID' watchlist_screening_id: $ref: '#/components/schemas/WatchlistScreeningIndividualID' cursor: $ref: '#/components/schemas/Cursor' required: - watchlist_screening_id LinkDeliveryGetRequest: type: object description: LinkDeliveryGetRequest defines the request schema for `/link_delivery/get` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' link_delivery_session_id: type: string description: The ID for the Hosted Link session from a previous invocation of `/link_delivery/create`. required: - link_delivery_session_id CreditFreddieMacVerificationOfAsset: title: CreditFreddieMacVerificationOfAsset type: object additionalProperties: true description: Documentation not found in the MISMO model viewer and not provided by Freddie Mac. properties: REPORTING_INFORMATION: $ref: '#/components/schemas/CreditFreddieMacReportingInformation' SERVICE_PRODUCT_FULFILLMENT: $ref: '#/components/schemas/ServiceProductFulfillment' VERIFICATION_OF_ASSET_RESPONSE: $ref: '#/components/schemas/CreditFreddieMacVerificationOfAssetResponse' required: - REPORTING_INFORMATION - SERVICE_PRODUCT_FULFILLMENT - VERIFICATION_OF_ASSET_RESPONSE EntityScreeningHitEmailsItems: type: object description: Analyzed emails for the associated hit properties: analysis: $ref: '#/components/schemas/MatchSummary' data: $ref: '#/components/schemas/EntityScreeningHitEmails' additionalProperties: true AddressData: title: AddressData type: object additionalProperties: true description: Data about the components comprising an address. properties: city: type: - string - 'null' description: The full city name region: type: - string - 'null' description: 'The region or state. In API versions 2018-05-22 and earlier, this field is called `state`. Example: `"NC"`' street: type: string description: 'The full street address Example: `"564 Main Street, APT 15"`' postal_code: type: - string - 'null' description: The postal code. In API versions 2018-05-22 and earlier, this field is called `zip`. country: type: - string - 'null' description: The ISO 3166-1 alpha-2 country code required: - city - region - street - postal_code - country TransferSweepStatus: type: - string - 'null' title: TransferSweepStatus description: 'The status of the sweep for the transfer. `unswept`: The transfer hasn''t been swept yet. `swept`: The transfer was swept to the sweep account. `swept_settled`: Credits are available to be withdrawn or debits have been deducted from the customer’s business checking account. `return_swept`: The transfer was returned, funds were pulled back or pushed back to the sweep account. `null`: The transfer will never be swept (e.g. if the transfer is cancelled or returned before being swept)' enum: - null - unswept - swept - swept_settled - return_swept CreditPlatformIds: title: CreditPlatformIds type: object additionalProperties: true description: The object containing a set of ids related to an employee. properties: employee_id: type: - string - 'null' description: The ID of an employee as given by their employer. payroll_id: type: - string - 'null' description: The ID of an employee as given by their payroll. position_id: type: - string - 'null' description: The ID of the position of the employee. required: - employee_id - payroll_id - position_id TaxpayerID: title: TaxpayerID type: object additionalProperties: true description: Taxpayer ID of the individual receiving the paystub. properties: id_type: type: - string - 'null' description: Type of ID, e.g. 'SSN' id_mask: type: - string - 'null' description: ID mask; i.e. last 4 digits of the taxpayer ID last_4_digits: deprecated: true type: - string - 'null' description: Last 4 digits of unique number of ID. minLength: 4 maxLength: 4 AssetReportTransactionType: title: AssetReportTransactionType type: string enum: - digital - place - special - unresolved description: '`digital:` transactions that took place online. `place:` transactions that were made at a physical location. `special:` transactions that relate to banks, e.g. fees or deposits. `unresolved:` transactions that do not fit into the other three types. ' Status: title: Status type: object additionalProperties: true description: Documentation not found in the MISMO model viewer and not provided by Freddie Mac. properties: StatusCode: type: - string - 'null' description: Satus Code. StatusDescription: type: - string - 'null' description: Status Description. required: - StatusCode - StatusDescription EmailAddressMatchScore: title: EmailAddressMatchScore type: - object - 'null' additionalProperties: true description: Score found by matching email provided by the API with the email on the account at the financial institution. 100 is a perfect match and 0 is a no match. If the account contains multiple owners, the maximum match score is filled. properties: score: type: - integer - 'null' description: Match score for normalized email. 100 is a perfect match, 99-70 is a partial match (matching the same email with different '+' extensions), anything below 70 is considered a mismatch. Typically, the match threshold should be set to a score of 70 or higher. If the email is missing from either the API or financial institution, this is null. Category: title: Category type: object additionalProperties: true description: Information describing a transaction category properties: category_id: type: string description: An identifying number for the category. `category_id` is a Plaid-specific identifier and does not necessarily correspond to merchant category codes. group: type: string description: '`place` for physical transactions or `special` for other transactions such as bank charges.' hierarchy: type: array description: A hierarchical array of the categories to which this `category_id` belongs. items: type: string required: - category_id - group - hierarchy KYCCheckDateOfBirthSummary: description: Result summary object specifying how the `date_of_birth` field matched. type: object properties: summary: $ref: '#/components/schemas/MatchSummaryCode' required: - summary additionalProperties: true BeaconUserUpdateRequest: description: Request input for updating the identity data of a Beacon User. type: object properties: beacon_user_id: $ref: '#/components/schemas/BeaconUserID' user: $ref: '#/components/schemas/BeaconUserUpdateRequestData' client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' required: - beacon_user_id - user AccountsBalanceGetResponsePaymentRiskAssessment: x-hidden-from-docs: true type: - object - 'null' description: This object provides detailed risk assessment for the requested transaction additionalProperties: true properties: risk_level: type: string description: 'A five-tier risk assessment for the transaction, based on the probability of ACH returns, measured by the incident rate.' attributes: $ref: '#/components/schemas/BalancePlusAttributes' score: description: 'A risk score ranging from 1-99, reflecting the likelihood of ACH debit return. A higher score indicates a greater risk of return, often due to overdrawn accounts or account ineligibility to receive ACH transactions. Typical return codes include "R01", "R02", "R03", "R04", "R06", "R08", "R09", "R13", "R16", "R17", "R20", "R23", etc., with a turnaround of 2 banking days.' type: - integer - 'null' minimum: 1 maximum: 99 balance_last_updated: type: string description: Timestamp of the last successful balance update, in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format. format: date-time risk_reasons: type: array description: 'An array of objects, each representing a specific reason contributing to the risk assessment of an ACH transaction. This field is particularly useful for understanding risk factors affecting the risk level assigned to a transaction classified as “high”, “medium-high”, and “medium” risk.' items: $ref: '#/components/schemas/RiskReason' exceeds_balance_threshold: type: boolean description: 'This boolean field denotes if the requested ACH debit amount exceeds the calculated threshold based on either the available or current balance of the bank account. Specifically, it checks if the amount is greater than the account balance multiplied by "balance_threshold_percentage"/100. In cases where available_balance is not accessible, current_balance is used. This field is particularly useful for clients handling indirect items who lack direct access to raw balance data.' RiskReason: title: RiskReason type: object description: This object includes a code and description to describe medium risk transactions and above on /accounts/balance/get. additionalProperties: true properties: code: description: 'A code that represents the type of risk associated with the proposed transaction. The codes are from PL01 to PL07 and from BK01 to BK07.' type: string description: description: A brief description explaining the risk associated with the proposed transaction and some recommended actions. type: string IncomeBreakdown: title: IncomeBreakdown type: object description: An object representing a breakdown of the different income types on the paystub. additionalProperties: true deprecated: true properties: type: $ref: '#/components/schemas/IncomeBreakdownType' rate: type: - number - 'null' format: double description: The hourly rate at which the income is paid. hours: type: - number - 'null' description: The number of hours logged for this income for this pay period. total: type: - number - 'null' format: double description: The total pay for this pay period. required: - type - rate - hours - total RequestID: title: RequestID type: string description: A unique identifier for the request, which can be used for troubleshooting. This identifier, like all Plaid identifiers, is case sensitive. WatchlistScreeningEntityReviewCreateRequest: type: object description: Request input for creating a review for an entity screening properties: confirmed_hits: type: array items: $ref: '#/components/schemas/EntityWatchlistScreeningHitID' description: Hits to mark as a true positive after thorough manual review. These hits will never recur or be updated once dismissed. In most cases, confirmed hits indicate that the customer should be rejected. dismissed_hits: type: array items: $ref: '#/components/schemas/EntityWatchlistScreeningHitID' description: Hits to mark as a false positive after thorough manual review. These hits will never recur or be updated once dismissed. comment: $ref: '#/components/schemas/ReviewComment' client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' entity_watchlist_screening_id: $ref: '#/components/schemas/EntityWatchlistScreeningID' required: - confirmed_hits - dismissed_hits - entity_watchlist_screening_id WalletTransactionExecuteResponse: type: object additionalProperties: true description: WalletTransactionExecuteResponse defines the response schema for `/wallet/transaction/execute` properties: transaction_id: type: string description: A unique ID identifying the transaction status: $ref: '#/components/schemas/WalletTransactionStatus' request_id: $ref: '#/components/schemas/RequestID' required: - transaction_id - status - request_id ItemImportRequestUserAuth: type: object required: - user_id - auth_token description: Object of user ID and auth token pair, permitting Plaid to aggregate a user’s accounts properties: user_id: type: string description: Opaque user identifier auth_token: type: string description: Authorization token Plaid will use to aggregate this user’s accounts TransferRecurringCancelResponse: title: TransferRecurringCancelResponse type: object additionalProperties: true description: Defines the response schema for `/transfer/recurring/cancel` properties: request_id: $ref: '#/components/schemas/RequestID' required: - request_id PaymentConsentMaxPaymentAmount: description: Maximum amount of a single payment initiated using the payment consent. allOf: - $ref: '#/components/schemas/PaymentAmount' SandboxPublicTokenCreateResponse: type: object additionalProperties: true description: SandboxPublicTokenCreateResponse defines the response schema for `/sandbox/public_token/create` properties: public_token: type: string description: A public token that can be exchanged for an access token using `/item/public_token/exchange` request_id: $ref: '#/components/schemas/RequestID' required: - public_token - request_id IncomeVerificationPrecheckConfidence: description: 'The confidence that Plaid can support the user in the digital income verification flow instead of requiring a manual paystub upload. One of the following: `"HIGH"`: It is very likely that this user can use the digital income verification flow. "`LOW`": It is unlikely that this user can use the digital income verification flow. `"UNKNOWN"`: It was not possible to determine if the user is supportable with the information passed.' type: string enum: - HIGH - LOW - UNKNOWN SandboxTransferRepaymentSimulateRequest: title: SandboxTransferRepaymentSimulateRequest type: object description: Defines the request schema for `/sandbox/transfer/repayment/simulate` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' CraLoanType: type: string description: The type of loan the user applied for. enum: - PERSONAL - CREDIT_CARD - BUSINESS - MORTGAGE - AUTO - PAYDAY - STUDENT - HOME_EQUITY - OTHER CreditFreddieMacServices: title: CreditFreddieMacServices type: object additionalProperties: true description: A collection of objects that describe requests and responses for services. properties: SERVICE: $ref: '#/components/schemas/CreditFreddieMacService' required: - SERVICE OptionContract: title: OptionContract type: - object - 'null' additionalProperties: true description: 'Details about the option security. For the Sandbox environment, this data is currently only available if the item is using a custom configuration object, and the `ticker` field of the custom security follows the [OCC Option Symbol](https://en.wikipedia.org/wiki/Option_symbol#The_OCC_Option_Symbol) standard with no spaces.' properties: contract_type: type: string description: 'The type of this option contract. It is one of: `put`: for Put option contracts `call`: for Call option contracts' expiration_date: type: string format: date description: The expiration date for this option contract, in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format. strike_price: type: number format: double description: The strike price for this option contract, per share of security. underlying_security_ticker: type: string description: The ticker of the underlying security for this option contract. required: - contract_type - expiration_date - strike_price - underlying_security_ticker CraBankIncomeHistoricalSummary: type: object description: The end user's monthly summary for the income source(s). additionalProperties: true properties: total_amounts: type: array description: 'Total amount of earnings for the income source(s) of the user for the month in the summary. This can contain multiple amounts, with each amount denominated in one unique currency.' items: $ref: '#/components/schemas/CreditAmountWithCurrency' start_date: type: string format: date description: 'The start date of the period covered in this monthly summary. This date will be the first day of the month, unless the month being covered is a partial month because it is the first month included in the summary and the date range being requested does not begin with the first day of the month. The date will be returned in an ISO 8601 format (YYYY-MM-DD).' end_date: type: string format: date description: 'The end date of the period included in this monthly summary. This date will be the last day of the month, unless the month being covered is a partial month because it is the last month included in the summary and the date range being requested does not end with the last day of the month. The date will be returned in an ISO 8601 format (YYYY-MM-DD).' transactions: type: array items: $ref: '#/components/schemas/CraBankIncomeTransaction' TransferUserInResponse: title: TransferUserInResponse type: object additionalProperties: true description: The legal name and other information for the account holder. properties: legal_name: type: string description: The user's legal name. phone_number: type: - string - 'null' description: The user's phone number. email_address: type: - string - 'null' description: The user's email address. address: $ref: '#/components/schemas/TransferUserAddressInResponse' required: - legal_name - phone_number - email_address - address BeaconAuditTrailSource: type: string enum: - dashboard - api - system - bulk_import description: 'A type indicating what caused a resource to be changed or updated. `dashboard` - The resource was created or updated by a member of your team via the Plaid dashboard. `api` - The resource was created or updated via the Plaid API. `system` - The resource was created or updated automatically by a part of the Plaid Beacon system. For example, if another business using Plaid Beacon created a fraud report that matched one of your users, your matching user''s status would automatically be updated and the audit trail source would be `system`. `bulk_import` - The resource was created or updated as part of a bulk import process. For example, if your company provided a CSV of user data as part of your initial onboarding, the audit trail source would be `bulk_import`.' PaystubEmployer: title: Employer description: Information about the employer on the paystub type: object additionalProperties: true properties: address: $ref: '#/components/schemas/PaystubAddress' name: type: - string - 'null' description: The name of the employer on the paystub. required: - name AssetTransactionDetail: title: AssetTransactionDetail type: object additionalProperties: true description: Documentation not found in the MISMO model viewer and not provided by Freddie Mac. properties: AssetTransactionUniqueIdentifier: type: string description: A vendor created unique Identifier. AssetTransactionAmount: type: number description: Asset Transaction Amount. AssetTransactionDate: type: string format: date description: Asset Transaction Date. AssetTransactionPostDate: type: string format: date description: Asset Transaction Post Date. AssetTransactionType: $ref: '#/components/schemas/AssetTransactionType' AssetTransactionPaidByName: type: - string - 'null' description: Populate with who did the transaction. AssetTransactionTypeAdditionalDescription: type: - string - 'null' description: FI Provided - examples are atm, cash, check, credit, debit, deposit, directDebit, directDeposit, dividend, fee, interest, other, payment, pointOfSale, repeatPayment, serviceCharge, transfer. AssetTransactionCategoryType: $ref: '#/components/schemas/AssetTransactionCategoryType' FinancialInstitutionTransactionIdentifier: type: - string - 'null' description: FI provided Transaction Identifier. required: - AssetTransactionUniqueIdentifier - AssetTransactionAmount - AssetTransactionDate - AssetTransactionPostDate - AssetTransactionType - AssetTransactionPaidByName - AssetTransactionTypeAdditionalDescription - AssetTransactionCategoryType - FinancialInstitutionTransactionIdentifier TransferRecurringIdempotencyKey: title: TransferRecurringIdempotencyKey type: string maxLength: 50 description: 'A random key provided by the client, per unique recurring transfer. Maximum of 50 characters. The API supports idempotency for safely retrying requests without accidentally performing the same operation twice. For example, if a request to create a recurring fails due to a network connection error, you can retry the request with the same idempotency key to guarantee that only a single recurring transfer is created.' CreditPayStub: title: CreditPayStub type: object additionalProperties: true description: An object representing an end user's pay stub. properties: deductions: $ref: '#/components/schemas/CreditPayStubDeductions' document_id: type: - string - 'null' description: An identifier of the document referenced by the document metadata. document_metadata: $ref: '#/components/schemas/CreditDocumentMetadata' earnings: $ref: '#/components/schemas/CreditPayStubEarnings' employee: $ref: '#/components/schemas/CreditPayStubEmployee' employer: $ref: '#/components/schemas/CreditPayStubEmployer' net_pay: $ref: '#/components/schemas/CreditPayStubNetPay' pay_period_details: $ref: '#/components/schemas/PayStubPayPeriodDetails' required: - deductions - document_id - document_metadata - earnings - employee - employer - net_pay - pay_period_details AssetReportRefreshRequestOptions: description: An optional object to filter `/asset_report/refresh` results. If provided, cannot be `null`. If not specified, the `options` from the original call to `/asset_report/create` will be used. type: object properties: client_report_id: type: - string - 'null' description: Client-generated identifier, which can be used by lenders to track loan applications. webhook: type: - string - 'null' description: URL to which Plaid will send Assets webhooks, for example when the requested Asset Report is ready. user: $ref: '#/components/schemas/AssetReportUser' LinkTokenCreateRequestIdentityVerification: type: object description: Specifies option for initializing Link for use with the Identity Verification product. properties: template_id: allOf: - $ref: '#/components/schemas/IdentityVerificationTemplateID' consent: x-hidden-from-docs: true allOf: - $ref: '#/components/schemas/IdentityVerificationConsent' gave_consent: $ref: '#/components/schemas/IdentityVerificationConsent' required: - template_id IdentityVerificationConsent: type: boolean example: true default: false title: IdentityVerificationConsent description: 'A flag specifying whether the end user has already agreed to a privacy policy specifying that their data will be shared with Plaid for verification purposes. If `gave_consent` is set to `true`, the `accept_tos` step will be marked as `skipped` and the end user''s session will start at the next step requirement.' BeaconAuditTrail: type: object title: BeaconAuditTrail description: Information about the last change made to the parent object specifying what caused the change as well as when it occurred. properties: source: $ref: '#/components/schemas/BeaconAuditTrailSource' dashboard_user_id: $ref: '#/components/schemas/DashboardUserIDNullable' timestamp: $ref: '#/components/schemas/Timestamp' required: - source - dashboard_user_id - timestamp additionalProperties: true IdentityVerificationDocumentISO8601DateOfBirth: type: - string - 'null' format: date title: IdentityVerificationDocumentISO8601DateOfBirth example: '1990-05-29' description: A date extracted from the document in the format YYYY-MM-DD (RFC 3339 Section 5.6). TransferOriginatorListResponse: title: TransferOriginatorListResponse type: object additionalProperties: true description: Defines the response schema for `/transfer/originator/list` properties: originators: type: array items: $ref: '#/components/schemas/Originator' request_id: $ref: '#/components/schemas/RequestID' required: - originators - request_id UserStatedIncomeSourcePayType: type: string description: The pay type - `GROSS`, `NET`, or `UNKNOWN` for a specified income source enum: - UNKNOWN - GROSS - NET IdentityDocumentMetadata: title: IdentityDocumentMetadata type: object additionalProperties: true description: In closed beta. Object representing metadata pertaining to the document. properties: is_account_number_match: type: boolean description: Boolean field indicating if the uploaded document's account number matches the account number we have on file last_updated: type: string format: date-time uploaded_at: type: string format: date-time x-hidden-from-docs: true AssetTransaction: title: AssetTransaction type: object additionalProperties: true description: An object representing... properties: ASSET_TRANSACTION_DETAIL: $ref: '#/components/schemas/AssetTransactionDetail' ASSET_TRANSACTION_DESCRIPTON: type: array items: $ref: '#/components/schemas/AssetTransactionDescription' description: Documentation not found in the MISMO model viewer and not provided by Freddie Mac. required: - ASSET_TRANSACTION_DETAIL - ASSET_TRANSACTION_DESCRIPTON RecurringTransactions: type: object description: Insights object for recurring transactions for `/beta/transactions/user_insights/v1/get` endpoint additionalProperties: true properties: inflow_streams: type: array description: An array of inflow transaction streams (e.g., income). items: $ref: '#/components/schemas/RecurringInsightsStream' outflow_streams: type: array description: An array of outflow transaction streams (e.g., subscriptions, bills, loan payments). items: $ref: '#/components/schemas/RecurringInsightsStream' required: - inflow_streams - outflow_streams LinkTokenCreateRequestUpdate: type: object description: Specifies options for initializing Link for [update mode](https://plaid.com/docs/link/update-mode). properties: account_selection_enabled: type: boolean description: If `true`, enables [update mode with Account Select](https://plaid.com/docs/link/update-mode/#using-update-mode-to-request-new-accounts) for institutions that do not use OAuth, or that use OAuth but do not have their own account selection flow. For institutions that have an OAuth account selection flow (i.e. most OAuth-enabled institutions), update mode with Account Select will always be enabled, regardless of the value of this field. default: false DepositoryAccountSubtypes: title: DepositoryAccountSubtypes type: array description: 'An array of account subtypes to display in Link. If not specified, all account subtypes will be shown. For a full list of valid types and subtypes, see the [Account schema](https://plaid.com/docs/api/accounts#account-type-schema). ' items: $ref: '#/components/schemas/DepositoryAccountSubtype' PhysicalDocumentImages: type: object description: URLs for downloading original and cropped images for this document submission. The URLs are designed to only allow downloading, not hot linking, so the URL will only serve the document image for 60 seconds before expiring. The expiration time is 60 seconds after the `GET` request for the associated Identity Verification attempt. A new expiring URL is generated with each request, so you can always rerequest the Identity Verification attempt if one of your URLs expires. properties: original_front: $ref: '#/components/schemas/DocumentImage__Front' original_back: $ref: '#/components/schemas/DocumentImage__Back' cropped_front: $ref: '#/components/schemas/DocumentImage__CroppedFront' cropped_back: $ref: '#/components/schemas/DocumentImage__CroppedBack' face: $ref: '#/components/schemas/DocumentImage__Face' required: - original_front - original_back - cropped_front - cropped_back - face additionalProperties: true TransferAuthorizationCancelRequest: title: TransferAuthorizationCancelRequest type: object description: Defines the request schema for `/transfer/authorization/cancel` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' authorization_id: $ref: '#/components/schemas/TransferAuthorizationID' required: - authorization_id PayrollRiskSignalsItem: title: PayrollRiskSignalsItem type: object additionalProperties: true description: Object containing fraud risk data pertaining to the Item linked as part of the verification. properties: item_id: $ref: '#/components/schemas/ItemId' verification_risk_signals: description: Array of payroll income document authenticity data retrieved for each of the user's accounts. type: array items: $ref: '#/components/schemas/DocumentRiskSignalsObject' required: - item_id - verification_risk_signals TransferBalance: title: TransferBalance description: Information about the balance held with Plaid. type: object additionalProperties: true properties: available: type: string description: The amount of this balance available for use (decimal string with two digits of precision e.g. "10.00"). current: type: string description: The available balance, plus amount of pending funds that in processing (decimal string with two digits of precision e.g. "10.00"). type: $ref: '#/components/schemas/TransferBalanceType' required: - available - type LinkSessionExit: type: - object - 'null' description: An object representing an [onExit](https://plaid.com/docs/link/web/#onexit) callback from Link. additionalProperties: true properties: error: $ref: '#/components/schemas/PlaidError' metadata: $ref: '#/components/schemas/LinkSessionExitMetadata' required: - error - metadata WatchlistScreeningStatus: description: A status enum indicating whether a screening is still pending review, has been rejected, or has been cleared. type: string enum: - rejected - pending_review - cleared example: cleared title: WatchlistScreeningStatus TransferLedgerGetResponse: title: TransferLedgerGetResponse type: object additionalProperties: true description: Defines the response schema for `/transfer/ledger/get` properties: balance: $ref: '#/components/schemas/TransferLedgerBalance' request_id: $ref: '#/components/schemas/RequestID' required: - balance - request_id AccountAccess: description: Allow or disallow product access by account. Unlisted (e.g. missing) accounts will be considered `new_accounts`. type: object properties: unique_id: description: The unique account identifier for this account. This value must match that returned by the data access API for this account. type: string authorized: description: Allow the application to see this account (and associated details, including balance) in the list of accounts If unset, defaults to `true`. type: - boolean - 'null' default: true account_product_access: $ref: '#/components/schemas/AccountProductAccessNullable' required: - unique_id TransferDiligenceDocumentUploadRequest: title: TransferDiligenceDocumentUploadRequest type: object description: Defines the request schema for `/transfer/diligence/document/upload` properties: originator_client_id: type: string description: The Client ID of the originator whose document that you want to upload. file: type: string format: binary description: 'A file to upload. The file size must be less than 20MB. Supported file extensions: .pdf.' purpose: $ref: '#/components/schemas/TransferDocumentPurpose' required: - originator_client_id - file - purpose ItemStatusLastWebhook: description: Information about the last webhook fired for the Item. type: - object - 'null' additionalProperties: true properties: sent_at: description: '[ISO 8601](https://wikipedia.org/wiki/ISO_8601) timestamp of when the webhook was fired. ' type: - string - 'null' format: date-time code_sent: description: The last webhook code sent. type: - string - 'null' WatchlistScreeningEntityHistoryListResponse: description: Paginated list of entity watchlist screenings additionalProperties: true properties: entity_watchlist_screenings: description: List of entity watchlist screening type: array items: $ref: '#/components/schemas/EntityWatchlistScreening' next_cursor: $ref: '#/components/schemas/Cursor' request_id: $ref: '#/components/schemas/RequestID' required: - entity_watchlist_screenings - next_cursor - request_id type: object LinkTokenGetMetadataResponse: type: object additionalProperties: true description: An object specifying the arguments originally provided to the `/link/token/create` call. properties: initial_products: type: array description: The `products` specified in the `/link/token/create` call. items: $ref: '#/components/schemas/Products' x-override-enum-values-shown: - assets - auth - employment - identity - income_verification - identity_verification - investments - liabilities - payment_initiation - standing_orders - transactions - transfer webhook: type: - string - 'null' description: The `webhook` specified in the `/link/token/create` call. country_codes: type: array description: The `country_codes` specified in the `/link/token/create` call. items: $ref: '#/components/schemas/CountryCode' language: type: - string - 'null' description: The `language` specified in the `/link/token/create` call. institution_data: $ref: '#/components/schemas/LinkTokenCreateInstitutionData' account_filters: $ref: '#/components/schemas/AccountFiltersResponse' redirect_uri: type: - string - 'null' description: The `redirect_uri` specified in the `/link/token/create` call. client_name: type: - string - 'null' description: The `client_name` specified in the `/link/token/create` call. user_token: $ref: '#/components/schemas/UserToken' required: - initial_products - webhook - country_codes - language - redirect_uri - client_name NumbersACH: title: NumbersACH type: object additionalProperties: true description: Identifying information for transferring money to or from a US account via ACH or wire transfer. properties: account_id: type: string description: The Plaid account ID associated with the account numbers account: type: string description: 'The ACH account number for the account. Note that when using OAuth with Chase Bank (`ins_56`), Chase will issue "tokenized" routing and account numbers, which are not the user''s actual account and routing numbers. These tokenized account numbers (also known as TANs) should work identically to normal account and routing numbers. The digits returned in the `mask` field will continue to reflect the actual account number, rather than the tokenized account number; for this reason, when displaying account numbers to the user to help them identify their account in your UI, always use the `mask` rather than truncating the `account` number. If a user revokes their permissions to your app, the tokenized numbers will no longer work.' routing: type: string description: The ACH routing number for the account. If the institution is `ins_56`, this may be a tokenized routing number. For more information, see the description of the `account` field. wire_routing: type: - string - 'null' description: The wire transfer routing number for the account, if available can_transfer_in: type: - boolean - 'null' description: Whether the account supports ACH transfers into the account x-hidden-from-docs: true can_transfer_out: type: - boolean - 'null' description: Whether the account supports ACH transfers out of the account x-hidden-from-docs: true required: - account_id - account - routing - wire_routing WatchlistScreeningEntityHitListRequest: description: Request input for listing hits for an entity watchlist screening type: object properties: secret: $ref: '#/components/schemas/APISecret' client_id: $ref: '#/components/schemas/APIClientID' entity_watchlist_screening_id: $ref: '#/components/schemas/EntityWatchlistScreeningID' cursor: $ref: '#/components/schemas/Cursor' required: - entity_watchlist_screening_id UserStatedIncomeSourceCategory: type: string description: The income category for a specified income source enum: - OTHER - SALARY - UNEMPLOYMENT - CASH - GIG_ECONOMY - RENTAL - CHILD_SUPPORT - MILITARY - RETIREMENT - LONG_TERM_DISABILITY - BANK_INTEREST IDNumberValue: type: string example: '123456789' title: IDNumberValue description: Value of identity document value typed in by user. Alpha-numeric, with all formatting characters stripped. For specific format requirements by ID type, see [Hybrid Input Validation](https://plaid.com/docs/identity-verification/hybrid-input-validation/). CreditBankIncomePDFGetRequest: title: CreditBankIncomePDFGetRequest type: object description: CreditBankIncomePDFGetRequest defines the request schema for `/credit/bank_income/pdf/get` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' user_token: $ref: '#/components/schemas/UserToken' required: - user_token EntityWatchlistSearchTerms: type: object required: - entity_watchlist_program_id - legal_name description: Search inputs for creating an entity watchlist screening properties: entity_watchlist_program_id: $ref: '#/components/schemas/EntityWatchlistProgramID' legal_name: $ref: '#/components/schemas/EntityWatchlistScreeningName' document_number: $ref: '#/components/schemas/WatchlistScreeningDocumentValueNullable' email_address: $ref: '#/components/schemas/EmailAddressNullable' country: $ref: '#/components/schemas/GenericCountryCodeNullable' phone_number: $ref: '#/components/schemas/WatchlistScreeningPhoneNumberNullable' url: $ref: '#/components/schemas/URLNullable' TransferGetRequest: title: TransferGetRequest type: object description: Defines the request schema for `/transfer/get` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' transfer_id: $ref: '#/components/schemas/TransferID' originator_client_id: deprecated: true x-hidden-from-docs: true type: - string - 'null' description: The Plaid client ID of the transfer originator. Should only be present if `client_id` is a third-party sender (TPS). required: - transfer_id SandboxTransferSweepSimulateResponse: title: SandboxTransferSweepSimulateResponse type: object additionalProperties: true description: Defines the response schema for `/sandbox/transfer/sweep/simulate` properties: sweep: $ref: '#/components/schemas/SimulatedTransferSweep' request_id: $ref: '#/components/schemas/RequestID' required: - request_id BaseReportWarningCode: type: string description: The warning code identifies a specific kind of warning. `OWNERS_UNAVAILABLE` indicates that account-owner information is not available. `TRANSACTIONS_UNAVAILABLE` indicates that transactions information associated with Credit and Depository accounts are unavailable. enum: - OWNERS_UNAVAILABLE - TRANSACTIONS_UNAVAILABLE ProcessorSignalReturnReportResponse: title: ProcessorSignalReturnReportResponse description: ProcessorSignalReturnReportResponse defines the response schema for `/processor/signal/return/report` additionalProperties: true type: object properties: request_id: $ref: '#/components/schemas/RequestID' required: - request_id PaymentProfileRemoveRequest: type: object description: PaymentProfileRemoveRequest defines the request schema for `/payment_profile/remove` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' payment_profile_token: $ref: '#/components/schemas/PaymentProfileToken' required: - payment_profile_token PartnerEndCustomerCustomerSupportInfo: description: This information is public. Users of your app will see this information when managing connections between your app and their bank accounts in Plaid Portal. Defaults to partner's customer support info if omitted. type: object additionalProperties: true properties: email: type: string phone_number: type: string contact_url: type: string link_update_url: type: string TransferAuthorizationGuaranteeDecision: type: - string - 'null' x-hidden-from-docs: true description: Indicates whether the transfer is guaranteed by Plaid (Guarantee customers only). This field will contain either `GUARANTEED` or `NOT_GUARANTEED` indicating whether Plaid will guarantee the transfer. If the transfer is not guaranteed, additional information will be provided in the `guarantee_decision_rationale` field. Refer to the `code` field in `guarantee_decision_rationale` for details. enum: - GUARANTEED - NOT_GUARANTEED - null IdentityDocumentUploadRiskSummary: title: IdentityDocumentUploadRiskSummary type: object additionalProperties: true description: Risk summary of an uploaded document properties: risk_score: type: - integer - 'null' description: Integer value representing the risk score of the document POBoxStatus: description: Field describing whether the associated address is a post office box. Will be `yes` when a P.O. box is detected, `no` when Plaid confirmed the address is not a P.O. box, and `no_data` when Plaid was not able to determine if the address is a P.O. box. type: string enum: - 'yes' - 'no' - no_data example: 'yes' SandboxProcessorTokenCreateResponse: type: object additionalProperties: true properties: processor_token: type: string description: A processor token that can be used to call the `/processor/` endpoints. request_id: $ref: '#/components/schemas/RequestID' description: SandboxProcessorTokenCreateResponse defines the response schema for `/sandbox/processor_token/create` required: - processor_token - request_id CreditBankIncomeCause: type: object description: An error object and associated `item_id` used to identify a specific Item and error when a batch operation operating on multiple Items has encountered an error in one of the Items. properties: error_type: $ref: '#/components/schemas/CreditBankIncomeErrorType' error_code: type: string description: We use standard HTTP response codes for success and failure notifications, and our errors are further classified by `error_type`. In general, 200 HTTP codes correspond to success, 40X codes are for developer- or user-related failures, and 50X codes are for Plaid-related issues. Error fields will be `null` if no error has occurred. error_message: type: string description: A developer-friendly representation of the error code. This may change over time and is not safe for programmatic use. display_message: type: string description: 'A user-friendly representation of the error code. null if the error is not related to user action. This may change over time and is not safe for programmatic use.' item_id: type: string description: The `item_id` of the Item associated with this warning. required: - error_type - error_code - error_message - display_message - item_id WatchlistScreeningIndividualProgramGetResponse: description: A program that configures the active lists, search parameters, and other behavior for initial and ongoing screening of individuals. additionalProperties: true properties: id: $ref: '#/components/schemas/WatchlistProgramID' created_at: $ref: '#/components/schemas/Timestamp' is_rescanning_enabled: description: Indicator specifying whether the program is enabled and will perform daily rescans. type: boolean example: true lists_enabled: description: Watchlists enabled for the associated program type: array example: - US_SDN uniqueItems: true items: $ref: '#/components/schemas/IndividualWatchlistCode' name: $ref: '#/components/schemas/IndividualWatchlistScreeningProgramName' name_sensitivity: $ref: '#/components/schemas/ProgramNameSensitivity' audit_trail: $ref: '#/components/schemas/WatchlistScreeningAuditTrail' is_archived: $ref: '#/components/schemas/ProgramArchived' request_id: $ref: '#/components/schemas/RequestID' required: - id - created_at - is_rescanning_enabled - lists_enabled - name - name_sensitivity - audit_trail - is_archived - request_id type: object CreditBankIncomeRefreshRequestOptions: description: An optional object for `/credit/bank_income/refresh` request options. type: object properties: days_requested: type: integer description: How many days of data to include in the refresh. If not specified, this will default to the days requested in the most recently generated bank income report for the user. PaymentInitiationConsentRevokeResponse: type: object additionalProperties: true description: PaymentInitiationConsentRevokeResponse defines the response schema for `/payment_initation/consent/revoke` properties: request_id: $ref: '#/components/schemas/RequestID' ProcessorTransactionsRecurringGetResponse: type: object additionalProperties: true description: ProcessorTransactionsRecurringGetResponse defines the response schema for `/processor/transactions/recurring/get` properties: inflow_streams: type: array description: An array of depository transaction streams. items: $ref: '#/components/schemas/TransactionStream' outflow_streams: type: array description: An array of expense transaction streams. items: $ref: '#/components/schemas/TransactionStream' updated_datetime: type: string format: date-time description: Timestamp in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format (`YYYY-MM-DDTHH:mm:ssZ`) indicating the last time transaction streams for the given account were updated on request_id: $ref: '#/components/schemas/RequestID' required: - inflow_streams - outflow_streams - updated_datetime - request_id WatchlistScreeningEntityProgramGetResponse: description: A program that configures the active lists, search parameters, and other behavior for initial and ongoing screening of entities. additionalProperties: true properties: id: $ref: '#/components/schemas/EntityWatchlistProgramID' created_at: $ref: '#/components/schemas/Timestamp' is_rescanning_enabled: description: Indicator specifying whether the program is enabled and will perform daily rescans. type: boolean example: true lists_enabled: description: Watchlists enabled for the associated program type: array example: - EU_CON uniqueItems: true items: $ref: '#/components/schemas/EntityWatchlistCode' name: $ref: '#/components/schemas/EntityWatchlistScreeningProgramName' name_sensitivity: $ref: '#/components/schemas/ProgramNameSensitivity' audit_trail: $ref: '#/components/schemas/WatchlistScreeningAuditTrail' is_archived: $ref: '#/components/schemas/ProgramArchived' request_id: $ref: '#/components/schemas/RequestID' required: - id - created_at - is_rescanning_enabled - lists_enabled - name - name_sensitivity - audit_trail - is_archived - request_id type: object WalletListRequest: type: object description: WalletListRequest defines the request schema for `/wallet/list` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' iso_currency_code: $ref: '#/components/schemas/WalletISOCurrencyCode' cursor: type: string maxLength: 256 description: A base64 value representing the latest e-wallet that has already been requested. Set this to `next_cursor` received from the previous `/wallet/list` request. If provided, the response will only contain e-wallets created before that e-wallet. If omitted, the response will contain e-wallets starting from the most recent, and in descending order. count: type: integer description: The number of e-wallets to fetch minimum: 1 maximum: 20 default: 10 RiskCheckEmailTopLevelDomainIsSuspicious: description: Indicates whether the email address top level domain, which is the last part of the domain, is fraudulent or risky if known. In most cases, a suspicious top level domain is also associated with a disposable or high-risk domain. example: 'yes' type: string enum: - 'yes' - 'no' - no_data MerchantInsights: type: object description: Insights into a user’s top merchants. properties: name: type: string description: The counterparty name. entity_id: type: - string - 'null' description: A unique, stable, Plaid-generated id that maps to the merchant. website: type: - string - 'null' description: The website associated with the merchant. transaction_count: type: integer description: The number of transactions associated with merchant of this type. personal_finance_category_primary: type: - string - 'null' description: The primary personal finance category associated with this merchant. personal_finance_category_detailed: type: - string - 'null' description: The detailed personal finance category associated with this merchant. total_outflows: type: number format: double description: Sum of outflow amounts. total_inflows: type: number format: double description: Sum of inflow amounts. required: - name - website - transaction_count - personal_finance_category_primary - personal_finance_category_detailed - total_outflows - total_inflows WatchlistScreeningIndividualListRequest: description: Request input for listinging watchlist screenings for individuals type: object properties: secret: $ref: '#/components/schemas/APISecret' client_id: $ref: '#/components/schemas/APIClientID' watchlist_program_id: $ref: '#/components/schemas/WatchlistProgramID' client_user_id: $ref: '#/components/schemas/ClientUserID' status: $ref: '#/components/schemas/WatchlistScreeningStatus' assignee: $ref: '#/components/schemas/DashboardUserID' cursor: $ref: '#/components/schemas/Cursor' required: - watchlist_program_id Role: title: Role type: object additionalProperties: true description: ADocumentation not found in the MISMO model viewer and not provided by Freddie Mac. properties: ROLE_DETAIL: $ref: '#/components/schemas/RoleDetail' required: - ROLE_DETAIL IdentityVerificationStepStatus: type: string enum: - success - active - failed - waiting_for_prerequisite - not_applicable - skipped - expired - canceled - pending_review - manually_approved - manually_rejected example: success title: IdentityVerificationStepStatus description: The status of a step in the Identity Verification process. LinkSessionPayrollIncomeResult: type: object description: The details of a digital payroll income verification in Link. additionalProperties: true properties: num_paystubs_retrieved: type: integer description: The number of paystubs retrieved from a payroll provider. num_w2s_retrieved: type: integer description: The number of W-2s retrieved from a payroll provider. institution: $ref: '#/components/schemas/LinkSessionSuccessMetadataInstitution' required: - num_paystubs_retrieved - num_w2s_retrieved - institution TransferAuthorizationGuaranteeDecisionRationale: title: TransferAuthorizationGuaranteeDecisionRationale type: - object - 'null' additionalProperties: true x-hidden-from-docs: true description: The rationale for Plaid's decision to not guarantee a transfer. Will be `null` unless `guarantee_decision` is `NOT_GUARANTEED`. properties: code: $ref: '#/components/schemas/TransferAuthorizationGuaranteeDecisionRationaleCode' description: type: string description: A human-readable description of why the transfer cannot be guaranteed. required: - code - description IdentityDocumentsUploadsGetRequestOptions: type: object description: An optional object to filter `/identity/documents/uploads/get` results. properties: account_ids: type: array description: 'A list of `account_ids` to retrieve for the Item. Note: An error will be returned if a provided `account_id` is not associated with the Item.' items: type: string TransferACHNetwork: type: string title: TransferACHNetwork description: 'The ACH networks used for the funds flow. For requests submitted as either `ach` or `same-day-ach` the cutoff for same-day is 3:30 PM Eastern Time and the cutoff for next-day transfers is 5:30 PM Eastern Time. It is recommended to submit a request at least 15 minutes before the cutoff time in order to ensure that it will be processed before the cutoff. Any request that is indicated as `same-day-ach` and that misses the same-day cutoff, but is submitted in time for the next-day cutoff, will be sent over next-day rails and will not incur same-day charges.' enum: - ach - same-day-ach TransferCapabilitiesGetResponse: title: TransferCapabilitiesGetResponse type: object additionalProperties: true description: Defines the response schema for `/transfer/capabilities/get` properties: institution_supported_networks: $ref: '#/components/schemas/InstitutionSupportedNetworks' request_id: $ref: '#/components/schemas/RequestID' required: - institution_supported_networks - request_id CreditFreddieMacAssets: title: CreditFreddieMacAssets type: object additionalProperties: true description: Documentation not found in the MISMO model viewer and not provided by Freddie Mac. properties: ASSET: type: array items: $ref: '#/components/schemas/CreditFreddieMacAsset' description: Documentation not found in the MISMO model viewer and not provided by Freddie Mac. required: - ASSET LinkSessionSuccessMetadataInstitution: type: - object - 'null' description: An institution object. If the Item was created via Same-Day or Instant micro-deposit verification, will be `null`. properties: name: type: string description: The full institution name, such as `'Wells Fargo'` institution_id: type: string description: The Plaid institution identifier RiskCheckEmailDomainIsFreeProvider: description: Indicates whether the email address domain is a free provider such as Gmail or Hotmail if known. example: 'yes' type: string enum: - 'yes' - 'no' - no_data CreditPayrollIncomeRiskSignalsGetRequest: title: CreditPayrollIncomeRiskSignalsGetRequest type: object description: CreditPayrollIncomeRiskSignalsGetRequest defines the request schema for `/credit/payroll_income/risk_signals/get` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' user_token: $ref: '#/components/schemas/UserToken' CreditFreddieMacParty: title: CreditFreddieMacParty type: object additionalProperties: true description: A collection of information about a single party to a transaction. Included direct participants like the borrower and seller as well as indirect participants such as the flood certificate provider. properties: INDIVIDUAL: $ref: '#/components/schemas/CreditFreddieMacPartyIndividual' ROLES: $ref: '#/components/schemas/Roles' TAXPAYER_IDENTIFIERS: $ref: '#/components/schemas/TaxpayerIdentifiers' required: - INDIVIDUAL - ROLES - TAXPAYER_IDENTIFIERS TransferCreateIdempotencyKey: title: TransferCreateIdempotencyKey type: string deprecated: true x-hidden-from-docs: true maxLength: 50 description: 'Deprecated. `authorization_id` is now used as idempotency instead. A random key provided by the client, per unique transfer. Maximum of 50 characters. The API supports idempotency for safely retrying requests without accidentally performing the same operation twice. For example, if a request to create a transfer fails due to a network connection error, you can retry the request with the same idempotency key to guarantee that only a single transfer is created.' OtherAccountSubtype: type: string description: Valid account subtypes for other accounts. For a list containing descriptions of each subtype, see [Account schemas](https://plaid.com/docs/api/accounts/#StandaloneAccountType-other). enum: - other - all DocumentRiskSummary: title: DocumentRiskSummary type: object additionalProperties: true description: A summary across all risk signals associated with a document properties: risk_score: type: - number - 'null' description: A number between 0 and 100, inclusive, where a score closer to 0 indicates a document is likely to be trustworthy and a score closer to 100 indicates a document is likely to be fraudulent required: - risk_score AddressPurposeLabel: description: 'Field describing whether the associated address is being used for commercial or residential purposes. Note: This value will be `no_data` when Plaid does not have sufficient data to determine the address''s use.' type: string enum: - residential - commercial - no_data example: residential AccountVerificationInsights: title: VerificationInsights type: object additionalProperties: true description: Insights from performing database verification for the account. properties: network_status: $ref: '#/components/schemas/AccountVerificationInsightsNetworkStatus' previous_returns: $ref: '#/components/schemas/AccountVerificationInsightsPreviousReturns' account_number_format: $ref: '#/components/schemas/AccountVerificationInsightsAccountNumberFormat' required: - network_status - account_number_format SandboxTransferFireWebhookRequest: title: SandboxTransferFireWebhookRequest type: object description: Defines the request schema for `/sandbox/transfer/fire_webhook` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' webhook: type: string description: The URL to which the webhook should be sent. required: - webhook PaymentInitiationConsentRevokeRequest: type: object description: PaymentInitiationConsentRevokeRequest defines the request schema for `/payment_initiation/consent/revoke` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' consent_id: type: string description: The consent ID. required: - consent_id ServiceProductFulfillment: title: ServiceProductFulfillment type: object additionalProperties: true description: A collection of details related to a fulfillment service or product in terms of request, process and result. properties: SERVICE_PRODUCT_FULFILLMENT_DETAIL: $ref: '#/components/schemas/ServiceProductFulfillmentDetail' required: - SERVICE_PRODUCT_FULFILLMENT_DETAIL TransferIntentCreate: title: TransferIntentCreate type: object additionalProperties: true description: Represents a transfer intent within Transfer UI. properties: id: type: string description: Plaid's unique identifier for the transfer intent object. created: type: string format: date-time description: The datetime the transfer was created. This will be of the form `2006-01-02T15:04:05Z`. status: $ref: '#/components/schemas/TransferIntentStatus' account_id: type: - string - 'null' description: The Plaid `account_id` corresponding to the end-user account that will be debited or credited. Returned only if `account_id` was set on intent creation. origination_account_id: type: string description: Plaid’s unique identifier for the origination account for the intent. If not provided, the default account will be used. deprecated: true x-hidden-from-docs: true funding_account_id: $ref: '#/components/schemas/TransferFundingAccountIDResponse' amount: $ref: '#/components/schemas/TransferAmount' mode: $ref: '#/components/schemas/TransferIntentCreateMode' network: $ref: '#/components/schemas/TransferIntentCreateNetwork' ach_class: $ref: '#/components/schemas/ACHClass' user: $ref: '#/components/schemas/TransferUserInResponse' description: type: string description: A description for the underlying transfer. Maximum of 8 characters. metadata: $ref: '#/components/schemas/TransferMetadata' iso_currency_code: type: string description: The currency of the transfer amount, e.g. "USD" require_guarantee: type: - boolean - 'null' x-hidden-from-docs: true description: When `true`, the transfer requires a `GUARANTEED` decision by Plaid to proceed (Guarantee customers only). required: - id - created - status - origination_account_id - funding_account_id - amount - mode - user - description - iso_currency_code StudentRepaymentPlan: title: StudentRepaymentPlan type: object additionalProperties: true description: An object representing the repayment plan for the student loan properties: description: type: - string - 'null' description: The description of the repayment plan as provided by the servicer. type: type: - string - 'null' enum: - extended graduated - extended standard - graduated - income-contingent repayment - income-based repayment - interest-only - other - pay as you earn - revised pay as you earn - standard - saving on a valuable education - null description: The type of the repayment plan. required: - description - type EmploymentSourceType: title: EmploymentSourceType enum: - bank - payroll description: The types of source employment data that users should be able to share type: string URLNullable: type: - string - 'null' format: uri title: URL example: https://example.com description: An 'http' or 'https' URL (must begin with either of those). PrismCashScore: type: - object - 'null' additionalProperties: true description: The data from the Cash Score product returned by Prism. properties: version: type: integer description: The version of Prism's cash score model used. score: type: integer description: The score returned by Prism. Ranges from 1-999, with higher score indicating lower risk. reason_codes: type: array description: The reasons for an individual having risk according to the cash score. items: type: string metadata: $ref: '#/components/schemas/PrismCashScoreMetadata' required: - version - score TransactionsGetRequestOptions: type: object description: An optional object to be used with the request. If specified, `options` must not be `null`. properties: account_ids: type: array description: 'A list of `account_ids` to retrieve for the Item Note: An error will be returned if a provided `account_id` is not associated with the Item.' items: type: string count: type: integer default: 100 description: The number of transactions to fetch. minimum: 1 maximum: 500 offset: type: integer default: 0 description: The number of transactions to skip. The default value is 0. minimum: 0 include_original_description: type: - boolean - 'null' default: false description: Include the raw unparsed transaction description from the financial institution. include_personal_finance_category_beta: type: boolean default: false description: Personal finance categories are now returned by default. deprecated: true x-hidden-from-docs: true include_personal_finance_category: type: boolean default: false description: Personal finance categories are now returned by default. deprecated: true x-hidden-from-docs: true include_logo_and_counterparty_beta: type: boolean default: false description: Counterparties and extra merchant fields are now returned by default. deprecated: true x-hidden-from-docs: true days_requested: description: 'This option only applies to calls for Items that were not initialized with Transactions during Link and are now adding the Transactions product to the Item for the first time. In these cases, this option controls the maximum number of days of transaction history that Plaid will request from the financial institution. For developer accounts created after December 3, 2023, if no value is specified, this will default to 90 days. For developer accounts created on December 3, 2023 or earlier, if no value is specified, this will default to 730 days until June 24, 2024, at which point it will default to 90 days. If Transactions has already been added to the Item prior to this call, this field will have no effect. We strongly recommend that customers utilizing [Recurring Transactions](https://plaid.com/docs/api/products/transactions/#transactionsrecurringget) request at least 180 days of history for optimal results.' type: integer minimum: 1 maximum: 730 default: 90 NumbersATON: x-hidden-from-docs: true title: NumbersATON type: object additionalProperties: true description: Identifying information for transferring holdings to an investments account via ATON. properties: account_id: type: string description: The Plaid account ID associated with the account numbers account: type: string description: The full account number for the account required: - account_id - account EntityScreeningHitsPhoneNumberItems: type: object description: Analyzed phone numbers for the associated hit properties: analysis: $ref: '#/components/schemas/MatchSummary' data: $ref: '#/components/schemas/EntityScreeningHitPhoneNumbers' additionalProperties: true InvestmentsTransactionsGetRequest: type: object description: InvestmentsTransactionsGetRequest defines the request schema for `/investments/transactions/get` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' access_token: $ref: '#/components/schemas/AccessToken' start_date: type: string format: date description: The earliest date for which to fetch transaction history. Dates should be formatted as YYYY-MM-DD. end_date: type: string format: date description: The most recent date for which to fetch transaction history. Dates should be formatted as YYYY-MM-DD. options: $ref: '#/components/schemas/InvestmentsTransactionsGetRequestOptions' required: - access_token - start_date - end_date CraLoanRegister: type: object description: Contains loan data to register. additionalProperties: true properties: user_token: $ref: '#/components/schemas/CraLoanUserToken' loan_id: $ref: '#/components/schemas/CraLoanID' type: $ref: '#/components/schemas/CraLoanType' payment_schedule: $ref: '#/components/schemas/CraLoanPaymentSchedule' opened_date: type: string format: date description: The date the loan account was opened. The date should be in ISO 8601 format (YYYY-MM-DD). opened_with_status: $ref: '#/components/schemas/CraLoanOpenedStatus' loan_amount: type: number description: The total amount of the approved loan. application: $ref: '#/components/schemas/CraLoanRegisterApplication' required: - user_token - loan_id - type - opened_date - payment_schedule - opened_with_status IncomeVerificationPayrollFlowType: title: IncomeVerificationPayrollFlowType enum: - payroll_digital_income - payroll_document_income description: Flow types to retrieve payroll income data type: string EntityWatchlistScreeningReviewID: type: string title: EntityWatchlistScreeningReviewID example: entrev_aCLNRxK3UVzn2r description: ID of the associated entity review. InstitutionsSearchPaymentInitiationOptions: type: - object - 'null' description: Additional options that will be used to filter institutions by various Payment Initiation configurations. properties: payment_id: type: - string - 'null' description: A unique ID identifying the payment consent_id: type: - string - 'null' description: A unique ID identifying the payment consent PaymentInitiationRecipientGetRequest: type: object description: PaymentInitiationRecipientGetRequest defines the request schema for `/payment_initiation/recipient/get` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' recipient_id: type: string description: The ID of the recipient required: - recipient_id CreditPayrollIncomePrecheckRequest: title: CreditPayrollIncomePrecheckRequest type: object description: Defines the request schema for `/credit/payroll_income/precheck`. properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' user_token: $ref: '#/components/schemas/UserToken' access_tokens: type: array description: An array of access tokens corresponding to Items belonging to the user whose eligibility is being checked. Note that if the Items specified here are not already initialized with `transactions`, providing them in this field will cause these Items to be initialized with (and billed for) the Transactions product. items: $ref: '#/components/schemas/AccessToken' employer: $ref: '#/components/schemas/IncomeVerificationPrecheckEmployer' us_military_info: $ref: '#/components/schemas/IncomeVerificationPrecheckMilitaryInfo' payroll_institution: $ref: '#/components/schemas/IncomeVerificationPrecheckPayrollInstitution' ProcessorTransactionsRefreshRequest: type: object description: ProcessorTransactionsRefreshRequest defines the request schema for `/processor/transactions/refresh` properties: client_id: $ref: '#/components/schemas/APIClientID' processor_token: $ref: '#/components/schemas/ProcessorToken' secret: $ref: '#/components/schemas/APISecret' required: - processor_token BankTransferStatus: type: string title: BankTransferStatus description: The status of the transfer. enum: - pending - posted - cancelled - failed - reversed ProcessorTokenPermissionsGetResponse: type: object additionalProperties: true description: ProcessorTokenPermissionsGetResponse defines the response schema for `/processor/token/permissions/get` properties: request_id: $ref: '#/components/schemas/RequestID' products: type: array description: A list of products the processor token should have access to. An empty list means that the processor has access to all available products, including future products. items: $ref: '#/components/schemas/Products' required: - request_id - products EntityWatchlistScreeningID: type: string example: entscr_52xR9LKo77r1Np title: EntityWatchlistScreeningID description: ID of the associated entity screening. TransferRefundStatus: type: string title: TransferRefundStatus description: 'The status of the refund. `pending`: A new refund was created; it is in the pending state. `posted`: The refund has been successfully submitted to the payment network. `settled`: Credits have been refunded to the Plaid linked account. `cancelled`: The refund was cancelled by the client. `failed`: The refund has failed. `returned`: The refund was returned.' enum: - pending - posted - cancelled - failed - settled - returned TransferCreditUsageConfiguration: description: Specifies the originator's expected usage of credits. For all dollar amounts, use a decimal string with two digits of precision e.g. "10.00". This field is required if the originator is expected to process credit transfers. type: - object - 'null' properties: expected_frequency: $ref: '#/components/schemas/OriginatorExpectedTransferFrequency' expected_highest_amount: description: The originator’s expected highest amount for a single credit transfer. type: string expected_average_amount: description: The originator’s expected average amount per credit. type: string expected_monthly_amount: description: The originator’s monthly expected ACH credit processing amount for the next 6-12 months. type: string sec_codes: description: 'Specifies the expected use cases for the originator’s credit transfers. This should be a list that contains one or more of the following codes: `"ccd"` - Corporate Credit or Debit - fund transfer between two corporate bank accounts `"ppd"` - Prearranged Payment or Deposit - the transfer is part of a pre-existing relationship with a consumer, e.g. bill payment `"web"` - A credit Entry initiated by or on behalf of a holder of a Consumer Account that is intended for a Consumer Account of a Receiver' type: array items: $ref: '#/components/schemas/CreditACHClass' required: - expected_frequency - expected_highest_amount - expected_average_amount - expected_monthly_amount - sec_codes TransferMetricsGetRequest: title: TransferMetricsGetRequest type: object description: Defines the request schema for `/transfer/metrics/get` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' originator_client_id: type: - string - 'null' description: The Plaid client ID of the transfer originator. Should only be present if `client_id` is a [Platform customer](https://plaid.com/docs/transfer/application/#originators-vs-platforms). WalletTransactionFailureReason: type: - string - 'null' description: 'The error code of a failed transaction. Error codes include: `EXTERNAL_SYSTEM`: The transaction was declined by an external system. `EXPIRED`: The transaction request has expired. `CANCELLED`: The transaction request was rescinded. `INVALID`: The transaction did not meet certain criteria, such as an inactive account or no valid counterparty, etc. `UNKNOWN`: The transaction was unsuccessful, but the exact cause is unknown.' enum: - EXTERNAL_SYSTEM - EXPIRED - CANCELLED - INVALID - UNKNOWN TransactionsRecurringGetRequestOptions: type: object description: An optional object to be used with the request. If specified, `options` must not be `null`. x-hidden-from-docs: true properties: include_personal_finance_category: type: boolean default: false description: Personal finance categories are now returned by default. deprecated: true x-hidden-from-docs: true NumbersACHNullable: description: Identifying information for transferring money to or from a US account via ACH or wire transfer. allOf: - $ref: '#/components/schemas/NumbersACH' - type: object additionalProperties: true WatchlistScreeningEntityUpdateRequestResettableField: type: string enum: - assignee description: The name of a field that can be reset back to null TransferLedgerFundingAccountIDRequest: type: - string - 'null' description: Specify which funding account linked to this Plaid Ledger to use. Customers can find a list of `funding_account_id`s in the Accounts page of your Plaid Dashboard, under the "Account ID" column. If this field is left blank, this will default to the default `funding_account_id` specified during onboarding. If an `originator_client_id` is specified, the `funding_account_id` must belong to the specified originator, and if `funding_account_id` is left blank, the originator's default `funding_account_id` will be used. TransactionsGetRequest: type: object description: TransactionsGetRequest defines the request schema for `/transactions/get` properties: client_id: $ref: '#/components/schemas/APIClientID' options: $ref: '#/components/schemas/TransactionsGetRequestOptions' access_token: $ref: '#/components/schemas/AccessToken' secret: $ref: '#/components/schemas/APISecret' start_date: type: string format: date description: The earliest date for which data should be returned. Dates should be formatted as YYYY-MM-DD. end_date: type: string format: date description: The latest date for which data should be returned. Dates should be formatted as YYYY-MM-DD. required: - access_token - start_date - end_date TransferType: type: string title: TransferType description: The type of transfer. This will be either `debit` or `credit`. A `debit` indicates a transfer of money into the origination account; a `credit` indicates a transfer of money out of the origination account. enum: - debit - credit GenericCountryCodeNullable: type: - string - 'null' title: GenericCountryCode minLength: 2 example: US description: Valid, capitalized, two-letter ISO code representing the country of this object. Must be in ISO 3166-1 alpha-2 form. ProxyType: type: - string - 'null' description: 'An enum indicating whether a network proxy is present and if so what type it is. `none_detected` indicates the user is not on a detectable proxy network. `tor` indicates the user was using a Tor browser, which sends encrypted traffic on a decentralized network and is somewhat similar to a VPN (Virtual Private Network). `vpn` indicates the user is on a VPN (Virtual Private Network) `web_proxy` indicates the user is on a web proxy server, which may allow them to conceal information such as their IP address or other identifying information. `public_proxy` indicates the user is on a public web proxy server, which is similar to a web proxy but can be shared by multiple users. This may allow multiple users to appear as if they have the same IP address for instance.' enum: - none_detected - tor - vpn - web_proxy - public_proxy PayStubDistributionBreakdown: title: PayStubDistributionBreakdown type: object description: Information about the accounts that the payment was distributed to. additionalProperties: true properties: account_name: type: - string - 'null' description: Name of the account for the given distribution. bank_name: type: - string - 'null' description: The name of the bank that the payment is being deposited to. current_amount: type: - number - 'null' format: double description: The amount distributed to this account. iso_currency_code: type: - string - 'null' description: The ISO-4217 currency code of the net pay. Always `null` if `unofficial_currency_code` is non-null. mask: type: - string - 'null' description: The last 2-4 alphanumeric characters of an account's official account number. type: type: - string - 'null' description: Type of the account that the paystub was sent to (e.g. 'checking'). unofficial_currency_code: type: - string - 'null' description: 'The unofficial currency code associated with the net pay. Always `null` if `iso_currency_code` is non-`null`. Unofficial currency codes are used for currencies that do not have official ISO currency codes, such as cryptocurrencies and the currencies of certain countries. See the [currency code schema](https://plaid.com/docs/api/accounts#currency-code-schema) for a full listing of supported `iso_currency_code`s.' required: - account_name - bank_name - current_amount - iso_currency_code - mask - type - unofficial_currency_code IssuingCountry: description: 'A binary match indicator specifying whether the country that issued the provided document matches the country that the user separately provided to Plaid. Note: You can configure whether a `no_match` on `issuing_country` fails the `documentary_verification` by editing your Plaid Template.' type: string enum: - match - no_match CraLoanOpenedStatus: type: object description: Contains the status and date information of the loan when registering. additionalProperties: true properties: status: $ref: '#/components/schemas/CraLoanStatus' date: $ref: '#/components/schemas/CraLoanStatusEffectiveDate' required: - status - date AssetReportId: title: AssetReportId description: A unique ID identifying an Asset Report. Like all Plaid identifiers, this ID is case sensitive. type: string BaseReportNumberFlowInsights: title: BaseReportNumberFlowInsights description: The number of credits or debits out of the account. This field will only added for depository accounts x-hidden-from-docs: true type: object additionalProperties: true properties: start_date: type: string format: date description: 'The start date of this time period. The date will be returned in an ISO 8601 format (YYYY-MM-DD).' end_date: type: string format: date description: 'The end date of this time period. The date will be returned in an ISO 8601 format (YYYY-MM-DD).' count: type: integer description: The number of credits or debits out of the account for this time period. EntityScreeningHitUrls: type: object description: URLs associated with the entity screening hit properties: url: $ref: '#/components/schemas/URL' required: - url additionalProperties: true RiskCheckBehaviorBotDetectedLabel: description: 'Field describing the outcome of a bot detection behavior risk check. `yes` indicates that automated activity was detected. `no` indicates that automated activity was not detected. `no_data` indicates there was not enough information available to give an accurate signal.' type: string enum: - 'yes' - 'no' - no_data BankTransferEventType: type: string title: BankTransferEventType description: 'The type of event that this bank transfer represents. `pending`: A new transfer was created; it is in the pending state. `cancelled`: The transfer was cancelled by the client. `failed`: The transfer failed, no funds were moved. `posted`: The transfer has been successfully submitted to the payment network. `reversed`: A posted transfer was reversed.' enum: - pending - cancelled - failed - posted - reversed InvestmentAccountSubtype: type: string description: Valid account subtypes for investment accounts. For a list containing descriptions of each subtype, see [Account schemas](https://plaid.com/docs/api/accounts/#StandaloneAccountType-investment). enum: - '529' - 401a - 401k - 403B - 457b - brokerage - cash isa - crypto exchange - education savings account - fixed annuity - gic - health reimbursement arrangement - hsa - ira - isa - keogh - lif - life insurance - lira - lrif - lrsp - mutual fund - non-custodial wallet - non-taxable brokerage account - other - other annuity - other insurance - pension - prif - profit sharing plan - qshr - rdsp - resp - retirement - rlif - roth - roth 401k - rrif - rrsp - sarsep - sep ira - simple ira - sipp - stock plan - tfsa - trust - ugma - utma - variable annuity - all SandboxBankIncomeWebhookFireRequestWebhookFields: type: object properties: user_id: type: string description: The user id to be returned in INCOME webhooks bank_income_refresh_complete_result: $ref: '#/components/schemas/BankIncomeRefreshCompleteResult' description: Optional fields which will be populated in the simulated webhook required: - user_id BeaconUserRequestAddress: type: - object - 'null' title: BeaconUserRequestAddress description: Home address for the associated user. For more context on this field, see [Input Validation by Country](https://plaid.com/docs/identity-verification/hybrid-input-validation/#input-validation-by-country). properties: street: $ref: '#/components/schemas/Street' street2: $ref: '#/components/schemas/Street2' city: $ref: '#/components/schemas/City' region: $ref: '#/components/schemas/Region' postal_code: $ref: '#/components/schemas/PostalCode' country: $ref: '#/components/schemas/GenericCountryCode' required: - street - city - country additionalProperties: true CreditBankIncomeErrorType: type: string description: A broad categorization of the error. Safe for programmatic use. enum: - INTERNAL_SERVER_ERROR - INSUFFICIENT_CREDENTIALS - ITEM_LOCKED - USER_SETUP_REQUIRED - COUNTRY_NOT_SUPPORTED - INSTITUTION_DOWN - INSTITUTION_NO_LONGER_SUPPORTED - INSTITUTION_NOT_RESPONDING - INVALID_CREDENTIALS - INVALID_MFA - INVALID_SEND_METHOD - ITEM_LOGIN_REQUIRED - MFA_NOT_SUPPORTED - NO_ACCOUNTS - ITEM_NOT_SUPPORTED - ACCESS_NOT_GRANTED CreditAmountWithCurrency: type: object description: This contains an amount, denominated in the currency specified by either `iso_currency_code` or `unofficial_currency_code` additionalProperties: true properties: amount: type: number description: Value of amount with up to 2 decimal places. iso_currency_code: $ref: '#/components/schemas/CreditIsoCurrencyCode' unofficial_currency_code: $ref: '#/components/schemas/CreditUnofficialCurrencyCode' LoanIdentifierType: title: LoanIdentifierType type: - string - 'null' description: A value from a MISMO prescribed list that specifies the type of loan identifier. enum: - LenderLoan - UniversalLoan ConsumerReportPDFGetResponse: format: binary type: string description: ConsumerReportPDFGetResponse defines the response schema for `/consumer_report/pdf/get` AssetReportTransaction: title: AssetReportTransaction description: A transaction on the asset report type: object additionalProperties: true properties: account_id: type: string description: The ID of the account in which this transaction occurred. amount: type: number format: double description: The settled value of the transaction, denominated in the transaction's currency, as stated in `iso_currency_code` or `unofficial_currency_code`. 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. iso_currency_code: type: - string - 'null' description: The ISO-4217 currency code of the transaction. Always `null` if `unofficial_currency_code` is non-null. unofficial_currency_code: type: - string - 'null' description: 'The unofficial currency code associated with the transaction. Always `null` if `iso_currency_code` is non-`null`. Unofficial currency codes are used for currencies that do not have official ISO currency codes, such as cryptocurrencies and the currencies of certain countries. See the [currency code schema](https://plaid.com/docs/api/accounts#currency-code-schema) for a full listing of supported `unofficial_currency_code`s.' original_description: type: - string - 'null' description: The string returned by the financial institution to describe the transaction. category: type: - array - 'null' description: 'A hierarchical array of the categories to which this transaction belongs. For a full list of categories, see [`/categories/get`](https://plaid.com/docs/api/products/transactions/#categoriesget). This field will only appear in an Asset Report with Insights.' items: type: string category_id: description: 'The ID of the category to which this transaction belongs. For a full list of categories, see [`/categories/get`](https://plaid.com/docs/api/products/transactions/#categoriesget). This field will only appear in an Asset Report with Insights.' type: - string - 'null' credit_category: $ref: '#/components/schemas/CreditCategory' check_number: type: - string - 'null' description: The check number of the transaction. This field is only populated for check transactions. date: type: string format: date description: 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](https://wikipedia.org/wiki/ISO_8601) format ( `YYYY-MM-DD` ). date_transacted: type: - string - 'null' description: The date on which the transaction took place, in IS0 8601 format. location: $ref: '#/components/schemas/Location' name: type: string description: 'The merchant name or transaction description. This field will only appear in an Asset Report with Insights.' merchant_name: type: - string - 'null' description: 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`. payment_meta: $ref: '#/components/schemas/PaymentMeta' pending: type: boolean description: When `true`, identifies the transaction as pending or unsettled. Pending transaction details (name, type, amount, category ID) may change before they are settled. pending_transaction_id: type: - string - 'null' description: The ID of a posted transaction's associated pending transaction, where applicable. account_owner: type: - string - 'null' description: The name of the account owner. This field is not typically populated and only relevant when dealing with sub-accounts. transaction_id: type: string description: The unique ID of the transaction. Like all Plaid identifiers, the `transaction_id` is case sensitive. transaction_type: $ref: '#/components/schemas/AssetReportTransactionType' income_source_id: type: string description: A unique identifier for an income source. x-hidden-from-docs: true required: - transaction_id - pending - date - unofficial_currency_code - iso_currency_code - amount - account_id - original_description AssetHolderName: title: NAME type: object additionalProperties: true description: Documentation not found in the MISMO model viewer and not provided by Freddie Mac. properties: FullName: type: string description: The unparsed name of either an individual or a legal entity. required: - FullName SandboxBankTransferFireWebhookRequest: title: SandboxBankTransferFireWebhookRequest type: object description: Defines the request schema for `/sandbox/bank_transfer/fire_webhook` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' webhook: type: string description: The URL to which the webhook should be sent. required: - webhook SandboxTransferRepaymentSimulateResponse: title: SandboxTransferSimulateResponse type: object additionalProperties: true description: Defines the response schema for `/sandbox/transfer/repayment/simulate` properties: request_id: $ref: '#/components/schemas/RequestID' required: - request_id PaymentScheme: type: - string - 'null' enum: - null - LOCAL_DEFAULT - LOCAL_INSTANT - SEPA_CREDIT_TRANSFER - SEPA_CREDIT_TRANSFER_INSTANT description: 'Payment scheme. If not specified - the default in the region will be used (e.g. `SEPA_CREDIT_TRANSFER` for EU). Using unsupported values will result in a failed payment. `LOCAL_DEFAULT`: The default payment scheme for the selected market and currency will be used. `LOCAL_INSTANT`: The instant payment scheme for the selected market and currency will be used (if applicable). Fees may be applied by the institution. If the market does not support an Instant Scheme (e.g. Denmark), the default in the region will be used. `SEPA_CREDIT_TRANSFER`: The standard payment to a beneficiary within the SEPA area. `SEPA_CREDIT_TRANSFER_INSTANT`: Instant payment within the SEPA area. May involve additional fees and may not be available at some banks.' IdentityVerificationDocumentRegion: type: - string - 'null' example: IN title: IdentityVerificationDocumentRegion description: An ISO 3166-2 subdivision code extracted from the document. Related terms would be "state", "province", "prefecture", "zone", "subdivision", etc. PayStubDeductionsTotal: title: PayStubDeductionsTotal type: object description: An object representing the total deductions for the pay period additionalProperties: true properties: current_amount: type: - number - 'null' format: double description: Raw amount of the deduction iso_currency_code: type: - string - 'null' description: The ISO-4217 currency code of the line item. Always `null` if `unofficial_currency_code` is non-null. unofficial_currency_code: type: - string - 'null' description: 'The unofficial currency code associated with the line item. Always `null` if `iso_currency_code` is non-`null`. Unofficial currency codes are used for currencies that do not have official ISO currency codes, such as cryptocurrencies and the currencies of certain countries. See the [currency code schema](https://plaid.com/docs/api/accounts#currency-code-schema) for a full listing of supported `iso_currency_code`s.' ytd_amount: type: - number - 'null' format: double description: The year-to-date total amount of the deductions required: - current_amount - iso_currency_code - unofficial_currency_code - ytd_amount BankTransferCancelRequest: title: BankTransferCancelRequest type: object description: Defines the request schema for `/bank_transfer/cancel` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' bank_transfer_id: $ref: '#/components/schemas/BankTransferID' required: - bank_transfer_id CreditBankIncomeWarningCode: type: string description: 'The warning code identifies a specific kind of warning. `IDENTITY_UNAVAILABLE`: Unable to extract identity for the Item `TRANSACTIONS_UNAVAILABLE`: Unable to extract transactions for the Item `ITEM_UNAPPROVED`: User exited flow before giving permission to share data for the Item `REPORT_DELETED`: Report deleted due to customer or consumer request `DATA_UNAVAILABLE`: No relevant data was found for the Item' enum: - IDENTITY_UNAVAILABLE - TRANSACTIONS_UNAVAILABLE - ITEM_UNAPPROVED - REPORT_DELETED - DATA_UNAVAILABLE PaymentInitiationConsentGetRequest: type: object description: PaymentInitiationConsentGetRequest defines the request schema for `/payment_initiation/consent/get` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' consent_id: type: string description: The `consent_id` returned from `/payment_initiation/consent/create`. required: - consent_id TransactionStreamStatus: type: string description: 'The current status of the transaction stream. `MATURE`: A `MATURE` recurring stream should have at least 3 transactions and happen on a regular cadence (For Annual recurring stream, we will mark it `MATURE` after 2 instances). `EARLY_DETECTION`: When a recurring transaction first appears in the transaction history and before it fulfills the requirement of a mature stream, the status will be `EARLY_DETECTION`. `TOMBSTONED`: A stream that was previously in the `EARLY_DETECTION` status will move to the `TOMBSTONED` status when no further transactions were found at the next expected date. `UNKNOWN`: A stream is assigned an `UNKNOWN` status when none of the other statuses are applicable.' title: TransactionStreamStatus enum: - UNKNOWN - MATURE - EARLY_DETECTION - TOMBSTONED TransferMigratedFundingAccountIDRequest: type: - string - 'null' description: Specify the account used to fund the transfer. Should be specified if using legacy funding methods only. If using Plaid Ledger, leave this field blank. Customers can find a list of `funding_account_id`s in the Accounts page of your Plaid Dashboard, under the "Account ID" column. If this field is left blank and you are using legacy funding methods, this will default to the default `funding_account_id` specified during onboarding. Otherwise, Plaid Ledger will be used. SignalEvaluateRequest: title: SignalEvaluateRequest description: SignalEvaluateRequest defines the request schema for `/signal/evaluate` type: object properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' access_token: $ref: '#/components/schemas/AccessToken' account_id: type: string description: 'The Plaid `account_id` of the account that is the funding source for the proposed transaction. The `account_id` is returned in the `/accounts/get` endpoint as well as the [`onSuccess`](/docs/link/ios/#link-ios-onsuccess-linkSuccess-metadata-accounts-id) callback metadata. This will return an [`INVALID_ACCOUNT_ID`](/docs/errors/invalid-input/#invalid_account_id) error if the account has been removed at the bank or if the `account_id` is no longer valid.' client_transaction_id: type: string description: The unique ID that you would like to use to refer to this transaction. For your convenience mapping your internal data, you could use your internal ID/identifier for this transaction. The max length for this field is 36 characters. minLength: 1 maxLength: 36 amount: type: number format: double description: The transaction amount, in USD (e.g. `102.05`) user_present: type: - boolean - 'null' description: '`true` if the end user is present while initiating the ACH transfer and the endpoint is being called; `false` otherwise (for example, when the ACH transfer is scheduled and the end user is not present, or you call this endpoint after the ACH transfer but before submitting the Nacha file for ACH processing).' client_user_id: type: string description: A unique ID that identifies the end user in your system. This ID is used to correlate requests by a user with multiple Items. Personally identifiable information, such as an email address or phone number, should not be used in the `client_user_id`. is_recurring: type: - boolean - 'null' description: '`true` if the ACH transaction is a recurring transaction; `false` otherwise ' default_payment_method: type: - string - 'null' description: 'The default ACH or non-ACH payment method to complete the transaction. `SAME_DAY_ACH`: Same Day ACH by NACHA. The debit transaction is processed and settled on the same day `NEXT_DAY_ACH`: Next Day ACH settlement for debit transactions, offered by some payment processors `STANDARD_ACH`: standard ACH by NACHA `REAL_TIME_PAYMENTS`: real-time payments such as RTP and FedNow `DEBIT_CARD`: if the default payment is over debit card networks `MULTIPLE_PAYMENT_METHODS`: if there is no default debit rail or there are multiple payment methods Possible values: `SAME_DAY_ACH`, `NEXT_DAY_ACH`, `STANDARD_ACH`, `REAL_TIME_PAYMENTS`, `DEBIT_CARD`, `MULTIPLE_PAYMENT_METHODS`' user: $ref: '#/components/schemas/SignalUser' device: $ref: '#/components/schemas/SignalDevice' risk_profile_key: type: - string - 'null' description: The key of the risk profile to use for this transaction. You can configure a risk profile using the Signal dashboard located within the Plaid Dashboard. If not provided, no risk profile will be used. This feature is currently in closed beta; to request access, contact your account manager. minLength: 1 maxLength: 64 required: - access_token - account_id - client_transaction_id - amount ClientUserID: type: string title: ClientUserID minLength: 1 example: your-db-id-3b24110 description: A unique ID that identifies the end user in your system. This ID can also be used to associate user-specific data from other Plaid products. Financial Account Matching requires this field and the `/link/token/create` `client_user_id` to be consistent. Personally identifiable information, such as an email address or phone number, should not be used in the `client_user_id`. CreditAccountSubtypes: title: CreditAccountSubtypes type: array description: 'An array of account subtypes to display in Link. If not specified, all account subtypes will be shown. For a full list of valid types and subtypes, see the [Account schema](https://plaid.com/docs/api/accounts#account-type-schema). ' items: $ref: '#/components/schemas/CreditAccountSubtype' LinkSessionSuccessMetadataTransferStatus: type: - string - 'null' description: 'The status of a transfer. Returned only when [Transfer UI](/docs/transfer/using-transfer-ui) is implemented. - `COMPLETE` – The transfer was completed. - `INCOMPLETE` – The transfer could not be completed. For help, see [Troubleshooting transfers](/docs/transfer/using-transfer-ui#troubleshooting-transfers).' enum: - COMPLETE - INCOMPLETE SignalDecisionReportRequest: title: SignalDecisionReportRequest description: SignalDecisionReportRequest defines the request schema for `/signal/decision/report` type: object properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' client_transaction_id: type: string description: Must be the same as the `client_transaction_id` supplied when calling `/signal/evaluate` minLength: 1 maxLength: 36 initiated: type: boolean description: '`true` if the ACH transaction was initiated, `false` otherwise. This field must be returned as a boolean. If formatted incorrectly, this will result in an [`INVALID_FIELD`](/docs/errors/invalid-request/#invalid_field) error.' days_funds_on_hold: type: - integer - 'null' description: 'The actual number of days (hold time) since the ACH debit transaction that you wait before making funds available to your customers. The holding time could affect the ACH return rate. For example, use 0 if you make funds available to your customers instantly or the same day following the debit transaction, or 1 if you make funds available the next day following the debit initialization.' minimum: 0 decision_outcome: $ref: '#/components/schemas/SignalDecisionOutcome' payment_method: $ref: '#/components/schemas/SignalPaymentMethod' amount_instantly_available: type: - number - 'null' format: double description: 'The amount (in USD) made available to your customers instantly following the debit transaction. It could be a partial amount of the requested transaction (example: 102.05).' required: - client_transaction_id - initiated FDXNotificationType: type: string title: Notification Type enum: - CONSENT_REVOKED - CONSENT_UPDATED - CUSTOM - SERVICE - BALANCE - PLANNED_OUTAGE description: Type of Notification PhoneType: description: An enum indicating whether a phone number is a phone line or a fax line. type: string enum: - phone - fax SignalPrepareResponse: title: SignalPrepareResponse description: SignalPrepareResponse defines the response schema for `/signal/prepare` additionalProperties: true type: object properties: request_id: $ref: '#/components/schemas/RequestID' required: - request_id DepositSwitchAltCreateRequest: title: DepositSwitchAltCreateRequest type: object description: DepositSwitchAltCreateRequest defines the request schema for `/deposit_switch/alt/create` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' target_account: $ref: '#/components/schemas/DepositSwitchTargetAccount' target_user: $ref: '#/components/schemas/DepositSwitchTargetUser' options: $ref: '#/components/schemas/DepositSwitchCreateRequestOptions' country_code: type: - string - 'null' title: CountryCode enum: - US - CA description: ISO-3166-1 alpha-2 country code standard. required: - target_account - target_user CreditBankEmploymentReport: type: object description: The report of the Bank Employment data for an end user. properties: bank_employment_report_id: type: string description: The unique identifier associated with the Bank Employment Report. generated_time: type: string description: The time when the Bank Employment Report was generated, in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format (e.g. "2018-04-12T03:32:11Z"). format: date-time days_requested: type: integer description: The number of days requested by the customer for the Bank Employment Report. items: type: array description: The list of Items in the report along with the associated metadata about the Item. items: $ref: '#/components/schemas/CreditBankEmploymentItem' warnings: type: array description: If data from the Bank Employment report was unable to be retrieved, the warnings will contain information about the error that caused the data to be incomplete. items: $ref: '#/components/schemas/CreditBankEmploymentWarning' required: - bank_employment_report_id - generated_time - days_requested - items - warnings ProcessorIdentityMatchRequest: type: object description: ProcessorIdentityMatchRequest defines the request schema for `/processor/identity/match` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' processor_token: $ref: '#/components/schemas/ProcessorToken' user: $ref: '#/components/schemas/IdentityMatchUser' required: - processor_token BaseReportAverageMonthlyBalances: title: BaseReportAverageMonthlyBalances description: Average balance in dollar amount per month x-hidden-from-docs: true type: object additionalProperties: true properties: start_date: type: string description: 'The start date of this time period. The date will be returned in an ISO 8601 format (YYYY-MM-DD).' end_date: type: string description: 'The end date of this time period. The date will be returned in an ISO 8601 format (YYYY-MM-DD).' average_balance: $ref: '#/components/schemas/CreditAmountWithCurrency' TransferSweepGetRequest: title: TransferSweepGetRequest type: object description: Defines the request schema for `/transfer/sweep/get` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' sweep_id: type: string description: Plaid's unique identifier for the sweep (UUID) or a shortened form consisting of the first 8 characters of the identifier (8-digit hexadecimal string). required: - sweep_id OtherAccountSubtypes: title: OtherAccountSubtypes type: array description: 'An array of account subtypes to display in Link. If not specified, all account subtypes will be shown. For a full list of valid types and subtypes, see the [Account schema](https://plaid.com/docs/api/accounts#account-type-schema). ' items: $ref: '#/components/schemas/OtherAccountSubtype' WatchlistScreeningEntityReviewCreateResponse: description: 'A review submitted by a team member for an entity watchlist screening. A review can be either a comment on the current screening state, actions taken against hits attached to the watchlist screening, or both.' additionalProperties: true properties: id: $ref: '#/components/schemas/EntityWatchlistScreeningReviewID' confirmed_hits: type: array description: Hits marked as a true positive after thorough manual review. These hits will never recur or be updated once dismissed. In most cases, confirmed hits indicate that the customer should be rejected. items: $ref: '#/components/schemas/EntityWatchlistScreeningHitID' dismissed_hits: type: array description: Hits marked as a false positive after thorough manual review. These hits will never recur or be updated once dismissed. items: $ref: '#/components/schemas/EntityWatchlistScreeningHitID' comment: $ref: '#/components/schemas/ReviewComment' audit_trail: $ref: '#/components/schemas/WatchlistScreeningAuditTrail' request_id: $ref: '#/components/schemas/RequestID' required: - id - confirmed_hits - dismissed_hits - comment - audit_trail - request_id type: object SelfieCheckStatus: type: string enum: - success - failed example: success description: The outcome status for the associated Identity Verification attempt's `selfie_check` step. This field will always have the same value as `steps.selfie_check`. CraLoanID: type: string description: "A unique identifier for the loan. \nPersonally identifiable information, such as an email address or phone number, should not be used in the `loan_id`." TransferRefundFailure: title: TransferRefundFailure type: - object - 'null' additionalProperties: true description: The failure reason if the event type for a refund is `"failed"` or `"returned"`. Null value otherwise. properties: ach_return_code: type: - string - 'null' description: The ACH return code, e.g. `R01`. A return code will be provided if and only if the refund status is `returned`. For a full listing of ACH return codes, see [Transfer errors](https://plaid.com/docs/errors/transfer/#ach-return-codes). description: type: string description: A human-readable description of the reason for the failure or reversal. CustomerInitiatedReturnRisk: title: CustomerInitiatedReturnRisk type: object description: 'The object contains a risk score and a risk tier that evaluate the transaction return risk of an unauthorized debit. Common return codes in this category include: "R05", "R07", "R10", "R11", "R29". These returns typically have a return time frame of up to 60 calendar days. During this period, the customer of financial institutions can dispute a transaction as unauthorized.' properties: score: $ref: '#/components/schemas/SignalScore' risk_tier: $ref: '#/components/schemas/CustomerInitiatedRiskTier' required: - risk_tier - score IndividualWatchlistCode: type: string enum: - AU_CON - CA_CON - EU_CON - IZ_CIA - IZ_IPL - IZ_PEP - IZ_UNC - IZ_WBK - UK_HMC - US_DPL - US_DTC - US_FBI - US_FSE - US_ISN - US_MBS - US_PLC - US_SDN - US_SSI - SG_SOF - TR_TWL - TR_DFD - TR_FOR - TR_WMD - TR_CMB example: US_SDN description: "Shorthand identifier for a specific screening list for individuals.\n `AU_CON`: Australia Department of Foreign Affairs and Trade Consolidated List\n `CA_CON`: Government of Canada Consolidated List of Sanctions\n `EU_CON`: European External Action Service Consolidated List\n `IZ_CIA`: CIA List of Chiefs of State and Cabinet Members\n `IZ_IPL`: Interpol Red Notices for Wanted Persons List\n `IZ_PEP`: Politically Exposed Persons List\n `IZ_UNC`: United Nations Consolidated Sanctions\n `IZ_WBK`: World Bank Listing of Ineligible Firms and Individuals\n `UK_HMC`: UK HM Treasury Consolidated List\n `US_DPL`: Bureau of Industry and Security Denied Persons List\n `US_DTC`: US Department of State AECA Debarred\n `US_FBI`: US Department of Justice FBI Wanted List\n `US_FSE`: US OFAC Foreign Sanctions Evaders\n `US_ISN`: US Department of State Nonproliferation Sanctions\n `US_PLC`: US OFAC Palestinian Legislative Council\n `US_SDN`: US OFAC Specially Designated Nationals List\n `US_SSI`: US OFAC Sectoral Sanctions Identifications\n `SG_SOF`: Government of Singapore Terrorists and Terrorist Entities\n `TR_TWL`: Government of Turkey Terrorist Wanted List\n `TR_DFD`: Government of Turkey Domestic Freezing Decisions\n `TR_FOR`: Government of Turkey Foreign Freezing Requests\n `TR_WMD`: Government of Turkey Weapons of Mass Destruction\n `TR_CMB`: Government of Turkey Capital Markets Board" title: IndividualWatchlistCode BeaconUserHistoryListRequest: description: Request input for listing the history of a Beacon User type: object properties: beacon_user_id: $ref: '#/components/schemas/BeaconUserID' cursor: $ref: '#/components/schemas/Cursor' client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' required: - beacon_user_id CreditPayStubEmployer: title: CreditPayStubEmployer description: Information about the employer on the pay stub. type: object additionalProperties: true properties: address: $ref: '#/components/schemas/CreditPayStubAddress' name: type: - string - 'null' description: The name of the employer on the pay stub. required: - address - name BaseReportId: title: BaseReportId x-hidden-from-docs: true description: A unique ID identifying an Base Report. Like all Plaid identifiers, this ID is case sensitive. type: string TransferIntentCreateRequest: title: TransferIntentCreateRequest type: object description: Defines the request schema for `/transfer/intent/create` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' account_id: type: - string - 'null' description: The Plaid `account_id` corresponding to the end-user account that will be debited or credited. funding_account_id: $ref: '#/components/schemas/TransferMigratedFundingAccountIDRequest' mode: $ref: '#/components/schemas/TransferIntentCreateMode' network: $ref: '#/components/schemas/TransferIntentCreateNetwork' amount: $ref: '#/components/schemas/TransferAmount' description: type: string description: A description for the underlying transfer. Maximum of 15 characters. minLength: 1 maxLength: 15 ach_class: $ref: '#/components/schemas/ACHClass' origination_account_id: type: - string - 'null' deprecated: true x-hidden-from-docs: true description: Plaid’s unique identifier for the origination account for the intent. If not provided, the default account will be used. user: $ref: '#/components/schemas/TransferUserInRequest' metadata: $ref: '#/components/schemas/TransferMetadata' iso_currency_code: type: string description: The currency of the transfer amount, e.g. "USD" require_guarantee: type: - boolean - 'null' default: false x-hidden-from-docs: true description: When `true`, the transfer requires a `GUARANTEED` decision by Plaid to proceed (Guarantee customers only). required: - mode - amount - description - user ProfileIdentity: type: - object - 'null' additionalProperties: true x-hidden-from-docs: true description: ProfileIdentity defines the identity data permissioned by the end user during the authorization flow. properties: name: $ref: '#/components/schemas/ProfileIdentityName' address: $ref: '#/components/schemas/ProfileIdentityAddress' phone_number: type: string description: The user's phone number in [E.164](https://en.wikipedia.org/wiki/E.164) format email: description: The user's email address. type: - string - 'null' date_of_birth: description: The user's date of birth. type: - string - 'null' ssn: description: The user's social security number. type: - string - 'null' ssn_last_4: description: The last 4 digits of the user's social security number. type: - string - 'null' WatchlistScreeningHitLocations: type: object description: Location information for the associated individual watchlist hit properties: full: type: string example: Florida, US description: The full location string, potentially including elements like street, city, postal codes and country codes. Note that this is not necessarily a complete or well-formatted address. country: $ref: '#/components/schemas/GenericCountryCode' required: - full - country additionalProperties: true RiskCheckDetails: type: - object - 'null' description: Additional information for the `risk_check` step. properties: status: $ref: '#/components/schemas/IdentityVerificationStepStatus' behavior: $ref: '#/components/schemas/RiskCheckBehavior' email: $ref: '#/components/schemas/RiskCheckEmail' phone: $ref: '#/components/schemas/RiskCheckPhone' devices: type: array description: Array of result summary objects specifying values for `device` attributes of risk check. items: $ref: '#/components/schemas/RiskCheckDevice' identity_abuse_signals: $ref: '#/components/schemas/RiskCheckIdentityAbuseSignals' required: - status - behavior - devices - email - phone - identity_abuse_signals additionalProperties: true ExternalPaymentRefundDetails: title: ExternalPaymentRefundDetails description: Details about external payment refund type: - object - 'null' properties: name: type: string description: The name of the account holder. iban: type: - string - 'null' description: The International Bank Account Number (IBAN) for the account. bacs: $ref: '#/components/schemas/RecipientBACSNullable' required: - name - iban - bacs FDXNotificationPayload: title: Notification Payload entity type: object description: Custom key-value pairs payload for a notification properties: id: type: string description: ID for the origination entity related to the notification idType: $ref: '#/components/schemas/FDXNotificationPayloadIdType' customFields: type: array items: $ref: '#/components/schemas/FDXFiAttribute' SandboxOauthSelectAccountsResponse: title: SandboxOauthSelectAccountsResponse additionalProperties: true type: object description: Defines the response schema for `/sandbox/oauth/select_accounts` TransferLedgerWithdrawResponse: title: TransferLedgerWithdrawResponse type: object additionalProperties: true description: Defines the response schema for `/transfer/ledger/withdraw` properties: sweep: $ref: '#/components/schemas/TransferSweep' request_id: $ref: '#/components/schemas/RequestID' required: - sweep - request_id WatchlistScreeningEntityListResponse: description: Paginated list of entity watchlist screenings additionalProperties: true properties: entity_watchlist_screenings: description: List of entity watchlist screening type: array items: $ref: '#/components/schemas/EntityWatchlistScreening' next_cursor: $ref: '#/components/schemas/Cursor' request_id: $ref: '#/components/schemas/RequestID' required: - entity_watchlist_screenings - next_cursor - request_id type: object SelfieCapture: type: object description: The image or video capture of a selfie. Only one of image or video URL will be populated per selfie. properties: image_url: $ref: '#/components/schemas/SelfieCaptureImageURL' video_url: $ref: '#/components/schemas/SelfieCaptureVideoURL' required: - image_url - video_url additionalProperties: true ItemRemoveRequest: type: object description: ItemRemoveRequest defines the request schema for `/item/remove` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' access_token: $ref: '#/components/schemas/AccessToken' required: - access_token ProductStatus: title: ProductStatus type: - object - 'null' additionalProperties: true description: A representation of the status health of a request type. Auth requests, Balance requests, Identity requests, Investments requests, Liabilities requests, Transactions updates, Investments updates, Liabilities updates, and Item logins each have their own status object. properties: status: type: string deprecated: true enum: - HEALTHY - DEGRADED - DOWN description: 'This field is deprecated in favor of the `breakdown` object, which provides more granular institution health data. `HEALTHY`: the majority of requests are successful `DEGRADED`: only some requests are successful `DOWN`: all requests are failing' last_status_change: type: string format: date-time description: '[ISO 8601](https://wikipedia.org/wiki/ISO_8601) formatted timestamp of the last status change for the institution. ' breakdown: $ref: '#/components/schemas/ProductStatusBreakdown' required: - status - last_status_change - breakdown SweepDescription: title: SweepDescription type: - string - 'null' maxLength: 10 description: The description of the deposit that will be passed to the receiving bank (up to 10 characters). Note that banks utilize this field differently, and may or may not show it on the bank statement. EntityScreeningHitData: type: object description: Information associated with the entity watchlist hit properties: documents: description: Documents associated with the watchlist hit type: array items: $ref: '#/components/schemas/EntityScreeningHitDocumentsItems' email_addresses: description: Email addresses associated with the watchlist hit type: array items: $ref: '#/components/schemas/EntityScreeningHitEmailsItems' locations: description: Locations associated with the watchlist hit type: array items: $ref: '#/components/schemas/GenericScreeningHitLocationItems' names: description: Names associated with the watchlist hit type: array items: $ref: '#/components/schemas/EntityScreeningHitNamesItems' phone_numbers: description: Phone numbers associated with the watchlist hit type: array items: $ref: '#/components/schemas/EntityScreeningHitsPhoneNumberItems' urls: description: URLs associated with the watchlist hit type: array items: $ref: '#/components/schemas/EntityScreeningHitUrlsItems' additionalProperties: true TransferAuthorizationDevice: title: TransferAuthorizationDevice type: object additionalProperties: true description: Information about the device being used to initiate the authorization. These fields are not currently incorporated into the risk check. properties: ip_address: type: string description: The IP address of the device being used to initiate the authorization. user_agent: type: string description: The user agent of the device being used to initiate the authorization. OtherFilter: title: OtherFilter description: A filter to apply to `other`-type accounts type: object additionalProperties: true properties: account_subtypes: $ref: '#/components/schemas/OtherAccountSubtypes' required: - account_subtypes PaymentInitiationRecipientCreateRequest: type: object description: PaymentInitiationRecipientCreateRequest defines the request schema for `/payment_initiation/recipient/create` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' name: type: string description: The name of the recipient. We recommend using strings of length 18 or less and avoid special characters to ensure compatibility with all institutions. minLength: 1 iban: type: - string - 'null' description: The International Bank Account Number (IBAN) for the recipient. If BACS data is not provided, an IBAN is required. minLength: 15 maxLength: 34 bacs: $ref: '#/components/schemas/RecipientBACSNullable' address: $ref: '#/components/schemas/PaymentInitiationAddress' required: - name TransferRefundCancelResponse: title: TransferRefundCancelResponse type: object additionalProperties: true description: Defines the response schema for `/transfer/refund/cancel` properties: request_id: $ref: '#/components/schemas/RequestID' required: - request_id FDXHateoasLink: title: HATEOAS Link description: REST application constraint (Hypermedia As The Engine Of Application State) required: - href type: object properties: href: type: string format: uri-reference description: URL to invoke the action on the resource example: https://api.fi.com/fdx/v4/accounts/12345 action: $ref: '#/components/schemas/FDXHateoasLinkAction' rel: description: Relation of this link to its containing entity, as defined by and with many example relation values at [IETF RFC5988](https://datatracker.ietf.org/doc/html/rfc5988) type: string types: type: array items: $ref: '#/components/schemas/FDXContentTypes' description: Content-types that can be used in the Accept header NumbersInternationalIBAN: type: - object - 'null' additionalProperties: true description: Account numbers using the International Bank Account Number and BIC/SWIFT code format. properties: iban: $ref: '#/components/schemas/NumbersIBAN' bic: type: string description: The Business Identifier Code, also known as SWIFT code, for this bank account. minLength: 8 maxLength: 11 required: - iban - bic LiabilitiesObject: title: LiabilitiesObject type: object additionalProperties: true description: An object containing liability accounts properties: credit: type: - array - 'null' description: The credit accounts returned. items: $ref: '#/components/schemas/CreditCardLiability' mortgage: description: The mortgage accounts returned. type: - array - 'null' items: $ref: '#/components/schemas/MortgageLiability' student: description: The student loan accounts returned. type: - array - 'null' items: $ref: '#/components/schemas/StudentLoan' required: - credit - mortgage - student ScopesContext: description: An indicator for when scopes are being updated. When scopes are updated via enrollment (i.e. OAuth), the partner must send `ENROLLMENT`. When scopes are updated in a post-enrollment view, the partner must send `PORTAL`. type: string enum: - ENROLLMENT - PORTAL SandboxTransferTestClockListRequest: title: SandboxTransferTestClockListRequest type: object description: Defines the request schema for `/sandbox/transfer/test_clock/list` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' start_virtual_time: type: - string - 'null' format: date-time description: The start virtual timestamp of test clocks to return. This should be in RFC 3339 format (i.e. `2019-12-06T22:35:49Z`) end_virtual_time: type: - string - 'null' format: date-time description: The end virtual timestamp of test clocks to return. This should be in RFC 3339 format (i.e. `2019-12-06T22:35:49Z`) count: type: - integer - 'null' minimum: 1 maximum: 25 default: 25 description: The maximum number of test clocks to return. offset: type: integer default: 0 minimum: 0 description: The number of test clocks to skip before returning results. EntityWatchlistScreeningName: type: string title: EntityWatchlistScreeningName minLength: 1 example: Al-Qaida description: The name of the organization being screened. PartnerCustomerCreateResponse: description: Response schema for `/partner/customer/create`. type: object additionalProperties: true properties: end_customer: $ref: '#/components/schemas/PartnerEndCustomerWithSecrets' request_id: $ref: '#/components/schemas/RequestID' ProductAccess: description: The product access being requested. Used to or disallow product access across all accounts. If unset, defaults to all products allowed. type: object additionalProperties: true properties: statements: description: Allow access to statements. Only used by certain partners. If relevant to the partner and unset, defaults to `true`. type: - boolean - 'null' default: true identity: description: Allow access to the Identity product (name, email, phone, address). Only used by certain partners. If relevant to the partner and unset, defaults to `true`. type: - boolean - 'null' default: true auth: description: Allow access to account number details. Only used by certain partners. If relevant to the partner and unset, defaults to `true`. type: - boolean - 'null' default: true transactions: description: Allow access to transaction details. Only used by certain partners. If relevant to the partner and unset, defaults to `true`. type: - boolean - 'null' default: true accounts_details_transactions: description: Allow access to "accounts_details_transactions". Only used by certain partners. If relevant to the partner and unset, defaults to `true`. type: - boolean - 'null' default: true accounts_routing_number: description: Allow access to "accounts_routing_number". Only used by certain partners. If relevant to the partner and unset, defaults to `true`. type: - boolean - 'null' default: true accounts_statements: description: Allow access to "accounts_statements". Only used by certain partners. If relevant to the partner and unset, defaults to `true`. type: - boolean - 'null' default: true accounts_tax_statements: description: Allow access to "accounts_tax_statements". Only used by certain partners. If relevant to the partner and unset, defaults to `true`. type: - boolean - 'null' default: true customers_profiles: description: Allow access to "customers_profiles". Only used by certain partners. If relevant to the partner and unset, defaults to `true`. type: - boolean - 'null' default: true Application: type: object description: Metadata about the application properties: application_id: $ref: '#/components/schemas/ApplicationID' name: type: string description: The name of the application display_name: type: - string - 'null' description: A human-readable name of the application for display purposes join_date: type: string format: date description: The date this application was granted production access at Plaid in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) (YYYY-MM-DD) format in UTC. logo_url: type: - string - 'null' description: A URL that links to the application logo image. application_url: type: - string - 'null' description: The URL for the application's website reason_for_access: type: - string - 'null' description: A string provided by the connected app stating why they use their respective enabled products. use_case: type: - string - 'null' description: A string representing client’s broad use case as assessed by Plaid. company_legal_name: type: - string - 'null' description: A string representing the name of client’s legal entity. city: type: - string - 'null' description: A string representing the city of the client’s headquarters. region: type: - string - 'null' description: A string representing the region of the client’s headquarters. postal_code: type: - string - 'null' description: A string representing the postal code of the client’s headquarters. country_code: type: - string - 'null' description: A string representing the country code of the client’s headquarters. required: - application_id - join_date - name - display_name - logo_url - application_url - reason_for_access - use_case - company_legal_name - city - region - postal_code - country_code TransferID: type: string title: TransferID description: Plaid’s unique identifier for a transfer. LastDataAccessTimes: description: Describes the last time each datatype was accessed by an application. type: object additionalProperties: true properties: application_id: type: string description: ID of the application accessing data. account_balance_info: type: - string - 'null' format: date-time description: The last time account_balance_info was accessed by this application in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format in UTC. null if never accessed. example: '2023-02-08T10:00:00Z' account_routing_number: type: - string - 'null' format: date-time description: The last time account_routing_number was accessed by this application in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format in UTC. null if never accessed. example: '2023-02-08T10:00:00Z' contact_details: type: - string - 'null' format: date-time description: The last time contact_details was accessed by this application in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format in UTC. null if never accessed. example: '2023-02-08T10:00:00Z' transactions: type: - string - 'null' format: date-time description: The last time transactions was accessed by this application in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format in UTC. null if never accessed. example: '2023-02-08T10:00:00Z' credit_and_loans: type: - string - 'null' format: date-time description: The last time credit_and_loans was accessed by this application in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format in UTC. null if never accessed. example: '2023-02-08T10:00:00Z' investments: type: - string - 'null' format: date-time description: The last time investments was accessed by this application in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format in UTC. null if never accessed. example: '2023-02-08T10:00:00Z' payroll_info: type: - string - 'null' format: date-time description: The last time payroll_info was accessed by this application in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format in UTC. null if never accessed. example: '2023-02-08T10:00:00Z' transaction_risk_info: type: - string - 'null' format: date-time description: The last time transaction_risk_info was accessed by this application in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format in UTC. null if never accessed. example: '2023-02-08T10:00:00Z' required: - application_id - account_balance_info - account_routing_number - contact_details - transactions - credit_and_loans - investments - payroll_info - transaction_risk_info Deductions: title: Deductions type: object description: An object with the deduction information found on a paystub. additionalProperties: true properties: subtotals: deprecated: true type: array items: $ref: '#/components/schemas/Total' breakdown: type: array items: $ref: '#/components/schemas/DeductionsBreakdown' totals: deprecated: true type: array items: $ref: '#/components/schemas/Total' total: $ref: '#/components/schemas/DeductionsTotal' required: - breakdown - total TransactionsRuleType: title: TransactionsRuleType type: string enum: - EXACT_MATCH - SUBSTRING_MATCH description: 'Transaction rule''s match type. For TRANSACTION_ID field, EXACT_MATCH is available. Matches are case sensitive. ' ProcessorAuthGetRequest: type: object description: ProcessorAuthGetRequest defines the request schema for `/processor/auth/get` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' processor_token: $ref: '#/components/schemas/ProcessorToken' required: - processor_token TransferRepaymentReturnListResponse: title: TransferRepaymentReturnListResponse type: object additionalProperties: true description: Defines the response schema for `/transfer/repayments/return/list` properties: repayment_returns: type: array items: $ref: '#/components/schemas/TransferRepaymentReturn' request_id: $ref: '#/components/schemas/RequestID' required: - repayment_returns - request_id LinkSessionExitMetadataInstitution: type: - object - 'null' description: An institution object. If the Item was created via Same-Day or Instant micro-deposit verification, will be `null`. properties: name: type: string description: The full institution name, such as `Wells Fargo` institution_id: type: string description: The Plaid institution identifier TransferEventListTransferType: type: - string - 'null' title: TransferType description: The type of transfer. This will be either `debit` or `credit`. A `debit` indicates a transfer of money into your origination account; a `credit` indicates a transfer of money out of your origination account. enum: - debit - credit - null PayStubEarningsTotal: title: PayStubEarningsTotal type: object description: An object representing both the current pay period and year to date amount for an earning category. additionalProperties: true properties: current_amount: type: - number - 'null' format: double description: Total amount of the earnings for this pay period. hours: type: - number - 'null' description: Total number of hours worked for this pay period. iso_currency_code: type: - string - 'null' description: The ISO-4217 currency code of the line item. Always `null` if `unofficial_currency_code` is non-null. unofficial_currency_code: type: - string - 'null' description: 'The unofficial currency code associated with the security. Always `null` if `iso_currency_code` is non-`null`. Unofficial currency codes are used for currencies that do not have official ISO currency codes, such as cryptocurrencies and the currencies of certain countries. See the [currency code schema](https://plaid.com/docs/api/accounts#currency-code-schema) for a full listing of supported `iso_currency_code`s.' ytd_amount: type: - number - 'null' format: double description: The total year-to-date amount of the earnings. required: - current_amount - hours - iso_currency_code - unofficial_currency_code - ytd_amount PostalCode: type: - string - 'null' example: '46001' title: PostalCode description: The postal code for the associated address. Between 2 and 10 alphanumeric characters. For US-based addresses this must be 5 numeric digits. BeaconReportSyndicationID: type: string title: BeaconReportSyndicationID example: becrsn_11111111111111 description: ID of the associated Beacon Report Syndication. LoanAccountSubtype: type: string description: Valid account subtypes for loan accounts. For a list containing descriptions of each subtype, see [Account schemas](https://plaid.com/docs/api/accounts/#StandaloneAccountType-loan). enum: - auto - business - commercial - construction - consumer - home equity - loan - mortgage - line of credit - student - other - all Recurrence: title: Recurrence type: - object - 'null' description: 'Insights relating to expenses and deposits that are predicted to occur on a scheduled basis, such as biweekly, monthly, or annually. Common examples include loan payments, bill payments, subscriptions, and payroll income. This is a beta field, available to all users.' additionalProperties: true properties: is_recurring: type: - boolean - 'null' description: Whether or not the transaction is periodically recurring. frequency: $ref: '#/components/schemas/RecurringFrequency' Source: type: string enum: - dashboard - link - api - system description: A type indicating whether a dashboard user, an API-based user, or Plaid last touched this object. StatementsDownloadResponse: title: StatementsDownloadResponse format: binary type: string description: StatementsDownloadResponse defines the response schema for `/statements/download`. The response will contain a `Plaid-Content-Hash` header containing a SHA 256 checksum of the statement. This can be used to verify that the file being sent by Plaid is the same file that was downloaded to your systems. DocType: title: DocType type: string description: 'The type of document. `DOCUMENT_TYPE_PAYSTUB`: A paystub. `DOCUMENT_TYPE_BANK_STATEMENT`: A bank statement. `DOCUMENT_TYPE_US_TAX_W2`: A W-2 wage and tax statement provided by a US employer reflecting wages earned by the employee. `DOCUMENT_TYPE_US_MILITARY_ERAS`: An electronic Retirement Account Statement (eRAS) issued by the US military. `DOCUMENT_TYPE_US_MILITARY_LES`: A Leave and Earnings Statement (LES) issued by the US military. `DOCUMENT_TYPE_US_MILITARY_CLES`: A Civilian Leave and Earnings Statement (CLES) issued by the US military. `DOCUMENT_TYPE_GIG`: Used to indicate that the income is related to gig work. Does not necessarily correspond to a specific document type. `DOCUMENT_TYPE_NONE`: Used to indicate that there is no underlying document for the data. `DOCUMENT_TYPE_PLAID_GENERATED_PAYSTUB_PDF`: Used to indicate that the PDF for the paystub was generated by Plaid. `UNKNOWN`: Document type could not be determined.' enum: - UNKNOWN - DOCUMENT_TYPE_PAYSTUB - DOCUMENT_TYPE_BANK_STATEMENT - DOCUMENT_TYPE_US_TAX_W2 - DOCUMENT_TYPE_US_MILITARY_ERAS - DOCUMENT_TYPE_US_MILITARY_LES - DOCUMENT_TYPE_US_MILITARY_CLES - DOCUMENT_TYPE_GIG - DOCUMENT_TYPE_NONE - DOCUMENT_TYPE_US_TAX_1099_MISC - DOCUMENT_TYPE_US_TAX_1099_K - DOCUMENT_TYPE_PLAID_GENERATED_PAYSTUB_PDF NumbersBACSNullable: description: Identifying information for transferring money to or from a UK bank account via BACS. allOf: - $ref: '#/components/schemas/NumbersBACS' - type: object additionalProperties: true ProfileIdentityAddress: description: ProfileIdentityAddress defines the user's address. x-hidden-from-docs: true additionalProperties: true type: - object - 'null' properties: city: type: - string - 'null' description: The full city name region: type: - string - 'null' description: 'The region or state. Example: `"NC"`' street: type: - string - 'null' description: 'The full street address Example: `"564 Main Street, APT 15"`' street2: type: - string - 'null' description: The second line street address postal_code: type: - string - 'null' description: The postal code. In API versions 2018-05-22 and earlier, this field is called `zip`. country: type: - string - 'null' description: The ISO 3166-1 alpha-2 country code AddressDataNullableNoRequiredFields: description: Data about the components comprising an address. allOf: - $ref: '#/components/schemas/AddressDataNotRequired' - type: object additionalProperties: true StudentLoan: title: StudentLoan type: object additionalProperties: true description: Contains details about a student loan account properties: account_id: type: - string - 'null' description: The ID of the account that this liability belongs to. Each account can only contain one liability. account_number: type: - string - 'null' description: 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). disbursement_dates: description: 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](https://wikipedia.org/wiki/ISO_8601) format (YYYY-MM-DD). type: - array - 'null' items: type: string format: date expected_payoff_date: type: - string - 'null' format: date description: 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](https://wikipedia.org/wiki/ISO_8601) format (YYYY-MM-DD). guarantor: type: - string - 'null' description: The guarantor of the student loan. interest_rate_percentage: description: The interest rate on the loan as a percentage. type: number format: double is_overdue: description: '`true` if a payment is currently overdue. Availability for this field is limited.' type: - boolean - 'null' last_payment_amount: description: The amount of the last payment. type: - number - 'null' format: double last_payment_date: type: - string - 'null' format: date description: The date of the last payment. Dates are returned in an [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format (YYYY-MM-DD). last_statement_issue_date: type: - string - 'null' format: date description: The date of the last statement. Dates are returned in an [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format (YYYY-MM-DD). loan_name: type: - string - 'null' description: The type of loan, e.g., "Consolidation Loans". loan_status: $ref: '#/components/schemas/StudentLoanStatus' minimum_payment_amount: description: '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`), EdFinancial Services (`ins_116304`), Granite State (`ins_116308`), and Oklahoma Student Loan Authority (`ins_116945`). Firstmark (`ins_116295` ), EdFinancial Services (`ins_116304`), and Navient (`ins_116248`) will display as $0 if there is an autopay program in effect.' type: - number - 'null' format: double next_payment_due_date: type: - string - 'null' format: date description: 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](https://wikipedia.org/wiki/ISO_8601) format (YYYY-MM-DD). origination_date: type: - string - 'null' format: date description: 'The date on which the loan was initially lent. Dates are returned in an [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format (YYYY-MM-DD). ' origination_principal_amount: description: The original principal balance of the loan. type: - number - 'null' format: double outstanding_interest_amount: description: 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`. type: - number - 'null' format: double payment_reference_number: type: - string - 'null' description: 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. pslf_status: $ref: '#/components/schemas/PSLFStatus' repayment_plan: $ref: '#/components/schemas/StudentRepaymentPlan' sequence_number: type: - string - 'null' description: The sequence number of the student loan. Heartland ECSI (`ins_116948`) does not make this field available. servicer_address: $ref: '#/components/schemas/ServicerAddressData' ytd_interest_paid: description: The year to date (YTD) interest paid. Availability for this field is limited. type: - number - 'null' format: double ytd_principal_paid: description: The year to date (YTD) principal paid. Availability for this field is limited. type: - number - 'null' format: double required: - account_id - account_number - disbursement_dates - expected_payoff_date - guarantor - interest_rate_percentage - is_overdue - last_payment_amount - last_payment_date - last_statement_issue_date - loan_name - loan_status - minimum_payment_amount - next_payment_due_date - origination_date - origination_principal_amount - outstanding_interest_amount - payment_reference_number - pslf_status - repayment_plan - sequence_number - servicer_address - ytd_interest_paid - ytd_principal_paid CreditAuditCopyTokenRemoveRequest: type: object description: CreditAuditCopyTokenRemoveRequest defines the request schema for `/credit/audit_copy_token/remove` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' audit_copy_token: type: string description: The `audit_copy_token` granting access to the Audit Copy you would like to revoke. required: - audit_copy_token SenderBACSNullable: description: An object containing a BACS account number and sort code. If an IBAN is not provided or if this recipient needs to accept domestic GBP-denominated payments, BACS data is required. allOf: - $ref: '#/components/schemas/RecipientBACS' - type: object additionalProperties: true description: The account number and sort code of the sender's account, if specified in the `/payment_initiation/payment/create` call. ExternalPaymentScheduleRequest: title: ExternalPaymentScheduleRequest description: The schedule that the payment will be executed on. If a schedule is provided, the payment is automatically set up as a standing order. If no schedule is specified, the payment will be executed only once. allOf: - $ref: '#/components/schemas/ExternalPaymentScheduleBase' - type: object required: - start_date - interval - interval_execution_day SweepTrigger: title: SweepTrigger type: - string - 'null' enum: - manual - incoming - balance_threshold - automatic_aggregate description: 'The trigger of the sweep `"manual"` - The sweep is created manually by the customer `"incoming"` - The sweep is created by incoming funds flow (e.g. Incoming Wire) `"balance_threshold"` - The sweep is created by balance threshold setting `"automatic_aggregate"` - The sweep is created by the Plaid automatic aggregation process. These funds did not pass through the Plaid Ledger balance.' IdentityVerificationRequestUser: type: - object - 'null' description: 'User information collected outside of Link, most likely via your own onboarding process. Each of the following identity fields are optional: `email_address` `phone_number` `date_of_birth` `name` `address` `id_number` Specifically, these fields are optional in that they can either be fully provided (satisfying every required field in their subschema) or omitted from the request entirely by not providing the key or value. Providing these fields via the API will result in Link skipping the data collection process for the associated user. All verification steps enabled in the associated Identity Verification Template will still be run. Verification steps will either be run immediately, or once the user completes the `accept_tos` step, depending on the value provided to the `gave_consent` field.' properties: email_address: $ref: '#/components/schemas/EmailAddress' phone_number: $ref: '#/components/schemas/IdentityVerificationUserPhoneNumber' date_of_birth: $ref: '#/components/schemas/ISO8601Date' name: $ref: '#/components/schemas/IdentityVerificationRequestUserName' address: $ref: '#/components/schemas/UserAddress' id_number: $ref: '#/components/schemas/UserIDNumber' additionalProperties: true CreditW2: title: CreditW2 type: object additionalProperties: true description: W2 is an object that represents income data taken from a W2 tax document. properties: document_metadata: $ref: '#/components/schemas/CreditDocumentMetadata' document_id: type: string description: An identifier of the document referenced by the document metadata. employer: $ref: '#/components/schemas/CreditPayStubEmployer' employee: $ref: '#/components/schemas/CreditPayStubEmployee' tax_year: type: - string - 'null' description: The tax year of the W2 document. employer_id_number: type: - string - 'null' description: An employee identification number or EIN. wages_tips_other_comp: type: - string - 'null' description: Wages from tips and other compensation. federal_income_tax_withheld: type: - string - 'null' description: Federal income tax withheld for the tax year. social_security_wages: type: - string - 'null' description: Wages from social security. social_security_tax_withheld: type: - string - 'null' description: Social security tax withheld for the tax year. medicare_wages_and_tips: type: - string - 'null' description: Wages and tips from medicare. medicare_tax_withheld: type: - string - 'null' description: Medicare tax withheld for the tax year. social_security_tips: type: - string - 'null' description: Tips from social security. allocated_tips: type: - string - 'null' description: Allocated tips. box_9: type: - string - 'null' description: Contents from box 9 on the W2. dependent_care_benefits: type: - string - 'null' description: Dependent care benefits. nonqualified_plans: type: - string - 'null' description: Nonqualified plans. box_12: type: array items: $ref: '#/components/schemas/W2Box12' statutory_employee: type: - string - 'null' description: Statutory employee. retirement_plan: type: - string - 'null' description: Retirement plan. third_party_sick_pay: type: - string - 'null' description: Third party sick pay. other: type: - string - 'null' description: Other. state_and_local_wages: type: array items: $ref: '#/components/schemas/W2StateAndLocalWages' required: - document_metadata - document_id - employer - employee - tax_year - employer_id_number - wages_tips_other_comp - federal_income_tax_withheld - social_security_wages - social_security_tax_withheld - medicare_wages_and_tips - medicare_tax_withheld - social_security_tips - allocated_tips - box_9 - dependent_care_benefits - nonqualified_plans - box_12 - statutory_employee - retirement_plan - third_party_sick_pay - other - state_and_local_wages CraLoanUserToken: type: string description: The user token for the user associated with the loan. TransferAuthorizationProposedTransfer: title: TransferAuthorizationProposedTransfer type: object additionalProperties: true description: Details regarding the proposed transfer. properties: ach_class: $ref: '#/components/schemas/ACHClass' account_id: type: string description: The Plaid `account_id` for the account that will be debited or credited. funding_account_id: $ref: '#/components/schemas/TransferFundingAccountIDResponseNullable' type: $ref: '#/components/schemas/TransferType' user: $ref: '#/components/schemas/TransferUserInResponse' amount: $ref: '#/components/schemas/TransferAmount' network: type: string description: The network or rails used for the transfer. wire_details: $ref: '#/components/schemas/TransferWireDetails' origination_account_id: type: string description: Plaid's unique identifier for the origination account that was used for this transfer. deprecated: true x-hidden-from-docs: true iso_currency_code: type: string description: The currency of the transfer amount. The default value is "USD". originator_client_id: type: - string - 'null' description: The Plaid client ID that is the originator of this transfer. Only present if created on behalf of another client as a [Platform customer](https://plaid.com/docs/transfer/application/#originators-vs-platforms). credit_funds_source: deprecated: true allOf: - $ref: '#/components/schemas/TransferCreditFundsSource' required: - type - user - amount - network - origination_account_id - iso_currency_code - originator_client_id - funding_account_id - credit_funds_source Pay: title: Pay type: object deprecated: true description: An object representing a monetary amount. additionalProperties: true properties: amount: type: - number - 'null' format: double description: A numerical amount of a specific currency. currency: type: - string - 'null' description: Currency code, e.g. USD PayStubTaxpayerID: title: PayStubTaxpayerID type: object additionalProperties: true description: Taxpayer ID of the individual receiving the paystub. properties: id_type: type: - string - 'null' description: Type of ID, e.g. 'SSN'. id_mask: type: - string - 'null' description: ID mask; i.e. last 4 digits of the taxpayer ID. required: - id_type - id_mask VerificationOfAsset: title: VerificationOfAsset type: object additionalProperties: true description: Documentation not found in the MISMO model viewer and not provided by Freddie Mac. properties: REPORTING_INFORMATION: $ref: '#/components/schemas/ReportingInformation' SERVICE_PRODUCT_FULFILLMENT: $ref: '#/components/schemas/ServiceProductFulfillment' VERIFICATION_OF_ASSET_RESPONSE: $ref: '#/components/schemas/VerificationOfAssetResponse' required: - REPORTING_INFORMATION - SERVICE_PRODUCT_FULFILLMENT - VERIFICATION_OF_ASSET_RESPONSE LinkSessionExitDeprecated: type: - object - 'null' deprecated: true description: An object representing an [onExit](https://plaid.com/docs/link/web/#onexit) callback from Link. additionalProperties: true properties: error: $ref: '#/components/schemas/PlaidError' metadata: $ref: '#/components/schemas/LinkSessionExitMetadata' required: - error - metadata Activity: description: Describes a consent activity. type: object properties: activity: $ref: '#/components/schemas/ActivityType' initiated_date: type: string format: date description: The date this activity was initiated [ISO 8601](https://wikipedia.org/wiki/ISO_8601) (YYYY-MM-DD) format in UTC. example: '2020-01-01' id: type: string description: A unique identifier for the activity initiator: type: string description: Application ID of the client who initiated the activity. state: $ref: '#/components/schemas/ActionState' target_application_id: $ref: '#/components/schemas/ApplicationID' scopes: $ref: '#/components/schemas/ScopesNullable' required: - activity - initiated_date - id - initiator - state IdentityVerificationTemplateVersion: type: integer example: 2 title: IdentityVerificationTemplateVersion description: Version of the associated Identity Verification template. DocumentaryVerification: description: Data, images, analysis, and results from the `documentary_verification` step. This field will be `null` unless `steps.documentary_verification` has reached a terminal state of either `success` or `failed`. title: DocumentaryVerification type: - object - 'null' properties: status: type: string description: The outcome status for the associated Identity Verification attempt's `documentary_verification` step. This field will always have the same value as `steps.documentary_verification`. example: success documents: description: 'An array of documents submitted to the `documentary_verification` step. Each entry represents one user submission, where each submission will contain both a front and back image, or just a front image, depending on the document type. Note: Plaid will automatically let a user submit a new set of document images up to three times if we detect that a previous attempt might have failed due to user error. For example, if the first set of document images are blurry or obscured by glare, the user will be asked to capture their documents again, resulting in at least two separate entries within `documents`. If the overall `documentary_verification` is `failed`, the user has exhausted their retry attempts.' type: array items: $ref: '#/components/schemas/DocumentaryVerificationDocument' required: - status - documents additionalProperties: true BankInitiatedReturnRisk: title: BankInitiatedReturnRisk type: object description: 'The object contains a risk score and a risk tier that evaluate the transaction return risk because an account is overdrawn or because an ineligible account is used. Common return codes in this category include: "R01", "R02", "R03", "R04", "R06", "R08", "R09", "R13", "R16", "R17", "R20", "R23". These returns have a turnaround time of 2 banking days.' properties: score: $ref: '#/components/schemas/SignalScore' risk_tier: $ref: '#/components/schemas/BankInitiatedRiskTier' required: - risk_tier - score PartnerCustomerOAuthInstitutionsGetRequest: description: Request schema for `/partner/customer/oauth_institutions/get`. properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' end_customer_client_id: type: string required: - end_customer_client_id IncomeBreakdownType: type: - string - 'null' description: "The type of income. Possible values include:\n `\"regular\"`: regular income\n `\"overtime\"`: overtime income\n `\"bonus\"`: bonus income" enum: - bonus - overtime - regular - null DeprecatedClientUserID: type: - string - 'null' title: CustomerReference deprecated: true minLength: 1 example: your-db-id-3b24110 description: Specifying `user.client_user_id` is deprecated. Please provide `client_user_id` at the root level instead. AssetReportToken: title: AssetReportToken type: string description: A token that can be provided to endpoints such as `/asset_report/get` or `/asset_report/pdf/get` to fetch or update an Asset Report. PaymentInitiationPaymentListResponse: type: object additionalProperties: true description: PaymentInitiationPaymentListResponse defines the response schema for `/payment_initiation/payment/list` properties: payments: type: array description: An array of payments that have been created, associated with the given `client_id`. items: $ref: '#/components/schemas/PaymentInitiationPayment' next_cursor: format: date-time type: - string - 'null' description: The value that, when used as the optional `cursor` parameter to `/payment_initiation/payment/list`, will return the next unreturned payment as its first payment. request_id: $ref: '#/components/schemas/RequestID' required: - payments - next_cursor - request_id ItemStatusTransactions: description: Information about the last successful and failed transactions update for the Item. type: - object - 'null' additionalProperties: true properties: last_successful_update: description: '[ISO 8601](https://wikipedia.org/wiki/ISO_8601) timestamp of the last successful transactions update for the Item. The status will update each time Plaid successfully connects with the institution, regardless of whether any new data is available in the update.' type: - string - 'null' format: date-time last_failed_update: description: '[ISO 8601](https://wikipedia.org/wiki/ISO_8601) timestamp of the last failed transactions update for the Item. The status will update each time Plaid fails an attempt to connect with the institution, regardless of whether any new data is available in the update.' type: - string - 'null' format: date-time SignalWarning: title: SignalWarning type: object description: Conveys information about the errors causing missing or stale bank data used to construct the /signal/evaluate scores and response properties: warning_type: type: string description: A broad categorization of the warning. Safe for programmatic use. warning_code: type: string description: The warning code identifies a specific kind of warning that pertains to the error causing bank data to be missing. Safe for programmatic use. For more details on warning codes, please refer to Plaid standard error codes documentation. If you receive the `ITEM_LOGIN_REQUIRED` warning, we recommend re-authenticating your user by implementing Link's update mode. This will guide your user to fix their credentials, allowing Plaid to start fetching data again for future Signal requests. warning_message: type: string description: A developer-friendly representation of the warning type. This may change over time and is not safe for programmatic use. TransferAuthorizationUserInRequest: title: TransferAuthorizationUserInRequest type: object description: The legal name and other information for the account holder. The `user.legal_name` field is required. Other fields are not currently used and are present to support planned future functionality. properties: legal_name: type: string description: The user's legal name. If the user is a business, provide the business name. phone_number: type: string description: The user's phone number. email_address: type: string description: The user's email address. address: $ref: '#/components/schemas/TransferUserAddressInRequest' required: - legal_name AssetReportFreddie: title: AssetReportFreddie type: object additionalProperties: true description: An object representing an Asset Report with Freddie Mac schema. properties: LOANS: $ref: '#/components/schemas/Loans' PARTIES: $ref: '#/components/schemas/Parties' SERVICES: $ref: '#/components/schemas/Services' required: - LOANS - PARTIES - SERVICES StatementsAccount: title: StatementsAccount type: object additionalProperties: true description: Account associated with the Item. properties: account_id: description: Plaid's unique identifier for the account. type: string account_mask: description: The last 2-4 alphanumeric characters of an account's official account number. Note that the mask may be non-unique between an Item's accounts, and it may also not match the mask that the bank displays to the user. type: string account_name: description: The name of the account, either assigned by the user or by the financial institution itself. type: string account_official_name: description: The official name of the account as given by the financial institution. type: string account_subtype: description: The subtype of the account. For a full list of valid types and subtypes, see the [Account schema](https://plaid.com/docs/api/accounts#account-type-schema). type: string account_type: description: The type of account. For a full list of valid types and subtypes, see the [Account schema](https://plaid.com/docs/api/accounts#account-type-schema). type: string statements: description: The list of statements' metadata associated with this account. type: array items: $ref: '#/components/schemas/StatementsStatement' required: - account_id - account_name - account_official_name - account_subtype - account_type - account_mask - statements InvestmentTransactionSubtype: type: string description: For descriptions of possible transaction types and subtypes, see the [Investment transaction types schema](https://plaid.com/docs/api/accounts/#investment-transaction-types-schema). enum: - account fee - adjustment - assignment - buy - buy to cover - contribution - deposit - distribution - dividend - dividend reinvestment - exercise - expire - fund fee - interest - interest receivable - interest reinvestment - legal fee - loan payment - long-term capital gain - long-term capital gain reinvestment - management fee - margin expense - merger - miscellaneous fee - non-qualified dividend - non-resident tax - pending credit - pending debit - qualified dividend - rebalance - return of principal - request - sell - sell short - send - short-term capital gain - short-term capital gain reinvestment - spin off - split - stock distribution - tax - tax withheld - trade - transfer - transfer fee - trust fee - unqualified gain - withdrawal PaymentInitiationPaymentStatus: type: string enum: - PAYMENT_STATUS_INPUT_NEEDED - PAYMENT_STATUS_PROCESSING - PAYMENT_STATUS_INITIATED - PAYMENT_STATUS_COMPLETED - PAYMENT_STATUS_INSUFFICIENT_FUNDS - PAYMENT_STATUS_FAILED - PAYMENT_STATUS_BLOCKED - PAYMENT_STATUS_UNKNOWN - PAYMENT_STATUS_EXECUTED - PAYMENT_STATUS_SETTLED - PAYMENT_STATUS_AUTHORISING - PAYMENT_STATUS_CANCELLED - PAYMENT_STATUS_ESTABLISHED - PAYMENT_STATUS_REJECTED description: 'The status of the payment. `PAYMENT_STATUS_INPUT_NEEDED`: This is the initial state of all payments. It indicates that the payment is waiting on user input to continue processing. A payment may re-enter this state later on if further input is needed. `PAYMENT_STATUS_INITIATED`: The payment has been successfully authorised and accepted by the financial institution. For successful payments, this is a potential terminal status. Further status transitions can be to REJECTED and, when supported by the institution, to EXECUTED. `PAYMENT_STATUS_INSUFFICIENT_FUNDS`: The payment has failed due to insufficient funds. `PAYMENT_STATUS_FAILED`: The payment has failed to be initiated. This error may be caused by transient system outages and is retryable once the root cause is resolved. `PAYMENT_STATUS_BLOCKED`: The payment has been blocked by Plaid. This can occur, for example, due to Plaid flagging the payment as potentially risky. This is a retryable error. `PAYMENT_STATUS_AUTHORISING`: The payment is currently being processed. The payment will automatically exit this state when the financial institution has authorised the transaction. `PAYMENT_STATUS_CANCELLED`: The payment was cancelled (typically by the end user) during authorisation. `PAYMENT_STATUS_EXECUTED`: The funds have successfully left the payer account and payment is considered complete. Not all institutions support this status: support is more common in the UK, and less common in the EU. For institutions where this status is not supported, the terminal status for a successful payment will be `PAYMENT_STATUS_INITIATED`. `PAYMENT_STATUS_SETTLED`: The payment has settled and funds are available for use. A payment will typically settle within seconds to several days, depending on which payment rail is used. This status is only available to customers using [Plaid Virtual Accounts](https://plaid.com/docs/virtual-accounts/). `PAYMENT_STATUS_ESTABLISHED`: Indicates that the standing order has been successfully established. This state is only used for standing orders. `PAYMENT_STATUS_REJECTED`: The payment was rejected by the financial institution. Deprecated: These statuses will be removed in a future release. `PAYMENT_STATUS_UNKNOWN`: The payment status is unknown. `PAYMENT_STATUS_PROCESSING`: The payment is currently being processed. The payment will automatically exit this state when processing is complete. `PAYMENT_STATUS_COMPLETED`: Indicates that the standing order has been successfully established. This state is only used for standing orders.' Party: title: Party type: object additionalProperties: true description: A collection of information about a single party to a transaction. Included direct participants like the borrower and seller as well as indirect participants such as the flood certificate provider. properties: INDIVIDUAL: $ref: '#/components/schemas/PartyIndividual' ROLES: $ref: '#/components/schemas/Roles' TAXPAYER_IDENTIFIERS: $ref: '#/components/schemas/TaxpayerIdentifiers' required: - INDIVIDUAL - ROLES - TAXPAYER_IDENTIFIERS TransferAuthorizationPaymentRisk: title: TransferAuthorizationPaymentRisk description: This object includes the scores and risk level. This response is offered as an add-on to /transfer/authorization/create. To request access to these fields please contact your Plaid account manager. type: - object - 'null' additionalProperties: true properties: bank_initiated_return_score: description: 'A score from 1-99 that indicates the transaction return risk: a higher risk score suggests a higher return likelihood. The score evaluates the transaction return risk because an account is overdrawn or because an ineligible account is used and covers return codes: "R01", "R02", "R03", "R04", "R06", "R08", "R09", "R13", "R16", "R17", "R20", "R23". These returns have a turnaround time of 2 banking days.' type: - integer - 'null' minimum: 1 maximum: 99 customer_initiated_return_score: description: 'A score from 1-99 that indicates the transaction return risk: a higher risk score suggests a higher return likelihood. The score evaluates the transaction return risk of an unauthorized debit and covers return codes: "R05", "R07", "R10", "R11", "R29". These returns typically have a return time frame of up to 60 calendar days. During this period, the customer of financial institutions can dispute a transaction as unauthorized.' type: - integer - 'null' minimum: 1 maximum: 99 risk_level: $ref: '#/components/schemas/TransferAuthorizationRiskLevel' warnings: type: array description: If bank information was not available to be used in the Signal model, this array contains warnings describing why bank data is missing. If you want to receive an API error instead of Signal scores in the case of missing bank data, file a support ticket or contact your Plaid account manager. items: $ref: '#/components/schemas/SignalWarning' required: - bank_initiated_return_score - customer_initiated_return_score - risk_level - warnings SandboxTransferLedgerWithdrawSimulateRequest: title: SandboxTransferLedgerWithdrawSimulateRequest type: object description: Defines the request schema for `/sandbox/transfer/ledger/withdraw/simulate` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' sweep_id: $ref: '#/components/schemas/TransferSweepID' event_type: $ref: '#/components/schemas/TransferLedgerSweepSimulateEventType' failure_reason: $ref: '#/components/schemas/TransferFailure' required: - sweep_id - event_type SignalDecisionReportResponse: title: SignalDecisionReportResponse description: SignalDecisionReportResponse defines the response schema for `/signal/decision/report` additionalProperties: true type: object properties: request_id: $ref: '#/components/schemas/RequestID' required: - request_id InstitutionsGetRequest: type: object description: InstitutionsGetRequest defines the request schema for `/institutions/get` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' count: type: integer minimum: 1 maximum: 500 description: The total number of Institutions to return. offset: type: integer description: The number of Institutions to skip. minimum: 0 country_codes: type: array description: 'Specify which country or countries to include institutions from, using the ISO-3166-1 alpha-2 country code standard. In API versions 2019-05-29 and earlier, the `country_codes` parameter is an optional parameter within the `options` object and will default to `[US]` if it is not supplied. ' minItems: 1 items: $ref: '#/components/schemas/CountryCode' options: $ref: '#/components/schemas/InstitutionsGetRequestOptions' required: - count - offset - country_codes SweepStatus: title: SweepStatus type: - string - 'null' enum: - pending - posted - settled - returned - failed - null description: 'The status of a sweep transfer `"pending"` - The sweep is currently pending `"posted"` - The sweep has been posted `"settled"` - The sweep has settled `"returned"` - The sweep has been returned `"failed"` - The sweep has failed' TransferOriginatorDiligence: description: The diligence information for the originator. type: object properties: dba: description: The business name of the originator. type: string tax_id: description: The tax ID of the originator. type: string minLength: 1 credit_usage_configuration: $ref: '#/components/schemas/TransferCreditUsageConfiguration' debit_usage_configuration: $ref: '#/components/schemas/TransferDebitUsageConfiguration' address: $ref: '#/components/schemas/TransferOriginatorAddress' website: description: The website of the originator. type: string naics_code: description: The NAICS code of the originator. type: string minLength: 6 maxLength: 6 funding_account: $ref: '#/components/schemas/TransferFundingAccount' required: - dba - tax_id - address - website - naics_code - funding_account WatchlistScreeningEntityProgramGetRequest: description: Request input for fetching an entity watchlist program type: object properties: entity_watchlist_program_id: $ref: '#/components/schemas/EntityWatchlistProgramID' secret: $ref: '#/components/schemas/APISecret' client_id: $ref: '#/components/schemas/APIClientID' required: - entity_watchlist_program_id BankTransferSweepListRequest: title: BankTransferSweepListRequest type: object description: BankTransferSweepListRequest defines the request schema for `/bank_transfer/sweep/list` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' origination_account_id: type: - string - 'null' description: If multiple origination accounts are available, `origination_account_id` must be used to specify the account that the sweeps belong to. start_time: type: - string - 'null' format: date-time description: The start datetime of sweeps to return (RFC 3339 format). end_time: type: - string - 'null' format: date-time description: The end datetime of sweeps to return (RFC 3339 format). count: type: - integer - 'null' minimum: 1 maximum: 25 default: 25 description: The maximum number of sweeps to return. LinkOAuthCorrelationIdExchangeRequest: type: object description: LinkOAuthCorrelationIdExchangeRequest defines the request schema for `/link/oauth/correlation_id/exchange` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' link_correlation_id: type: string description: A `link_correlation_id` from a received OAuth redirect URI callback required: - link_correlation_id PaymentProfileStatus: type: string enum: - PENDING - READY - REMOVED description: 'The status of the given Payment Profile. `READY`: This Payment Profile is ready to be used to create transfers using `/transfer/authorization/create` and `/transfer/create`. `PENDING`: This Payment Profile is not ready to be used. You’ll need to call `/link/token/create` and provide the `payment_profile_token` in the `transfer.payment_profile_token` field to initiate the account linking experience. `REMOVED`: This Payment Profile has been removed.' CreditBankStatementUploadBankAccount: title: CreditBankStatementUploadBankAccount type: object additionalProperties: true description: An object containing data about a user's bank account related to an uploaded bank statement. properties: name: type: - string - 'null' description: The name of the bank account bank_name: type: - string - 'null' description: The name of the bank institution. account_type: type: - string - 'null' description: The type of the bank account. account_number: type: - string - 'null' description: The bank account number. owner: $ref: '#/components/schemas/CreditBankStatementUploadAccountOwner' periods: type: array description: An array of period objects, containing more data on the overall period of the statement. items: $ref: '#/components/schemas/CreditBankStatementUploadBankAccountPeriod' account_id: type: - string - 'null' description: The unique id of the bank account required: - name - bank_name - account_type - account_number - owner - periods - account_id IdentityVerificationAutofillStatus: description: A status enum indicating whether autofill succeeded or failed. type: string enum: - success - failed example: success title: IdentityVerificationAutofillStatus BankTransferID: type: string title: BankTransferID description: Plaid’s unique identifier for a bank transfer. WatchlistScreeningDocumentValueNullable: type: - string - 'null' title: WatchlistScreeningDocumentValue minLength: 4 example: C31195855 description: The numeric or alphanumeric identifier associated with this document. LinkSessionResults: type: - object - 'null' description: The set of results for a Link session. additionalProperties: true properties: item_add_results: type: array description: The set of Item adds for the Link session. items: $ref: '#/components/schemas/LinkSessionItemAddResult' bank_income_results: type: array description: The set of bank income verifications for the Link session. items: $ref: '#/components/schemas/LinkSessionBankIncomeResult' payroll_income_results: type: array description: The set of payroll income verifications for the Link session. items: $ref: '#/components/schemas/LinkSessionPayrollIncomeResult' document_income_results: $ref: '#/components/schemas/CreditSessionDocumentIncomeResult' CreditBankIncomeCategory: type: string description: The income category. Note that the `CASH` value has been deprecated and is used only for existing legacy implementations. It has been replaced by the new categories `CASH_DEPOSIT` (representing cash or check deposits) and `TRANSFER_FROM_APPLICATION` (representing cash transfers originating from apps, such as Zelle or Venmo). enum: - SALARY - UNEMPLOYMENT - CASH - GIG_ECONOMY - RENTAL - CHILD_SUPPORT - MILITARY - RETIREMENT - LONG_TERM_DISABILITY - BANK_INTEREST - CASH_DEPOSIT - TRANSFER_FROM_APPLICATION - TAX_REFUND - BENEFIT_OTHER - OTHER PayStubDeductionsBreakdown: title: PayStubDeductionsBreakdown type: object additionalProperties: true description: An object representing the deduction line items for the pay period properties: current_amount: type: - number - 'null' format: double description: Raw amount of the deduction description: type: - string - 'null' description: Description of the deduction line item iso_currency_code: type: - string - 'null' description: The ISO-4217 currency code of the line item. Always `null` if `unofficial_currency_code` is non-null. unofficial_currency_code: type: - string - 'null' description: 'The unofficial currency code associated with the line item. Always `null` if `iso_currency_code` is non-`null`. Unofficial currency codes are used for currencies that do not have official ISO currency codes, such as cryptocurrencies and the currencies of certain countries. See the [currency code schema](https://plaid.com/docs/api/accounts#currency-code-schema) for a full listing of supported `iso_currency_code`s.' ytd_amount: type: - number - 'null' format: double description: The year-to-date amount of the deduction required: - current_amount - description - iso_currency_code - unofficial_currency_code - ytd_amount DocumentAnalysis: description: High level descriptions of how the associated document was processed. If a document fails verification, the details in the `analysis` object should help clarify why the document was rejected. type: object properties: authenticity: $ref: '#/components/schemas/DocumentAuthenticityMatchCode' image_quality: $ref: '#/components/schemas/ImageQuality' extracted_data: $ref: '#/components/schemas/PhysicalDocumentExtractedDataAnalysis' required: - authenticity - image_quality - extracted_data additionalProperties: true BeaconReportSyndicationListRequest: description: Request input for listing Beacon Report Syndications type: object properties: beacon_user_id: $ref: '#/components/schemas/BeaconUserID' cursor: $ref: '#/components/schemas/Cursor' client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' required: - beacon_user_id LoanAccountSubtypes: title: LoanAccountSubtypes type: array description: 'An array of account subtypes to display in Link. If not specified, all account subtypes will be shown. For a full list of valid types and subtypes, see the [Account schema](https://plaid.com/docs/api/accounts#account-type-schema). ' items: $ref: '#/components/schemas/LoanAccountSubtype' WalletGetRequest: type: object description: WalletGetRequest defines the request schema for `/wallet/get` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' wallet_id: type: string description: The ID of the e-wallet minLength: 1 required: - wallet_id BaseReportTransactionType: title: BaseReportTransactionType type: - string - 'null' x-hidden-from-docs: true enum: - digital - place - special - unresolved description: '`digital:` transactions that took place online. `place:` transactions that were made at a physical location. `special:` transactions that relate to banks, e.g. fees or deposits. `unresolved:` transactions that do not fit into the other types. ' PayrollItem: title: PayrollItem type: object description: An object containing information about the payroll item. properties: item_id: $ref: '#/components/schemas/ItemId' institution_id: type: string description: The unique identifier of the institution associated with the Item. institution_name: type: string description: The name of the institution associated with the Item. accounts: type: array items: $ref: '#/components/schemas/PayrollIncomeAccountData' payroll_income: type: array items: $ref: '#/components/schemas/PayrollIncomeObject' status: $ref: '#/components/schemas/PayrollItemStatus' updated_at: type: - string - 'null' format: date-time description: Timestamp in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format (YYYY-MM-DDTHH:mm:ssZ) indicating the last time that the Item was updated. required: - item_id - institution_id - institution_name - payroll_income - status - accounts - updated_at DepositSwitchAddressData: title: DepositSwitchAddressData type: object additionalProperties: true description: The user's address. properties: city: type: string description: The full city name region: type: string description: 'The region or state Example: `"NC"`' street: type: string description: 'The full street address Example: `"564 Main Street, APT 15"`' postal_code: type: string description: The postal code country: type: string description: The ISO 3166-1 alpha-2 country code required: - street - city - region - postal_code - country BeaconUserAddress: type: object title: BeaconUserAddress description: 'Even if an address has been collected, some fields may be null depending on the region''s addressing system. For example: Addresses from the United Kingdom will not include a region Addresses from Hong Kong will not include a postal code' properties: street: $ref: '#/components/schemas/Street' street2: $ref: '#/components/schemas/Street2' city: $ref: '#/components/schemas/City' region: $ref: '#/components/schemas/Region' postal_code: $ref: '#/components/schemas/PostalCode' country: $ref: '#/components/schemas/GenericCountryCode' required: - street - street2 - city - region - postal_code - country additionalProperties: true UpdatedAtTimestamp: description: An ISO8601 formatted timestamp. This field indicates the last time the resource was modified. type: string format: date-time title: Timestamp example: '2020-07-24T03:26:02Z' BeaconUserData: type: object title: BeaconUserData description: A Beacon User's data and resulting analysis when checked against duplicate records and the Beacon Fraud Network. properties: date_of_birth: $ref: '#/components/schemas/ISO8601Date' name: $ref: '#/components/schemas/BeaconUserName' address: $ref: '#/components/schemas/BeaconUserAddress' email_address: $ref: '#/components/schemas/EmailAddressNullable' phone_number: $ref: '#/components/schemas/BeaconUserPhoneNumber' id_number: $ref: '#/components/schemas/BeaconUserIDNumber' ip_address: $ref: '#/components/schemas/IPAddress' required: - date_of_birth - name - address - email_address - phone_number - id_number - ip_address additionalProperties: true LinkTokenAccountFilters: description: 'By default, Link will provide limited account filtering: it will only display Institutions that are compatible with all products supplied in the `products` parameter of `/link/token/create`, and, if `auth` is specified in the `products` array, will also filter out accounts other than `checking` and `savings` accounts on the Account Select pane. You can further limit the accounts shown in Link by using `account_filters` to specify the account subtypes to be shown in Link. Only the specified subtypes will be shown. This filtering applies to both the Account Select view (if enabled) and the Institution Select view. Institutions that do not support the selected subtypes will be omitted from Link. To indicate that all subtypes should be shown, use the value `"all"`. If the `account_filters` filter is used, any account type for which a filter is not specified will be entirely omitted from Link. For a full list of valid types and subtypes, see the [Account schema](https://plaid.com/docs/api/accounts#account-type-schema). The filter may or may not impact the list of accounts shown by the institution in the OAuth account selection flow, depending on the specific institution. If the user selects excluded account subtypes in the OAuth flow, these accounts will not be added to the Item. If the user selects only excluded account subtypes, the link attempt will fail and the user will be prompted to try again. ' type: object additionalProperties: true properties: depository: $ref: '#/components/schemas/DepositoryFilter' credit: $ref: '#/components/schemas/CreditFilter' loan: $ref: '#/components/schemas/LoanFilter' investment: $ref: '#/components/schemas/InvestmentFilter' other: $ref: '#/components/schemas/OtherFilter' CityNullable: type: - string - 'null' example: Pawnee title: CityName description: City from the end user's address. A string with at least one non-whitespace alphabetical character, with a max length of 100 characters." CreditBankStatementsUploadsGetRequest: title: CreditBankStatementsUploadsGetRequest type: object description: CreditBankStatementsUploadsGetRequest defines the request schema for `/credit/bank_statements/uploads/get` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' user_token: $ref: '#/components/schemas/UserToken' options: $ref: '#/components/schemas/CreditBankStatementsUploadsGetRequestOptions' required: - user_token CreditBankStatementUploadAccountOwner: title: CreditBankStatementUploadAccountOwner type: object description: An object containing data about the owner of the bank account for the uploaded bank statement. additionalProperties: true properties: name: type: - string - 'null' description: The name of the account owner address: $ref: '#/components/schemas/CreditBankStatementUploadAccountOwnerAddress' required: - name - address BankTransferSweep: title: BankTransferSweep type: object additionalProperties: true description: BankTransferSweep describes a sweep transfer. properties: id: type: string description: Identifier of the sweep. created_at: type: string description: The datetime when the sweep occurred, in RFC 3339 format. format: date-time amount: type: string description: The amount of the sweep. iso_currency_code: type: string description: The currency of the sweep, e.g. "USD". required: - id - created_at - amount - iso_currency_code TransferSweepListRequest: title: TransferSweepListRequest type: object description: Defines the request schema for `/transfer/sweep/list` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' start_date: type: - string - 'null' format: date-time description: The start datetime of sweeps to return (RFC 3339 format). end_date: type: - string - 'null' format: date-time description: The end datetime of sweeps to return (RFC 3339 format). count: type: - integer - 'null' minimum: 1 maximum: 25 default: 25 description: The maximum number of sweeps to return. offset: type: integer default: 0 minimum: 0 description: The number of sweeps to skip before returning results. amount: type: - string - 'null' description: Filter sweeps to only those with the specified amount. status: $ref: '#/components/schemas/SweepStatus' originator_client_id: type: - string - 'null' description: Filter sweeps to only those with the specified originator client. funding_account_id: type: - string - 'null' description: Filter sweeps to only those with the specified `funding_account_id`. transfer_id: type: - string - 'null' description: Filter sweeps to only those with the included `transfer_id`. trigger: $ref: '#/components/schemas/SweepTrigger' WatchlistScreeningEntityProgramListRequest: description: Request input for listing entity watchlist screening programs type: object properties: secret: $ref: '#/components/schemas/APISecret' client_id: $ref: '#/components/schemas/APIClientID' cursor: $ref: '#/components/schemas/Cursor' BaseReportCreateRequest: type: object x-hidden-from-docs: true description: BaseReportCreateRequest defines the request schema for `/cra/base_report/create` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' user_token: $ref: '#/components/schemas/UserToken' days_requested: type: integer maximum: 731 minimum: 0 description: The duration of transaction history you requested webhook: type: - string - 'null' description: URL to which Plaid will send Assets webhooks, for example when the requested Asset Report is ready. consumer_report_permissible_purpose: $ref: '#/components/schemas/ConsumerReportPermissiblePurpose' required: - user_token - days_requested - webhook - consumer_report_permissible_purpose WatchlistScreeningRequestSearchTerms: type: object description: Search inputs for creating a watchlist screening required: - watchlist_program_id - legal_name properties: watchlist_program_id: $ref: '#/components/schemas/WatchlistProgramID' legal_name: $ref: '#/components/schemas/WatchlistScreeningIndividualName' date_of_birth: $ref: '#/components/schemas/ISO8601Date' document_number: $ref: '#/components/schemas/WatchlistScreeningDocumentValue' country: $ref: '#/components/schemas/GenericCountryCode' WatchlistScreeningEntityCreateRequest: type: object description: Request input for creating an entity screening review properties: search_terms: $ref: '#/components/schemas/EntityWatchlistSearchTerms' client_user_id: $ref: '#/components/schemas/ClientUserID' client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' required: - search_terms PartnerEndCustomer: description: The details for an end customer. type: object additionalProperties: true properties: client_id: type: string description: The `client_id` of the end customer. company_name: type: string description: The company name associated with the end customer. status: $ref: '#/components/schemas/PartnerEndCustomerStatus' SandboxTransferRefundSimulateResponse: title: SandboxTransferRefundSimulateResponse type: object additionalProperties: true description: Defines the response schema for `/sandbox/transfer/refund/simulate` properties: request_id: $ref: '#/components/schemas/RequestID' required: - request_id PayrollItemStatus: title: PayrollItemStatus description: Details about the status of the payroll item. type: - object - 'null' additionalProperties: true properties: processing_status: title: PayrollItemStatusProcessingStatus type: - string - 'null' description: 'Denotes the processing status for the verification. `UNKNOWN`: The processing status could not be determined. `PROCESSING_COMPLETE`: The processing has completed and the user has approved for sharing. The data is available to be retrieved. `PROCESSING`: The verification is still processing. The data is not available yet. `FAILED`: The processing failed to complete successfully. `APPROVAL_STATUS_PENDING`: The processing has completed but the user has not yet approved the sharing of the data.' x-override-enum-values-shown: - UNKNOWN - PROCESSING_COMPLETE - PROCESSING - FAILED - APPROVAL_STATUS_PENDING AccountVerificationInsightsPreviousReturns: title: VerificationInsightsNetworkStatus type: object additionalProperties: true description: Information about known ACH returns for the account and routing number. properties: has_previous_administrative_return: type: boolean description: Indicates whether Plaid's data sources include a known administrative ACH return for account and routing number. required: - has_previous_administrative_return BalancePlusAttributes: title: BalancePlusAttributes type: object description: 'Contains additional data that can be used to assess the ACH return risk. Examples of data include: `days_since_first_plaid_connection`: The number of days since the first time the Item was connected to an application via Plaid `plaid_connections_count_7d`: The number of times the Item has been connected to applications via Plaid over the past 7 days `plaid_connections_count_30d`: The number of times the Item has been connected to applications via Plaid over the past 30 days `total_plaid_connections_count`: The number of times the Item has been connected to applications via Plaid `is_savings_or_money_market_account`: Indicates whether the ACH transaction funding account is a savings/money market account For the full list and detailed documentation of attributes available, or to request that attributes not be returned, contact Sales or your Plaid account manager' properties: unauthorized_transactions_count_7d: type: - integer - 'null' description: We parse and analyze historical transaction metadata to identify the number of possible past returns due to unauthorized transactions over the past 7 days from the account that will be debited. unauthorized_transactions_count_30d: type: - integer - 'null' description: We parse and analyze historical transaction metadata to identify the number of possible past returns due to unauthorized transactions over the past 30 days from the account that will be debited. unauthorized_transactions_count_60d: type: - integer - 'null' description: We parse and analyze historical transaction metadata to identify the number of possible past returns due to unauthorized transactions over the past 60 days from the account that will be debited. unauthorized_transactions_count_90d: type: - integer - 'null' description: We parse and analyze historical transaction metadata to identify the number of possible past returns due to unauthorized transactions over the past 90 days from the account that will be debited. nsf_overdraft_transactions_count_7d: type: - integer - 'null' description: We parse and analyze historical transaction metadata to identify the number of possible past returns due to non-sufficient funds/overdrafts over the past 7 days from the account that will be debited. nsf_overdraft_transactions_count_30d: type: - integer - 'null' description: We parse and analyze historical transaction metadata to identify the number of possible past returns due to non-sufficient funds/overdrafts over the past 30 days from the account that will be debited. nsf_overdraft_transactions_count_60d: type: - integer - 'null' description: We parse and analyze historical transaction metadata to identify the number of possible past returns due to non-sufficient funds/overdrafts over the past 60 days from the account that will be debited. nsf_overdraft_transactions_count_90d: type: - integer - 'null' description: We parse and analyze historical transaction metadata to identify the number of possible past returns due to non-sufficient funds/overdrafts over the past 90 days from the account that will be debited. days_since_first_plaid_connection: type: - integer - 'null' description: The number of days since the first time the Item was connected to an application via Plaid plaid_connections_count_7d: type: - integer - 'null' description: The number of times the Item has been connected to applications via Plaid over the past 7 days plaid_connections_count_30d: type: - integer - 'null' description: The number of times the Item has been connected to applications via Plaid over the past 30 days total_plaid_connections_count: type: - integer - 'null' description: The total number of times the Item has been connected to applications via Plaid is_savings_or_money_market_account: type: - boolean - 'null' description: Indicates if the ACH transaction funding account is a savings/money market account phone_change_count_28d: type: - integer - 'null' description: The number of times the account's phone numbers on file have changed over the past 28 days phone_change_count_90d: type: - integer - 'null' description: The number of times the account's phone numbers on file have changed over the past 90 days email_change_count_28d: type: - integer - 'null' description: The number of times the account's email addresses on file have changed over the past 28 days email_change_count_90d: type: - integer - 'null' description: The number of times the account's email addresses on file have changed over the past 90 days address_change_count_28d: type: - integer - 'null' description: The number of times the account's addresses on file have changed over the past 28 days address_change_count_90d: type: - integer - 'null' description: The number of times the account's addresses on file have changed over the past 90 days plaid_non_oauth_authentication_attempts_count_3d: type: - integer - 'null' description: The number of non-OAuth authentication attempts via Plaid for this bank account over the past 3 days plaid_non_oauth_authentication_attempts_count_7d: type: - integer - 'null' description: The number of non-OAuth authentication attempts via Plaid for this bank account over the past 7 days plaid_non_oauth_authentication_attempts_count_30d: type: - integer - 'null' description: The number of non-OAuth authentication attempts via Plaid for this bank account over the past 30 days failed_plaid_non_oauth_authentication_attempts_count_3d: type: - integer - 'null' description: The number of failed non-OAuth authentication attempts via Plaid for this bank account over the past 3 days failed_plaid_non_oauth_authentication_attempts_count_7d: type: - integer - 'null' description: The number of failed non-OAuth authentication attempts via Plaid for this bank account over the past 7 days failed_plaid_non_oauth_authentication_attempts_count_30d: type: - integer - 'null' description: The number of failed non-OAuth authentication attempts via Plaid for this bank account over the past 30 days is_account_closed: type: - boolean - 'null' description: Indicates if the receiver bank account is closed is_account_frozen_or_restricted: type: - boolean - 'null' description: Indicates if the receiver bank account is either frozen or restricted WatchlistScreeningIndividualProgramListResponse: description: Paginated list of individual watchlist screening programs additionalProperties: true properties: watchlist_programs: description: List of individual watchlist screening programs type: array items: $ref: '#/components/schemas/IndividualWatchlistProgram' next_cursor: $ref: '#/components/schemas/Cursor' request_id: $ref: '#/components/schemas/RequestID' required: - watchlist_programs - next_cursor - request_id type: object IncomeVerificationCreateRequestOptions: title: IncomeVerificationCreateRequestOptions type: object description: Optional arguments for `/income/verification/create` properties: access_tokens: type: array description: An array of access tokens corresponding to the Items that will be cross-referenced with the product data. Plaid will attempt to correlate transaction history from these Items with data from the user's paystub, such as date and amount. If the `transactions` product was not initialized for the Items during Link, it will be initialized after this Link session. items: $ref: '#/components/schemas/AccessToken' CraBankIncomeCause: type: object description: An error object and associated `item_id` used to identify a specific Item and error when a batch operation operating on multiple Items has encountered an error in one of the Items. properties: error_type: $ref: '#/components/schemas/CreditBankIncomeErrorType' error_code: type: string description: We use standard HTTP response codes for success and failure notifications, and our errors are further classified by `error_type`. In general, 200 HTTP codes correspond to success, 40X codes are for developer- or user-related failures, and 50X codes are for Plaid-related issues. Error fields will be `null` if no error has occurred. error_message: type: string description: A developer-friendly representation of the error code. This may change over time and is not safe for programmatic use. display_message: type: string description: 'A user-friendly representation of the error code. null if the error is not related to user action. This may change over time and is not safe for programmatic use.' required: - error_type - error_code - error_message - display_message Parties: title: Parties type: object additionalProperties: true description: A collection of objects that define specific parties to a deal. This includes the direct participating parties, such as borrower and seller and the indirect parties such as the credit report provider. properties: PARTY: type: array items: $ref: '#/components/schemas/Party' required: - PARTY DateRange: type: object description: A date range with a start and end date example: ending: '1966-06-30' beginning: '1966-06-01' properties: beginning: $ref: '#/components/schemas/ISO8601Date' ending: $ref: '#/components/schemas/ISO8601Date' required: - beginning - ending title: DateRange additionalProperties: true ProcessorBalanceGetResponse: type: object additionalProperties: true description: ProcessorBalanceGetResponse defines the response schema for `/processor/balance/get` properties: account: $ref: '#/components/schemas/AccountBase' request_id: $ref: '#/components/schemas/RequestID' required: - account - request_id LinkTokenCreateInstitutionData: type: object description: A map containing data used to highlight institutions in Link. properties: routing_number: type: string description: 'The routing number of the bank to highlight in Link. Note: in rare cases, a single routing number can be associated with multiple institutions, e.g. due to a brokerage using another institution to manage ACH on its sweep accounts. If this happens, the bank will not be highlighted in Link even if the routing number is provided.' Total: title: Total type: object deprecated: true description: An object representing both the current pay period and year to date amount for a category. additionalProperties: true properties: canonical_description: $ref: '#/components/schemas/TotalCanonicalDescription' description: type: - string - 'null' description: Text of the line item as printed on the paystub. current_pay: $ref: '#/components/schemas/Pay' ytd_pay: $ref: '#/components/schemas/Pay' AuthGetNumbers: type: object additionalProperties: true description: An object containing identifying numbers used for making electronic transfers to and from the `accounts`. The identifying number type (ACH, EFT, IBAN, or BACS) used will depend on the country of the account. An account may have more than one number type. If a particular identifying number type is not used by any `accounts` for which data has been requested, the array for that type will be empty. properties: ach: type: array description: An array of ACH numbers identifying accounts. items: $ref: '#/components/schemas/NumbersACH' eft: type: array description: An array of EFT numbers identifying accounts. items: $ref: '#/components/schemas/NumbersEFT' international: type: array description: An array of IBAN numbers identifying accounts. items: $ref: '#/components/schemas/NumbersInternational' bacs: type: array description: An array of BACS numbers identifying accounts. items: $ref: '#/components/schemas/NumbersBACS' required: - ach - eft - international - bacs BeaconUserIDNumber: type: - object - 'null' title: BeaconUserIDNumber description: The ID number associated with a Beacon User. properties: value: $ref: '#/components/schemas/IDNumberValue' type: $ref: '#/components/schemas/IDNumberType' required: - value - type additionalProperties: true IdentityGetRequestOptions: type: object description: An optional object to filter `/identity/get` results. properties: account_ids: type: array description: 'A list of `account_ids` to retrieve for the Item. Note: An error will be returned if a provided `account_id` is not associated with the Item.' items: type: string WatchlistScreeningIndividualGetResponse: description: 'The screening object allows you to represent a customer in your system, update their profile, and search for them on various watchlists. Note: Rejected customers will not receive new hits, regardless of program configuration.' additionalProperties: true properties: id: $ref: '#/components/schemas/WatchlistScreeningIndividualID' search_terms: $ref: '#/components/schemas/WatchlistScreeningSearchTerms' assignee: $ref: '#/components/schemas/DashboardUserIDNullable' status: $ref: '#/components/schemas/WatchlistScreeningStatus' client_user_id: $ref: '#/components/schemas/ClientUserIDNullable' audit_trail: $ref: '#/components/schemas/WatchlistScreeningAuditTrail' request_id: $ref: '#/components/schemas/RequestID' required: - id - search_terms - assignee - status - client_user_id - audit_trail - request_id type: object ClientUserIDNullable: type: - string - 'null' title: ClientUserID minLength: 1 example: your-db-id-3b24110 description: A unique ID that identifies the end user in your system. This ID can also be used to associate user-specific data from other Plaid products. Financial Account Matching requires this field and the `/link/token/create` `client_user_id` to be consistent. Personally identifiable information, such as an email address or phone number, should not be used in the `client_user_id`. UserDataOverview: type: object description: metadata for the set of insights provided in `TransactionsUserInsightsGetResponse` additionalProperties: true properties: transaction_count: type: integer description: The total number of transactions. oldest_transaction_date: type: string format: date description: The date of the oldest transaction processed to generate insights. newest_transaction_date: type: string format: date description: The date of the newest transaction processed to generate insights. days_available: type: integer description: The range of days of transactions available. total_outflows: type: number format: double description: Sum of outflow amounts. total_inflows: type: number format: double description: Sum of inflow amounts. required: - transaction_count - days_available - total_outflows - total_inflows PaymentInitiationPayment: type: object additionalProperties: true description: PaymentInitiationPayment defines a payment initiation payment properties: payment_id: type: string description: The ID of the payment. Like all Plaid identifiers, the `payment_id` is case sensitive. amount: $ref: '#/components/schemas/PaymentAmount' status: $ref: '#/components/schemas/PaymentInitiationPaymentStatus' recipient_id: type: string description: The ID of the recipient reference: type: string description: A reference for the payment. adjusted_reference: type: - string - 'null' description: The value of the reference sent to the bank after adjustment to pass bank validation rules. last_status_update: format: date-time type: string description: The date and time of the last time the `status` was updated, in IS0 8601 format schedule: $ref: '#/components/schemas/ExternalPaymentScheduleGet' refund_details: $ref: '#/components/schemas/ExternalPaymentRefundDetails' bacs: $ref: '#/components/schemas/SenderBACSNullable' iban: type: - string - 'null' description: The International Bank Account Number (IBAN) for the sender, if specified in the `/payment_initiation/payment/create` call. refund_ids: type: - array - 'null' description: Refund IDs associated with the payment. items: type: string amount_refunded: $ref: '#/components/schemas/PaymentAmountRefunded' wallet_id: type: - string - 'null' description: The EMI (E-Money Institution) wallet that this payment is associated with, if any. This wallet is used as an intermediary account to enable Plaid to reconcile the settlement of funds for Payment Initiation requests. scheme: $ref: '#/components/schemas/PaymentScheme' adjusted_scheme: $ref: '#/components/schemas/PaymentScheme' consent_id: type: - string - 'null' description: The payment consent ID that this payment was initiated with. Is present only when payment was initiated using the payment consent. transaction_id: type: - string - 'null' description: The transaction ID that this payment is associated with, if any. This is present only when a payment was initiated using virtual accounts. required: - payment_id - amount - status - recipient_id - reference - last_status_update - bacs - iban DepositSwitchTargetAccount: title: DepositSwitchTargetAccount description: The deposit switch destination account type: object additionalProperties: true properties: account_number: type: string description: Account number for deposit switch destination routing_number: type: string description: Routing number for deposit switch destination account_name: type: string description: The name of the deposit switch destination account, as it will be displayed to the end user in the Deposit Switch interface. It is not required to match the name used in online banking. account_subtype: type: string description: The account subtype of the account, either `checking` or `savings`. enum: - checking - savings required: - account_number - routing_number - account_name - account_subtype TransferIntentCreateResponse: title: TransferIntentCreateResponse type: object additionalProperties: true description: Defines the response schema for `/transfer/intent/create` properties: transfer_intent: $ref: '#/components/schemas/TransferIntentCreate' request_id: $ref: '#/components/schemas/RequestID' required: - transfer_intent - request_id Item: description: Metadata about the Item. type: object additionalProperties: true properties: item_id: description: 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. type: string institution_id: description: The Plaid Institution ID associated with the Item. Field is `null` for Items created via Same Day Micro-deposits. type: - string - 'null' webhook: description: The URL registered to receive webhooks for the Item. type: - string - 'null' error: $ref: '#/components/schemas/PlaidError' available_products: description: 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`. type: array items: $ref: '#/components/schemas/Products' billed_products: description: '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. ' type: array items: $ref: '#/components/schemas/Products' products: description: '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`. ' type: array items: $ref: '#/components/schemas/Products' consented_products: description: 'A list of products that have gone through consent collection for the Item. Only present for those enabled in the [Data Transparency](https://plaid.com/docs/link/data-transparency-messaging-migration-guide) beta. If you are not enrolled in Data Transparency, this field is not used. ' type: array items: $ref: '#/components/schemas/Products' consent_expiration_time: description: 'The RFC 3339 timestamp after which the consent provided by the end user will expire. Upon consent expiration, the item will enter the `ITEM_LOGIN_REQUIRED` error state. To circumvent the `ITEM_LOGIN_REQUIRED` error and maintain continuous consent, the end user can reauthenticate via Link’s update mode in advance of the consent expiration time. Note - This is only relevant for certain OAuth-based institutions. For all other institutions, this field will be null. ' type: - string - 'null' format: date-time update_type: type: string description: 'Indicates whether an Item requires user interaction to be updated, which can be the case for Items with some forms of two-factor authentication. `background` - Item can be updated in the background `user_present_required` - Item requires user interaction to be updated' enum: - background - user_present_required required: - item_id - webhook - error - available_products - billed_products - consent_expiration_time - update_type DashboardUserIDNullable: type: - string - 'null' title: DashboardUserID example: 54350110fedcbaf01234ffee description: ID of the associated user. SandboxPublicTokenCreateRequestOptionsIncomeVerification: type: object description: A set of parameters for income verification options. This field is required if `income_verification` is included in the `initial_products` array. properties: income_source_types: type: array description: The types of source income data that users will be permitted to share. Options include `bank` and `payroll`. Currently you can only specify one of these options. items: $ref: '#/components/schemas/IncomeVerificationSourceType' bank_income: $ref: '#/components/schemas/SandboxPublicTokenCreateRequestIncomeVerificationBankIncome' TransferAuthorizationCreateRequest: title: TransferAuthorizationCreateRequest type: object description: Defines the request schema for `/transfer/authorization/create` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' access_token: $ref: '#/components/schemas/TransferAccessToken' account_id: $ref: '#/components/schemas/TransferAccountID' funding_account_id: $ref: '#/components/schemas/TransferMigratedFundingAccountIDRequest' payment_profile_token: $ref: '#/components/schemas/TransferPaymentProfileToken' type: $ref: '#/components/schemas/TransferType' network: $ref: '#/components/schemas/TransferNetwork' amount: $ref: '#/components/schemas/TransferAmount' ach_class: $ref: '#/components/schemas/ACHClass' wire_details: $ref: '#/components/schemas/TransferWireDetails' user: $ref: '#/components/schemas/TransferAuthorizationUserInRequest' device: $ref: '#/components/schemas/TransferAuthorizationDevice' origination_account_id: type: string description: Plaid's unique identifier for the origination account for this authorization. If not specified, the default account will be used. deprecated: true x-hidden-from-docs: true iso_currency_code: type: string description: The currency of the transfer amount. The default value is "USD". idempotency_key: $ref: '#/components/schemas/TransferAuthorizationIdempotencyKey' user_present: type: - boolean - 'null' description: If the end user is initiating the specific transfer themselves via an interactive UI, this should be `true`; for automatic recurring payments where the end user is not actually initiating each individual transfer, it should be `false`. This field is not currently used and is present to support planned future functionality. with_guarantee: type: - boolean - 'null' default: true x-hidden-from-docs: true description: If set to `false`, Plaid will not offer a `guarantee_decision` for this request (Guarantee customers only). beacon_session_id: x-hidden-from-docs: true type: - string - 'null' description: The unique identifier returned by Plaid's [beacon](https://plaid.com/docs/transfer/guarantee/#using-a-beacon) when it is run on your webpage. originator_client_id: type: - string - 'null' description: The Plaid client ID that is the originator of this transfer. Only needed if creating transfers on behalf of another client as a [Platform customer](https://plaid.com/docs/transfer/application/#originators-vs-platforms). credit_funds_source: x-hidden-from-docs: true deprecated: true allOf: - $ref: '#/components/schemas/TransferCreditFundsSource' test_clock_id: type: - string - 'null' description: Plaid’s unique identifier for a test clock. This field may only be used when using `sandbox` environment. If provided, the `authorization` is created at the `virtual_time` on the provided test clock. required: - type - network - amount - user - access_token - account_id BankTransferAccessToken: description: The Plaid `access_token` for the account that will be debited or credited. type: string SandboxProcessorTokenCreateRequest: description: SandboxProcessorTokenCreateRequest defines the request schema for `/sandbox/processor_token/create` type: object properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' institution_id: type: string description: The ID of the institution the Item will be associated with options: $ref: '#/components/schemas/SandboxProcessorTokenCreateRequestOptions' required: - institution_id RecurringTransferNullable: title: RecurringTransferNullable type: object additionalProperties: true description: Represents a recurring transfer within the Transfers API. allOf: - $ref: '#/components/schemas/RecurringTransfer' - type: - object - 'null' UserIDNumber: description: ID number submitted by the user, currently used only for the Identity Verification product. If the user has not submitted this data yet, this field will be `null`. Otherwise, both fields are guaranteed to be filled. type: - object - 'null' properties: value: $ref: '#/components/schemas/IDNumberValue' type: $ref: '#/components/schemas/IDNumberType' required: - value - type additionalProperties: true WatchlistScreeningIndividualGetRequest: description: Request input for fetching an individual watchlist screening type: object properties: watchlist_screening_id: $ref: '#/components/schemas/WatchlistScreeningIndividualID' secret: $ref: '#/components/schemas/APISecret' client_id: $ref: '#/components/schemas/APIClientID' required: - watchlist_screening_id BaseReportAccount: title: BaseReportAccount description: Base Report information about an account x-hidden-from-docs: true type: object additionalProperties: true properties: balances: $ref: '#/components/schemas/BaseReportAccountBalances' mask: type: - string - 'null' description: The last 2-4 alphanumeric characters of an account's official account number. Note that the mask may be non-unique between an Item's accounts, and it may also not match the mask that the bank displays to the user. name: type: string description: The name of the account, either assigned by the user or by the financial institution itself official_name: type: - string - 'null' description: The official name of the account as given by the financial institution type: $ref: '#/components/schemas/AccountType' subtype: $ref: '#/components/schemas/AccountSubtype' days_available: type: number description: The duration of transaction history available for this Item, typically defined as the time since the date of the earliest transaction in that account. Only returned by Base Report endpoints. transactions: type: array description: Transaction history associated with the account. Only returned by Base Report endpoints. Transaction history returned by endpoints such as `/transactions/get` or `/investments/transactions/get` will be returned in the top-level `transactions` field instead. items: $ref: '#/components/schemas/BaseReportTransaction' owners: type: array description: Data returned by the financial institution about the account owner or owners. For business accounts, the name reported may be either the name of the individual or the name of the business, depending on the institution. Multiple owners on a single account will be represented in the same `owner` object, not in multiple owner objects within the array. items: $ref: '#/components/schemas/Owner' ownership_type: $ref: '#/components/schemas/OwnershipType' historical_balances: type: array description: Calculated data about the historical balances on the account. Only returned by Base Report endpoints and currently not supported by `brokerage` or `investment` accounts. items: $ref: '#/components/schemas/HistoricalBalance' account_insights: $ref: '#/components/schemas/BaseReportAccountInsights' required: - balances - mask - name - official_name - type - subtype - days_available - transactions - owners - ownership_type InstitutionsSearchRequestOptions: type: object description: An optional object to filter `/institutions/search` results. properties: oauth: type: - boolean - 'null' description: Limit results to institutions with or without OAuth login flows. Note that institutions will have `oauth` set to `true` if some Items associated with that institution are required to use OAuth flows; institutions in a state of migration to OAuth will have the `oauth` attribute set to `true`. include_optional_metadata: type: boolean description: When true, return the institution's homepage URL, logo and primary brand color. include_auth_metadata: type: - boolean - 'null' default: false description: When `true`, returns metadata related to the Auth product indicating which auth methods are supported. include_payment_initiation_metadata: type: - boolean - 'null' default: false description: When `true`, returns metadata related to the Payment Initiation product indicating which payment configurations are supported. payment_initiation: $ref: '#/components/schemas/InstitutionsSearchPaymentInitiationOptions' DepositSwitchTokenCreateRequest: type: object description: DepositSwitchTokenCreateRequest defines the request schema for `/deposit_switch/token/create` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' deposit_switch_id: type: string description: The ID of the deposit switch required: - deposit_switch_id SelfieCaptureImageURL: type: - string - 'null' example: https://example.plaid.com/verifications/idv_52xR9LKo77r1Np/selfie/liveness.jpeg description: Temporary URL for downloading an image selfie capture. DeductionsTotal: title: DeductionsTotal type: object description: An object representing the total deductions for the pay period additionalProperties: true properties: current_amount: type: - number - 'null' format: double description: Raw amount of the deduction iso_currency_code: type: - string - 'null' description: The ISO-4217 currency code of the line item. Always `null` if `unofficial_currency_code` is non-null. unofficial_currency_code: type: - string - 'null' description: 'The unofficial currency code associated with the line item. Always `null` if `iso_currency_code` is non-`null`. Unofficial currency codes are used for currencies that do not have official ISO currency codes, such as cryptocurrencies and the currencies of certain countries. See the [currency code schema](https://plaid.com/docs/api/accounts#currency-code-schema) for a full listing of supported `iso_currency_code`s.' ytd_amount: type: - number - 'null' format: double description: The year-to-date total amount of the deductions CreditBankIncomeGetRequestOptions: description: An optional object for `/credit/bank_income/get` request options. type: object properties: count: type: integer default: 1 description: How many Bank Income Reports should be fetched. Multiple reports may be available if the report has been re-created or refreshed. If more than one report is available, the most recent reports will be returned first. Enrichments: title: Enrichments type: object description: A grouping of the Plaid produced transaction enrichment fields. additionalProperties: true properties: check_number: x-hidden-from-docs: true type: - string - 'null' description: The check number of the transaction. This field is only populated for check transactions. counterparties: type: array description: The counterparties present in the transaction. Counterparties, such as the merchant or the financial institution, are extracted by Plaid from the raw description. items: $ref: '#/components/schemas/Counterparty' entity_id: type: - string - 'null' description: A unique, stable, Plaid-generated ID that maps to the primary counterparty. legacy_category_id: deprecated: true description: 'The ID of the legacy category to which this transaction belongs. For a full list of legacy categories, see [`/categories/get`](https://plaid.com/docs/api/products/transactions/#categoriesget). We recommend using the `personal_finance_category` for transaction categorization to obtain the best results.' type: - string - 'null' legacy_category: deprecated: true type: array description: 'A hierarchical array of the legacy categories to which this transaction belongs. For a full list of legacy categories, see [`/categories/get`](https://plaid.com/docs/api/products/transactions/#categoriesget). We recommend using the `personal_finance_category` for transaction categorization to obtain the best results.' items: type: string location: $ref: '#/components/schemas/Location' logo_url: type: - string - 'null' description: The URL of a logo associated with this transaction, if available. The logo will always be 100×100 pixel PNG file. merchant_name: type: - string - 'null' description: The name of the primary counterparty, such as the merchant or the financial institution, as extracted by Plaid from the raw description. payment_channel: $ref: '#/components/schemas/PaymentChannel' phone_number: type: - string - 'null' description: The phone number associated with the counterparty in E. 164 format. If there is a location match (i.e. a street address is returned in the location object), the phone number will be location specific. personal_finance_category: $ref: '#/components/schemas/PersonalFinanceCategory' personal_finance_category_icon_url: type: string description: The URL of an icon associated with the primary personal finance category. The icon will always be 100×100 pixel PNG file. recurrence: $ref: '#/components/schemas/Recurrence' website: type: - string - 'null' description: The website associated with this transaction. required: - payment_channel - location - personal_finance_category - personal_finance_category_icon_url - logo_url - website - counterparties - merchant_name - phone_number WatchlistScreeningReviewID: type: string title: WatchlistScreeningReviewID example: rev_aCLNRxK3UVzn2r description: ID of the associated review. RiskCheckLinkedService: type: string description: An enum indicating the type of a linked service. Note that `adult_sites` refers' to explicit video content, and includes a number of related services. enum: - aboutme - adobe - adult_sites - airbnb - altbalaji - amazon - apple - archiveorg - atlassian - bitmoji - bodybuilding - booking - bukalapak - codecademy - deliveroo - diigo - discord - disneyplus - duolingo - ebay - envato - eventbrite - evernote - facebook - firefox - flickr - flipkart - foursquare - freelancer - gaana - giphy - github - google - gravatar - hubspot - imgur - instagram - jdid - kakao - kommo - komoot - lastfm - lazada - line - linkedin - mailru - microsoft - myspace - netflix - nike - ok - patreon - pinterest - plurk - quora - qzone - rambler - rappi - replit - samsung - seoclerks - shopclues - skype - snapchat - snapdeal - soundcloud - spotify - starz - strava - taringa - telegram - tiki - tokopedia - treehouse - tumblr - twitter - venmo - viber - vimeo - vivino - vkontakte - wattpad - weibo - whatsapp - wordpress - xing - yahoo - yandex - zalo - zoho example: apple TransferAuthorizationIdempotencyKey: title: TransferAuthorizationIdempotencyKey type: - string - 'null' maxLength: 50 description: 'A random key provided by the client, per unique authorization, which expires after 48 hours. Maximum of 50 characters. The API supports idempotency for safely retrying requests without accidentally performing the same operation twice. For example, if a request to create an authorization fails due to a network connection error, you can retry the request with the same idempotency key to guarantee that only a single authorization is created. This idempotency key expires after 48 hours, after which the same key can be reused. Failure to provide this key may result in duplicate charges.' WalletTransactionStatus: type: string enum: - AUTHORISING - INITIATED - EXECUTED - SETTLED - BLOCKED - FAILED description: 'The status of the transaction. `AUTHORISING`: The transaction is being processed for validation and compliance. `INITIATED`: The transaction has been initiated and is currently being processed. `EXECUTED`: The transaction has been successfully executed and is considered complete. This is only applicable for debit transactions. `SETTLED`: The transaction has settled and funds are available for use. This is only applicable for credit transactions. A transaction will typically settle within seconds to several days, depending on which payment rail is used. `FAILED`: The transaction failed to process successfully. This is a terminal status. `BLOCKED`: The transaction has been blocked for violating compliance rules. This is a terminal status.' LinkTokenCreateRequestIncomeVerificationBankIncome: title: LinkTokenCreateRequestIncomeVerificationBankIncome type: object description: Specifies options for initializing Link for use with Bank Income. This field is required if `income_verification` is included in the `products` array and `bank` is specified in `income_source_types`. properties: days_requested: type: integer description: The number of days of data to request for the Bank Income product minimum: 1 maximum: 731 enable_multiple_items: type: - boolean - 'null' default: false description: Whether to enable multiple Items to be added in the Link session required: - days_requested TransferWireDetails: title: TransferWireDetails type: - object - 'null' description: Information specific to wire transfers. properties: message_to_beneficiary: type: - string - 'null' description: Additional information from the wire originator to the beneficiary. Max 140 characters. DocumentDateOfBirthMatchCode: description: A match summary describing the cross comparison between the subject's date of birth, extracted from the document image, and the date of birth they separately provided to the identity verification attempt. type: string enum: - match - partial_match - no_match - no_data example: match BankTransferEventListRequest: title: BankTransferEventListRequest type: object description: Defines the request schema for `/bank_transfer/event/list` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' start_date: type: - string - 'null' format: date-time description: The start datetime of bank transfers to list. This should be in RFC 3339 format (i.e. `2019-12-06T22:35:49Z`) end_date: type: - string - 'null' format: date-time description: The end datetime of bank transfers to list. This should be in RFC 3339 format (i.e. `2019-12-06T22:35:49Z`) bank_transfer_id: type: - string - 'null' title: BankTransferID description: Plaid’s unique identifier for a bank transfer. account_id: type: - string - 'null' description: The account ID to get events for all transactions to/from an account. bank_transfer_type: $ref: '#/components/schemas/BankTransferEventListBankTransferType' event_types: type: array description: Filter events by event type. items: $ref: '#/components/schemas/BankTransferEventType' count: type: - integer - 'null' description: The maximum number of bank transfer events to return. If the number of events matching the above parameters is greater than `count`, the most recent events will be returned. default: 25 maximum: 25 minimum: 1 offset: type: - integer - 'null' default: 0 minimum: 0 description: The offset into the list of bank transfer events. When `count`=25 and `offset`=0, the first 25 events will be returned. When `count`=25 and `offset`=25, the next 25 bank transfer events will be returned. origination_account_id: type: - string - 'null' description: The origination account ID to get events for transfers from a specific origination account. direction: $ref: '#/components/schemas/BankTransferEventListDirection' CraLoanApplication: type: object description: Contains loan application data. additionalProperties: true properties: user_token: $ref: '#/components/schemas/CraLoanUserToken' application_id: $ref: '#/components/schemas/CraLoanApplicationID' type: $ref: '#/components/schemas/CraLoanType' decision: $ref: '#/components/schemas/CraLoanApplicationDecision' application_date: type: string format: date description: The date the user applied for the loan. The date should be in ISO 8601 format (YYYY-MM-DD). decision_date: type: string format: date description: The date when the loan application's decision was made. The date should be in ISO 8601 format (YYYY-MM-DD). required: - user_token - application_id - type - decision TransferCapabilitiesGetRequest: title: TransferCapabilitiesGetRequest type: object description: Defines the request schema for `/transfer/capabilities/get` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' access_token: $ref: '#/components/schemas/TransferAccessToken' account_id: $ref: '#/components/schemas/TransferAccountID' payment_profile_token: $ref: '#/components/schemas/PaymentProfileToken' required: - access_token - account_id RecurringInsightsStream: type: object description: Insights object for recurring transactions streams. additionalProperties: true properties: stream_id: type: string description: A unique id for the stream. description: type: string description: The client-provided raw description of the most recent transaction in the stream. merchant_name: type: string description: The merchant or primary counterparty associated with the transaction stream. oldest_transaction_date: type: string format: date description: The posted date of the earliest transaction in the stream. newest_transaction_date: type: string format: date description: The posted date of the latest transaction in the stream. average_days_apart: type: number format: double description: The average number of days between each of the recurring transactions. frequency: $ref: '#/components/schemas/RecurringTransactionFrequency' transaction_count: type: integer description: The number of transactions in this stream. transaction_ids: type: array description: An array of Plaid transaction IDs belonging to the stream, sorted by posted date. items: type: string average_amount: $ref: '#/components/schemas/TransactionStreamAmount' newest_transaction_amount: $ref: '#/components/schemas/TransactionStreamAmount' is_active: type: boolean description: Indicates whether the transaction stream is still live. status: $ref: '#/components/schemas/TransactionStreamStatus' personal_finance_category_primary: type: string description: The primary category associated with the transaction stream. personal_finance_category_detailed: type: string description: The detailed category associated with the transaction stream. required: - stream_id - merchant_name - average_days_apart - is_active DocumentaryVerificationDocument: type: object description: Images, extracted data, and analysis from a user's identity document additionalProperties: true properties: status: $ref: '#/components/schemas/DocumentStatus' attempt: example: 1 type: integer description: The `attempt` field begins with 1 and increments with each subsequent document upload. images: $ref: '#/components/schemas/PhysicalDocumentImages' extracted_data: $ref: '#/components/schemas/PhysicalDocumentExtractedData' analysis: $ref: '#/components/schemas/DocumentAnalysis' redacted_at: $ref: '#/components/schemas/TimestampNullable' required: - analysis - attempt - extracted_data - images - status - redacted_at Timestamp: description: An ISO8601 formatted timestamp. type: string format: date-time title: Timestamp example: '2020-07-24T03:26:02Z' ActionState: type: string description: Enum representing the state of the action/activity. enum: - UNKNOWN - ATTEMPT - SUCCESS - FAILURE - SKIPPED CreditRelayRemoveRequest: type: object description: CreditRelayRemoveRequest defines the request schema for `/credit/relay/remove` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' relay_token: type: string description: The `relay_token` you would like to revoke. required: - relay_token DocumentImage__Front: type: - string - 'null' example: https://example.plaid.com/verifications/idv_52xR9LKo77r1Np/documents/1/original_front.jpeg description: Temporary URL that expires after 60 seconds for downloading the uncropped original image of the front of the document. EntityWatchlistProgramID: type: string example: entprg_2eRPsDnL66rZ7H title: EntityWatchlistProgramID description: ID of the associated entity program. EntityScreeningHitEmails: type: object description: Email address information for the associated entity watchlist hit properties: email_address: $ref: '#/components/schemas/EmailAddress' required: - email_address additionalProperties: true TransferEventSyncResponse: title: TransferEventSyncResponse type: object additionalProperties: true description: Defines the response schema for `/transfer/event/sync` properties: transfer_events: type: array items: $ref: '#/components/schemas/TransferEvent' has_more: type: boolean description: Whether there are more events to be pulled from the endpoint that have not already been returned request_id: $ref: '#/components/schemas/RequestID' required: - transfer_events - has_more - request_id CraLoanRegisterApplication: type: object description: Contains loan application data to register. additionalProperties: true properties: application_id: $ref: '#/components/schemas/CraLoanApplicationID' application_date: type: string format: date description: The date the user applied for the loan. The date should be in ISO 8601 format (YYYY-MM-DD). CreditPayrollIncomeParsingConfigUpdateRequest: title: CreditPayrollIncomeParsingConfigUpdateRequest type: object additionalProperties: true description: CreditPayrollIncomeParsingConfigUpdateRequest defines the request schema for `/credit/payroll_income/documents/update`. properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' user_token: $ref: '#/components/schemas/UserToken' item_id: $ref: '#/components/schemas/ItemId' parsing_config: type: array description: The types of analysis to enable for the document income verification session items: $ref: '#/components/schemas/IncomeVerificationDocParsingConfig' required: - user_token - parsing_config TransferOriginatorClientID: type: - string - 'null' description: Client ID of the customer that owns the Ledger balance. This is so Plaid knows which of your customers to payout or collect funds. Only applicable for [Platform customers](https://plaid.com/docs/transfer/application/#originators-vs-platforms). Do not include if you’re paying out to yourself. AccountVerificationInsightsNetworkStatus: title: VerificationInsightsNetworkStatus type: object additionalProperties: true description: Status information about the account and routing number in the Plaid network. properties: has_numbers_match: type: boolean description: Indicates whether we found at least one matching account for the ACH account and routing number. is_numbers_match_verified: type: boolean description: Indicates if at least one matching account for the ACH account and routing number is already verified. required: - has_numbers_match - is_numbers_match_verified BaseReportWarning: title: BaseReportWarning type: object additionalProperties: true description: It is possible for an Base Report to be returned with missing account owner information. In such cases, the Base Report will contain warning data in the response, indicating why obtaining the owner information failed. properties: warning_type: type: string description: The warning type, which will always be `BASE_REPORT_WARNING` warning_code: $ref: '#/components/schemas/BaseReportWarningCode' cause: $ref: '#/components/schemas/Cause' required: - warning_type - warning_code - cause EarningsBreakdownCanonicalDescription: type: - string - 'null' description: Commonly used term to describe the earning line item. enum: - BONUS - COMMISSION - OVERTIME - PAID TIME OFF - REGULAR PAY - VACATION - BASIC ALLOWANCE HOUSING - BASIC ALLOWANCE SUBSISTENCE - OTHER - null NetPay: title: NetPay type: object description: An object representing information about the net pay amount on the paystub. additionalProperties: true properties: current_amount: type: - number - 'null' format: double description: Raw amount of the net pay for the pay period description: type: - string - 'null' description: Description of the net pay iso_currency_code: type: - string - 'null' description: The ISO-4217 currency code of the net pay. Always `null` if `unofficial_currency_code` is non-null. unofficial_currency_code: type: - string - 'null' description: 'The unofficial currency code associated with the net pay. Always `null` if `iso_currency_code` is non-`null`. Unofficial currency codes are used for currencies that do not have official ISO currency codes, such as cryptocurrencies and the currencies of certain countries. See the [currency code schema](https://plaid.com/docs/api/accounts#currency-code-schema) for a full listing of supported `iso_currency_code`s.' ytd_amount: type: - number - 'null' format: double description: The year-to-date amount of the net pay total: $ref: '#/components/schemas/Total' IncomeVerificationPrecheckUser: title: IncomeVerificationPrecheckUser type: - object - 'null' description: Information about the user whose eligibility is being evaluated. properties: first_name: type: - string - 'null' description: The user's first name last_name: type: - string - 'null' description: The user's last name email_address: type: - string - 'null' description: The user's email address home_address: $ref: '#/components/schemas/SignalAddressData' NumbersInternationalNullable: description: Identifying information for transferring money to or from an international bank account via wire transfer. allOf: - $ref: '#/components/schemas/NumbersInternational' - type: object additionalProperties: true PhysicalDocumentCategory: type: string description: "The type of identity document detected in the images provided. Will always be one of the following values:\n\n `drivers_license` - A driver's license issued by the associated country, establishing identity without any guarantee as to citizenship, and granting driving privileges\n\n `id_card` - A general national identification card, distinct from driver's licenses as it only establishes identity\n\n `passport` - A travel passport issued by the associated country for one of its citizens\n\n `residence_permit_card` - An identity document issued by the associated country permitting a foreign citizen to temporarily reside there\n\n `resident_card` - An identity document issued by the associated country permitting a foreign citizen to permanently reside there\n\n `visa` - An identity document issued by the associated country permitting a foreign citizen entry for a short duration and for a specific purpose, typically no longer than 6 months\n\nNote: This value may be different from the ID type that the user selects within Link. For example, if they select \"Driver's License\" but then submit a picture of a passport, this field will say `passport`" enum: - drivers_license - id_card - passport - residence_permit_card - resident_card - visa example: drivers_license CreditFreddieMacLoanIdentifiers: title: CreditFreddieMacLoanIdentifiers type: object additionalProperties: true description: Collection of current and previous identifiers for this loan. properties: LOAN_IDENTIFIER: type: array items: $ref: '#/components/schemas/LoanIdentifier' required: - LOAN_IDENTIFIER WalletISOCurrencyCode: type: string title: ISO Currency Code enum: - GBP - EUR description: An ISO-4217 currency code, used with e-wallets and transactions. minLength: 3 maxLength: 3 TransferRecurringGetResponse: title: TransferRecurringGetResponse type: object additionalProperties: true description: Defines the response schema for `/transfer/recurring/get` properties: recurring_transfer: $ref: '#/components/schemas/RecurringTransfer' request_id: $ref: '#/components/schemas/RequestID' required: - recurring_transfer - request_id TransferTestClock: title: TransferTestClock type: object additionalProperties: true description: Defines the test clock for a transfer. properties: test_clock_id: $ref: '#/components/schemas/TransferTestClockID' virtual_time: $ref: '#/components/schemas/VirtualTime' required: - test_clock_id - virtual_time SandboxTransferLedgerDepositSimulateResponse: title: SandboxTransferLedgerDepositSimulateResponse type: object additionalProperties: true description: Defines the response schema for `/sandbox/transfer/ledger/deposit/simulate` properties: request_id: $ref: '#/components/schemas/RequestID' required: - request_id WalletTransactionListRequest: type: object description: WalletTransactionListRequest defines the request schema for `/wallet/transaction/list` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' wallet_id: type: string description: The ID of the e-wallet to fetch transactions from minLength: 1 cursor: type: string maxLength: 256 description: A base64 value representing the latest transaction that has already been requested. Set this to `next_cursor` received from the previous `/wallet/transaction/list` request. If provided, the response will only contain transactions created before that transaction. If omitted, the response will contain transactions starting from the most recent, and in descending order by the `created_at` time. count: type: integer description: The number of transactions to fetch minimum: 1 maximum: 200 default: 10 options: $ref: '#/components/schemas/WalletTransactionListRequestOptions' required: - wallet_id SandboxTransferLedgerWithdrawSimulateResponse: title: SandboxTransferLedgerWithdrawSimulateResponse type: object additionalProperties: true description: Defines the response schema for `/sandbox/transfer/ledger/withdraw/simulate` properties: request_id: $ref: '#/components/schemas/RequestID' required: - request_id CreditEmploymentGetRequest: title: CreditEmploymentGetRequest type: object description: CreditEmploymentGetRequest defines the request schema for `/credit/employment/get`. properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' user_token: $ref: '#/components/schemas/UserToken' required: - user_token EntityWatchlistScreeningProgramName: type: string title: EntityWatchlistScreeningProgramName example: Sample Program minLength: 1 description: A name for the entity program to define its purpose. For example, "High Risk Organizations" or "Applicants". EmploymentVerificationGetResponse: title: EmploymentVerificationGetResponse type: object additionalProperties: true description: EmploymentVerificationGetResponse defines the response schema for `/employment/verification/get`. properties: employments: type: array description: A list of employment verification summaries. items: $ref: '#/components/schemas/EmploymentVerification' request_id: $ref: '#/components/schemas/RequestID' required: - employments - request_id WatchlistScreeningIndividualReviewCreateResponse: description: 'A review submitted by a team member for an individual watchlist screening. A review can be either a comment on the current screening state, actions taken against hits attached to the watchlist screening, or both.' additionalProperties: true properties: id: $ref: '#/components/schemas/WatchlistScreeningReviewID' confirmed_hits: type: array description: Hits marked as a true positive after thorough manual review. These hits will never recur or be updated once dismissed. In most cases, confirmed hits indicate that the customer should be rejected. items: $ref: '#/components/schemas/WatchlistScreeningHitID' dismissed_hits: type: array description: Hits marked as a false positive after thorough manual review. These hits will never recur or be updated once dismissed. items: $ref: '#/components/schemas/WatchlistScreeningHitID' comment: $ref: '#/components/schemas/ReviewComment' audit_trail: $ref: '#/components/schemas/WatchlistScreeningAuditTrail' request_id: $ref: '#/components/schemas/RequestID' required: - id - confirmed_hits - dismissed_hits - comment - audit_trail - request_id type: object CraBankIncomeTransaction: type: object description: The transactions data for the end user's income source(s). additionalProperties: true properties: amount: type: number description: 'The settled value of the transaction, denominated in the transactions''s currency as stated in `iso_currency_code` or `unofficial_currency_code`. Positive values when money moves out of the account; negative values when money moves in. For example, credit card purchases are positive; credit card payment, direct deposits, and refunds are negative.' date: type: string format: date description: '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).' name: type: string description: The merchant name or transaction description. original_description: type: - string - 'null' description: The string returned by the financial institution to describe the transaction. pending: type: boolean description: 'When true, identifies the transaction as pending or unsettled. Pending transaction details (name, type, amount, category ID) may change before they are settled.' check_number: type: - string - 'null' description: The check number of the transaction. This field is only populated for check transactions. iso_currency_code: $ref: '#/components/schemas/CreditIsoCurrencyCode' unofficial_currency_code: $ref: '#/components/schemas/CreditUnofficialCurrencyCode' bonus_type: $ref: '#/components/schemas/CraBankIncomeBonusType' LinkTokenCreateRequestPaymentInitiation: type: object description: Specifies options for initializing Link for use with the Payment Initiation (Europe) product. This field is required if `payment_initiation` is included in the `products` array. Either `payment_id` or `consent_id` must be provided. properties: payment_id: type: string description: The `payment_id` provided by the `/payment_initiation/payment/create` endpoint. consent_id: type: string description: The `consent_id` provided by the `/payment_initiation/consent/create` endpoint. WatchlistScreeningIndividual: type: object properties: id: $ref: '#/components/schemas/WatchlistScreeningIndividualID' search_terms: $ref: '#/components/schemas/WatchlistScreeningSearchTerms' assignee: $ref: '#/components/schemas/DashboardUserIDNullable' status: $ref: '#/components/schemas/WatchlistScreeningStatus' client_user_id: $ref: '#/components/schemas/ClientUserIDNullable' audit_trail: $ref: '#/components/schemas/WatchlistScreeningAuditTrail' required: - id - search_terms - assignee - status - client_user_id - audit_trail title: WatchlistScreeningIndividual description: 'The screening object allows you to represent a customer in your system, update their profile, and search for them on various watchlists. Note: Rejected customers will not receive new hits, regardless of program configuration.' additionalProperties: true IdentityRefreshRequest: type: object description: IdentityRefreshRequest defines the request schema for `/identity/refresh` properties: client_id: $ref: '#/components/schemas/APIClientID' access_token: $ref: '#/components/schemas/AccessToken' secret: $ref: '#/components/schemas/APISecret' required: - access_token TransferLedgerWithdrawRequest: title: TransferLedgerWithdrawRequest type: object description: Defines the request schema for `/transfer/ledger/withdraw` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' originator_client_id: $ref: '#/components/schemas/TransferOriginatorClientID' funding_account_id: $ref: '#/components/schemas/TransferLedgerFundingAccountIDRequest' amount: type: string description: A positive amount of how much will be withdrawn from the ledger balance (decimal string with two digits of precision e.g. "5.50"). description: $ref: '#/components/schemas/SweepDescription' idempotency_key: $ref: '#/components/schemas/LedgerWithdrawIdempotencyKey' network: $ref: '#/components/schemas/TransferNetwork' required: - amount - idempotency_key - network PartnerEndCustomerFlowdownStatus: type: string enum: - NOT_STARTED - IN_REVIEW - NEGOTIATION - COMPLETE description: The status of the addendum to the Plaid MSA ("flowdown") for the end customer. InvestmentsRefreshRequest: x-hidden-from-docs: true type: object description: InvestmentsRefreshRequest defines the request schema for `/investments/refresh` properties: client_id: $ref: '#/components/schemas/APIClientID' access_token: $ref: '#/components/schemas/AccessToken' secret: $ref: '#/components/schemas/APISecret' required: - access_token LinkProfileEligibilityCheckRequest: type: object x-hidden-from-docs: true description: LinkProfileEligibilityCheckRequest defines the request schema for `/link/profile/eligibility/check` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' link_session_id: type: string description: The unique ID for the user's Link session user: $ref: '#/components/schemas/LinkProfileEligibilityCheckUser' required: - link_session_id - user ProcessorAccountGetResponse: type: object additionalProperties: true description: ProcessorAccountGetResponse defines the response schema for `/processor/account/get` properties: account: $ref: '#/components/schemas/AccountBase' institution_id: description: The Plaid Institution ID associated with the Account. type: string request_id: $ref: '#/components/schemas/RequestID' required: - account - institution_id - request_id CraBankIncomeSource: type: object description: Detailed information for the income source. properties: income_source_id: type: string description: A unique identifier for an income source. income_description: type: string description: The most common name or original description for the underlying income transactions. income_category: $ref: '#/components/schemas/CreditBankIncomeCategory' start_date: type: string format: date description: 'Minimum of all dates within the specific income sources in the user''s bank account for days requested by the client. The date will be returned in an ISO 8601 format (YYYY-MM-DD).' end_date: type: string format: date description: 'Maximum of all dates within the specific income sources in the user’s bank account for days requested by the client. The date will be returned in an ISO 8601 format (YYYY-MM-DD).' pay_frequency: $ref: '#/components/schemas/CreditBankIncomePayFrequency' total_amount: type: number description: Total amount of earnings in the user’s bank account for the specific income source for days requested by the client. iso_currency_code: $ref: '#/components/schemas/CreditIsoCurrencyCode' unofficial_currency_code: $ref: '#/components/schemas/CreditUnofficialCurrencyCode' transaction_count: type: integer description: Number of transactions for the income source within the start and end date. next_payment_date: type: - string - 'null' format: date description: 'The expected date of the end user’s next paycheck for the income source. The date will be returned in an ISO 8601 format (YYYY-MM-DD).' historical_average_monthly_gross_income: type: - number - 'null' description: An estimate of the average gross monthly income based on the historical net amount and income category for the income source(s). historical_average_monthly_income: type: - number - 'null' description: The average monthly net income amount estimated based on the historical data for the income source(s). forecasted_average_monthly_income: type: - number - 'null' description: The predicted average monthly net income amount for the income source(s). forecasted_average_monthly_income_prediction_intervals: type: array description: The prediction interval(s) for the forecasted average monthly income. items: $ref: '#/components/schemas/CraPredictionInterval' employer: $ref: '#/components/schemas/CraBankIncomeEmployer' historical_summary: type: array items: $ref: '#/components/schemas/CraBankIncomeHistoricalSummary' required: - forecasted_average_monthly_income_prediction_intervals PartnerEndCustomerStatus: type: string enum: - UNDER_REVIEW - PENDING_ENABLEMENT - ACTIVE - DENIED description: 'The status of the given end customer. `UNDER_REVIEW`: The end customer has been created and enabled in the non-Production environments. The end customer must be manually reviewed by the Plaid team before it can be enabled in production, at which point its status will automatically transition to `PENDING_ENABLEMENT` or `DENIED`. `PENDING_ENABLEMENT`: The end customer is ready to be enabled in the Production environment. Call the `/partner/customer/enable` endpoint to enable the end customer in Production. `ACTIVE`: The end customer has been enabled in all environments. `DENIED`: The end customer has been created and enabled in the non-Production environments, but it did not pass review by the Plaid team and therefore cannot be enabled in the Production environment. Talk to your Account Manager for more information.' IndividualScreeningHitNames: type: object description: Name information for the associated individual watchlist hit properties: full: type: string example: Aleksey Potemkin description: The full name of the individual, including all parts. is_primary: type: boolean example: false description: Primary names are those most commonly used to refer to this person. Only one name will ever be marked as primary. weak_alias_determination: $ref: '#/components/schemas/WeakAliasDetermination' required: - full - is_primary - weak_alias_determination additionalProperties: true SandboxTransferTestClockListResponse: title: SandboxTransferTestClockListResponse type: object additionalProperties: true description: Defines the response schema for `/sandbox/transfer/test_clock/list` properties: test_clocks: type: array items: $ref: '#/components/schemas/TransferTestClock' request_id: $ref: '#/components/schemas/RequestID' required: - test_clocks - request_id WatchlistProgramID: type: string example: prg_2eRPsDnL66rZ7H title: WatchlistProgramID description: ID of the associated program. WatchlistScreeningEntityUpdateRequest: type: object description: Request input for editing an entity watchlist screening properties: entity_watchlist_screening_id: $ref: '#/components/schemas/EntityWatchlistScreeningID' search_terms: $ref: '#/components/schemas/UpdateEntityScreeningRequestSearchTerms' assignee: $ref: '#/components/schemas/DashboardUserID' status: $ref: '#/components/schemas/WatchlistScreeningStatus' client_user_id: $ref: '#/components/schemas/ClientUserID' client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' reset_fields: $ref: '#/components/schemas/WatchlistScreeningEntityUpdateRequestResettableFieldList' required: - entity_watchlist_screening_id CategoryInsights: type: object description: Insights on a user's top personal finance categories. additionalProperties: true properties: primary_category_insights: type: array description: List of insights of top primary personal finance categories ranked by outflow. items: $ref: '#/components/schemas/CategoryInsightDetails' detailed_category_insights: type: array description: List of insights of top detailed personal finance categories ranked by outflow. items: $ref: '#/components/schemas/CategoryInsightDetails' SignalDecisionOutcome: type: - string - 'null' enum: - APPROVE - REVIEW - REJECT - TAKE_OTHER_RISK_MEASURES - NOT_EVALUATED description: 'The payment decision from the risk assessment. `APPROVE`: approve the transaction without requiring further actions from your customers. For example, use this field if you are placing a standard hold for all the approved transactions before making funds available to your customers. You should also use this field if you decide to accelerate the fund availability for your customers. `REVIEW`: the transaction requires manual review `REJECT`: reject the transaction `TAKE_OTHER_RISK_MEASURES`: for example, placing a longer hold on funds than those approved transactions or introducing customer frictions such as step-up verification/authentication `NOT_EVALUATED`: if only logging the Signal results without using them Possible values: `APPROVE`, `REVIEW`, `REJECT`, `TAKE_OTHER_RISK_MEASURES`, `NOT_EVALUATED` ' DocumentAuthenticityMatchCode: description: 'High level summary of whether the document in the provided image matches the formatting rules and security checks for the associated jurisdiction. For example, most identity documents have formatting rules like the following: The image of the person''s face must have a certain contrast in order to highlight skin tone The subject in the document''s image must remove eye glasses and pose in a certain way The informational fields (name, date of birth, ID number, etc.) must be colored and aligned according to specific rules Security features like watermarks and background patterns must be present So a `match` status for this field indicates that the document in the provided image seems to conform to the various formatting and security rules associated with the detected document.' type: string enum: - match - partial_match - no_match - no_data example: match NumbersEFT: title: NumbersEFT type: object additionalProperties: true description: Identifying information for transferring money to or from a Canadian bank account via EFT. properties: account_id: type: string description: The Plaid account ID associated with the account numbers account: type: string description: The EFT account number for the account institution: type: string description: The EFT institution number for the account branch: type: string description: The EFT branch number for the account required: - account_id - account - institution - branch CraPartnerInsightsGetRequest: title: CraPartnerInsightsGetRequest type: object description: CraPartnerInsightsGetRequest defines the request schema for `/cra/partner_insights/get`. properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' user_token: $ref: '#/components/schemas/UserToken' BeaconMatchSummaryAnalysis: type: object title: BeaconMatchSummaryAnalysis description: Analysis of which fields matched between one Beacon User and another. properties: address: $ref: '#/components/schemas/BeaconMatchSummaryCode' date_of_birth: $ref: '#/components/schemas/BeaconMatchSummaryCode' email_address: $ref: '#/components/schemas/BeaconMatchSummaryCode' name: $ref: '#/components/schemas/BeaconMatchSummaryCode' id_number: $ref: '#/components/schemas/BeaconMatchSummaryCode' ip_address: $ref: '#/components/schemas/BeaconMatchSummaryCode' phone_number: $ref: '#/components/schemas/BeaconMatchSummaryCode' required: - address - date_of_birth - email_address - name - id_number - ip_address - phone_number additionalProperties: true MatchSummary: type: object description: Summary object reflecting the match result of the associated data properties: summary: $ref: '#/components/schemas/MatchSummaryCode' required: - summary additionalProperties: true TransactionStreamAmount: type: object title: TransactionStreamAmount description: Object with data pertaining to an amount on the transaction stream. additionalProperties: true properties: amount: type: number format: double description: Represents the numerical value of an amount. iso_currency_code: type: - string - 'null' description: 'The ISO-4217 currency code of the amount. Always `null` if `unofficial_currency_code` is non-`null`. See the [currency code schema](https://plaid.com/docs/api/accounts#currency-code-schema) for a full listing of supported `iso_currency_code`s.' unofficial_currency_code: type: - string - 'null' description: The unofficial currency code of the amount. Always `null` if `iso_currency_code` is non-`null`. Unofficial currency codes are used for currencies that do not have official ISO currency codes, such as cryptocurrencies and the currencies of certain countries. LinkTokenInvestmentsAuth: x-hidden-from-docs: true description: Configuration parameters for the Investments Auth Product type: object properties: manual_entry_enabled: default: false type: - boolean - 'null' description: If `true`, show institutions that use the manual entry fallback flow. masked_number_match_enabled: default: false type: - boolean - 'null' description: If `true`, show institutions that use the masked number match fallback flow. CreditCardLiability: title: CreditCardLiability type: object additionalProperties: true description: An object representing a credit card account. properties: account_id: type: - string - 'null' description: The ID of the account that this liability belongs to. aprs: type: array description: 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. items: $ref: '#/components/schemas/APR' is_overdue: description: true if a payment is currently overdue. Availability for this field is limited. type: - boolean - 'null' last_payment_amount: description: The amount of the last payment. type: - number - 'null' format: double last_payment_date: type: - string - 'null' format: date description: The date of the last payment. Dates are returned in an [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format (YYYY-MM-DD). Availability for this field is limited. last_statement_issue_date: type: - string - 'null' format: date description: The date of the last statement. Dates are returned in an [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format (YYYY-MM-DD). last_statement_balance: description: The total amount owed as of the last statement issued type: - number - 'null' format: double minimum_payment_amount: description: The minimum payment due for the next billing cycle. type: - number - 'null' format: double next_payment_due_date: type: - string - 'null' format: date description: 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](https://wikipedia.org/wiki/ISO_8601) format (YYYY-MM-DD). required: - account_id - aprs - is_overdue - last_payment_amount - last_payment_date - last_statement_issue_date - last_statement_balance - minimum_payment_amount - next_payment_due_date AssetDetail: title: AssetDetail type: object additionalProperties: true description: Details about an asset. properties: AssetUniqueIdentifier: type: string description: A vendor created unique Identifier. AssetAccountIdentifier: type: string description: A unique alphanumeric string identifying an asset. AssetAsOfDate: type: string description: Account Report As of Date / Create Date. Format YYYY-MM-DD AssetDescription: type: - string - 'null' description: A text description that further defines the Asset. This could be used to describe the shares associated with the stocks, bonds or mutual funds, retirement funds or business owned that the borrower has disclosed (named) as an asset. AssetAvailableBalanceAmount: type: number format: double description: Asset Account Available Balance. AssetCurrentBalanceAmount: type: number format: double description: A vendor created unique Identifier AssetType: $ref: '#/components/schemas/AssetType' AssetTypeAdditionalDescription: type: - string - 'null' description: Additional Asset Decription some examples are Investment Tax-Deferred , Loan, 401K, 403B, Checking, Money Market, Credit Card,ROTH,529,Biller,ROLLOVER,CD,Savings,Investment Taxable, IRA, Mortgage, Line Of Credit. AssetDaysRequestedCount: type: integer description: The Number of days requested made to the Financial Institution. Example When looking for 3 months of data from the FI, pass in 90 days. AssetOwnershipType: type: - string - 'null' description: Ownership type of the asset account. required: - AssetUniqueIdentifier - AssetAccountIdentifier - AssetAsOfDate - AssetDescription - AssetAvailableBalanceAmount - AssetCurrentBalanceAmount - AssetType - AssetTypeAdditionalDescription - AssetDaysRequestedCount - AssetOwnershipType WebhookType: type: string enum: - AUTH - HOLDINGS - INVESTMENTS_TRANSACTIONS - ITEM - LIABILITIES - TRANSACTIONS - ASSETS description: The webhook types that can be fired by this test endpoint. BeaconUserPhoneNumber: type: - string - 'null' title: BeaconUserPhoneNumber description: A phone number in E.164 format. example: '+19876543212' PaymentInitiationPaymentTokenCreateRequest: type: object description: PaymentInitiationPaymentTokenCreateRequest defines the request schema for `/payment_initiation/payment/token/create` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' payment_id: type: string description: The `payment_id` returned from `/payment_initiation/payment/create`. required: - payment_id TransferAuthorizationDecision: type: string description: ' A decision regarding the proposed transfer. `approved` – The proposed transfer has received the end user''s consent and has been approved for processing by Plaid. The `decision_rationale` field is set if Plaid was unable to fetch the account information. You may proceed with the transfer, but further review is recommended (i.e., use Link in update mode to re-authenticate your user when `decision_rationale.code` is `ITEM_LOGIN_REQUIRED`). Refer to the `code` field in the `decision_rationale` object for details. `declined` – Plaid reviewed the proposed transfer and declined processing. Refer to the `code` field in the `decision_rationale` object for details.' enum: - approved - declined CreditBankIncomeSource: type: object description: Detailed information for the income source. properties: income_source_id: type: string description: A unique identifier for an income source. income_description: type: string description: The most common name or original description for the underlying income transactions. income_category: $ref: '#/components/schemas/CreditBankIncomeCategory' account_id: type: string description: Plaid's unique identifier for the account. start_date: type: string format: date description: 'Minimum of all dates within the specific income sources in the user''s bank account for days requested by the client. The date will be returned in an ISO 8601 format (YYYY-MM-DD).' end_date: type: string format: date description: 'Maximum of all dates within the specific income sources in the user’s bank account for days requested by the client. The date will be returned in an ISO 8601 format (YYYY-MM-DD).' pay_frequency: $ref: '#/components/schemas/CreditBankIncomePayFrequency' total_amount: type: number description: Total amount of earnings in the user’s bank account for the specific income source for days requested by the client. transaction_count: type: integer description: Number of transactions for the income source within the start and end date. historical_summary: type: array items: $ref: '#/components/schemas/CreditBankIncomeHistoricalSummary' TransferLedgerDepositRequest: title: TransferLedgerDepositRequest type: object description: Defines the request schema for `/transfer/ledger/deposit` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' originator_client_id: $ref: '#/components/schemas/TransferOriginatorClientID' funding_account_id: $ref: '#/components/schemas/TransferLedgerFundingAccountIDRequest' amount: type: string description: A positive amount of how much will be deposited into ledger (decimal string with two digits of precision e.g. "5.50"). description: $ref: '#/components/schemas/SweepDescription' idempotency_key: $ref: '#/components/schemas/LedgerDepositIdempotencyKey' network: $ref: '#/components/schemas/TransferACHNetwork' required: - amount - idempotency_key - network RiskCheckBehavior: type: - object - 'null' description: Result summary object specifying values for `behavior` attributes of risk check, when available. properties: user_interactions: $ref: '#/components/schemas/RiskCheckBehaviorUserInteractionsLabel' fraud_ring_detected: $ref: '#/components/schemas/RiskCheckBehaviorFraudRingDetectedLabel' bot_detected: $ref: '#/components/schemas/RiskCheckBehaviorBotDetectedLabel' required: - user_interactions - fraud_ring_detected - bot_detected additionalProperties: true UserCreateRequest: type: object description: UserCreateRequest defines the request schema for `/user/create` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' client_user_id: description: A unique ID representing the end user. Maximum of 128 characters. Typically this will be a user ID number from your application. Personally identifiable information, such as an email address or phone number, should not be used in the `client_user_id`. type: string maxLength: 128 minLength: 1 consumer_report_user_identity: $ref: '#/components/schemas/ConsumerReportUserIdentity' required: - client_user_id SandboxBankIncomeWebhookFireRequestWebhookCode: type: string enum: - BANK_INCOME_REFRESH_UPDATE - BANK_INCOME_REFRESH_COMPLETE description: The webhook codes this endpoint can be used to test SandboxTransferTestClockAdvanceRequest: title: SandboxTransferTestClockAdvanceRequest type: object description: Defines the request schema for `/sandbox/transfer/test_clock/advance` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' test_clock_id: $ref: '#/components/schemas/TransferTestClockID' new_virtual_time: $ref: '#/components/schemas/VirtualTime' required: - test_clock_id - new_virtual_time TransferRepaymentListRequest: title: TransferRepaymentListRequest type: object description: Defines the request schema for `/transfer/repayment/list` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' start_date: type: - string - 'null' format: date-time description: The start datetime of repayments to return (RFC 3339 format). end_date: type: - string - 'null' format: date-time description: The end datetime of repayments to return (RFC 3339 format). count: type: - integer - 'null' minimum: 1 maximum: 25 default: 25 description: The maximum number of repayments to return. offset: type: integer default: 0 minimum: 0 description: The number of repayments to skip before returning results. ApplicationID: title: ApplicationID type: string description: This field will map to the application ID that is returned from /item/application/list, or provided to the institution in an oauth redirect. PaymentConsentPeriodicAlignment: type: string enum: - CALENDAR - CONSENT description: 'Where the payment consent period should start. `CALENDAR`: line up with a calendar. `CONSENT`: on the date of consent creation.' CraBankIncomeAccount: type: object description: The Item's bank accounts that have the selected data. properties: mask: type: - string - 'null' description: 'The last 2-4 alphanumeric characters of an account''s official account number. Note that the mask may be non-unique between an Item''s accounts, and it may also not match the mask that the bank displays to the user.' name: type: string description: The name of the bank account. official_name: type: - string - 'null' description: The official name of the bank account. subtype: $ref: '#/components/schemas/DepositoryAccountSubtype' type: $ref: '#/components/schemas/CreditBankIncomeAccountType' owners: type: array description: Data returned by the financial institution about the account owner or owners. Identity information is optional, so field may return an empty array. items: $ref: '#/components/schemas/Owner' required: - mask - name - official_name - subtype - type - owners ProcessorBalanceGetRequest: type: object description: ProcessorBalanceGetRequest defines the request schema for `/processor/balance/get` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' processor_token: $ref: '#/components/schemas/ProcessorToken' options: $ref: '#/components/schemas/ProcessorBalanceGetRequestOptions' required: - processor_token FDXNotificationPayloadIdType: type: string title: Notification Payload Id Type enum: - ACCOUNT - CUSTOMER - PARTY - MAINTENANCE - CONSENT description: Type of entity causing origination of a notification TransferSweepGetResponse: title: TransferSweepGetResponse type: object additionalProperties: true description: Defines the response schema for `/transfer/sweep/get` properties: sweep: $ref: '#/components/schemas/TransferSweep' request_id: $ref: '#/components/schemas/RequestID' required: - sweep - request_id CraPartnerInsightsPrism: type: object additionalProperties: true description: The Prism insights for the user. properties: insights: $ref: '#/components/schemas/PrismInsights' cash_score: $ref: '#/components/schemas/PrismCashScore' first_detect: $ref: '#/components/schemas/PrismFirstDetect' status: type: string description: Details on whether the Prism attributes succeeded or failed to be generated. required: - status LedgerWithdrawIdempotencyKey: title: LedgerWithdrawIdempotencyKey type: string maxLength: 50 description: 'A unique key provided by the client, per unique ledger withdraw. Maximum of 50 characters. The API supports idempotency for safely retrying the request without accidentally performing the same operation twice. For example, if a request to create a ledger withdraw fails due to a network connection error, you can retry the request with the same idempotency key to guarantee that only a single withdraw is created.' ItemWebhookUpdateRequest: type: object description: ItemWebhookUpdateRequest defines the request schema for `/item/webhook/update` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' access_token: $ref: '#/components/schemas/AccessToken' webhook: type: - string - 'null' description: The new webhook URL to associate with the Item. To remove a webhook from an Item, set to `null`. required: - access_token AssetReportAuditCopyCreateRequest: type: object description: AssetReportAuditCopyCreateRequest defines the request schema for `/asset_report/audit_copy/get` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' asset_report_token: $ref: '#/components/schemas/AssetReportToken' auditor_id: type: string description: The `auditor_id` of the third party with whom you would like to share the Asset Report. required: - asset_report_token CounterpartyType: title: CounterpartyType description: 'The counterparty type. `merchant`: a provider of goods or services for purchase `financial_institution`: a financial entity (bank, credit union, BNPL, fintech) `payment_app`: a transfer or P2P app (e.g. Zelle) `marketplace`: a marketplace (e.g DoorDash, Google Play Store) `payment_terminal`: a point-of-sale payment terminal (e.g Square, Toast) `income_source`: the payer in an income transaction (e.g., an employer, client, or government agency)' type: string enum: - merchant - financial_institution - payment_app - marketplace - payment_terminal - income_source MinLastUpdatedDatetime: title: MinLastUpdatedDatetime type: string format: date-time description: 'Timestamp in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format (`YYYY-MM-DDTHH:mm:ssZ`) indicating the oldest acceptable balance when making a request to `/accounts/balance/get`. This field is only necessary when the institution is `ins_128026` (Capital One), *and* one or more account types being requested is a non-depository account (such as a credit card) as Capital One does not provide real-time balance for non-depository accounts. In this case, a value must be provided or an `INVALID_REQUEST` error with the code of `INVALID_FIELD` will be returned. For all other institutions, as well as for depository accounts at Capital One (including all checking and savings accounts) this field is ignored and real-time balance information will be fetched. If this field is not ignored, and no acceptable balance is available, an `INVALID_RESULT` error with the code `LAST_UPDATED_DATETIME_OUT_OF_RANGE` will be returned.' ExpirationDate: description: 'A description of whether the associated document was expired when the verification was performed. Note: In the case where an expiration date is not present on the document or failed to be extracted, this value will be `no_data`.' type: string enum: - not_expired - expired - no_data example: not_expired CraPartnerInsightsItemAccount: type: object additionalProperties: true description: Account data corresponding to the item from which Partner Insights were generated from properties: mask: type: - string - 'null' description: 'The last 2-4 alphanumeric characters of an account''s official account number. Note that the mask may be non-unique between an Item''s accounts, and it may also not match the mask that the bank displays to the user.' name: type: string description: The name of the account official_name: type: - string - 'null' description: The official name of the bank account. subtype: $ref: '#/components/schemas/DepositoryAccountSubtype' type: $ref: '#/components/schemas/CreditBankIncomeAccountType' owners: type: array description: Data returned by the financial institution about the account owner or owners. Identity information is optional, so field may return an empty array. items: $ref: '#/components/schemas/Owner' required: - mask - name - official_name - subtype - type - owners BankTransferAmount: title: BankTransferAmount type: string description: The amount of the bank transfer (decimal string with two digits of precision e.g. "10.00"). TransactionsRecurringGetResponse: type: object additionalProperties: true description: TransactionsRecurringGetResponse defines the response schema for `/transactions/recurring/get` properties: inflow_streams: type: array description: An array of depository transaction streams. items: $ref: '#/components/schemas/TransactionStream' outflow_streams: type: array description: An array of expense transaction streams. items: $ref: '#/components/schemas/TransactionStream' updated_datetime: type: string format: date-time description: Timestamp in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format (`YYYY-MM-DDTHH:mm:ssZ`) indicating the last time transaction streams for the given account were updated on request_id: $ref: '#/components/schemas/RequestID' required: - inflow_streams - outflow_streams - updated_datetime - request_id LinkSessionSuccessMetadata: type: - object - 'null' description: Displayed once a user has successfully linked their Item. properties: institution: $ref: '#/components/schemas/LinkSessionSuccessMetadataInstitution' accounts: type: array description: A list of accounts attached to the connected Item. If Account Select is enabled via the developer dashboard, `accounts` will only include selected accounts. items: $ref: '#/components/schemas/LinkSessionSuccessMetadataAccount' link_session_id: type: string description: A unique identifier associated with a user's actions and events through the Link flow. Include this identifier when opening a support ticket for faster turnaround. transfer_status: $ref: '#/components/schemas/LinkSessionSuccessMetadataTransferStatus' PaymentInitiationOptionalRestrictionBacs: description: An optional object used to restrict the accounts used for payments. If provided, the end user will be able to send payments only from the specified bank account. allOf: - $ref: '#/components/schemas/RecipientBACS' - type: object additionalProperties: true IndividualWatchlistScreeningProgramName: type: string title: IndividualWatchlistScreeningProgramName example: Sample Program minLength: 1 description: A name for the program to define its purpose. For example, "High Risk Individuals", "US Cardholders", or "Applicants". ItemApplicationListRequest: description: Request to list connected applications for a user. type: object properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' access_token: $ref: '#/components/schemas/AccessTokenNullable' TransferEventSyncRequest: title: TransferEventSyncRequest type: object description: Defines the request schema for `/transfer/event/sync` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' after_id: type: integer description: The latest (largest) `event_id` fetched via the sync endpoint, or 0 initially. minimum: 0 count: type: - integer - 'null' default: 25 minimum: 1 maximum: 25 description: The maximum number of transfer events to return. required: - after_id TransactionsRuleDetails: title: TransactionsRuleDetails type: object description: A representation of transactions rule details. x-examples: {} properties: field: $ref: '#/components/schemas/TransactionsRuleField' type: $ref: '#/components/schemas/TransactionsRuleType' query: type: string description: 'For TRANSACTION_ID field, provide transaction_id. For NAME field, provide a string pattern. ' required: - field - type - query SandboxTransferTestClockCreateResponse: title: SandboxTransferTestClockCreateResponse type: object additionalProperties: true description: Defines the response schema for `/sandbox/transfer/test_clock/create` properties: test_clock: $ref: '#/components/schemas/TransferTestClock' request_id: $ref: '#/components/schemas/RequestID' required: - test_clock - request_id CreditSessionResults: type: object description: The set of results for a Link session. properties: item_add_results: type: array description: The set of Item adds for the Link session. items: $ref: '#/components/schemas/CreditSessionItemAddResult' bank_income_results: type: array description: The set of bank income verifications for the Link session. items: $ref: '#/components/schemas/CreditSessionBankIncomeResult' bank_employment_results: type: array description: The set of bank employment verifications for the Link session. items: $ref: '#/components/schemas/CreditSessionBankEmploymentResult' payroll_income_results: type: array description: The set of payroll income verifications for the Link session. items: $ref: '#/components/schemas/CreditSessionPayrollIncomeResult' document_income_results: $ref: '#/components/schemas/CreditSessionDocumentIncomeResult' Credit1099Filer: title: Credit1099Filer type: object additionalProperties: true description: An object representing a filer used by 1099-K tax documents. properties: address: $ref: '#/components/schemas/CreditPayStubAddress' name: type: - string - 'null' description: Name of filer. tin: type: - string - 'null' description: Tax identification number of filer. type: type: - string - 'null' description: 'One of the following values will be provided: Payment Settlement Entity (PSE), Electronic Payment Facilitator (EPF), Other Third Party' x-override-enum-values-shown: - Payment Settlement Entity (PSE) - Electronic Payment Facilitator (EPF) - Other Third Party CraLoanUpdate: type: object description: Contains loan data to update. additionalProperties: true properties: loan_id: $ref: '#/components/schemas/CraLoanID' status_history: type: array description: A list of status update history of the loan. items: $ref: '#/components/schemas/CraLoanStatusHistoryUpdate' payment_history: type: array description: The updates to the payment history for the loan. items: $ref: '#/components/schemas/CraLoanPaymentHistory' WatchlistScreeningDocumentType: type: string enum: - birth_certificate - drivers_license - immigration_number - military_id - other - passport - personal_identification - ration_card - ssn - student_id - tax_id - travel_document - voter_id title: WatchlistScreeningDocumentType example: passport description: 'The kind of official document represented by this object. `birth_certificate` - A certificate of birth `drivers_license` - A license to operate a motor vehicle `immigration_number` - Immigration or residence documents `military_id` - Identification issued by a military group `other` - Any document not covered by other categories `passport` - An official passport issue by a government `personal_identification` - Any generic personal identification that is not covered by other categories `ration_card` - Identification that entitles the holder to rations `ssn` - United States Social Security Number `student_id` - Identification issued by an educational institution `tax_id` - Identification issued for the purpose of collecting taxes `travel_document` - Visas, entry permits, refugee documents, etc. `voter_id` - Identification issued for the purpose of voting' CreditEmploymentVerification: title: CreditEmploymentVerification type: object additionalProperties: true description: The object containing proof of employment data for an individual. properties: account_id: type: - string - 'null' description: ID of the payroll provider account. status: $ref: '#/components/schemas/CreditEmploymentVerificationStatus' start_date: format: date type: - string - 'null' description: Start of employment in ISO 8601 format (YYYY-MM-DD). end_date: format: date type: - string - 'null' description: End of employment, if applicable. Provided in ISO 8601 format (YYY-MM-DD). employer: $ref: '#/components/schemas/CreditEmployerVerification' title: type: - string - 'null' description: Current title of employee. platform_ids: $ref: '#/components/schemas/CreditPlatformIds' employee_type: $ref: '#/components/schemas/CreditEmploymentEmployeeType' last_paystub_date: format: date type: - string - 'null' description: The date of the employee's most recent paystub in ISO 8601 format (YYYY-MM-DD). required: - account_id - status - start_date - end_date - employer - title - platform_ids - employee_type - last_paystub_date LinkTokenCreateRequestDepositSwitch: type: object x-hidden-from-docs: true description: Specifies options for initializing Link for use with the Deposit Switch (beta) product. This field is required if `deposit_switch` is included in the `products` array. properties: deposit_switch_id: type: string description: The `deposit_switch_id` provided by the `/deposit_switch/create` endpoint. required: - deposit_switch_id PaymentInitiationAddress: title: PaymentInitiationAddress type: - object - 'null' additionalProperties: true description: The optional address of the payment recipient's bank account. Required by most institutions outside of the UK. properties: street: description: An array of length 1-2 representing the street address where the recipient is located. Maximum of 70 characters. type: array minItems: 1 items: type: string minLength: 1 city: type: string description: The city where the recipient is located. Maximum of 35 characters. minLength: 1 maxLength: 35 postal_code: type: string description: The postal code where the recipient is located. Maximum of 16 characters. minLength: 1 maxLength: 16 country: type: string description: The ISO 3166-1 alpha-2 country code where the recipient is located. minLength: 2 maxLength: 2 required: - street - city - postal_code - country InvestmentFilter: title: InvestmentFilter description: A filter to apply to `investment`-type accounts (or `brokerage`-type accounts for API versions 2018-05-22 and earlier). type: object additionalProperties: true properties: account_subtypes: $ref: '#/components/schemas/InvestmentAccountSubtypes' required: - account_subtypes AccountProductAccess: description: Allow the application to access specific products on this account type: object properties: account_data: description: Allow the application to access account data. Only used by certain partners. If relevant to the partner and unset, defaults to `true`. type: - boolean - 'null' default: true statements: description: Allow the application to access bank statements. Only used by certain partners. If relevant to the partner and unset, defaults to `true`. type: - boolean - 'null' default: true tax_documents: description: Allow the application to access tax documents. Only used by certain partners. If relevant to the partner and unset, defaults to `true`. type: - boolean - 'null' default: true Street2: type: - string - 'null' example: Unit 42 title: Street2 description: Extra street information, like an apartment or suite number. If provided, a string with at least one non-whitespace character, with a max length of 20 characters. BankTransferEventSyncRequest: title: BankTransferEventSyncRequest type: object description: Defines the request schema for `/bank_transfer/event/sync` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' after_id: type: integer description: The latest (largest) `event_id` fetched via the sync endpoint, or 0 initially. minimum: 0 count: type: - integer - 'null' default: 25 minimum: 1 maximum: 25 description: The maximum number of bank transfer events to return. required: - after_id PaystubDetails: title: PaystubDetails type: object deprecated: true description: An object representing details that can be found on the paystub. additionalProperties: true properties: pay_period_start_date: type: - string - 'null' format: date description: Beginning date of the pay period on the paystub in the 'YYYY-MM-DD' format. pay_period_end_date: type: - string - 'null' format: date description: Ending date of the pay period on the paystub in the 'YYYY-MM-DD' format. pay_date: type: - string - 'null' format: date description: Pay date on the paystub in the 'YYYY-MM-DD' format. paystub_provider: type: - string - 'null' description: The name of the payroll provider that generated the paystub, e.g. ADP pay_frequency: $ref: '#/components/schemas/PaystubPayFrequency' AccountsBalanceGetRequest: type: object description: AccountsBalanceGetRequest defines the request schema for `/accounts/balance/get` properties: access_token: $ref: '#/components/schemas/AccessToken' secret: $ref: '#/components/schemas/APISecret' client_id: $ref: '#/components/schemas/APIClientID' options: $ref: '#/components/schemas/AccountsBalanceGetRequestOptions' payment_details: $ref: '#/components/schemas/AccountsBalanceGetRequestPaymentDetails' required: - access_token LoanIdentifier: title: LoanIdentifier type: object additionalProperties: true description: The information used to identify this loan by various parties to the transaction or other organizations. properties: LoanIdentifier: type: - string - 'null' description: The value of the identifier for the specified type. LoanIdentifierType: $ref: '#/components/schemas/LoanIdentifierType' required: - LoanIdentifier - LoanIdentifierType BankInitiatedRiskTier: description: "In the `bank_initiated_return_risk` object, there are eight risk tiers corresponding to the scores:\n 1: Predicted bank-initiated return incidence rate between 0.0% - 0.5%\n 2: Predicted bank-initiated return incidence rate between 0.5% - 1.5%\n 3: Predicted bank-initiated return incidence rate between 1.5% - 3%\n 4: Predicted bank-initiated return incidence rate between 3% - 5%\n 5: Predicted bank-initiated return incidence rate between 5% - 10%\n 6: Predicted bank-initiated return incidence rate between 10% - 15%\n 7: Predicted bank-initiated return incidence rate between 15% and 50%\n 8: Predicted bank-initiated return incidence rate greater than 50%\n" type: integer minimum: 1 maximum: 8 BeaconUserUpdateRequestData: type: object title: BeaconUserUpdateRequestData description: A subset of a Beacon User's data which is used to patch the existing identity data associated with a Beacon User. At least one field must be provided,. properties: date_of_birth: $ref: '#/components/schemas/ISO8601Date' name: $ref: '#/components/schemas/BeaconUserNameNullable' address: $ref: '#/components/schemas/BeaconUserRequestAddressNullable' email_address: $ref: '#/components/schemas/EmailAddress' phone_number: $ref: '#/components/schemas/BeaconUserPhoneNumber' id_number: $ref: '#/components/schemas/BeaconUserIDNumber' ip_address: $ref: '#/components/schemas/IPAddress' additionalProperties: true ScreeningHitDateOfBirthItem: type: object description: Analyzed date of birth for the associated hit properties: analysis: $ref: '#/components/schemas/MatchSummary' data: $ref: '#/components/schemas/DateRange' additionalProperties: true Counterparty: type: object title: Counterparty additionalProperties: true description: The counterparty, such as the merchant or financial institution, is extracted by Plaid from the raw description. properties: name: type: string description: The name of the counterparty, such as the merchant or the financial institution, as extracted by Plaid from the raw description. entity_id: type: - string - 'null' description: A unique, stable, Plaid-generated ID that maps to the counterparty. type: $ref: '#/components/schemas/CounterpartyType' website: type: - string - 'null' description: The website associated with the counterparty. logo_url: type: - string - 'null' description: The URL of a logo associated with the counterparty, if available. The logo will always be 100×100 pixel PNG file. confidence_level: type: - string - 'null' description: 'A description of how confident we are that the provided counterparty is involved in the transaction. `VERY_HIGH`: We recognize this counterparty and we are more than 98% confident that it is involved in this transaction. `HIGH`: We recognize this counterparty and we are more than 90% confident that it is involved in this transaction. `MEDIUM`: We are moderately confident that this counterparty was involved in this transaction, but some details may differ from our records. `LOW`: We didn’t find a matching counterparty in our records, so we are returning a cleansed name parsed out of the request description. `UNKNOWN`: We don’t know the confidence level for this counterparty.' phone_number: type: - string - 'null' description: The phone number associated with the counterparty in E. 164 format. If there is a location match (i.e. a street address is returned in the location object), the phone number will be location specific. required: - name - type - logo_url - website - phone_number PaymentInitiationRecipientCreateResponse: type: object additionalProperties: true description: PaymentInitiationRecipientCreateResponse defines the response schema for `/payment_initation/recipient/create` properties: recipient_id: type: string description: A unique ID identifying the recipient request_id: $ref: '#/components/schemas/RequestID' required: - recipient_id - request_id ProcessorApexProcessorTokenCreateRequest: type: object description: ProcessorApexProcessorTokenCreateRequest defines the request schema for `/processor/apex/processor_token/create` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' access_token: $ref: '#/components/schemas/AccessToken' account_id: type: string description: The `account_id` value obtained from the `onSuccess` callback in Link required: - access_token - account_id TransactionsSyncRequest: type: object description: TransactionsSyncRequest defines the request schema for `/transactions/sync` properties: client_id: $ref: '#/components/schemas/APIClientID' access_token: $ref: '#/components/schemas/AccessToken' secret: $ref: '#/components/schemas/APISecret' cursor: type: string description: 'The cursor value represents the last update requested. Providing it will cause the response to only return changes after this update. If omitted, the entire history of updates will be returned, starting with the first-added transactions on the Item. The cursor also accepts the special value of `"now"`, which can be used to fast-forward the cursor as part of migrating an existing Item from `/transactions/get` to `/transactions/sync`. For more information, see the [Transactions sync migration guide](https://plaid.com/docs/transactions/sync-migration/). Note that using the `"now"` value is not supported for any use case other than migrating existing Items from `/transactions/get`. The upper-bound length of this cursor is 256 characters of base64.' count: type: integer default: 100 description: The number of transaction updates to fetch. minimum: 1 maximum: 500 options: $ref: '#/components/schemas/TransactionsSyncRequestOptions' required: - access_token DetailedOriginator: type: object title: Originator additionalProperties: true description: Originator and their status. properties: client_id: type: string description: Originator’s client ID. transfer_diligence_status: $ref: '#/components/schemas/TransferDiligenceStatus' company_name: type: string description: The company name of the end customer. required: - client_id - transfer_diligence_status - company_name ItemActivityListRequest: description: Request to list a historical log of user consent events. type: object properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' access_token: $ref: '#/components/schemas/AccessToken' cursor: type: string description: Cursor used for pagination. count: type: integer minimum: 1 maximum: 50 default: 50 TransferRecurringListResponse: title: TransferRecurringListResponse type: object additionalProperties: true description: Defines the response schema for `/transfer/recurring/list` properties: recurring_transfers: type: array items: $ref: '#/components/schemas/RecurringTransfer' request_id: $ref: '#/components/schemas/RequestID' required: - recurring_transfers - request_id TransferAuthorizationDecisionRationaleCode: type: string description: 'A code representing the rationale for approving or declining the proposed transfer. If the `rationale_code` is `null`, the transfer passed the authorization check. Any non-`null` value for an `approved` transfer indicates that the the authorization check could not be run and that you should perform your own risk assessment on the transfer. The code will indicate why the check could not be run. Possible values for an `approved` transfer are: `MANUALLY_VERIFIED_ITEM` – Item created via a manual entry flow (i.e. Same Day Micro-deposit, Instant Micro-deposit, Database Insights, or Database Match), limited information available. `ITEM_LOGIN_REQUIRED` – Unable to collect the account information due to Item staleness. Can be resolved by using Link in [update mode](https://www.plaid.com/docs/link/update-mode). `MIGRATED_ACCOUNT_ITEM` - Item created via `/transfer/account_migration` endpoint, limited information available. `ERROR` – Unable to collect the account information due to an unspecified error. The following codes indicate that the authorization decision was `declined`: `NSF` – Transaction likely to result in a return due to insufficient funds. `RISK` - Transaction is high-risk. `TRANSFER_LIMIT_REACHED` - One or several transfer limits are reached, e.g. monthly transfer limit.' enum: - NSF - RISK - TRANSFER_LIMIT_REACHED - MANUALLY_VERIFIED_ITEM - ITEM_LOGIN_REQUIRED - PAYMENT_PROFILE_LOGIN_REQUIRED - ERROR - MIGRATED_ACCOUNT_ITEM - null StatementsRefreshRequest: title: StatementsRefreshRequest type: object description: StatementsRefreshRequest defines the request schema for `/statements/refresh` properties: access_token: $ref: '#/components/schemas/AccessToken' client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' start_date: description: The start date for statements, in “YYYY-MM-DD” format, e.g. "2023-08-30". To determine whether a statement falls within the specified date range, Plaid will use the statement posted date. The statement posted date is typically either the last day of the statement period, or the following day. type: string format: date end_date: description: The end date for statements, in “YYYY-MM-DD” format, e.g. "2023-10-30". You can request up to two years of data. To determine whether a statement falls within the specified date range, Plaid will use the statement posted date. The statement posted date is typically either the last day of the statement period, or the following day. type: string format: date required: - access_token - start_date - end_date TransferRefundIdempotencyKey: title: TransferRefundIdempotencyKey type: string maxLength: 50 description: 'A random key provided by the client, per unique refund. Maximum of 50 characters. The API supports idempotency for safely retrying requests without accidentally performing the same operation twice. For example, if a request to create a refund fails due to a network connection error, you can retry the request with the same idempotency key to guarantee that only a single refund is created.' AssetOwner: title: AssetOwner type: object additionalProperties: true description: Documentation not found in the MISMO model viewer and not provided by Freddie Mac. properties: AssetOwnerText: type: - string - 'null' description: Account Owner Full Name. required: - AssetOwnerText Holding: title: Holding type: object additionalProperties: true description: A securities holding at an institution. properties: account_id: type: string description: The Plaid `account_id` associated with the holding. security_id: type: string description: 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. institution_price: type: number format: double description: The last price given by the institution for this security. institution_price_as_of: type: - string - 'null' format: date description: The date at which `institution_price` was current. institution_price_datetime: type: - string - 'null' format: date-time description: 'Date and time at which `institution_price` was current, in ISO 8601 format (YYYY-MM-DDTHH:mm:ssZ). 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). ' institution_value: type: number format: double description: The value of the holding, as reported by the institution. cost_basis: type: - number - 'null' format: double description: The total cost basis of the holding (e.g., the total amount spent to acquire all assets currently in the holding). quantity: description: 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. type: number format: double iso_currency_code: type: - string - 'null' description: The ISO-4217 currency code of the holding. Always `null` if `unofficial_currency_code` is non-`null`. unofficial_currency_code: type: - string - 'null' description: 'The unofficial currency code associated with the holding. Always `null` if `iso_currency_code` is non-`null`. Unofficial currency codes are used for currencies that do not have official ISO currency codes, such as cryptocurrencies and the currencies of certain countries. See the [currency code schema](https://plaid.com/docs/api/accounts#currency-code-schema) for a full listing of supported `iso_currency_code`s. ' vested_quantity: type: - number - 'null' format: double description: The total quantity of vested assets held, as reported by the financial institution. Vested assets are only associated with [equities](https://plaid.com/docs/api/products/investments/#investments-holdings-get-response-securities-type). vested_value: type: - number - 'null' format: double description: The value of the vested holdings as reported by the institution. required: - account_id - security_id - institution_price - institution_value - cost_basis - quantity - iso_currency_code - unofficial_currency_code WalletPaymentScheme: type: - string - 'null' enum: - null - FASTER_PAYMENTS - SEPA_CREDIT_TRANSFER - SEPA_CREDIT_TRANSFER_INSTANT description: 'The payment scheme used to execute this transaction. This is present only for transaction types `PAYOUT` and `REFUND`. `FASTER_PAYMENTS`: The standard payment scheme within the UK. `SEPA_CREDIT_TRANSFER`: The standard payment to a beneficiary within the SEPA area. `SEPA_CREDIT_TRANSFER_INSTANT`: Instant payment to a beneficiary within the SEPA area.' StatementsStatement: title: StatementsStatement type: object additionalProperties: true description: A statement's metadata associated with an account properties: statement_id: description: Plaid's unique identifier for the statement. type: string month: description: 'Month of the year. Possible values: 1 through 12 (January through December).' type: integer year: description: The year of statement. type: integer minimum: 2010 required: - statement_id - month - year CreditSessionBankEmploymentStatus: type: string enum: - APPROVED - NO_EMPLOYERS_FOUND - EMPLOYER_NOT_LISTED description: 'Status of the Bank Employment Link session. `APPROVED`: User has approved and verified their employment. `NO_EMPLOYMENTS_FOUND`: We attempted, but were unable to find any employment in the connected account. `EMPLOYER_NOT_LISTED`: The user explicitly indicated that they did not see their current or previous employer in the list of employer names found. `STARTED`: The user began the bank income portion of the link flow. `INTERNAL_ERROR`: The user encountered an internal error.' PartnerEndCustomerTechnicalContact: description: The technical contact for the end customer. Defaults to partner's technical contact if omitted. type: object additionalProperties: true properties: given_name: type: string family_name: type: string email: type: string IdentityVerificationStatus: type: string enum: - active - success - failed - expired - canceled - pending_review example: success title: IdentityVerificationStatus description: 'The status of this Identity Verification attempt. `active` - The Identity Verification attempt is incomplete. The user may have completed part of the session, but has neither failed or passed. `success` - The Identity Verification attempt has completed, passing all steps defined to the associated Identity Verification template `failed` - The user failed one or more steps in the session and was told to contact support. `expired` - The Identity Verification attempt was active for a long period of time without being completed and was automatically marked as expired. Note that sessions currently do not expire. Automatic expiration is expected to be enabled in the future. `canceled` - The Identity Verification attempt was canceled, either via the dashboard by a user, or via API. The user may have completed part of the session, but has neither failed or passed. `pending_review` - The Identity Verification attempt template was configured to perform a screening that had one or more hits needing review.' ScreeningHitNamesItems: type: object description: Analyzed name information for the associated hit properties: analysis: $ref: '#/components/schemas/MatchSummary' data: $ref: '#/components/schemas/IndividualScreeningHitNames' additionalProperties: true PaymentInitiationConsentPaymentExecuteRequest: type: object description: PaymentInitiationConsentPaymentExecuteRequest defines the request schema for `/payment_initiation/consent/payment/execute` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' consent_id: type: string description: The consent ID. amount: $ref: '#/components/schemas/PaymentAmount' idempotency_key: $ref: '#/components/schemas/ConsentPaymentIdempotencyKey' reference: type: - string - 'null' description: 'A reference for the payment. This must be an alphanumeric string with at most 18 characters and must not contain any special characters (since not all institutions support them). If not provided, Plaid will automatically fall back to the reference from consent. In order to track settlement via Payment Confirmation, each payment must have a unique reference. If the reference provided through the API is not unique, Plaid will adjust it. Some institutions may limit the reference to less than 18 characters. If necessary, Plaid will adjust the reference by truncating it to fit the institution''s requirements. Both the originally provided and automatically adjusted references (if any) can be found in the `reference` and `adjusted_reference` fields, respectively.' minLength: 1 maxLength: 18 scope: allOf: - $ref: '#/components/schemas/PaymentInitiationConsentScope' - type: - string - 'null' description: A scope of the payment. Must be one of the scopes mentioned in the consent. Optional if the appropriate consent has only one scope defined, required otherwise. required: - consent_id - amount - idempotency_key EntityScreeningHitNamesItems: type: object description: Analyzed names for the associated hit properties: analysis: $ref: '#/components/schemas/MatchSummary' data: $ref: '#/components/schemas/EntityScreeningHitNames' additionalProperties: true SandboxTransferLedgerDepositSimulateRequest: title: SandboxTransferLedgerDepositSimulateRequest type: object description: Defines the request schema for `/sandbox/transfer/ledger/deposit/simulate` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' sweep_id: $ref: '#/components/schemas/TransferSweepID' event_type: $ref: '#/components/schemas/TransferLedgerSweepSimulateEventType' failure_reason: $ref: '#/components/schemas/TransferFailure' required: - sweep_id - event_type CreditBankIncomeWarning: type: object description: The warning associated with the data that was unavailable for the Bank Income Report. properties: warning_type: $ref: '#/components/schemas/CreditBankIncomeWarningType' warning_code: $ref: '#/components/schemas/CreditBankIncomeWarningCode' cause: $ref: '#/components/schemas/CreditBankIncomeCause' EarningsBreakdown: title: EarningsBreakdown type: object additionalProperties: true description: An object representing the earnings line items for the pay period. properties: canonical_description: $ref: '#/components/schemas/EarningsBreakdownCanonicalDescription' current_amount: type: - number - 'null' format: double description: Raw amount of the earning line item. description: type: - string - 'null' description: Description of the earning line item. hours: type: - number - 'null' description: Number of hours applicable for this earning. iso_currency_code: type: - string - 'null' description: The ISO-4217 currency code of the line item. Always `null` if `unofficial_currency_code` is non-null. rate: type: - number - 'null' format: double description: Hourly rate applicable for this earning. unofficial_currency_code: type: - string - 'null' description: 'The unofficial currency code associated with the line item. Always `null` if `iso_currency_code` is non-`null`. Unofficial currency codes are used for currencies that do not have official ISO currency codes, such as cryptocurrencies and the currencies of certain countries. See the [currency code schema](https://plaid.com/docs/api/accounts#currency-code-schema) for a full listing of supported `iso_currency_code`s.' ytd_amount: type: - number - 'null' format: double description: The year-to-date amount of the deduction. TransferRepayment: title: TransferRepayment type: object additionalProperties: true description: 'A repayment is created automatically after one or more guaranteed transactions receive a return. If there are multiple eligible returns in a day, they are batched together into a single repayment. Repayments are sent over ACH, with funds typically available on the next banking day.' properties: repayment_id: type: string description: Identifier of the repayment. created: type: string description: The datetime when the repayment occurred, in RFC 3339 format. format: date-time amount: type: string description: Decimal amount of the repayment as it appears on your account ledger. iso_currency_code: type: string description: The currency of the repayment, e.g. "USD". required: - repayment_id - created - amount - iso_currency_code RecipientBACS: title: RecipientBACS type: - object - 'null' additionalProperties: true description: An object containing a BACS account number and sort code. If an IBAN is not provided or if you need to accept domestic GBP-denominated payments, BACS data is required. properties: account: type: string description: The account number of the account. Maximum of 10 characters. minLength: 1 maxLength: 10 sort_code: type: string description: The 6-character sort code of the account. minLength: 6 maxLength: 6 FDXPartyType: title: Party Type description: Identifies the type of a party type: string enum: - DATA_ACCESS_PLATFORM - DATA_PROVIDER - DATA_RECIPIENT - INDIVIDUAL - MERCHANT - VENDOR TransferRecurringListRequest: title: TransferRecurringListRequest type: object description: Defines the request schema for `/transfer/recurring/list` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' start_time: type: - string - 'null' format: date-time description: The start datetime of recurring transfers to list. This should be in RFC 3339 format (i.e. `2019-12-06T22:35:49Z`) end_time: type: - string - 'null' format: date-time description: The end datetime of recurring transfers to list. This should be in RFC 3339 format (i.e. `2019-12-06T22:35:49Z`) count: type: integer minimum: 1 maximum: 25 default: 25 description: The maximum number of recurring transfers to return. offset: type: integer default: 0 minimum: 0 description: The number of recurring transfers to skip before returning results. funding_account_id: type: - string - 'null' description: Filter recurring transfers to only those with the specified `funding_account_id`. WalletTransactionGetResponse: title: WalletTransactionGetResponse type: object additionalProperties: true description: WalletTransactionGetResponse defines the response schema for `/wallet/transaction/get` allOf: - $ref: '#/components/schemas/WalletTransaction' - type: object properties: request_id: $ref: '#/components/schemas/RequestID' required: - transaction_id - reference - type - amount - counterparty - status - created_at - request_id AuthGetRequestOptions: type: object description: An optional object to filter `/auth/get` results. properties: account_ids: type: array description: 'A list of `account_ids` to retrieve for the Item. Note: An error will be returned if a provided `account_id` is not associated with the Item.' items: type: string EmployerVerification: title: EmployerVerification type: object additionalProperties: true description: An object containing employer data. properties: name: type: - string - 'null' description: Name of employer. WatchlistScreeningPhoneNumber: type: string description: A phone number in E.164 format. example: '+14025671234' title: WatchlistScreeningPhoneNumber PaymentMeta: title: PaymentMeta type: object additionalProperties: true 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.' properties: reference_number: type: - string - 'null' description: The transaction reference number supplied by the financial institution. ppd_id: type: - string - 'null' description: The ACH PPD ID for the payer. payee: type: - string - 'null' description: For transfers, the party that is receiving the transaction. by_order_of: type: - string - 'null' description: The party initiating a wire transfer. Will be `null` if the transaction is not a wire transfer. payer: type: - string - 'null' description: For transfers, the party that is paying the transaction. payment_method: type: - string - 'null' description: The type of transfer, e.g. 'ACH' payment_processor: type: - string - 'null' description: The name of the payment processor reason: type: - string - 'null' description: The payer-supplied description of the transfer. required: - reference_number - ppd_id - payee - by_order_of - payer - payment_method - payment_processor - reason TransferBalanceGetRequest: title: TransferBalanceGetRequest type: object description: Defines the request schema for `/transfer/balance/get` properties: client_id: $ref: '#/components/schemas/APIClientID' originator_client_id: deprecated: true x-hidden-from-docs: true type: - string - 'null' description: Client ID of the end customer. secret: $ref: '#/components/schemas/APISecret' type: $ref: '#/components/schemas/TransferBalanceType' FDXTimestamp: title: Timestamp description: ISO 8601 date-time in format 'YYYY-MM-DDThh:mm:ss.nnn[Z|[+|-]hh:mm]' according to [IETF RFC3339](https://xml2rfc.tools.ietf.org/public/rfc/html/rfc3339.html#anchor14) type: string format: date-time example: '2021-07-15T14:46:41.375Z' BeaconMatchSummaryCode: description: 'An enum indicating the match type between two Beacon Users. `match` indicates that the provided input data was a strong match against the other Beacon User. `partial_match` indicates the data approximately matched the other Beacon User. For example, "Knope" vs. "Knope-Wyatt" for last name. `no_match` indicates that Plaid was able to compare this field against the other Beacon User and it did not match the provided input data. `no_data` indicates that Plaid was unable to compare this field against the original Beacon User because the field was not present in one of the Beacon Users.' type: string title: BeaconMatchSummaryCode enum: - match - partial_match - no_match - no_data example: match IdentityVerificationResponseUserName: type: - object - 'null' properties: given_name: $ref: '#/components/schemas/GivenNameField' family_name: $ref: '#/components/schemas/FamilyNameField' required: - given_name - family_name description: The full name provided by the user. If the user has not submitted their name, this field will be null. Otherwise, both fields are guaranteed to be filled. additionalProperties: true PhysicalDocumentExtractedData: type: - object - 'null' description: Data extracted from a user-submitted document. properties: id_number: $ref: '#/components/schemas/PhysicalDocumentIDNumber' category: $ref: '#/components/schemas/PhysicalDocumentCategory' expiration_date: $ref: '#/components/schemas/ISO8601DateNullable' issuing_country: $ref: '#/components/schemas/GenericCountryCode' issuing_region: $ref: '#/components/schemas/Region' date_of_birth: $ref: '#/components/schemas/IdentityVerificationDocumentISO8601DateOfBirth' address: $ref: '#/components/schemas/IdentityVerificationDocumentAddressResponse' required: - id_number - category - expiration_date - issuing_country - issuing_region - date_of_birth - address additionalProperties: true IncomeVerificationPrecheckMilitaryInfo: title: IncomeVerificationPrecheckMilitaryInfo description: Data about military info in the income verification precheck. type: - object - 'null' properties: is_active_duty: type: - boolean - 'null' description: Is the user currently active duty in the US military branch: type: - string - 'null' description: 'If the user is currently serving in the US military, the branch of the military in which they are serving Valid values: ''AIR FORCE'', ''ARMY'', ''COAST GUARD'', ''MARINES'', ''NAVY'', ''UNKNOWN''' BeaconReportID: type: string title: BeaconReportID example: becrpt_11111111111111 description: ID of the associated Beacon Report. TransferFacilitatorFee: title: TransferFacilitatorFee type: string description: The amount to deduct from `transfer.amount` and distribute to the platform’s Ledger balance as a facilitator fee (decimal string with two digits of precision e.g. "10.00"). The remainder will go to the end-customer’s Ledger balance. This must be less than or equal to the `transfer.amount`. LinkTokenCreateRequestUserStatedIncomeSource: type: object description: Specifies user stated income sources for the Income product properties: employer: type: string description: The employer corresponding to an income source specified by the user category: $ref: '#/components/schemas/UserStatedIncomeSourceCategory' pay_per_cycle: type: number format: double description: The income amount paid per cycle for a specified income source pay_annual: type: number format: double description: The income amount paid annually for a specified income source pay_type: $ref: '#/components/schemas/UserStatedIncomeSourcePayType' pay_frequency: $ref: '#/components/schemas/UserStatedIncomeSourceFrequency' BeaconUserReviewRequest: description: Request input for updating the status of a Beacon User type: object properties: beacon_user_id: $ref: '#/components/schemas/BeaconUserID' status: $ref: '#/components/schemas/BeaconUserStatus' client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' required: - beacon_user_id - status PhysicalDocumentExtractedDataAnalysis: type: - object - 'null' description: Analysis of the data extracted from the submitted document. properties: name: $ref: '#/components/schemas/DocumentNameMatchCode' date_of_birth: $ref: '#/components/schemas/DocumentDateOfBirthMatchCode' expiration_date: $ref: '#/components/schemas/ExpirationDate' issuing_country: $ref: '#/components/schemas/IssuingCountry' required: - name - date_of_birth - expiration_date - issuing_country additionalProperties: true PartnerCustomerEnableRequest: description: Request schema for `/partner/customer/enable`. properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' end_customer_client_id: type: string required: - end_customer_client_id TransactionsUpdateStatus: title: TransactionsUpdateStatus type: string description: 'A description of the update status for transaction pulls of an Item. `TRANSACTIONS_UPDATE_STATUS_UNKNOWN`: Unable to fetch transactions update status for Item. `NOT_READY`: The Item is pending transaction pull. `INITIAL_UPDATE_COMPLETE`: Initial pull for the Item is complete, historical pull is pending. `HISTORICAL_UPDATE_COMPLETE`: Both initial and historical pull for Item are complete.' enum: - TRANSACTIONS_UPDATE_STATUS_UNKNOWN - NOT_READY - INITIAL_UPDATE_COMPLETE - HISTORICAL_UPDATE_COMPLETE BeaconProgramID: type: string title: BeaconProgramID example: becprg_11111111111111 description: ID of the associated Beacon Program. CreditUnofficialCurrencyCode: type: - string - 'null' description: 'The unofficial currency code associated with the amount or balance. Always `null` if `iso_currency_code` is non-null. Unofficial currency codes are used for currencies that do not have official ISO currency codes, such as cryptocurrencies and the currencies of certain countries.' BeaconUser: type: object title: BeaconUser description: A Beacon User represents an end user that has been scanned against the Beacon Network. properties: id: $ref: '#/components/schemas/BeaconUserID' version: type: integer description: The `version` field begins with 1 and increments each time the user is updated. example: 1 created_at: $ref: '#/components/schemas/Timestamp' updated_at: $ref: '#/components/schemas/UpdatedAtTimestamp' status: $ref: '#/components/schemas/BeaconUserStatus' program_id: $ref: '#/components/schemas/BeaconProgramID' client_user_id: $ref: '#/components/schemas/ClientUserID' user: $ref: '#/components/schemas/BeaconUserData' audit_trail: $ref: '#/components/schemas/BeaconAuditTrail' required: - id - version - created_at - updated_at - status - program_id - client_user_id - user - audit_trail additionalProperties: true CraBankIncome: type: object description: The report of the Bank Income data for an end user. properties: bank_income_id: type: string description: The unique identifier associated with the Bank Income Report. generated_time: type: string description: The time when the Bank Income Report was generated. format: date-time days_requested: type: integer description: The number of days requested by the customer for the Bank Income Report. items: type: array description: The list of Items in the report along with the associated metadata about the Item. items: $ref: '#/components/schemas/CraBankIncomeItem' bank_income_summary: $ref: '#/components/schemas/CraBankIncomeSummary' warnings: type: array description: If data from the Bank Income report was unable to be retrieved, the warnings will contain information about the error that caused the data to be incomplete. items: $ref: '#/components/schemas/CraBankIncomeWarning' TransferUserAddressInRequest: title: TransferUserAddressInRequest type: object description: The address associated with the account holder. properties: street: type: string description: The street number and name (i.e., "100 Market St."). city: type: string description: Ex. "San Francisco" region: type: string description: The state or province (e.g., "CA"). postal_code: type: string description: The postal code (e.g., "94103"). country: type: string description: A two-letter country code (e.g., "US"). LinkSessionBankIncomeResult: type: object description: The details of a bank income verification in Link. additionalProperties: true properties: status: $ref: '#/components/schemas/CreditSessionBankIncomeStatus' item_id: description: 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. type: string institution: $ref: '#/components/schemas/LinkSessionSuccessMetadataInstitution' required: - status - item_id - institution EntityDocumentType: type: string enum: - bik - business_number - imo - other - swift - tax_id title: EntityDocumentType example: swift description: 'The kind of official document represented by this object. `bik` - Russian bank code `business_number` - A number that uniquely identifies the business within a category of businesses `imo` - Number assigned to the entity by the International Maritime Organization `other` - Any document not covered by other categories `swift` - Number identifying a bank and branch. `tax_id` - Identification issued for the purpose of collecting taxes' RecurringTransfer: title: RecurringTransfer type: object additionalProperties: true description: Represents a recurring transfer within the Transfers API. properties: recurring_transfer_id: $ref: '#/components/schemas/RecurringTransferID' created: type: string format: date-time description: The datetime when this transfer was created. This will be of the form `2006-01-02T15:04:05Z` next_origination_date: type: - string - 'null' format: date description: 'A date in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format (YYYY-MM-DD). The next transfer origination date after bank holiday adjustment.' test_clock_id: type: - string - 'null' description: Plaid’s unique identifier for a test clock. type: $ref: '#/components/schemas/TransferType' amount: $ref: '#/components/schemas/TransferAmount' status: $ref: '#/components/schemas/TransferRecurringStatus' ach_class: $ref: '#/components/schemas/ACHClass' network: $ref: '#/components/schemas/TransferRecurringNetwork' origination_account_id: type: string description: Plaid’s unique identifier for the origination account that was used for this transfer. deprecated: true x-hidden-from-docs: true account_id: type: string description: The Plaid `account_id` corresponding to the end-user account that will be debited or credited. funding_account_id: $ref: '#/components/schemas/TransferFundingAccountIDResponse' iso_currency_code: type: string description: The currency of the transfer amount, e.g. "USD" description: type: string description: The description of the recurring transfer. transfer_ids: type: array items: $ref: '#/components/schemas/TransferID' user: $ref: '#/components/schemas/TransferUserInResponse' schedule: $ref: '#/components/schemas/TransferRecurringSchedule' required: - recurring_transfer_id - created - next_origination_date - type - amount - status - network - iso_currency_code - origination_account_id - funding_account_id - account_id - user - schedule - description - transfer_ids AssetReportRefreshAssetReportToken: title: AssetReportRefreshAssetReportToken type: string description: The `asset_report_token` returned by the original call to `/asset_report/create` EntityWatchlistScreeningHitID: type: string example: enthit_52xR9LKo77r1Np title: EntityWatchlistScreeningHitID description: ID of the associated entity screening hit. TransferSweepID: type: string title: TransferSweepID description: Plaid’s unique identifier for a sweep. AccountAssets: title: AccountAssets type: object additionalProperties: true description: Asset information about an account properties: account_id: type: string description: '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 `account_id` will be assigned to the account. The `account_id` can also change if the `access_token` is deleted and the same credentials that were used to generate that `access_token` are used to generate a new `access_token` on a later date. In that case, the new `account_id` will be different from the old `account_id`. If an account with a specific `account_id` disappears instead of changing, the account is likely closed. Closed accounts are not returned by the Plaid API. Like all Plaid identifiers, the `account_id` is case sensitive.' balances: $ref: '#/components/schemas/AssetReportAccountBalance' mask: type: - string - 'null' description: The last 2-4 alphanumeric characters of an account's official account number. Note that the mask may be non-unique between an Item's accounts, and it may also not match the mask that the bank displays to the user. name: type: string description: The name of the account, either assigned by the user or by the financial institution itself official_name: type: - string - 'null' description: The official name of the account as given by the financial institution type: $ref: '#/components/schemas/AccountType' subtype: $ref: '#/components/schemas/AccountSubtype' verification_status: type: string enum: - automatically_verified - pending_automatic_verification - pending_manual_verification - manually_verified - verification_expired - verification_failed - database_matched description: "The current verification status of an Auth Item initiated through Automated or Manual micro-deposits. Returned for Auth Items only.\n\n`pending_automatic_verification`: The Item is pending automatic verification\n\n`pending_manual_verification`: The Item is pending manual micro-deposit verification. Items remain in this state until the user successfully verifies the micro-deposit.\n\n`automatically_verified`: The Item has successfully been automatically verified\t\n\n`manually_verified`: The Item has successfully been manually verified\n\n`verification_expired`: Plaid was unable to automatically verify the deposit within 7 calendar days and will no longer attempt to validate the Item. Users may retry by submitting their information again through Link.\n\n`verification_failed`: The Item failed manual micro-deposit verification because the user exhausted all 3 verification attempts. Users may retry by submitting their information again through Link.\n\n`database_matched`: The Item has successfully been verified using Plaid's data sources. Note: Database Match is currently a beta feature, please contact your account manager for more information.\t\n\t" persistent_account_id: type: string description: 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 is currently an opt-in field and only supported for Chase Items. days_available: type: number description: The duration of transaction history available for this Item, typically defined as the time since the date of the earliest transaction in that account. transactions: type: array description: Transaction history associated with the account. items: $ref: '#/components/schemas/AssetReportTransaction' investments: $ref: '#/components/schemas/AssetReportInvestments' owners: type: array description: Data returned by the financial institution about the account owner or owners.For business accounts, the name reported may be either the name of the individual or the name of the business, depending on the institution. Multiple owners on a single account will be represented in the same `owner` object, not in multiple owner objects within the array. In API versions 2018-05-22 and earlier, the `owners` object is not returned, and instead identity information is returned in the top level `identity` object. For more details, see [Plaid API versioning](https://plaid.com/docs/api/versioning/#version-2019-05-29) items: $ref: '#/components/schemas/Owner' ownership_type: $ref: '#/components/schemas/OwnershipType' historical_balances: type: array description: Calculated data about the historical balances on the account. items: $ref: '#/components/schemas/HistoricalBalance' required: - account_id - balances - mask - name - official_name - type - subtype - days_available - transactions - owners - historical_balances PartnerCustomerGetResponse: description: Response schema for `/partner/customer/get`. type: object additionalProperties: true properties: end_customer: $ref: '#/components/schemas/PartnerEndCustomer' request_id: $ref: '#/components/schemas/RequestID' EntityWatchlistScreeningHit: type: object description: Data from a government watchlist that has been attached to the screening. title: EntityWatchlistScreeningHit properties: id: $ref: '#/components/schemas/EntityWatchlistScreeningHitID' review_status: $ref: '#/components/schemas/WatchlistScreeningHitStatus' first_active: $ref: '#/components/schemas/Timestamp' inactive_since: $ref: '#/components/schemas/TimestampNullable' historical_since: $ref: '#/components/schemas/TimestampNullable' list_code: $ref: '#/components/schemas/EntityWatchlistCode' plaid_uid: $ref: '#/components/schemas/InternalUID' source_uid: $ref: '#/components/schemas/SourceUID' analysis: $ref: '#/components/schemas/EntityScreeningHitAnalysis' data: $ref: '#/components/schemas/EntityScreeningHitData' required: - id - review_status - first_active - inactive_since - historical_since - list_code - plaid_uid - source_uid additionalProperties: true RiskSignalDocumentStatus: title: RiskSignalDocumentStatus type: string description: Status of a document for risk signal analysis enum: - PROCESSING - PROCESSING_COMPLETE - PROCESSING_ERROR - PASSWORD_PROTECTED - VIRUS_DETECTED WatchlistScreeningDocument: title: WatchlistScreeningDocument type: object description: An official document, usually issued by a governing body or institution, with an associated identifier. properties: type: $ref: '#/components/schemas/WatchlistScreeningDocumentType' number: $ref: '#/components/schemas/WatchlistScreeningDocumentValue' required: - type - number additionalProperties: true CreditSessionError: type: object description: The details of a Link error. properties: error_type: type: string description: A broad categorization of the error. error_code: description: The particular error code. type: string error_message: description: A developer-friendly representation of the error code. type: string display_message: description: A user-friendly representation of the error code. `null` if the error is not related to user action. type: - string - 'null' PhoneNumberMatchScore: title: PhoneNumberMatchScore type: - object - 'null' additionalProperties: true description: Score found by matching phone number provided by the API with the phone number on the account at the financial institution. 100 is a perfect match and 0 is a no match. If the account contains multiple owners, the maximum match score is filled. properties: score: type: - integer - 'null' description: Match score for normalized phone number. 100 is a perfect match, 99-70 is a partial match (matching the same phone number with extension against one without extension, etc.), anything below 70 is considered a mismatch. Typically, the match threshold should be set to a score of 70 or higher. If the phone number is missing from either the API or financial institution, this is null. AccountIdentityDocumentUpload: description: Identity information about an account title: AccountIdentityDocumentUpload allOf: - $ref: '#/components/schemas/AccountBase' - type: object additionalProperties: true properties: owners: type: array description: Data returned by the financial institution about the account owner or owners. Only returned by Identity or Assets endpoints. For business accounts, the name reported may be either the name of the individual or the name of the business, depending on the institution; detecting whether the linked account is a business account is not currently supported. Multiple owners on a single account will be represented in the same `owner` object, not in multiple owner objects within the array. In API versions 2018-05-22 and earlier, the `owners` object is not returned, and instead identity information is returned in the top level `identity` object. For more details, see [Plaid API versioning](https://plaid.com/docs/api/versioning/#version-2019-05-29) items: $ref: '#/components/schemas/Owner' documents: type: - array - 'null' description: An array of document with which the Identity data is derived from. items: $ref: '#/components/schemas/IdentityDocumentUpload' x-hidden-from-docs: true required: - owners WatchlistScreeningIndividualCreateRequest: type: object description: Request input for creating an individual watchlist screening properties: search_terms: $ref: '#/components/schemas/WatchlistScreeningRequestSearchTerms' client_user_id: $ref: '#/components/schemas/ClientUserID' client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' required: - search_terms SandboxTransferTestClockGetRequest: title: SandboxTransferTestClockGetRequest type: object description: Defines the request schema for `/sandbox/transfer/test_clock/get` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' test_clock_id: $ref: '#/components/schemas/TransferTestClockID' required: - test_clock_id TransactionsGetResponse: type: object additionalProperties: true description: TransactionsGetResponse defines the response schema for `/transactions/get` properties: accounts: type: array description: An array containing the `accounts` associated with the Item for which transactions are being returned. Each transaction can be mapped to its corresponding account via the `account_id` field. items: $ref: '#/components/schemas/AccountBase' transactions: type: array description: An array containing transactions from the account. Transactions are returned in reverse chronological order, with the most recent at the beginning of the array. The maximum number of transactions returned is determined by the `count` parameter. items: $ref: '#/components/schemas/Transaction' total_transactions: type: integer description: The total number of transactions available within the date range specified. If `total_transactions` is larger than the size of the `transactions` array, more transactions are available and can be fetched via manipulating the `offset` parameter. item: $ref: '#/components/schemas/Item' request_id: $ref: '#/components/schemas/RequestID' required: - accounts - transactions - total_transactions - item - request_id IdentityVerificationUserAddress: description: 'Even if an address has been collected, some fields may be null depending on the region''s addressing system. For example: Addresses from the United Kingdom will not include a region Addresses from Hong Kong will not include postal code' type: - object - 'null' properties: street: $ref: '#/components/schemas/StreetNullable' street2: $ref: '#/components/schemas/Street2' city: $ref: '#/components/schemas/CityNullable' region: $ref: '#/components/schemas/Region' postal_code: $ref: '#/components/schemas/PostalCode' country: $ref: '#/components/schemas/GenericCountryCode' required: - street - street2 - city - region - postal_code - country additionalProperties: true ProfileGetRequest: description: ProfileGetRequest defines the request schema for `/profile/get` x-hidden-from-docs: true type: object properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' profile_token: type: string description: The profile token generated by the end user authorization session. required: - client_id - secret - profile_token SelfieAnalysisDocumentComparison: type: string enum: - match - no_match - no_input description: Information about the comparison between the selfie and the document (if documentary verification also ran). TransferRecurringGetRequest: title: TransferRecurringGetRequest type: object description: Defines the request schema for `/transfer/recurring/get` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' recurring_transfer_id: $ref: '#/components/schemas/RecurringTransferID' required: - recurring_transfer_id EmploymentVerificationGetRequest: title: EmploymentVerificationGetRequest type: object description: EmploymentVerificationGetRequest defines the request schema for `/employment/verification/get`. properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' access_token: $ref: '#/components/schemas/AccessToken' required: - access_token SignalScore: description: 'A score from 1-99 that indicates the transaction return risk: a higher risk score suggests a higher return likelihood.' type: integer minimum: 1 maximum: 99 CreditFreddieMacVerificationOfAssetsDeal: title: CreditFreddieMacVerificationOfAssetsDeal type: object additionalProperties: true description: An object representing an Asset Report with Freddie Mac schema. properties: LOANS: $ref: '#/components/schemas/CreditFreddieMacLoans' PARTIES: $ref: '#/components/schemas/CreditFreddieMacParties' SERVICES: $ref: '#/components/schemas/CreditFreddieMacServices' required: - LOANS - PARTIES - SERVICES ProcessorSignalDecisionReportResponse: title: ProcessorSignalDecisionReportResponse description: ProcessorSignalDecisionReportResponse defines the response schema for `/processor/signal/decision/report` additionalProperties: true type: object properties: request_id: $ref: '#/components/schemas/RequestID' required: - request_id AssetReportGetRequestOptions: type: object description: An optional object to filter or add data to `/asset_report/get` results. If provided, must be non-`null`. properties: days_to_include: type: - integer - 'null' maximum: 731 minimum: 0 description: The maximum number of days of history to include in the Asset Report. SandboxPaymentProfileResetLoginRequest: type: object description: SandboxPaymentProfileResetLoginRequest defines the request schema for `/sandbox/payment_profile/reset_login` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' payment_profile_token: $ref: '#/components/schemas/PaymentProfileToken' required: - payment_profile_token TransferCancelRequest: title: TransferCancelRequest type: object description: Defines the request schema for `/transfer/cancel` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' transfer_id: $ref: '#/components/schemas/TransferID' originator_client_id: deprecated: true x-hidden-from-docs: true type: - string - 'null' description: The Plaid client ID of the transfer originator. Should only be present if `client_id` is a third-party sender (TPS). required: - transfer_id ProcessorBankTransferCreateRequest: title: ProcessorBankTransferCreateRequest type: object description: Defines the request schema for `/processor/bank_transfer/create` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' idempotency_key: $ref: '#/components/schemas/BankTransferIdempotencyKey' processor_token: $ref: '#/components/schemas/ProcessorToken' type: $ref: '#/components/schemas/BankTransferType' network: $ref: '#/components/schemas/BankTransferNetwork' amount: $ref: '#/components/schemas/BankTransferAmount' iso_currency_code: type: string description: The currency of the transfer amount – should be set to "USD". description: type: string description: The transfer description. Maximum of 10 characters. maxLength: 10 ach_class: $ref: '#/components/schemas/ACHClass' user: $ref: '#/components/schemas/BankTransferUser' custom_tag: type: - string - 'null' maxLength: 100 description: An arbitrary string provided by the client for storage with the bank transfer. May be up to 100 characters. metadata: $ref: '#/components/schemas/BankTransferMetadata' origination_account_id: type: - string - 'null' description: Plaid’s unique identifier for the origination account for this transfer. If you have more than one origination account, this value must be specified. required: - idempotency_key - processor_token - type - network - amount - iso_currency_code - description - user ActivityType: type: string description: Types of consent activities enum: - UNKNOWN - ITEM_CREATE - ITEM_IMPORT - ITEM_UPDATE - ITEM_UNLINK - PORTAL_UNLINK - PORTAL_ITEMS_DELETE - ITEM_REMOVE - INVARIANT_CHECKER_DELETION - SCOPES_UPDATE ApplicationGetRequest: description: ApplicationGetRequest defines the schema for `/application/get` type: object properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' application_id: $ref: '#/components/schemas/ApplicationID' required: - client_id - secret - application_id WatchlistScreeningIndividualUpdateRequest: type: object description: Request input for editing an individual watchlist screening properties: watchlist_screening_id: $ref: '#/components/schemas/WatchlistScreeningIndividualID' search_terms: $ref: '#/components/schemas/UpdateIndividualScreeningRequestSearchTerms' assignee: $ref: '#/components/schemas/DashboardUserID' status: $ref: '#/components/schemas/WatchlistScreeningStatus' client_user_id: $ref: '#/components/schemas/ClientUserID' client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' reset_fields: $ref: '#/components/schemas/WatchlistScreeningIndividualUpdateRequestResettableFieldList' required: - watchlist_screening_id PaymentProfileCreateResponse: type: object additionalProperties: true description: PaymentProfileCreateResponse defines the response schema for `/payment_profile/create` properties: payment_profile_token: $ref: '#/components/schemas/PaymentProfileToken' request_id: $ref: '#/components/schemas/RequestID' required: - payment_profile_token - request_id LinkTokenCreateRequestAuth: type: object description: Specifies options for initializing Link for use with the Auth product. This field can be used to enable or disable extended Auth flows for the resulting Link session. Omitting any field will result in a default that can be configured by your account manager. The default behavior described in the documentation is the default behavior that will apply if you have not requested your account manager to apply a different default. properties: auth_type_select_enabled: type: boolean description: Specifies whether Auth Type Select is enabled for the Link session, allowing the end user to choose between linking via a credentials-based flow (i.e. Instant Auth, Instant Match, Automated Micro-deposits) or a manual flow that does not require login (all other Auth flows) prior to selecting their financial institution. Default behavior is `false`. automated_microdeposits_enabled: type: boolean description: Specifies whether the Link session is enabled for the Automated Micro-deposits flow. Default behavior is `false`. instant_match_enabled: type: boolean description: Specifies whether the Link session is enabled for the Instant Match flow. Instant Match is enabled by default. Instant Match can be disabled by setting this field to `false`. same_day_microdeposits_enabled: type: boolean description: Specifies whether the Link session is enabled for the Same Day Micro-deposits flow. Default behavior is `false`. instant_microdeposits_enabled: type: boolean description: Specifies whether the Link session is enabled for the Instant Micro-deposits flow. Default behavior for Plaid teams created after November 2023 is `false`; default behavior for Plaid teams created before that date is `true`. reroute_to_credentials: type: string enum: - 'OFF' - OPTIONAL - FORCED description: Specifies what type of [Reroute to Credentials](https://plaid.com/docs/auth/coverage/same-day/#reroute-to-credentials) pane should be used in the Link session for the Same Day Micro-deposits flow. Default behavior is `OPTIONAL`. database_match_enabled: type: boolean description: Specifies whether the Link session is enabled for the Database Match flow. Default behavior is `false`. database_insights_enabled: type: boolean description: Specifies whether the Link session is enabled for the Database Insights flow. Database Insights is currently in closed beta; for access, contact your Account Manager. Default behavior is `false`. flow_type: type: string enum: - FLEXIBLE_AUTH description: This field has been deprecated in favor of `auth_type_select_enabled`. deprecated: true x-plaid-hidden-from-docs: true sms_microdeposits_verification_enabled: type: boolean description: Specifies whether the Link session is enabled for SMS micro-deposits verification. Default behavior is `true`. PrismInsightsResult: type: object title: PrismInsightsResult description: The Insights Result object is a map of cash flow attributes, where the key is a string, and the value is a float or string. Roles: title: Roles type: object additionalProperties: true description: Documentation not found in the MISMO model viewer and not provided by Freddie Mac. properties: ROLE: $ref: '#/components/schemas/Role' required: - ROLE SandboxProcessorTokenCreateRequestOptions: type: object description: An optional set of options to be used when configuring the Item. If specified, must not be `null`. properties: override_username: $ref: '#/components/schemas/SandboxOverrideUsername' override_password: $ref: '#/components/schemas/SandboxOverridePassword' CreditBankStatementsUploadsGetRequestOptions: description: An optional object for `/credit/bank_statements/uploads/get` request options. type: object properties: item_ids: type: array description: An array of `item_id`s whose bank statements information is returned. Each `item_id` should uniquely identify a bank statements uploaded item. If this field is not provided, all `item_id`s associated with the `user_token` will returned in the response. items: type: string TransferIntentCreateNetwork: type: string title: TransferIntentCreateNetwork description: 'The network or rails used for the transfer. Defaults to `same-day-ach`. For transfers submitted as `ach`, the next-day cutoff is 5:30 PM Eastern Time. For transfers submitted as `same-day-ach`, the same-day cutoff is 3:30 PM Eastern Time. If the transfer is submitted after this cutoff but before the next-day cutoff, it will be sent over next-day rails and will not incur same-day charges; this will apply to both legs of the transfer if applicable.' enum: - ach - same-day-ach default: same-day-ach PartnerEndCustomerOAuthInstitutionEnvironments: description: Registration statuses by environment. type: object additionalProperties: true properties: development: $ref: '#/components/schemas/PartnerEndCustomerOAuthInstitutionApplicationStatus' production: $ref: '#/components/schemas/PartnerEndCustomerOAuthInstitutionApplicationStatus' SandboxOverridePassword: type: - string - 'null' default: pass_good description: Test password to use for the creation of the Sandbox Item. Default value is `pass_good`. InvestmentTransaction: title: InvestmentTransaction type: object additionalProperties: true description: A transaction within an investment account. properties: investment_transaction_id: type: string description: The ID of the Investment transaction, unique across all Plaid transactions. Like all Plaid identifiers, the `investment_transaction_id` is case sensitive. cancel_transaction_id: type: - string - 'null' deprecated: true description: A legacy field formerly used internally by Plaid to identify certain canceled transactions. account_id: type: string description: The `account_id` of the account against which this transaction posted. security_id: type: - string - 'null' description: The `security_id` to which this transaction is related. date: type: string format: date description: The [ISO 8601](https://wikipedia.org/wiki/ISO_8601) posting date for the transaction. name: type: string description: The institution’s description of the transaction. quantity: type: number format: double description: The number of units of the security involved in this transaction. Positive for buy transactions; negative for sell transactions. amount: description: 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. type: number format: double price: description: The price of the security at which this transaction occurred. type: number format: double fees: type: - number - 'null' format: double description: The combined value of all fees applied to this transaction type: $ref: '#/components/schemas/InvestmentTransactionType' subtype: $ref: '#/components/schemas/InvestmentTransactionSubtype' iso_currency_code: type: - string - 'null' description: The ISO-4217 currency code of the transaction. Always `null` if `unofficial_currency_code` is non-`null`. unofficial_currency_code: type: - string - 'null' description: 'The unofficial currency code associated with the holding. Always `null` if `iso_currency_code` is non-`null`. Unofficial currency codes are used for currencies that do not have official ISO currency codes, such as cryptocurrencies and the currencies of certain countries. See the [currency code schema](https://plaid.com/docs/api/accounts#currency-code-schema) for a full listing of supported `iso_currency_code`s.' required: - investment_transaction_id - account_id - security_id - date - name - quantity - amount - price - fees - type - subtype - iso_currency_code - unofficial_currency_code LinkTokenCreateCardSwitch: type: object description: A map containing data to pass in for the Card Switch flow. x-hidden-from-docs: true properties: card_bin: type: string description: The BIN (Bank Identification Number) of the card to switch. required: - card_bin SandboxBankIncomeFireWebhookResponse: title: SandboxBankIncomeFireWebhookResponse additionalProperties: true type: object description: SandboxBankIncomeFireWebhookResponse defines the response schema for `/sandbox/bank_income/fire_webhook` properties: request_id: $ref: '#/components/schemas/RequestID' required: - request_id DeductionsBreakdown: title: DeductionsBreakdown type: object additionalProperties: true description: An object representing the deduction line items for the pay period properties: current_amount: type: - number - 'null' format: double description: Raw amount of the deduction description: type: - string - 'null' description: Description of the deduction line item iso_currency_code: type: - string - 'null' description: The ISO-4217 currency code of the line item. Always `null` if `unofficial_currency_code` is non-null. unofficial_currency_code: type: - string - 'null' description: 'The unofficial currency code associated with the line item. Always `null` if `iso_currency_code` is non-`null`. Unofficial currency codes are used for currencies that do not have official ISO currency codes, such as cryptocurrencies and the currencies of certain countries. See the [currency code schema](https://plaid.com/docs/api/accounts#currency-code-schema) for a full listing of supported `iso_currency_code`s.' ytd_amount: type: - number - 'null' format: double description: The year-to-date amount of the deduction CreditFreddieMacService: title: CreditFreddieMacService type: object additionalProperties: true description: A collection of details related to a fulfillment service or product in terms of request, process and result. properties: VERIFICATION_OF_ASSET: type: array items: $ref: '#/components/schemas/CreditFreddieMacVerificationOfAsset' STATUSES: $ref: '#/components/schemas/Statuses' required: - VERIFICATION_OF_ASSET - STATUSES BeaconDuplicateID: type: string title: BeaconDuplicateID example: becdup_11111111111111 description: ID of the associated Beacon Duplicate. LinkTokenCreateRequestIncomeVerificationPayrollIncome: title: LinkTokenCreateRequestIncomeVerificationPayrollIncome type: object description: Specifies options for initializing Link for use with Payroll Income (including Document Income). Further customization options for Document Income, such as customizing which document types may be uploaded, are also available via the [Link Customization pane](https://dashboard.plaid.com/link) in the Dashboard. (Requires Production enablement.) properties: flow_types: type: - array - 'null' description: The types of payroll income verification to enable for the Link session. If none are specified, then users will see both document and digital payroll income. items: $ref: '#/components/schemas/IncomeVerificationPayrollFlowType' is_update_mode: type: boolean description: An identifier to indicate whether the income verification Link token will be used for update mode. This field is only relevant for participants in the Payroll Income Refresh beta. default: false item_id_to_update: type: - string - 'null' description: Uniquely identify a payroll income Item to update with. This field is only relevant for participants in the Payroll Income Refresh beta. parsing_config: type: - array - 'null' description: The types of analysis to enable for document uploads. If this field is not provided, then docs will undergo OCR parsing only. items: $ref: '#/components/schemas/IncomeVerificationDocParsingConfig' CreditFreddieMacAssetTransactions: title: CreditFreddieMacAssetTransactions type: object additionalProperties: true description: Documentation not found in the MISMO model viewer and not provided by Freddie Mac. properties: ASSET_TRANSACTION: type: array items: $ref: '#/components/schemas/CreditFreddieMacAssetTransaction' required: - ASSET_TRANSACTION ProcessorTransactionsSyncResponse: type: object additionalProperties: true description: ProcessorTransactionsSyncResponse defines the response schema for `/processor/transactions/sync` properties: transactions_update_status: $ref: '#/components/schemas/TransactionsUpdateStatus' account: $ref: '#/components/schemas/AccountBase' added: type: array description: Transactions that have been added to the Item since `cursor` ordered by ascending last modified time. items: $ref: '#/components/schemas/Transaction' modified: type: array description: Transactions that have been modified on the Item since `cursor` ordered by ascending last modified time. items: $ref: '#/components/schemas/Transaction' removed: type: array description: Transactions that have been removed from the Item since `cursor` ordered by ascending last modified time. items: $ref: '#/components/schemas/RemovedTransaction' next_cursor: type: string description: Cursor used for fetching any future updates after the latest update provided in this response. The cursor obtained after all pages have been pulled (indicated by `has_more` being `false`) will be valid for at least 1 year. This cursor should be persisted for later calls. If transactions are not yet available, this will be an empty string. has_more: type: boolean description: Represents if more than requested count of transaction updates exist. If true, the additional updates can be fetched by making an additional request with `cursor` set to `next_cursor`. If `has_more` is true, it’s important to pull all available pages, to make it less likely for underlying data changes to conflict with pagination. request_id: $ref: '#/components/schemas/RequestID' required: - account - added - modified - removed - next_cursor - has_more - request_id - transactions_update_status LinkDeliveryCreateRequest: type: object description: LinkDeliveryCreateRequest defines the request schema for `/link_delivery/create` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' link_token: type: string description: A `link_token` from a previous invocation of `/link/token/create`. options: $ref: '#/components/schemas/LinkDeliveryOptions' required: - link_token AccountBase: title: Account type: object additionalProperties: true description: A single account at a financial institution. x-examples: example-1: {} properties: account_id: type: string description: '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 `account_id` will be assigned to the account. The `account_id` can also change if the `access_token` is deleted and the same credentials that were used to generate that `access_token` are used to generate a new `access_token` on a later date. In that case, the new `account_id` will be different from the old `account_id`. If an account with a specific `account_id` disappears instead of changing, the account is likely closed. Closed accounts are not returned by the Plaid API. Like all Plaid identifiers, the `account_id` is case sensitive.' balances: $ref: '#/components/schemas/AccountBalance' mask: type: - string - 'null' description: The last 2-4 alphanumeric characters of an account's official account number. Note that the mask may be non-unique between an Item's accounts, and it may also not match the mask that the bank displays to the user. name: type: string description: The name of the account, either assigned by the user or by the financial institution itself official_name: type: - string - 'null' description: The official name of the account as given by the financial institution type: $ref: '#/components/schemas/AccountType' subtype: $ref: '#/components/schemas/AccountSubtype' verification_status: type: string enum: - automatically_verified - pending_automatic_verification - pending_manual_verification - manually_verified - verification_expired - verification_failed - database_matched - database_insights_pass - database_insights_pass_with_caution - database_insights_fail description: "The current verification status of an Auth Item initiated through Automated or Manual micro-deposits. Returned for Auth Items only.\n\n`pending_automatic_verification`: The Item is pending automatic verification\n\n`pending_manual_verification`: The Item is pending manual micro-deposit verification. Items remain in this state until the user successfully verifies the micro-deposit.\n\n`automatically_verified`: The Item has successfully been automatically verified\t\n\n`manually_verified`: The Item has successfully been manually verified\n\n`verification_expired`: Plaid was unable to automatically verify the deposit within 7 calendar days and will no longer attempt to validate the Item. Users may retry by submitting their information again through Link.\n\n`verification_failed`: The Item failed manual micro-deposit verification because the user exhausted all 3 verification attempts. Users may retry by submitting their information again through Link.\n\n`database_matched`: The Item has successfully been verified using Plaid's data sources.\n\n`database_insights_pass`: The Item's ACH numbers have been verified using Plaid's data sources and have strong signal for being valid. Note: Database Insights is currently a beta feature, please contact your account manager for more information.\n\n`database_insights_pass_with_caution`: The Item's ACH numbers have been verified using Plaid's data sources and have some signal for being valid. Note: Database Insights is currently a beta feature, please contact your account manager for more information.\n\n`database_insights_fail`: The Item's ACH numbers have been verified using Plaid's data sources and have signal for being invalid and/or have no signal for being valid. Note: Database Insights is currently a beta feature, please contact your account manager for more information.\t\n\t" verification_insights: $ref: '#/components/schemas/AccountVerificationInsights' persistent_account_id: type: string description: 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 is currently only supported for Chase Items. Because Chase accounts have a different account number each time they are linked, this field may be used instead of the account number to uniquely identify a Chase account across multiple Items for payments use cases, helping to reduce duplicate Items or attempted fraud. In Sandbox, this field may be populated for any account; in Production and Development, it will only be populated for Chase accounts. required: - account_id - balances - mask - name - official_name - type - subtype FinancialInstitutionInsights: type: object description: Insights surrounding external financial institution counterparties associated with a user. properties: name: type: string description: Name of the financial institution counterparty. entity_id: type: - string - 'null' description: A unique, stable, Plaid-generated id that maps to the counterparty. website: type: - string - 'null' description: The website associated with the counterparty. detected_accounts: type: array description: Associated accounts, detected based on the nature of transfers to/from this institution. items: $ref: '#/components/schemas/DetectedAccount' required: - name - website - detected_accounts ClientProvidedTransactionLocation: title: ClientProvidedTransactionLocation type: object description: 'A representation of where a transaction took place. Use this field to pass in structured location information you may have about your transactions. Providing location data is optional but can increase result quality. If you have unstructured location information, it may be appended to the `description` field.' additionalProperties: true properties: country: type: string description: The country where the transaction occurred. region: type: string description: The region or state where the transaction occurred. city: type: string description: The city where the transaction occurred. address: type: string description: The street address where the transaction occurred. postal_code: type: string description: The postal code where the transaction occurred. DashboardUserGetRequest: description: Request input for fetching a dashboard user type: object properties: dashboard_user_id: $ref: '#/components/schemas/DashboardUserID' secret: $ref: '#/components/schemas/APISecret' client_id: $ref: '#/components/schemas/APIClientID' required: - dashboard_user_id RiskCheckDevice: description: Result summary object specifying values for `device` attributes of risk check. type: object properties: ip_proxy_type: $ref: '#/components/schemas/ProxyType' ip_spam_list_count: example: 1 description: Count of spam lists the IP address is associated with if known. type: - integer - 'null' ip_timezone_offset: $ref: '#/components/schemas/UTCOffset' required: - ip_proxy_type - ip_spam_list_count - ip_timezone_offset additionalProperties: true CreditPayrollIncomeGetRequest: title: CreditPayrollIncomeGetRequest type: object description: CreditPayrollIncomeGetRequest defines the request schema for `/credit/payroll_income/get`. properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' user_token: $ref: '#/components/schemas/UserToken' options: $ref: '#/components/schemas/CreditPayrollIncomeGetRequestOptions' PayrollIncomeRateOfPay: title: PayrollIncomeRateOfPay type: object additionalProperties: true description: An object representing the rate at which an individual is paid. properties: pay_rate: type: - string - 'null' description: The rate at which an employee is paid. x-override-enum-values-shown: - ANNUAL - HOURLY - CONTRACT - WEEKLY - BI_WEEKLY - MONTHLY - SEMI_MONTHLY - DAILY - COMMISSION - OTHER - null pay_amount: type: - number - 'null' format: double description: The amount at which an employee is paid. PayPeriodDetails: title: PayPeriodDetails type: object additionalProperties: true description: Details about the pay period. properties: check_amount: type: - number - 'null' format: double description: The amount of the paycheck. distribution_breakdown: type: array items: $ref: '#/components/schemas/DistributionBreakdown' end_date: type: - string - 'null' format: date description: 'The pay period end date, in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format: "yyyy-mm-dd".' gross_earnings: type: - number - 'null' format: double description: Total earnings before tax/deductions. pay_date: type: - string - 'null' format: date description: The date on which the paystub was issued, in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format ("yyyy-mm-dd"). pay_frequency: $ref: '#/components/schemas/PayPeriodDetailsPayFrequency' pay_day: deprecated: true type: - string - 'null' format: date description: The date on which the paystub was issued, in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format ("yyyy-mm-dd"). start_date: type: - string - 'null' format: date description: 'The pay period start date, in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format: "yyyy-mm-dd".' PayrollIncomeAccountData: title: PayrollIncomeAccountData type: - object - 'null' additionalProperties: true description: An object containing account level data. properties: account_id: type: - string - 'null' description: ID of the payroll provider account. rate_of_pay: $ref: '#/components/schemas/PayrollIncomeRateOfPay' pay_frequency: type: - string - 'null' description: The frequency at which an individual is paid. x-override-enum-values-shown: - DAILY - WEEKLY - BIWEEKLY - SEMI_MONTHLY - MONTHLY - CONTRACT - QUARTERLY - SEMI_ANNUALLY - ANNUALLY - OTHER - null required: - account_id - rate_of_pay - pay_frequency ProcessorSignalEvaluateRequest: title: ProcessorSignalEvaluateRequest description: ProcessorSignalEvaluateRequest defines the request schema for `/processor/signal/evaluate` type: object properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' processor_token: $ref: '#/components/schemas/ProcessorToken' client_transaction_id: type: string description: The unique ID that you would like to use to refer to this transaction. For your convenience mapping your internal data, you could use your internal ID/identifier for this transaction. The max length for this field is 36 characters. minLength: 1 maxLength: 36 amount: type: number format: double description: The transaction amount, in USD (e.g. `102.05`) user_present: type: - boolean - 'null' description: '`true` if the end user is present while initiating the ACH transfer and the endpoint is being called; `false` otherwise (for example, when the ACH transfer is scheduled and the end user is not present, or you call this endpoint after the ACH transfer but before submitting the Nacha file for ACH processing).' client_user_id: type: string description: A unique ID that identifies the end user in your system. This ID is used to correlate requests by a user with multiple Items. Personally identifiable information, such as an email address or phone number, should not be used in the `client_user_id`. is_recurring: type: - boolean - 'null' description: '**true** if the ACH transaction is a recurring transaction; **false** otherwise ' default_payment_method: type: - string - 'null' description: 'The default ACH or non-ACH payment method to complete the transaction. `SAME_DAY_ACH`: Same Day ACH by NACHA. The debit transaction is processed and settled on the same day `NEXT_DAY_ACH`: Next Day ACH settlement for debit transactions, offered by some payment processors `STANDARD_ACH`: standard ACH by NACHA `REAL_TIME_PAYMENTS`: real-time payments such as RTP and FedNow `DEBIT_CARD`: if the default payment is over debit card networks `MULTIPLE_PAYMENT_METHODS`: if there is no default debit rail or there are multiple payment methods Possible values: `SAME_DAY_ACH`, `NEXT_DAY_ACH`, `STANDARD_ACH`, `REAL_TIME_PAYMENTS`, `DEBIT_CARD`, `MULTIPLE_PAYMENT_METHODS`' user: $ref: '#/components/schemas/SignalUser' device: $ref: '#/components/schemas/SignalDevice' required: - processor_token - client_transaction_id - amount IdempotencyFlag: type: - boolean - 'null' example: true title: IdempotencyFlag description: 'An optional flag specifying how you would like Plaid to handle attempts to create an Identity Verification when an Identity Verification already exists for the provided `client_user_id` and `template_id`. If idempotency is enabled, Plaid will return the existing Identity Verification. If idempotency is disabled, Plaid will reject the request with a `400 Bad Request` status code if an Identity Verification already exists for the supplied `client_user_id` and `template_id`.' TransferRefundCreateRequest: title: TransferRefundCreateRequest type: object description: Defines the request schema for `/transfer/refund/create` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' transfer_id: $ref: '#/components/schemas/TransferIDForRefund' amount: $ref: '#/components/schemas/TransferRefundAmount' idempotency_key: $ref: '#/components/schemas/TransferRefundIdempotencyKey' required: - transfer_id - idempotency_key - amount Employee: title: Employee type: object additionalProperties: true description: Data about the employee. properties: address: $ref: '#/components/schemas/PaystubAddress' name: type: - string - 'null' description: The name of the employee. marital_status: type: - string - 'null' description: Marital status of the employee - either `single` or `married`. x-override-enum-values-shown: - single - married taxpayer_id: $ref: '#/components/schemas/TaxpayerID' required: - name - address CreditDocumentMetadata: title: CreditDocumentMetadata type: object additionalProperties: true description: Object representing metadata pertaining to the document. properties: name: type: string description: The name of the document. document_type: $ref: '#/components/schemas/CreditDocumentType' download_url: type: - string - 'null' description: 'Signed URL to retrieve the underlying file. For Payroll Income, the file type will always be PDF, and the file may not be available, in which case the field will be `null`. If you would like Plaid to generate a PDF if the original is not available, contact your Account Manager. [Example generated pay stub](https://www.plaid.com/documents/plaid-generated-mock-paystub.pdf). For Document Income, this field will not be `null`, and the file type will be the original file type uploaded by the user. For more details on available file types, see the [Document Income](https://www.plaid.com/docs/income/payroll-income) documentation. This download URL can only be used once and expires after two minutes. To generate a new download URL, call `/credit/payroll_income/get` again.' status: type: - string - 'null' description: 'The processing status of the document. `PROCESSING_COMPLETE`: The document was successfully processed. `DOCUMENT_ERROR`: The document could not be processed. Possible causes include: The document was an unacceptable document type such as an offer letter or bank statement, the document image was cropped or blurry, or the document was corrupted. `UNKNOWN` or `null`: An internal error occurred. If this happens repeatedly, contact support or your Plaid account manager.' x-override-enum-values-shown: - UNKNOWN - PROCESSING_COMPLETE - DOCUMENT_ERROR - null page_count: type: - integer - 'null' description: The number of pages of the uploaded document (if available). required: - name - document_type - download_url - status PaymentChannel: title: Transaction Payment Channel type: string enum: - online - in store - other description: 'The channel used to make a payment. `online:` transactions that took place online. `in store:` transactions that were made at a physical location. `other:` transactions that relate to banks, e.g. fees or deposits.' WatchlistScreeningIndividualUpdateResponse: description: 'The screening object allows you to represent a customer in your system, update their profile, and search for them on various watchlists. Note: Rejected customers will not receive new hits, regardless of program configuration.' additionalProperties: true properties: id: $ref: '#/components/schemas/WatchlistScreeningIndividualID' search_terms: $ref: '#/components/schemas/WatchlistScreeningSearchTerms' assignee: $ref: '#/components/schemas/DashboardUserIDNullable' status: $ref: '#/components/schemas/WatchlistScreeningStatus' client_user_id: $ref: '#/components/schemas/ClientUserIDNullable' audit_trail: $ref: '#/components/schemas/WatchlistScreeningAuditTrail' request_id: $ref: '#/components/schemas/RequestID' required: - id - search_terms - assignee - status - client_user_id - audit_trail - request_id type: object TransferEventListRequest: title: TransferEventListRequest type: object description: Defines the request schema for `/transfer/event/list` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' start_date: type: - string - 'null' format: date-time description: The start datetime of transfers to list. This should be in RFC 3339 format (i.e. `2019-12-06T22:35:49Z`) end_date: type: - string - 'null' format: date-time description: The end datetime of transfers to list. This should be in RFC 3339 format (i.e. `2019-12-06T22:35:49Z`) transfer_id: type: - string - 'null' title: TransferID description: Plaid’s unique identifier for a transfer. account_id: type: - string - 'null' description: The account ID to get events for all transactions to/from an account. transfer_type: $ref: '#/components/schemas/TransferEventListTransferType' event_types: type: array description: Filter events by event type. items: $ref: '#/components/schemas/TransferEventType' sweep_id: type: string description: Plaid’s unique identifier for a sweep. count: type: - integer - 'null' description: The maximum number of transfer events to return. If the number of events matching the above parameters is greater than `count`, the most recent events will be returned. default: 25 maximum: 25 minimum: 1 offset: type: - integer - 'null' default: 0 minimum: 0 description: The offset into the list of transfer events. When `count`=25 and `offset`=0, the first 25 events will be returned. When `count`=25 and `offset`=25, the next 25 events will be returned. origination_account_id: type: - string - 'null' description: The origination account ID to get events for transfers from a specific origination account. deprecated: true x-hidden-from-docs: true originator_client_id: type: - string - 'null' description: Filter transfer events to only those with the specified originator client. funding_account_id: type: - string - 'null' description: Filter transfer events to only those with the specified `funding_account_id`. IncomeVerificationPaystubsGetRequest: title: IncomeVerificationPaystubsGetRequest type: object description: IncomeVerificationPaystubsGetRequest defines the request schema for `/income/verification/paystubs/get`. properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' income_verification_id: type: - string - 'null' deprecated: true description: The ID of the verification for which to get paystub information. access_token: $ref: '#/components/schemas/AccessTokenNullable' SelfieCaptureVideoURL: type: - string - 'null' example: https://example.plaid.com/verifications/idv_52xR9LKo77r1Np/selfie/liveness.webm description: Temporary URL for downloading a video selfie capture. BeaconUserName: type: object title: BeaconUserName description: The full name for a given Beacon User. properties: given_name: $ref: '#/components/schemas/GivenNameField' family_name: $ref: '#/components/schemas/FamilyNameField' required: - given_name - family_name additionalProperties: true CreditBankEmployment: type: object description: Detailed information for the bank employment. properties: bank_employment_id: type: string description: A unique identifier for the bank employment. account_id: type: string description: Plaid's unique identifier for the account. employer: $ref: '#/components/schemas/CreditBankEmployer' latest_deposit_date: type: string description: The date of the most recent deposit from this employer. format: date earliest_deposit_date: type: string description: The date of the earliest deposit from this employer from within the period of the days requested. format: date required: - bank_employment_id - account_id - employer - latest_deposit_date - earliest_deposit_date TransferBalanceType: type: string title: TransferBalanceType enum: - prefunded_rtp_credits - prefunded_ach_credits description: 'The type of balance. `prefunded_rtp_credits` - Your prefunded RTP credit balance with Plaid `prefunded_ach_credits` - Your prefunded ACH credit balance with Plaid' PaymentInitiationPaymentReverseRequest: type: object description: PaymentInitiationPaymentReverseRequest defines the request schema for `/payment_initiation/payment/reverse` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' payment_id: type: string description: The ID of the payment to reverse idempotency_key: $ref: '#/components/schemas/WalletTransactionIdempotencyKey' reference: type: string maxLength: 18 minLength: 6 description: A reference for the refund. This must be an alphanumeric string with 6 to 18 characters and must not contain any special characters or spaces. amount: $ref: '#/components/schemas/PaymentAmountToRefund' counterparty_date_of_birth: type: - string - 'null' format: date description: The counterparty's birthdate, in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) (YYYY-MM-DD) format. counterparty_address: $ref: '#/components/schemas/PaymentInitiationAddress' required: - payment_id - idempotency_key - reference IncomeVerificationDocumentsDownloadRequest: title: IncomeVerificationDocumentsDownloadRequest type: object description: IncomeVerificationDocumentsDownloadRequest defines the request schema for `/income/verification/documents/download`. properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' income_verification_id: type: - string - 'null' deprecated: true description: The ID of the verification. access_token: $ref: '#/components/schemas/AccessTokenNullable' document_id: type: - string - 'null' description: The document ID to download. If passed, a single document will be returned in the resulting zip file, rather than all document IdentityVerificationRequestUserName: type: - object - 'null' properties: given_name: $ref: '#/components/schemas/GivenNameField' family_name: $ref: '#/components/schemas/FamilyNameField' required: - given_name - family_name description: You can use this field to pre-populate the user's legal name; if it is provided here, they will not be prompted to enter their name in the identity verification attempt. ImageQuality: description: 'A high level description of the quality of the image the user submitted. For example, an image that is blurry, distorted by glare from a nearby light source, or improperly framed might be marked as low or medium quality. Poor quality images are more likely to fail OCR and/or template conformity checks. Note: By default, Plaid will let a user recapture document images twice before failing the entire session if we attribute the failure to low image quality.' type: string enum: - high - medium - low example: high WatchlistScreeningEntityHitListResponse: description: Paginated list of entity watchlist screening hits additionalProperties: true properties: entity_watchlist_screening_hits: description: List of entity watchlist screening hits type: array items: $ref: '#/components/schemas/EntityWatchlistScreeningHit' next_cursor: $ref: '#/components/schemas/Cursor' request_id: $ref: '#/components/schemas/RequestID' required: - entity_watchlist_screening_hits - next_cursor - request_id type: object IdentityGetRequest: type: object description: IdentityGetRequest defines the request schema for `/identity/get` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' access_token: $ref: '#/components/schemas/AccessToken' options: $ref: '#/components/schemas/IdentityGetRequestOptions' required: - access_token BankTransferGetRequest: title: BankTransferGetRequest type: object description: Defines the request schema for `/bank_transfer/get` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' bank_transfer_id: $ref: '#/components/schemas/BankTransferID' required: - bank_transfer_id ConnectedApplication: description: Describes the connected application for a particular end user. type: object properties: application_id: $ref: '#/components/schemas/ApplicationID' name: type: string description: The name of the application display_name: type: - string - 'null' description: A human-readable name of the application for display purposes logo_url: type: - string - 'null' description: A URL that links to the application logo image. application_url: type: - string - 'null' description: The URL for the application's website reason_for_access: type: - string - 'null' description: A string provided by the connected app stating why they use their respective enabled products. created_at: type: string format: date-time description: The date this application was linked in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) (YYYY-MM-DD) format in UTC. example: '2020-01-01' scopes: $ref: '#/components/schemas/ScopesNullable' required: - application_id - name - created_at AssetReportRefreshRequest: type: object description: AssetReportRefreshRequest defines the request schema for `/asset_report/refresh` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' asset_report_token: $ref: '#/components/schemas/AssetReportRefreshAssetReportToken' days_requested: type: - integer - 'null' minimum: 0 maximum: 731 description: The maximum number of days of history to include in the Asset Report. Must be an integer. If not specified, the value from the original call to `/asset_report/create` will be used. options: $ref: '#/components/schemas/AssetReportRefreshRequestOptions' required: - asset_report_token IDNumberType: description: A globally unique and human readable ID type, specific to the country and document category. For more context on this field, see [Hybrid Input Validation](https://plaid.com/docs/identity-verification/hybrid-input-validation). type: string enum: - ar_dni - au_drivers_license - au_passport - br_cpf - ca_sin - cl_run - cn_resident_card - co_nit - dk_cpr - eg_national_id - es_dni - es_nie - hk_hkid - in_pan - it_cf - jo_civil_id - jp_my_number - ke_huduma_namba - kw_civil_id - mx_curp - mx_rfc - my_nric - ng_nin - nz_drivers_license - om_civil_id - ph_psn - pl_pesel - ro_cnp - sa_national_id - se_pin - sg_nric - tr_tc_kimlik - us_ssn - us_ssn_last_4 - za_smart_id example: us_ssn title: IDNumberType SignalReturnReportRequest: title: SignalReturnReportRequest description: SignalReturnReportRequest defines the request schema for `/signal/return/report` type: object properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' client_transaction_id: type: string description: Must be the same as the `client_transaction_id` supplied when calling `/signal/evaluate` minLength: 1 maxLength: 36 return_code: type: string description: 'Must be a valid ACH return code (e.g. "R01") If formatted incorrectly, this will result in an [`INVALID_FIELD`](/docs/errors/invalid-request/#invalid_field) error.' returned_at: type: - string - 'null' format: date-time description: Date and time when you receive the returns from your payment processors, in ISO 8601 format (`YYYY-MM-DDTHH:mm:ssZ`). required: - client_transaction_id - return_code SelfieCheckSelfie: type: object description: Captures and analysis from a user's selfie. additionalProperties: true properties: status: $ref: '#/components/schemas/SelfieStatus' attempt: example: 1 type: integer description: The `attempt` field begins with 1 and increments with each subsequent selfie upload. capture: $ref: '#/components/schemas/SelfieCapture' analysis: $ref: '#/components/schemas/SelfieAnalysis' required: - status - attempt - capture - analysis Loans: title: Loans type: object additionalProperties: true description: A collection of loans that are part of a single deal. properties: LOAN: $ref: '#/components/schemas/Loan' required: - LOAN WatchlistScreeningIndividualCreateResponse: description: 'The screening object allows you to represent a customer in your system, update their profile, and search for them on various watchlists. Note: Rejected customers will not receive new hits, regardless of program configuration.' additionalProperties: true properties: id: $ref: '#/components/schemas/WatchlistScreeningIndividualID' search_terms: $ref: '#/components/schemas/WatchlistScreeningSearchTerms' assignee: $ref: '#/components/schemas/DashboardUserIDNullable' status: $ref: '#/components/schemas/WatchlistScreeningStatus' client_user_id: $ref: '#/components/schemas/ClientUserIDNullable' audit_trail: $ref: '#/components/schemas/WatchlistScreeningAuditTrail' request_id: $ref: '#/components/schemas/RequestID' required: - id - search_terms - assignee - status - client_user_id - audit_trail - request_id type: object UserUpdateRequest: x-hidden-from-docs: true type: object description: UserUpdateRequest defines the request schema for `/user/update` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' user_token: $ref: '#/components/schemas/UserToken' consumer_report_user_identity: $ref: '#/components/schemas/ConsumerReportUserIdentity' required: - user_token UserStatedIncomeSourceFrequency: type: string description: The pay frequency of a specified income source enum: - UNKNOWN - WEEKLY - BIWEEKLY - SEMI_MONTHLY - MONTHLY PaymentInitiationRecipient: type: object additionalProperties: true description: PaymentInitiationRecipient defines a payment initiation recipient properties: recipient_id: type: string description: The ID of the recipient. name: type: string description: The name of the recipient. address: $ref: '#/components/schemas/PaymentInitiationAddress' iban: type: - string - 'null' description: The International Bank Account Number (IBAN) for the recipient. bacs: $ref: '#/components/schemas/RecipientBACSNullable' required: - recipient_id - name title: PaymentInitiationRecipient BeaconUserNameNullable: type: - object - 'null' title: BeaconUserName description: The full name for a given Beacon User. properties: given_name: $ref: '#/components/schemas/GivenNameField' family_name: $ref: '#/components/schemas/FamilyNameField' required: - given_name - family_name additionalProperties: true CreditFreddieMacAssetTransaction: title: CreditFreddieMacAssetTransaction type: object additionalProperties: true description: An object representing... properties: ASSET_TRANSACTION_DETAIL: $ref: '#/components/schemas/AssetTransactionDetail' ASSET_TRANSACTION_DESCRIPTION: type: array items: $ref: '#/components/schemas/AssetTransactionDescription' description: Documentation not found in the MISMO model viewer and not provided by Freddie Mac. required: - ASSET_TRANSACTION_DETAIL - ASSET_TRANSACTION_DESCRIPTION CreditEmploymentVerificationStatus: type: - string - 'null' title: CreditEmploymentVerificationStatus description: Current employment status. x-override-enum-values-shown: - ACTIVE - INACTIVE - null EmployersSearchRequest: title: EmployersSearchRequest type: object description: EmployersSearchRequest defines the request schema for `/employers/search`. properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' query: type: string description: The employer name to be searched for. products: type: array description: The Plaid products the returned employers should support. Currently, this field must be set to `"deposit_switch"`. items: type: string required: - query - products PaymentInitiationMaximumPaymentAmount: type: object description: 'A mapping of currency to maximum payment amount (denominated in the smallest unit of currency) supported by the institution. Example: `{"GBP": "10000"}` ' additionalProperties: type: string TransferAuthorization: title: TransferAuthorization type: object additionalProperties: true description: Contains the authorization decision for a proposed transfer. properties: id: $ref: '#/components/schemas/TransferAuthorizationID' created: type: string format: date-time description: The datetime representing when the authorization was created, in the format `2006-01-02T15:04:05Z`. decision: $ref: '#/components/schemas/TransferAuthorizationDecision' decision_rationale: $ref: '#/components/schemas/TransferAuthorizationDecisionRationale' guarantee_decision: $ref: '#/components/schemas/TransferAuthorizationGuaranteeDecision' guarantee_decision_rationale: $ref: '#/components/schemas/TransferAuthorizationGuaranteeDecisionRationale' payment_risk: $ref: '#/components/schemas/TransferAuthorizationPaymentRisk' proposed_transfer: $ref: '#/components/schemas/TransferAuthorizationProposedTransfer' required: - id - created - decision - decision_rationale - guarantee_decision - guarantee_decision_rationale - proposed_transfer - payment_risk CreditIsoCurrencyCode: type: - string - 'null' description: The ISO 4217 currency code of the amount or balance. BaseReportAccountInsights: title: BaseReportAccountInsights description: Calculated insights derived from transaction-level data. x-hidden-from-docs: true type: object additionalProperties: true properties: oldest_transaction_date: type: string format: date description: Date of the earliest transaction in the base report for the account. most_recent_transaction_date: type: string format: date description: Date of the most recent transaction in the base report for the account. days_available: type: integer description: Number of days days available in the base report for the account. average_days_between_transactions: type: number description: Average number of days between sequential transactions longest_gap_between_transactions: type: array description: Longest gap between sequential transactions items: $ref: '#/components/schemas/BaseReportLongestGapInsights' number_of_inflows: type: - array - 'null' description: The number of debits into the account. This field will be null for non-depository accounts. items: $ref: '#/components/schemas/BaseReportNumberFlowInsights' average_inflow_amount: type: - array - 'null' description: Average amount of debit transactions into account. This field will be null for non-depository accounts. This field only takes into account USD transactions from the account. items: $ref: '#/components/schemas/BaseReportAverageFlowInsights' number_of_outflows: type: - array - 'null' description: The number of credit into the account. This field will be null for non-depository accounts. items: $ref: '#/components/schemas/BaseReportNumberFlowInsights' average_outflow_amount: type: - array - 'null' description: Average amount of credit transactions into account. This field will be null for non-depository accounts. This field only takes into account USD transactions from the account. items: $ref: '#/components/schemas/BaseReportAverageFlowInsights' number_of_days_no_transactions: type: integer description: Number of days with no transactions AuthGetRequest: type: object description: AuthGetRequest defines the request schema for `/auth/get` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' access_token: $ref: '#/components/schemas/AccessToken' options: $ref: '#/components/schemas/AuthGetRequestOptions' required: - access_token BankTransferFailure: title: BankTransferFailure type: - object - 'null' additionalProperties: true description: The failure reason if the type of this transfer is `"failed"` or `"reversed"`. Null value otherwise. properties: ach_return_code: type: - string - 'null' description: The ACH return code, e.g. `R01`. A return code will be provided if and only if the transfer status is `reversed`. For a full listing of ACH return codes, see [Bank Transfers errors](https://plaid.com/docs/errors/bank-transfers/#ach-return-codes). description: type: string description: A human-readable description of the reason for the failure or reversal. TransferIntentGetFailureReason: title: TransferIntentGetFailureReason type: - object - 'null' additionalProperties: true description: The reason for a failed transfer intent. Returned only if the transfer intent status is `failed`. Null otherwise. properties: error_type: type: string description: A broad categorization of the error. error_code: type: string description: A code representing the reason for a failed transfer intent (i.e., an API error or the authorization being declined). error_message: type: string description: A human-readable description of the code associated with a failed transfer intent. IdentityVerificationDocumentAddressResponse: description: 'The address extracted from the document. The address must at least contain the following fields to be a valid address: `street`, `city`, `country`. If any are missing or unable to be extracted, the address will be null. `region`, and `postal_code` may be null based on the addressing system. For example: Addresses from the United Kingdom will not include a region Addresses from Hong Kong will not include postal code Note: Optical Character Recognition (OCR) technology may sometimes extract incorrect data from a document.' type: - object - 'null' properties: street: $ref: '#/components/schemas/IdentityVerificationDocumentStreet' city: $ref: '#/components/schemas/IdentityVerificationDocumentCity' region: $ref: '#/components/schemas/IdentityVerificationDocumentRegion' postal_code: $ref: '#/components/schemas/IdentityVerificationDocumentPostalCode' country: $ref: '#/components/schemas/IdentityVerificationDocumentCountryCode' required: - street - city - region - postal_code - country additionalProperties: true WalletTransactionListResponse: type: object additionalProperties: true description: WalletTransactionListResponse defines the response schema for `/wallet/transaction/list` properties: transactions: type: array description: An array of transactions of an e-wallet, associated with the given `wallet_id` items: $ref: '#/components/schemas/WalletTransaction' next_cursor: type: string description: Cursor used for fetching transactions created before the latest transaction provided in this response request_id: $ref: '#/components/schemas/RequestID' required: - transactions - request_id ItemPublicTokenCreateRequest: type: object description: ItemPublicTokenCreateRequest defines the request schema for `/item/public_token/create` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' access_token: $ref: '#/components/schemas/AccessToken' required: - access_token VirtualTime: type: string title: VirtualTime format: date-time description: The virtual timestamp on the test clock. This will be of the form `2006-01-02T15:04:05Z`. TransactionsRulesListRequest: type: object description: TransactionsRulesListRequest defines the request schema for `/beta/transactions/rules/v1/list` properties: client_id: $ref: '#/components/schemas/APIClientID' access_token: $ref: '#/components/schemas/AccessToken' secret: $ref: '#/components/schemas/APISecret' required: - access_token RiskCheckEmailDomainIsDisposable: description: Indicates whether the email domain is listed as disposable if known. Disposable domains are often used to create email addresses that are part of a fake set of user details. example: 'yes' type: string enum: - 'yes' - 'no' - no_data AccountFiltersResponse: title: AccountFiltersResponse description: 'The `account_filters` specified in the original call to `/link/token/create`. ' type: object additionalProperties: true properties: depository: $ref: '#/components/schemas/DepositoryFilter' credit: $ref: '#/components/schemas/CreditFilter' loan: $ref: '#/components/schemas/LoanFilter' investment: $ref: '#/components/schemas/InvestmentFilter' InstitutionSupportedNetworks: title: InstitutionSupportedNetworks type: object additionalProperties: true description: Contains the RTP network and types supported by the linked Item's institution. properties: rtp: $ref: '#/components/schemas/TransferCapabilitiesGetRTP' required: - rtp CraBankIncomeGetRequest: title: CraBankIncomeGetRequest type: object description: CraBankIncomeGetRequest defines the request schema for `/cra/bank_income/get`. properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' user_token: $ref: '#/components/schemas/UserToken' WatchlistScreeningIndividualName: type: string title: WatchlistScreeningIndividualName minLength: 1 example: Aleksey Potemkin description: The legal name of the individual being screened. Products: title: Products enum: - assets - auth - balance - identity - identity_match - investments - investments_auth - liabilities - payment_initiation - identity_verification - transactions - credit_details - income - income_verification - deposit_switch - standing_orders - transfer - employment - recurring_transactions - signal - statements - processor_payments - processor_identity - profile description: A list of products that an institution can support. All Items must be initialized with at least one product. The Balance product is always available and does not need to be specified during initialization. type: string CreditRelayCreateRequest: type: object description: CreditRelayCreateRequest defines the request schema for `/credit/relay/create` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' report_tokens: type: array description: List of report token strings, with at most one token of each report type. Currently only Asset Report token is supported. items: type: string description: The report token. It can only be an asset report token token. secondary_client_id: type: string description: The `secondary_client_id` is the client id of the third party with whom you would like to share the relay token. webhook: type: - string - 'null' description: URL to which Plaid will send webhooks when the Secondary Client successfully retrieves an Asset Report by calling `/credit/relay/get`. required: - report_tokens - secondary_client_id InvestmentTransactionType: type: string enum: - buy - sell - cancel - cash - fee - transfer description: 'Value is one of the following: `buy`: Buying an investment `sell`: Selling an investment `cancel`: A cancellation of a pending transaction `cash`: Activity that modifies a cash position `fee`: A fee on the account `transfer`: Activity which modifies a position, but not through buy/sell activity e.g. options exercise, portfolio transfer For descriptions of possible transaction types and subtypes, see the [Investment transaction types schema](https://plaid.com/docs/api/accounts/#investment-transaction-types-schema).' PaymentInitiationConsentGetResponse: type: object additionalProperties: true description: PaymentInitiationConsentGetResponse defines the response schema for `/payment_initation/consent/get` allOf: - $ref: '#/components/schemas/PaymentInitiationConsent' - type: object properties: request_id: $ref: '#/components/schemas/RequestID' required: - request_id TransferDocumentPurpose: type: string title: purpose enum: - DUE_DILIGENCE description: 'Specifies the purpose of the uploaded file. `"DUE_DILIGENCE"` - The transfer due diligence document of the originator.' RiskProfile: title: SignalEvaluateRiskProfile type: - object - 'null' description: Details about the transaction result after evaluated by the requested risk profile. If a `risk_profile_key` is not provided, this field will be omitted. This feature is currently in closed beta; to request access, contact your account manager. properties: key: type: string description: The key of the risk profile used for this transaction. outcome: type: string description: The evaluated outcome for this transaction. You can configure a list of outcomes, such as "accept", "review", and "decline" using the Signal dashboard located within the Plaid Dashboard. TransferSweepIDNullable: type: - string - 'null' title: TransferSweepID description: Plaid’s unique identifier for a sweep. BeaconReportSyndication: type: object title: BeaconReportSyndication description: 'A Beacon Report Syndication represents a Beacon Report created either by your organization or another Beacon customer that matches a specific Beacon User you''ve created. The `analysis` field in the response indicates which fields matched between the originally reported Beacon User and the Beacon User that the report was syndicated to. The `report` field in the response contains a subset of information from the original report.' properties: id: $ref: '#/components/schemas/BeaconReportSyndicationID' report: $ref: '#/components/schemas/BeaconReportSyndicationOriginalReport' analysis: $ref: '#/components/schemas/BeaconReportSyndicationAnalysis' required: - id - report - analysis additionalProperties: true InvestmentsAuthOwner: x-hidden-from-docs: true title: InvestmentsAuthOwner type: object description: Information on the ownership of an investments account additionalProperties: true properties: account_id: type: string description: The ID of the account that this identity information pertains to names: description: '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 `names` array.' type: array items: type: string CreditACHClass: type: string title: CreditACHClass enum: - ccd - ppd - web description: 'Specifies the use case of the transfer. Required for transfers on an ACH network. `"ccd"` - Corporate Credit or Debit - fund transfer between two corporate bank accounts `"ppd"` - Prearranged Payment or Deposit - the transfer is part of a pre-existing relationship with a consumer, eg. bill payment `"web"` - A credit Entry initiated by or on behalf of a holder of a Consumer Account that is intended for a Consumer Account of a Receiver' TransferRecurringCreateResponse: title: TransferRecurringCreateResponse type: object additionalProperties: true description: Defines the response schema for `/transfer/recurring/create` properties: recurring_transfer: $ref: '#/components/schemas/RecurringTransferNullable' decision: $ref: '#/components/schemas/TransferAuthorizationDecision' decision_rationale: $ref: '#/components/schemas/TransferAuthorizationDecisionRationale' request_id: $ref: '#/components/schemas/RequestID' required: - decision - request_id IdentityVerification: type: object description: A identity verification attempt represents a customer's attempt to verify their identity, reflecting the required steps for completing the session, the results for each step, and information collected in the process. additionalProperties: true properties: id: $ref: '#/components/schemas/IdentityVerificationID' client_user_id: $ref: '#/components/schemas/ClientUserID' created_at: $ref: '#/components/schemas/Timestamp' completed_at: $ref: '#/components/schemas/TimestampNullable' previous_attempt_id: $ref: '#/components/schemas/PreviousIdentityVerificationAttemptID' shareable_url: $ref: '#/components/schemas/ShareableURL' template: $ref: '#/components/schemas/IdentityVerificationTemplateReference' user: $ref: '#/components/schemas/IdentityVerificationUserData' status: $ref: '#/components/schemas/IdentityVerificationStatus' steps: $ref: '#/components/schemas/IdentityVerificationStepSummary' documentary_verification: $ref: '#/components/schemas/DocumentaryVerification' selfie_check: $ref: '#/components/schemas/SelfieCheck' kyc_check: $ref: '#/components/schemas/KYCCheckDetails' risk_check: $ref: '#/components/schemas/RiskCheckDetails' watchlist_screening_id: $ref: '#/components/schemas/WatchlistScreeningIndividualIDNullable' redacted_at: $ref: '#/components/schemas/TimestampNullable' required: - id - client_user_id - created_at - completed_at - previous_attempt_id - shareable_url - template - user - status - steps - documentary_verification - selfie_check - kyc_check - risk_check - watchlist_screening_id - redacted_at DocumentImage__CroppedFront: type: - string - 'null' example: https://example.plaid.com/verifications/idv_52xR9LKo77r1Np/documents/1/cropped_front.jpeg description: Temporary URL that expires after 60 seconds for downloading a cropped image containing just the front of the document. UserToken: title: UserToken type: string description: The user token associated with the User data is being requested for. CreditSessionItemAddResult: type: object description: The details of an Item add in Link. properties: public_token: description: Returned once a user has successfully linked their Item. type: string item_id: description: 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. type: string institution_id: description: The Plaid Institution ID associated with the Item. type: string CreditRelayPDFGetResponse: title: CreditRelayPDFGetResponse format: binary type: string description: CreditRelayPDFGetResponse defines the response schema for `/credit/relay/pdf/get` ProcessorTokenWebhookUpdateRequest: type: object description: ProcessorTokenWebhookUpdateRequest defines the request schema for `/processor/token/webhook/update` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' processor_token: $ref: '#/components/schemas/ProcessorToken' webhook: type: - string - 'null' description: The new webhook URL to associate with the processor token. To remove a webhook from a processor token, set to `null`. required: - processor_token - webhook TransferCreateResponse: title: TransferCreateResponse type: object additionalProperties: true description: Defines the response schema for `/transfer/create` properties: transfer: $ref: '#/components/schemas/Transfer' request_id: $ref: '#/components/schemas/RequestID' required: - transfer - request_id PartnerEndCustomerOAuthInstitutionApplicationStatus: type: string enum: - NOT_STARTED - PROCESSING - APPROVED - ENABLED - ATTENTION_REQUIRED description: The registration status for the end customer's application. CreditSessionBankEmploymentResult: type: object description: The details of a bank employment verification in Link. properties: status: $ref: '#/components/schemas/CreditSessionBankEmploymentStatus' item_id: description: 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. type: string institution_id: description: The Plaid Institution ID associated with the Item. type: string ServicerAddressData: title: ServicerAddressData type: object additionalProperties: true description: The address of the student loan servicer. This is generally the remittance address to which payments should be sent. properties: city: type: - string - 'null' description: The full city name region: type: - string - 'null' description: 'The region or state Example: `"NC"`' street: type: - string - 'null' description: 'The full street address Example: `"564 Main Street, APT 15"`' postal_code: type: - string - 'null' description: The postal code country: type: - string - 'null' description: The ISO 3166-1 alpha-2 country code required: - city - region - street - postal_code - country InstitutionsGetByIdRequest: type: object description: InstitutionsGetByIdRequest defines the request schema for `/institutions/get_by_id` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' institution_id: type: string description: The ID of the institution to get details about minLength: 1 country_codes: type: array description: 'Specify which country or countries to include institutions from, using the ISO-3166-1 alpha-2 country code standard. In API versions 2019-05-29 and earlier, the `country_codes` parameter is an optional parameter within the `options` object and will default to `[US]` if it is not supplied. ' items: $ref: '#/components/schemas/CountryCode' options: $ref: '#/components/schemas/InstitutionsGetByIdRequestOptions' required: - institution_id - country_codes IncomeVerificationPrecheckEmployer: title: IncomeVerificationPrecheckEmployer type: - object - 'null' description: Information about the end user's employer properties: name: type: - string - 'null' description: The employer's name address: $ref: '#/components/schemas/IncomeVerificationPrecheckEmployerAddress' tax_id: type: - string - 'null' description: The employer's tax id url: type: - string - 'null' description: The URL for the employer's public website TransferAuthorizationCreateResponse: title: TransferAuthorizationCreateResponse type: object additionalProperties: true description: Defines the response schema for `/transfer/authorization/create` properties: authorization: $ref: '#/components/schemas/TransferAuthorization' request_id: $ref: '#/components/schemas/RequestID' required: - authorization - request_id AssetTransactions: title: AssetTransactions type: object additionalProperties: true description: Documentation not found in the MISMO model viewer and not provided by Freddie Mac. properties: ASSET_TRANSACTION: type: array items: $ref: '#/components/schemas/AssetTransaction' required: - ASSET_TRANSACTION RiskCheckEmailIsDeliverableStatus: description: SMTP-MX check to confirm the email address exists if known. example: 'yes' type: string enum: - 'yes' - 'no' - no_data LinkTokenTransactions: description: Configuration parameters for the Transactions product type: object properties: days_requested: description: 'The maximum number of days of transaction history to request for the Transactions product. For developer accounts created after December 3, 2023, if no value is specified, this will default to 90 days. For developer accounts created on December 3, 2023 or earlier, if no value is specified, this will default to 730 days until June 24, 2024, at which point it will default to 90 days. We strongly recommend that customers utilizing [Recurring Transactions](https://plaid.com/docs/api/products/transactions/#transactionsrecurringget) request at least 180 days of history for optimal results.' type: integer minimum: 1 maximum: 730 default: 90 TransactionsEnhanceGetRequest: type: object description: TransactionsEnhanceGetRequest defines the request schema for `/transactions/enhance`. properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' account_type: type: string description: The type of account for the requested transactions (`depository` or `credit`). transactions: type: array description: An array of raw transactions to be enhanced. items: $ref: '#/components/schemas/ClientProvidedRawTransaction' required: - account_type - transactions NumbersInternational: title: NumbersInternational type: object additionalProperties: true description: Identifying information for transferring money to or from an international bank account via wire transfer. properties: account_id: type: string description: The Plaid account ID associated with the account numbers iban: type: string description: The International Bank Account Number (IBAN) for the account bic: type: string description: The Bank Identifier Code (BIC) for the account required: - account_id - iban - bic IdentityVerificationID: type: string example: idv_52xR9LKo77r1Np title: IdentityVerificationID description: ID of the associated Identity Verification attempt. BeaconAccountRiskEvaluateEvaluationReason: type: string enum: - ONBOARDING - NEW_ACCOUNT - INFORMATION_CHANGE - DORMANT_USER - OTHER x-hidden-from-docs: true description: "Description of the reason you want to evaluate risk.\n`ONBOARDING`: user links a first bank account as part of the onboarding flow of your platform.\n`NEW_ACCOUNT`: user links another bank account or replaces the currently linked bank account on your platform.\n`INFORMATION_CHANGE`: user changes their information on your platform, e.g., updating their phone number.\n`DORMANT_USER`: you decide to re-evaluate a user that becomes active after a period of inactivity. \n`OTHER`: any other reasons not listed here\nPossible values: `ONBOARDING`, `NEW_ACCOUNT`, `INFORMATION_CHANGE`, `DORMANT_USER`, `OTHER`\n" DashboardUserID: type: string title: DashboardUserID example: 54350110fedcbaf01234ffee description: ID of the associated user. TransferAuthorizationCancelResponse: title: TransferAuthorizationCancelResponse type: object additionalProperties: true description: Defines the response schema for `/transfer/authorization/cancel` properties: request_id: $ref: '#/components/schemas/RequestID' required: - request_id CraBankIncomeBonusType: type: - string - 'null' description: 'The type of bonus that this transaction represents, if it is a bonus `BONUS_INCLUDED`: Bonus is included in this transaction along with the normal pay `BONUS_ONLY`: This transaction is a standalone bonus' enum: - BONUS_INCLUDED - BONUS_ONLY LinkTokenCreateRequestBaseReport: title: LinkTokenCreateRequestBaseReport type: object x-hidden-from-docs: true description: Specifies options for initializing Link for use with the Base Report product. This field is required if `assets` is included in the `products` array and the client is CRA-enabled. properties: days_requested: type: integer description: The maximum integer number of days of history to include in the Base Report. minimum: 1 maximum: 730 client_report_id: type: - string - 'null' description: Client-generated identifier, which can be used by lenders to track loan applications. required: - days_requested FDXNotificationSeverity: type: string title: Notification Severity enum: - EMERGENCY - ALERT - WARNING - NOTICE - INFO description: Severity level of notification LinkTokenCreateRequestEmploymentBankIncome: title: LinkTokenCreateRequestEmploymentBankIncome type: object description: Specifies options for initializing Link for use with Bank Employment. This field is required if `employment` is included in the `products` array and `bank` is specified in `employment_source_types`. properties: days_requested: type: integer description: The number of days of data to request for the Bank Employment product. required: - days_requested CreditBankEmploymentItem: type: object description: The details and metadata for an end user's Item. properties: item_id: type: string description: The unique identifier for the Item. last_updated_time: type: string description: The time when this Item's data was last retrieved from the financial institution, in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format (e.g. "2018-04-12T03:32:11Z"). format: date-time institution_id: type: string description: The unique identifier of the institution associated with the Item. institution_name: type: string description: The name of the institution associated with the Item. bank_employments: type: array description: The bank employment information for this Item. Each entry in the array is a different employer found. items: $ref: '#/components/schemas/CreditBankEmployment' bank_employment_accounts: type: array description: The Item's accounts that have Bank Employment data. items: $ref: '#/components/schemas/CreditBankIncomeAccount' required: - item_id - last_updated_time - institution_id - institution_name - bank_employments - bank_employment_accounts Street: type: string example: 123 Main St. title: Street description: The primary street portion of an address. If an address is provided, this field will always be filled. A string with at least one non-whitespace alphabetical character, with a max length of 80 characters. UpdateEntityScreeningRequestSearchTerms: type: - object - 'null' description: Search terms for editing an entity watchlist screening properties: entity_watchlist_program_id: $ref: '#/components/schemas/EntityWatchlistProgramID' legal_name: $ref: '#/components/schemas/EntityWatchlistScreeningName' document_number: $ref: '#/components/schemas/WatchlistScreeningDocumentValue' email_address: $ref: '#/components/schemas/EmailAddress' country: $ref: '#/components/schemas/GenericCountryCode' phone_number: $ref: '#/components/schemas/WatchlistScreeningPhoneNumber' url: $ref: '#/components/schemas/URL' required: - entity_watchlist_program_id BankTransferEvent: title: BankTransferEvent type: object additionalProperties: true description: Represents an event in the Bank Transfers API. properties: event_id: type: integer description: Plaid’s unique identifier for this event. IDs are sequential unsigned 64-bit integers. minimum: 0 timestamp: type: string format: date-time description: The datetime when this event occurred. This will be of the form `2006-01-02T15:04:05Z`. event_type: $ref: '#/components/schemas/BankTransferEventType' account_id: type: string description: The account ID associated with the bank transfer. bank_transfer_id: $ref: '#/components/schemas/BankTransferID' origination_account_id: type: - string - 'null' description: The ID of the origination account that this balance belongs to. bank_transfer_type: $ref: '#/components/schemas/BankTransferType' bank_transfer_amount: type: string description: The bank transfer amount. bank_transfer_iso_currency_code: type: string description: The currency of the bank transfer amount. failure_reason: $ref: '#/components/schemas/BankTransferFailure' direction: $ref: '#/components/schemas/BankTransferDirection' required: - event_id - timestamp - event_type - account_id - bank_transfer_id - origination_account_id - bank_transfer_type - bank_transfer_amount - bank_transfer_iso_currency_code - failure_reason - direction WatchlistScreeningIndividualID: type: string example: scr_52xR9LKo77r1Np title: WatchlistScreeningIndividualID description: ID of the associated screening. KYCCheckDetails: type: - object - 'null' description: Additional information for the `kyc_check` step. This field will be `null` unless `steps.kyc_check` has reached a terminal state of either `success` or `failed`. properties: status: type: string description: The outcome status for the associated Identity Verification attempt's `kyc_check` step. This field will always have the same value as `steps.kyc_check`. example: success address: $ref: '#/components/schemas/KYCCheckAddressSummary' name: $ref: '#/components/schemas/KYCCheckNameSummary' date_of_birth: $ref: '#/components/schemas/KYCCheckDateOfBirthSummary' id_number: $ref: '#/components/schemas/KYCCheckIDNumberSummary' phone_number: $ref: '#/components/schemas/KYCCheckPhoneSummary' required: - status - phone_number - address - name - date_of_birth - id_number additionalProperties: true DepositSwitchTargetUser: title: DepositSwitchTargetUser description: The deposit switch target user type: object additionalProperties: true properties: given_name: type: string description: The given name (first name) of the user. family_name: type: string description: The family name (last name) of the user. phone: type: string description: The phone number of the user. The endpoint can accept a variety of phone number formats, including E.164. email: type: string description: The email address of the user. address: $ref: '#/components/schemas/DepositSwitchAddressData' tax_payer_id: type: string description: The taxpayer ID of the user, generally their SSN, EIN, or TIN. required: - given_name - family_name - phone - email PaymentInitiationConsentCreateRequest: type: object description: PaymentInitiationConsentCreateRequest defines the request schema for `/payment_initiation/consent/create` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' recipient_id: type: string description: The ID of the recipient the payment consent is for. The created consent can be used to transfer funds to this recipient only. reference: type: string description: A reference for the payment consent. This must be an alphanumeric string with at most 18 characters and must not contain any special characters. minLength: 1 maxLength: 18 scopes: type: array description: An array of payment consent scopes. minItems: 1 uniqueItems: true items: $ref: '#/components/schemas/PaymentInitiationConsentScope' constraints: $ref: '#/components/schemas/PaymentInitiationConsentConstraints' options: $ref: '#/components/schemas/ExternalPaymentInitiationConsentOptions' required: - recipient_id - reference - scopes - constraints AccessTokenNullable: type: - string - 'null' description: The access token associated with the Item data is being requested for. UserId: title: UserId type: string description: The Plaid `user_id` of the User associated with this webhook, warning, or error. TransferMetricsGetResponse: title: TransferMetricsGetResponse type: object additionalProperties: true description: Defines the response schema for `/transfer/metrics/get` properties: request_id: $ref: '#/components/schemas/RequestID' daily_debit_transfer_volume: type: string description: Sum of dollar amount of debit transfers in last 24 hours (decimal string with two digits of precision e.g. "10.00"). daily_credit_transfer_volume: type: string description: Sum of dollar amount of credit transfers in last 24 hours (decimal string with two digits of precision e.g. "10.00"). monthly_transfer_volume: type: string description: Sum of dollar amount of credit and debit transfers in current calendar month (decimal string with two digits of precision e.g. "10.00"). deprecated: true x-hidden-from-docs: true monthly_debit_transfer_volume: type: string description: Sum of dollar amount of debit transfers in current calendar month (decimal string with two digits of precision e.g. "10.00"). monthly_credit_transfer_volume: type: string description: Sum of dollar amount of credit transfers in current calendar month (decimal string with two digits of precision e.g. "10.00"). iso_currency_code: type: string description: The currency of the dollar amount, e.g. "USD". required: - request_id - daily_debit_transfer_volume - daily_credit_transfer_volume - monthly_transfer_volume - monthly_debit_transfer_volume - monthly_credit_transfer_volume - iso_currency_code PaymentInitiationPaymentReverseResponse: type: object additionalProperties: true description: PaymentInitiationPaymentReverseResponse defines the response schema for `/payment_initation/payment/reverse` properties: refund_id: type: string description: A unique ID identifying the refund status: $ref: '#/components/schemas/WalletTransactionStatus' request_id: $ref: '#/components/schemas/RequestID' required: - refund_id - request_id - status AccessToken: title: AccessToken type: string description: The access token associated with the Item data is being requested for. TransferDevice: title: TransferDevice type: object additionalProperties: true description: Information about the device being used to initiate the authorization. properties: ip_address: type: string description: The IP address of the device being used to initiate the authorization. user_agent: type: string description: The user agent of the device being used to initiate the authorization. required: - ip_address - user_agent DocumentImage__Back: type: - string - 'null' example: https://example.plaid.com/verifications/idv_52xR9LKo77r1Np/documents/1/original_back.jpeg description: Temporary URL that expires after 60 seconds for downloading the original image of the back of the document. Might be null if the back of the document was not collected. LoanFilter: title: LoanFilter description: A filter to apply to `loan`-type accounts type: object additionalProperties: true properties: account_subtypes: $ref: '#/components/schemas/LoanAccountSubtypes' required: - account_subtypes PaymentInitiationMetadata: title: PaymentInitiationMetadata type: - object - 'null' additionalProperties: true description: Metadata that captures what specific payment configurations an institution supports when making Payment Initiation requests. properties: supports_international_payments: type: boolean description: Indicates whether the institution supports payments from a different country. supports_sepa_instant: type: boolean description: Indicates whether the institution supports SEPA Instant payments. maximum_payment_amount: $ref: '#/components/schemas/PaymentInitiationMaximumPaymentAmount' supports_refund_details: type: boolean description: Indicates whether the institution supports returning refund details when initiating a payment. standing_order_metadata: $ref: '#/components/schemas/PaymentInitiationStandingOrderMetadata' supports_payment_consents: type: boolean description: Indicates whether the institution supports payment consents. required: - supports_international_payments - supports_sepa_instant - maximum_payment_amount - supports_refund_details - standing_order_metadata - supports_payment_consents PaymentProfileToken: type: string title: PaymentProfileToken description: A payment profile token associated with the Payment Profile data that is being requested. x-hidden-from-docs: true BeaconUserID: type: string title: BeaconUserID example: becusr_42cF1MNo42r9Xj description: ID of the associated Beacon User. AccountType: type: string title: AccountType enum: - investment - credit - depository - loan - brokerage - other description: '`investment:` Investment account. In API versions 2018-05-22 and earlier, this type is called `brokerage` instead. `credit:` Credit card `depository:` Depository account `loan:` Loan account `other:` Non-specified account type See the [Account type schema](https://plaid.com/docs/api/accounts#account-type-schema) for a full listing of account types and corresponding subtypes.' AccountsGetRequest: type: object description: AccountsGetRequest defines the request schema for `/accounts/get` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' access_token: $ref: '#/components/schemas/AccessToken' options: $ref: '#/components/schemas/AccountsGetRequestOptions' required: - access_token x-examples: example-1: {} IdentityVerificationTemplateID: type: string example: idvtmp_4FrXJvfQU3zGUR title: IdentityVerificationTemplateID description: ID of the associated Identity Verification template. TimestampNullable: description: An ISO8601 formatted timestamp. type: - string - 'null' format: date-time title: Timestamp example: '2020-07-24T03:26:02Z' FDXPartyRegistry: title: Party Registry description: The registry containing the party’s registration with name and id type: string enum: - FDX - GLEIF - ICANN - PRIVATE NumbersBACS: title: NumbersBACS type: object additionalProperties: true description: Identifying information for transferring money to or from a UK bank account via BACS. properties: account_id: type: string description: The Plaid account ID associated with the account numbers account: type: string description: The BACS account number for the account sort_code: type: string description: The BACS sort code for the account required: - account_id - account - sort_code ProfileGetResponse: type: object x-hidden-from-docs: true additionalProperties: true description: ProfileGetResponse defines the response schema for `/profile/get` properties: identity: $ref: '#/components/schemas/ProfileIdentity' items: type: array items: $ref: '#/components/schemas/ProfileItem' request_id: $ref: '#/components/schemas/RequestID' required: - identity - items - request_id TransferFundingAccountIDResponse: type: string description: The id of the funding account to use, available in the Plaid Dashboard. This determines which of your business checking accounts will be credited or debited. DocumentMetadata: title: DocumentMetadata type: object additionalProperties: true description: An object representing metadata from the end user's uploaded document. properties: name: type: string description: The name of the document. status: type: - string - 'null' description: 'The processing status of the document. `PROCESSING_COMPLETE`: The document was successfully processed. `DOCUMENT_ERROR`: The document could not be processed. Possible causes include: The document was an unacceptable document type such as an offer letter or bank statement, the document image was cropped or blurry, or the document was corrupted. `UNKNOWN` or `null`: An internal error occurred. If this happens repeatedly, contact support or your Plaid account manager.' x-override-enum-values-shown: - UNKNOWN - PROCESSING_COMPLETE - DOCUMENT_ERROR - null doc_id: type: string description: An identifier of the document that is also present in the paystub response. doc_type: $ref: '#/components/schemas/DocType' IdentityVerificationCreateRequest: type: object properties: client_user_id: $ref: '#/components/schemas/ClientUserID' is_shareable: type: boolean example: true title: EnableSharableLink description: A flag specifying whether you would like Plaid to expose a shareable URL for the verification being created. template_id: $ref: '#/components/schemas/IdentityVerificationTemplateID' gave_consent: $ref: '#/components/schemas/IdentityVerificationConsent' user: $ref: '#/components/schemas/IdentityVerificationCreateRequestUser' client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' is_idempotent: $ref: '#/components/schemas/IdempotencyFlag' required: - is_shareable - template_id - gave_consent description: Request schema for '/identity_verification/create' TransferSweep: title: TransferSweep type: object additionalProperties: true description: 'Describes a sweep of funds to / from the sweep account. A sweep is associated with many sweep events (events of type `swept` or `return_swept`) which can be retrieved by invoking the `/transfer/event/list` endpoint with the corresponding `sweep_id`. `swept` events occur when the transfer amount is credited or debited from your sweep account, depending on the `type` of the transfer. `return_swept` events occur when a transfer is returned and Plaid undoes the credit or debit. The total sum of the `swept` and `return_swept` events is equal to the `amount` of the sweep Plaid creates and matches the amount of the entry on your sweep account ledger.' properties: id: type: string description: Identifier of the sweep. funding_account_id: $ref: '#/components/schemas/TransferFundingAccountIDResponse' created: type: string description: The datetime when the sweep occurred, in RFC 3339 format. format: date-time amount: type: string description: 'Signed decimal amount of the sweep as it appears on your sweep account ledger (e.g. "-10.00") If amount is not present, the sweep was net-settled to zero and outstanding debits and credits between the sweep account and Plaid are balanced.' iso_currency_code: type: string description: The currency of the sweep, e.g. "USD". settled: type: - string - 'null' description: The date when the sweep settled, in the YYYY-MM-DD format. format: date status: $ref: '#/components/schemas/SweepStatus' trigger: $ref: '#/components/schemas/SweepTrigger' description: type: string description: The description of the deposit that will be passed to the receiving bank (up to 10 characters). Note that banks utilize this field differently, and may or may not show it on the bank statement. network_trace_id: $ref: '#/components/schemas/TransferNetworkTraceID' required: - id - created - amount - iso_currency_code - settled - funding_account_id PrismFirstDetect: type: - object - 'null' additionalProperties: true description: The data from the Firstdetect product returned by Prism. properties: version: type: integer description: The version of Prism's Firstdetect model used. score: type: integer description: The score returned by Prism. Ranges from 1-999, with higher score indicating lower risk. reason_codes: type: array description: The reasons for an individual having risk according to the Firstdetect score. items: type: string metadata: $ref: '#/components/schemas/PrismCashScoreMetadata' required: - version - score PlaidErrorType: title: PlaidErrorType type: string description: A broad categorization of the error. Safe for programmatic use. enum: - INVALID_REQUEST - INVALID_RESULT - INVALID_INPUT - INSTITUTION_ERROR - RATE_LIMIT_EXCEEDED - API_ERROR - ITEM_ERROR - ASSET_REPORT_ERROR - RECAPTCHA_ERROR - OAUTH_ERROR - PAYMENT_ERROR - BANK_TRANSFER_ERROR - INCOME_VERIFICATION_ERROR - MICRODEPOSITS_ERROR W2StateAndLocalWages: title: W2StateAndLocalWages description: W2 state and local wages type: object additionalProperties: true properties: state: type: - string - 'null' description: State associated with the wage. employer_state_id_number: type: - string - 'null' description: State identification number of the employer. state_wages_tips: type: - string - 'null' description: Wages and tips from the specified state. state_income_tax: type: - string - 'null' description: Income tax from the specified state. local_wages_tips: type: - string - 'null' description: Wages and tips from the locality. local_income_tax: type: - string - 'null' description: Income tax from the locality. locality_name: type: - string - 'null' description: Name of the locality. PaystubYTDDetails: title: PaystubYTDDetails type: object deprecated: true additionalProperties: true properties: gross_earnings: type: - number - 'null' format: double description: Year-to-date gross earnings. net_earnings: type: - number - 'null' format: double description: Year-to-date net (take home) earnings. description: The amount of income earned year to date, as based on paystub data. WeakAliasDetermination: type: string enum: - none - source - plaid example: none description: Names that are explicitly marked as low quality either by their `source` list, or by `plaid` by a series of additional checks done by Plaid. Plaid does not ever surface a hit as a result of a weak name alone. If a name has no quality issues, this value will be `none`. title: WeakAliasDetermination AccountsBalanceGetRequestPaymentDetails: x-hidden-from-docs: true type: - object - 'null' description: An optional object containing payment details. If set, a payment risk assessment is performed and returned as AccountsBalanceGetResponsePaymentRiskAssessment. additionalProperties: true properties: account_id: type: string description: 'The Plaid `account_id` of the account that is the funding source for the proposed transaction. The `account_id` is returned in the `/accounts/get` endpoint as well as the [`onSuccess`](/docs/link/ios/#link-ios-onsuccess-linkSuccess-metadata-accounts-id) callback metadata. This will return an [`INVALID_ACCOUNT_ID`](/docs/errors/invalid-input/#invalid_account_id) error if the account has been removed at the bank or if the `account_id` is no longer valid.' client_transaction_id: type: string description: The unique ID that you would like to use to refer to this transaction. For your convenience mapping your internal data, you could use your internal identifier for this transaction. The max length for this field is 36 characters. minLength: 1 maxLength: 36 amount: type: number format: double description: The transaction amount, in USD (e.g. `102.05`) balance_threshold_percentage: type: integer minimum: 1 maximum: 100 default: 90 description: The threshold percentage of the account balance used for comparison with the requested ACH debit amount. requires_real_time_balance_refresh: type: boolean description: A boolean that determines whether the balance has to be refreshed in real time as part of the API call. AssetReportRemoveRequest: type: object description: AssetReportRemoveRequest defines the request schema for `/asset_report/remove` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' asset_report_token: $ref: '#/components/schemas/AssetReportToken' required: - asset_report_token TransactionStream: title: TransactionStream type: object description: A grouping of related transactions x-examples: {} additionalProperties: true properties: account_id: type: string description: The ID of the account to which the stream belongs stream_id: type: string description: A unique id for the stream category: deprecated: true type: array description: 'A hierarchical array of the categories to which this transaction belongs. See [Categories](https://plaid.com/docs/api/products/transactions/#categoriesget). All implementations are encouraged to use the new `personal_finance_category` instead of `category`. `personal_finance_category` provides more meaningful categorization and greater accuracy.' items: type: string category_id: deprecated: true description: 'The ID of the category to which this transaction belongs. See [Categories](https://plaid.com/docs/api/products/transactions/#categoriesget). All implementations are encouraged to use the new `personal_finance_category` instead of `category`. `personal_finance_category` provides more meaningful categorization and greater accuracy.' type: string description: type: string description: A description of the transaction stream. merchant_name: type: - string - 'null' description: The merchant associated with the transaction stream. first_date: type: string description: The posted date of the earliest transaction in the stream. format: date last_date: type: string description: The posted date of the latest transaction in the stream. format: date frequency: $ref: '#/components/schemas/RecurringTransactionFrequency' transaction_ids: type: array description: An array of Plaid transaction IDs belonging to the stream, sorted by posted date. items: type: string average_amount: $ref: '#/components/schemas/TransactionStreamAmount' last_amount: $ref: '#/components/schemas/TransactionStreamAmount' is_active: type: boolean description: Indicates whether the transaction stream is still live. status: $ref: '#/components/schemas/TransactionStreamStatus' personal_finance_category: $ref: '#/components/schemas/PersonalFinanceCategory' is_user_modified: type: boolean description: This will be set to `true` if the stream has been modified by request to a `/transactions/recurring/streams` endpoint. It will be `false` for all other streams. last_user_modified_datetime: type: string description: The date and time of the most recent user modification. This will only be set if `is_user_modified` is `true`. format: date-time required: - account_id - stream_id - category - category_id - description - merchant_name - first_date - last_date - frequency - transaction_ids - average_amount - last_amount - is_active - status - is_user_modified TransferCreditFundsSource: type: - string - 'null' title: TransferCreditFundsSource enum: - sweep - prefunded_rtp_credits - prefunded_ach_credits - null description: 'This field is now deprecated. You may ignore it for transfers created on and after 12/01/2023. Specifies the source of funds for the transfer. Only valid for `credit` transfers, and defaults to `sweep` if not specified. This field is not specified for `debit` transfers. `sweep` - Sweep funds from your funding account `prefunded_rtp_credits` - Use your prefunded RTP credit balance with Plaid `prefunded_ach_credits` - Use your prefunded ACH credit balance with Plaid' SingleDocumentRiskSignal: title: SingleDocumentRiskSignal type: object additionalProperties: true description: Object containing all risk signals and relevant metadata for a single document properties: document_reference: $ref: '#/components/schemas/RiskSignalDocumentReference' risk_signals: type: array description: Array of attributes that indicate whether or not there is fraud risk with a document items: $ref: '#/components/schemas/DocumentRiskSignal' risk_summary: $ref: '#/components/schemas/DocumentRiskSummary' required: - document_reference - risk_signals - risk_summary PartnerEndCustomerOAuthInstitution: description: The OAuth registration information for an institution. type: object additionalProperties: true properties: name: type: string institution_id: type: string environments: $ref: '#/components/schemas/PartnerEndCustomerOAuthInstitutionEnvironments' production_enablement_date: type: - string - 'null' description: The date on which the end customer's application was approved by the institution, or an empty string if their application has not yet been approved. classic_disablement_date: type: - string - 'null' description: The date on which non-OAuth Item adds will no longer be supported for this institution, or an empty string if no such date has been set by the institution. WalletTransactionCounterpartyInternational: description: International Bank Account Number for a Wallet Transaction type: - object - 'null' additionalProperties: true properties: iban: $ref: '#/components/schemas/NumbersIBAN' TransferAmount: title: TransferAmount type: string description: The amount of the transfer (decimal string with two digits of precision e.g. "10.00"). When calling `/transfer/authorization/create`, specify the maximum amount to authorize. When calling `/transfer/create`, specify the exact amount of the transfer, up to a maximum of the amount authorized. If this field is left blank when calling `/transfer/create`, the maximum amount authorized in the `authorization_id` will be sent. ItemStatusNullable: description: Information about the last successful and failed transactions update for the Item. allOf: - $ref: '#/components/schemas/ItemStatus' - type: object additionalProperties: true SandboxTransferRefundSimulateRequest: title: SandboxTransferRefundSimulateRequest type: object description: Defines the request schema for `/sandbox/transfer/refund/simulate` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' refund_id: $ref: '#/components/schemas/TransferRefundID' test_clock_id: type: - string - 'null' description: Plaid’s unique identifier for a test clock. If provided, the event to be simulated is created at the `virtual_time` on the provided `test_clock`. event_type: type: string description: 'The asynchronous event to be simulated. May be: `refund.posted`, `refund.settled`, `refund.failed`, or `refund.returned`. An error will be returned if the event type is incompatible with the current refund status. Compatible status --> event type transitions include: `refund.pending` --> `refund.failed` `refund.pending` --> `refund.posted` `refund.posted` --> `refund.returned` `refund.posted` --> `refund.settled` `refund.posted` events can only be simulated if the refunded transfer has been transitioned to settled. This mimics the ordering of events in Production. ' failure_reason: $ref: '#/components/schemas/TransferFailure' required: - refund_id - event_type ProcessorTokenWebhookUpdateResponse: type: object additionalProperties: true description: ProcessorTokenWebhookUpdateResponse defines the response schema for `/processor/token/webhook/update` properties: request_id: $ref: '#/components/schemas/RequestID' required: - request_id AccountBalance: title: AccountBalance type: object additionalProperties: true 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`. properties: available: type: - number - 'null' format: double description: 'The amount of funds available to be withdrawn from the account, as determined by the financial institution. For `credit`-type accounts, the `available` balance typically equals the `limit` less the `current` balance, less any pending outflows plus any pending inflows. For `depository`-type accounts, the `available` balance typically equals the `current` balance less any pending outflows plus any pending inflows. For `depository`-type accounts, the `available` balance does not include the overdraft limit. For `investment`-type accounts (or `brokerage`-type accounts for API versions 2018-05-22 and earlier), the `available` balance is the total cash available to withdraw as presented by the institution. Note that not all institutions calculate the `available` balance. In the event that `available` balance is unavailable, Plaid will return an `available` balance value of `null`. Available balance may be cached and is not guaranteed to be up-to-date in realtime unless the value was returned by `/accounts/balance/get`. If `current` is `null` this field is guaranteed not to be `null`.' current: type: - number - 'null' format: double description: 'The total amount of funds in or owed by the account. For `credit`-type accounts, a positive balance indicates the amount owed; a negative amount indicates the lender owing the account holder. For `loan`-type accounts, the current balance is the principal remaining on the loan, except in the case of student loan accounts at Sallie Mae (`ins_116944`). For Sallie Mae student loans, the account''s balance includes both principal and any outstanding interest. For `investment`-type accounts (or `brokerage`-type accounts for API versions 2018-05-22 and earlier), the current balance is the total value of assets as presented by the institution. Note that balance information may be cached unless the value was returned by `/accounts/balance/get`; if the Item is enabled for Transactions, the balance will be at least as recent as the most recent Transaction update. If you require realtime balance information, use the `available` balance as provided by `/accounts/balance/get`. When returned by `/accounts/balance/get`, this field may be `null`. When this happens, `available` is guaranteed not to be `null`.' limit: type: - number - 'null' format: double description: 'For `credit`-type accounts, this represents the credit limit. For `depository`-type accounts, this represents the pre-arranged overdraft limit, which is common for current (checking) accounts in Europe. In North America, this field is typically only available for `credit`-type accounts.' iso_currency_code: type: - string - 'null' description: The ISO-4217 currency code of the balance. Always null if `unofficial_currency_code` is non-null. unofficial_currency_code: type: - string - 'null' description: 'The unofficial currency code associated with the balance. Always null if `iso_currency_code` is non-null. Unofficial currency codes are used for currencies that do not have official ISO currency codes, such as cryptocurrencies and the currencies of certain countries. See the [currency code schema](https://plaid.com/docs/api/accounts#currency-code-schema) for a full listing of supported `unofficial_currency_code`s.' last_updated_datetime: type: - string - 'null' format: date-time description: 'Timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format (`YYYY-MM-DDTHH:mm:ssZ`) indicating the oldest acceptable balance when making a request to `/accounts/balance/get`. This field is only used and expected when the institution is `ins_128026` (Capital One) and the Item contains one or more accounts with a non-depository account type, in which case a value must be provided or an `INVALID_REQUEST` error with the code of `INVALID_FIELD` will be returned. For Capital One depository accounts as well as all other account types on all other institutions, this field is ignored. See [account type schema](https://en.wikipedia.org/wiki/ISO_8601) for a full list of account types. If the balance that is pulled is older than the given timestamp for Items with this field required, an `INVALID_REQUEST` error with the code of `LAST_UPDATED_DATETIME_OUT_OF_RANGE` will be returned with the most recent timestamp for the requested account contained in the response.' required: - available - current - limit - iso_currency_code - unofficial_currency_code FDXContentTypes: title: Content Types description: Types of document formats. (Suggested values) type: string enum: - application/pdf - image/gif - image/jpeg - image/tiff - image/png - application/json LinkDeliveryDeliveryMethod: type: string enum: - SMS - EMAIL description: 'The delivery method to be used to deliver the Hosted Link session URL. `SMS`: The URL will be delivered through SMS `EMAIL`: The URL will be delivered through email' ValidationSources: title: ValidationSources type: object additionalProperties: true description: Documentation not found in the MISMO model viewer and not provided by Freddie Mac. properties: VALIDATION_SOURCE: type: array items: $ref: '#/components/schemas/ValidationSource' description: Documentation not found in the MISMO model viewer and not provided by Freddie Mac. required: - VALIDATION_SOURCE LinkDeliverySessionStatus: type: string enum: - CREATED - OPENED - EXITED - COMPLETED - EXPIRED description: 'The status of the given Hosted Link session. `CREATED`: The session is created but not yet accessed by the user `OPENED`: The session is opened by the user but not yet completed `EXITED`: The session has been exited by the user `COMPLETED`: The session has been completed by the user `EXPIRED`: The session has expired' LinkDeliveryCommunicationMethod: type: object description: The communication method containing both the type and address to send the URL. properties: method: $ref: '#/components/schemas/LinkDeliveryDeliveryMethod' address: type: string description: The phone number / email address that Hosted Link sessions are delivered to. Phone numbers must be in E.164 format. AccountIdentityMatchScore: description: Identity match scores for an account title: AccountIdentityMatchScore allOf: - $ref: '#/components/schemas/AccountBase' - type: object additionalProperties: true properties: legal_name: $ref: '#/components/schemas/NameMatchScore' phone_number: $ref: '#/components/schemas/PhoneNumberMatchScore' email_address: $ref: '#/components/schemas/EmailAddressMatchScore' address: $ref: '#/components/schemas/AddressMatchScore' SignalEvaluateCoreAttributes: title: SignalEvaluateCoreAttributes type: object description: 'The core attributes object contains additional data that can be used to assess the ACH return risk. Examples of data include: `days_since_first_plaid_connection`: The number of days since the first time the Item was connected to an application via Plaid `plaid_connections_count_7d`: The number of times the Item has been connected to applications via Plaid over the past 7 days `plaid_connections_count_30d`: The number of times the Item has been connected to applications via Plaid over the past 30 days `total_plaid_connections_count`: The number of times the Item has been connected to applications via Plaid `is_savings_or_money_market_account`: Indicates whether the ACH transaction funding account is a savings/money market account For the full list and detailed documentation of core attributes available, or to request that core attributes not be returned, contact Sales or your Plaid account manager' properties: unauthorized_transactions_count_7d: type: - integer - 'null' description: We parse and analyze historical transaction metadata to identify the number of possible past returns due to unauthorized transactions over the past 7 days from the account that will be debited. unauthorized_transactions_count_30d: type: - integer - 'null' description: We parse and analyze historical transaction metadata to identify the number of possible past returns due to unauthorized transactions over the past 30 days from the account that will be debited. unauthorized_transactions_count_60d: type: - integer - 'null' description: We parse and analyze historical transaction metadata to identify the number of possible past returns due to unauthorized transactions over the past 60 days from the account that will be debited. unauthorized_transactions_count_90d: type: - integer - 'null' description: We parse and analyze historical transaction metadata to identify the number of possible past returns due to unauthorized transactions over the past 90 days from the account that will be debited. nsf_overdraft_transactions_count_7d: type: - integer - 'null' description: We parse and analyze historical transaction metadata to identify the number of possible past returns due to non-sufficient funds/overdrafts over the past 7 days from the account that will be debited. nsf_overdraft_transactions_count_30d: type: - integer - 'null' description: We parse and analyze historical transaction metadata to identify the number of possible past returns due to non-sufficient funds/overdrafts over the past 30 days from the account that will be debited. nsf_overdraft_transactions_count_60d: type: - integer - 'null' description: We parse and analyze historical transaction metadata to identify the number of possible past returns due to non-sufficient funds/overdrafts over the past 60 days from the account that will be debited. nsf_overdraft_transactions_count_90d: type: - integer - 'null' description: We parse and analyze historical transaction metadata to identify the number of possible past returns due to non-sufficient funds/overdrafts over the past 90 days from the account that will be debited. days_since_first_plaid_connection: type: - integer - 'null' description: The number of days since the first time the Item was connected to an application via Plaid plaid_connections_count_7d: type: - integer - 'null' description: The number of times the Item has been connected to applications via Plaid over the past 7 days plaid_connections_count_30d: type: - integer - 'null' description: The number of times the Item has been connected to applications via Plaid over the past 30 days total_plaid_connections_count: type: - integer - 'null' description: The total number of times the Item has been connected to applications via Plaid is_savings_or_money_market_account: type: - boolean - 'null' description: Indicates if the ACH transaction funding account is a savings/money market account total_credit_transactions_amount_10d: type: - number - 'null' format: double description: The total credit (inflow) transaction amount over the past 10 days from the account that will be debited total_debit_transactions_amount_10d: type: - number - 'null' format: double description: The total debit (outflow) transaction amount over the past 10 days from the account that will be debited p50_credit_transactions_amount_28d: type: - number - 'null' format: double description: The 50th percentile of all credit (inflow) transaction amounts over the past 28 days from the account that will be debited p50_debit_transactions_amount_28d: type: - number - 'null' format: double description: The 50th percentile of all debit (outflow) transaction amounts over the past 28 days from the account that will be debited p95_credit_transactions_amount_28d: type: - number - 'null' format: double description: The 95th percentile of all credit (inflow) transaction amounts over the past 28 days from the account that will be debited p95_debit_transactions_amount_28d: type: - number - 'null' format: double description: The 95th percentile of all debit (outflow) transaction amounts over the past 28 days from the account that will be debited days_with_negative_balance_count_90d: type: - integer - 'null' description: The number of days within the past 90 days when the account that will be debited had a negative end-of-day available balance p90_eod_balance_30d: type: - number - 'null' format: double description: The 90th percentile of the end-of-day available balance over the past 30 days of the account that will be debited p90_eod_balance_60d: type: - number - 'null' format: double description: The 90th percentile of the end-of-day available balance over the past 60 days of the account that will be debited p90_eod_balance_90d: type: - number - 'null' format: double description: The 90th percentile of the end-of-day available balance over the past 90 days of the account that will be debited p10_eod_balance_30d: type: - number - 'null' format: double description: The 10th percentile of the end-of-day available balance over the past 30 days of the account that will be debited p10_eod_balance_60d: type: - number - 'null' format: double description: The 10th percentile of the end-of-day available balance over the past 60 days of the account that will be debited p10_eod_balance_90d: type: - number - 'null' format: double description: The 10th percentile of the end-of-day available balance over the past 90 days of the account that will be debited available_balance: type: - number - 'null' format: double description: Available balance, as of the `balance_last_updated` time. The available balance is the current balance less any outstanding holds or debits that have not yet posted to the account. current_balance: type: - number - 'null' format: double description: Current balance, as of the `balance_last_updated` time. The current balance is the total amount of funds in the account. balance_last_updated: type: - string - 'null' format: date-time description: Timestamp in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format (YYYY-MM-DDTHH:mm:ssZ) indicating the last time that the balance for the given account has been updated. phone_change_count_28d: type: - integer - 'null' description: The number of times the account's phone numbers on file have changed over the past 28 days phone_change_count_90d: type: - integer - 'null' description: The number of times the account's phone numbers on file have changed over the past 90 days email_change_count_28d: type: - integer - 'null' description: The number of times the account's email addresses on file have changed over the past 28 days email_change_count_90d: type: - integer - 'null' description: The number of times the account's email addresses on file have changed over the past 90 days address_change_count_28d: type: - integer - 'null' description: The number of times the account's addresses on file have changed over the past 28 days address_change_count_90d: type: - integer - 'null' description: The number of times the account's addresses on file have changed over the past 90 days plaid_non_oauth_authentication_attempts_count_3d: type: - integer - 'null' description: The number of non-OAuth authentication attempts via Plaid for this bank account over the past 3 days plaid_non_oauth_authentication_attempts_count_7d: type: - integer - 'null' description: The number of non-OAuth authentication attempts via Plaid for this bank account over the past 7 days plaid_non_oauth_authentication_attempts_count_30d: type: - integer - 'null' description: The number of non-OAuth authentication attempts via Plaid for this bank account over the past 30 days failed_plaid_non_oauth_authentication_attempts_count_3d: type: - integer - 'null' description: The number of failed non-OAuth authentication attempts via Plaid for this bank account over the past 3 days failed_plaid_non_oauth_authentication_attempts_count_7d: type: - integer - 'null' description: The number of failed non-OAuth authentication attempts via Plaid for this bank account over the past 7 days failed_plaid_non_oauth_authentication_attempts_count_30d: type: - integer - 'null' description: The number of failed non-OAuth authentication attempts via Plaid for this bank account over the past 30 days debit_transactions_count_10d: type: - integer - 'null' description: The total number of debit (outflow) transactions over the past 10 days from the account that will be debited credit_transactions_count_10d: type: - integer - 'null' description: The total number of credit (inflow) transactions over the past 10 days from the account that will be debited debit_transactions_count_30d: type: - integer - 'null' description: The total number of debit (outflow) transactions over the past 30 days from the account that will be debited credit_transactions_count_30d: type: - integer - 'null' description: The total number of credit (inflow) transactions over the past 30 days from the account that will be debited debit_transactions_count_60d: type: - integer - 'null' description: The total number of debit (outflow) transactions over the past 60 days from the account that will be debited credit_transactions_count_60d: type: - integer - 'null' description: The total number of credit (inflow) transactions over the past 60 days from the account that will be debited debit_transactions_count_90d: type: - integer - 'null' description: The total number of debit (outflow) transactions over the past 90 days from the account that will be debited credit_transactions_count_90d: type: - integer - 'null' description: The total number of credit (inflow) transactions over the past 90 days from the account that will be debited total_debit_transactions_amount_30d: type: - number - 'null' format: double description: The total debit (outflow) transaction amount over the past 30 days from the account that will be debited total_credit_transactions_amount_30d: type: - number - 'null' format: double description: The total credit (inflow) transaction amount over the past 30 days from the account that will be debited total_debit_transactions_amount_60d: type: - number - 'null' format: double description: The total debit (outflow) transaction amount over the past 60 days from the account that will be debited total_credit_transactions_amount_60d: type: - number - 'null' format: double description: The total credit (inflow) transaction amount over the past 60 days from the account that will be debited total_debit_transactions_amount_90d: type: - number - 'null' format: double description: The total debit (outflow) transaction amount over the past 90 days from the account that will be debited total_credit_transactions_amount_90d: type: - number - 'null' format: double description: The total credit (inflow) transaction amount over the past 90 days from the account that will be debited p50_eod_balance_30d: type: - number - 'null' format: double description: The 50th percentile of the end-of-day available balance over the past 30 days of the account that will be debited p50_eod_balance_60d: type: - number - 'null' format: double description: The 50th percentile of the end-of-day available balance over the past 60 days of the account that will be debited p50_eod_balance_90d: type: - number - 'null' format: double description: The 50th percentile of the end-of-day available balance over the past 90 days of the account that will be debited p50_eod_balance_31d_to_60d: type: - number - 'null' format: double description: The 50th percentile of the end-of-day available balance between day 31 and day 60 over the past 60 days of the account that will be debited p50_eod_balance_61d_to_90d: type: - number - 'null' format: double description: The 50th percentile of the end-of-day available balance between day 61 and day 90 over the past 60 days of the account that will be debited p90_eod_balance_31d_to_60d: type: - number - 'null' format: double description: The 90th percentile of the end-of-day available balance between day 31 and day 60 over the past 60 days of the account that will be debited p90_eod_balance_61d_to_90d: type: - number - 'null' format: double description: The 90th percentile of the end-of-day available balance between day 61 and day 90 over the past 60 days of the account that will be debited p10_eod_balance_31d_to_60d: type: - number - 'null' format: double description: The 10th percentile of the end-of-day available balance between day 31 and day 60 over the past 60 days of the account that will be debited p10_eod_balance_61d_to_90d: type: - number - 'null' format: double description: The 10th percentile of the end-of-day available balance between day 61 and day 90 over the past 60 days of the account that will be debited transactions_last_updated: type: - string - 'null' format: date-time description: Timestamp in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format (YYYY-MM-DDTHH:mm:ssZ) indicating the last time that the transactions for the given account have been updated. is_account_closed: type: - boolean - 'null' description: Indicates if the receiver bank account is closed is_account_frozen_or_restricted: type: - boolean - 'null' description: Indicates if the receiver bank account is either frozen or restricted distinct_ip_addresses_count_3d: type: - integer - 'null' description: The number of distinct IP addresses linked to the same bank account during Plaid authentication in the last 3 days distinct_ip_addresses_count_7d: type: - integer - 'null' description: The number of distinct IP addresses linked to the same bank account during Plaid authentication in the last 7 days distinct_ip_addresses_count_30d: type: - integer - 'null' description: The number of distinct IP addresses linked to the same bank account during Plaid authentication in the last 30 days (max 100) distinct_ip_addresses_count_90d: type: - integer - 'null' description: The number of distinct IP addresses linked to the same bank account during Plaid authentication in the last 90 days (max 100) distinct_user_agents_count_3d: type: - integer - 'null' description: The number of distinct user agents linked to the same bank account during Plaid authentication in the last 3 days distinct_user_agents_count_7d: type: - integer - 'null' description: The number of distinct user agents linked to the same bank account during Plaid authentication in the last 7 days distinct_user_agents_count_30d: type: - integer - 'null' description: The number of distinct user agents linked to the same bank account during Plaid authentication in the last 30 days distinct_user_agents_count_90d: type: - integer - 'null' description: The number of distinct user agents linked to the same bank account during Plaid authentication in the last 90 days distinct_ssl_tls_connection_sessions_count_3d: type: - integer - 'null' description: The number of distinct SSL/TLS connection sessions linked to the same bank account during Plaid authentication in the last 3 days distinct_ssl_tls_connection_sessions_count_7d: type: - integer - 'null' description: The number of distinct SSL/TLS connection sessions linked to the same bank account during Plaid authentication in the last 7 days distinct_ssl_tls_connection_sessions_count_30d: type: - integer - 'null' description: The number of distinct SSL/TLS connection sessions linked to the same bank account during Plaid authentication in the last 30 days distinct_ssl_tls_connection_sessions_count_90d: type: - integer - 'null' description: The number of distinct SSL/TLS connection sessions linked to the same bank account during Plaid authentication in the last 90 days days_since_account_opening: type: - integer - 'null' description: The number of days since the bank account was opened, as reported by the financial institution WalletTransactionExecuteRequest: type: object description: WalletTransactionExecuteRequest defines the request schema for `/wallet/transaction/execute` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' idempotency_key: $ref: '#/components/schemas/WalletTransactionIdempotencyKey' wallet_id: type: string description: The ID of the e-wallet to debit from minLength: 1 counterparty: $ref: '#/components/schemas/WalletTransactionCounterparty' amount: $ref: '#/components/schemas/WalletTransactionAmount' reference: type: string maxLength: 18 minLength: 6 description: 'A reference for the transaction. This must be an alphanumeric string with 6 to 18 characters and must not contain any special characters or spaces. Ensure that the `reference` field is unique for each transaction.' required: - idempotency_key - wallet_id - counterparty - amount - reference IdentityVerificationStepSummary: type: object description: 'Each step will be one of the following values: `active` - This step is the user''s current step. They are either in the process of completing this step, or they recently closed their Identity Verification attempt while in the middle of this step. Only one step will be marked as `active` at any given point. `success` - The Identity Verification attempt has completed this step. `failed` - The user failed this step. This can either call the user to fail the session as a whole, or cause them to fallback to another step depending on how the Identity Verification template is configured. A failed step does not imply a failed session. `waiting_for_prerequisite` - The user needs to complete another step first, before they progress to this step. This step may never run, depending on if the user fails an earlier step or if the step is only run as a fallback. `not_applicable` - This step will not be run for this session. `skipped` - The retry instructions that created this Identity Verification attempt specified that this step should be skipped. `expired` - This step had not yet been completed when the Identity Verification attempt as a whole expired. `canceled` - The Identity Verification attempt was canceled before the user completed this step. `pending_review` - The Identity Verification attempt template was configured to perform a screening that had one or more hits needing review. `manually_approved` - The step was manually overridden to pass by a team member in the dashboard. `manually_rejected` - The step was manually overridden to fail by a team member in the dashboard.' required: - accept_tos - verify_sms - kyc_check - documentary_verification - selfie_check - watchlist_screening - risk_check properties: accept_tos: $ref: '#/components/schemas/IdentityVerificationStepStatus' verify_sms: $ref: '#/components/schemas/IdentityVerificationStepStatus' kyc_check: $ref: '#/components/schemas/IdentityVerificationStepStatus' documentary_verification: $ref: '#/components/schemas/IdentityVerificationStepStatus' selfie_check: $ref: '#/components/schemas/IdentityVerificationStepStatus' watchlist_screening: $ref: '#/components/schemas/IdentityVerificationStepStatus' risk_check: $ref: '#/components/schemas/IdentityVerificationStepStatus' additionalProperties: true CraLoanPaymentHistory: type: object description: Contains the payment information for a loan payment period. additionalProperties: true properties: period: type: integer description: "The index to identify the loan's payment period, starting from 1.\nFor example:\n 1 means the period between the loan's opening date and the 1st payment due date.\n 2 means the period between the loan's 1st payment due date and 2nd payment due date." due_date: type: string format: date description: The payment due date or end date of the payment period. The date should be in ISO 8601 format (YYYY-MM-DD). days_past_due: type: integer description: 'The number of days the loan was delinquent at the end of the pay period. If specified, should be greater of equal to 0.' amount_past_due: type: number description: The amount past due or the charge-off amount of the loan at the end of the payment period. balance_remaining: type: number description: The balance remaining on the loan at the end of the payment period. required: - period - due_date - days_past_due WatchlistScreeningIndividualProgramGetRequest: description: Request input for fetching an individual watchlist program type: object properties: watchlist_program_id: $ref: '#/components/schemas/WatchlistProgramID' secret: $ref: '#/components/schemas/APISecret' client_id: $ref: '#/components/schemas/APIClientID' required: - watchlist_program_id TransferLedgerDistributeRequest: title: TransferLedgerDistributeRequest type: object description: Defines the request schema for `/transfer/ledger/distribute` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' from_client_id: type: string description: The client to pull money from. Must be the platform itself or its originator. One of `from_client_id` and `to_client_id` must be the platform's `client_id`. to_client_id: type: string description: The client to credit money to. Must be the platform itself or its originator. One of `from_client_id` and `to_client_id` must be the platform's `client_id`. amount: type: string description: The amount to move (decimal string with two digits of precision e.g. "10.00"). Amount must be positive. idempotency_key: $ref: '#/components/schemas/LedgerDistributeIdempotencyKey' description: type: string description: An optional description for the ledger distribute operation. required: - from_client_id - to_client_id - amount - idempotency_key ItemGetRequest: description: ItemGetRequest defines the request schema for `/item/get` type: object properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' access_token: $ref: '#/components/schemas/AccessToken' required: - access_token ScopesState: description: When scopes are updated during enrollment, this field must be populated with the state sent to the partner in the OAuth Login URI. This field is required when the context is `ENROLLMENT`. type: string DepositSwitchCreateRequest: type: object description: DepositSwitchCreateRequest defines the request schema for `/deposit_switch/create` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' target_access_token: type: string description: 'Access token for the target Item, typically provided in the Import Item response. ' target_account_id: type: string description: Plaid Account ID that specifies the target bank account. This account will become the recipient for a user's direct deposit. country_code: type: - string - 'null' title: CountryCode enum: - US - CA description: ISO-3166-1 alpha-2 country code standard. options: $ref: '#/components/schemas/DepositSwitchCreateRequestOptions' required: - target_access_token - target_account_id MortgageLiability: title: MortgageLiability type: object additionalProperties: true description: Contains details about a mortgage account. properties: account_id: type: string description: The ID of the account that this liability belongs to. account_number: type: string description: The account number of the loan. current_late_fee: description: The current outstanding amount charged for late payment. type: - number - 'null' format: double escrow_balance: type: - number - 'null' format: double description: Total amount held in escrow to pay taxes and insurance on behalf of the borrower. has_pmi: type: - boolean - 'null' description: Indicates whether the borrower has private mortgage insurance in effect. has_prepayment_penalty: description: Indicates whether the borrower will pay a penalty for early payoff of mortgage. type: - boolean - 'null' interest_rate: $ref: '#/components/schemas/MortgageInterestRate' last_payment_amount: description: The amount of the last payment. type: - number - 'null' format: double last_payment_date: type: - string - 'null' format: date description: The date of the last payment. Dates are returned in an [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format (YYYY-MM-DD). loan_type_description: description: 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. type: - string - 'null' loan_term: description: Full duration of mortgage as at origination (e.g. `10 year`). type: - string - 'null' maturity_date: type: - string - 'null' format: date description: Original date on which mortgage is due in full. Dates are returned in an [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format (YYYY-MM-DD). next_monthly_payment: type: - number - 'null' format: double description: The amount of the next payment. next_payment_due_date: description: The due date for the next payment. Dates are returned in an [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format (YYYY-MM-DD). type: - string - 'null' format: date origination_date: description: The date on which the loan was initially lent. Dates are returned in an [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format (YYYY-MM-DD). type: - string - 'null' format: date origination_principal_amount: type: - number - 'null' format: double description: The original principal balance of the mortgage. past_due_amount: type: - number - 'null' format: double description: Amount of loan (principal + interest) past due for payment. property_address: $ref: '#/components/schemas/MortgagePropertyAddress' ytd_interest_paid: description: The year to date (YTD) interest paid. type: - number - 'null' format: double ytd_principal_paid: type: - number - 'null' format: double description: The YTD principal paid. required: - account_id - account_number - current_late_fee - escrow_balance - has_pmi - has_prepayment_penalty - interest_rate - last_payment_amount - last_payment_date - loan_type_description - loan_term - maturity_date - next_monthly_payment - next_payment_due_date - origination_date - origination_principal_amount - past_due_amount - property_address - ytd_interest_paid - ytd_principal_paid ProcessorTransactionsRefreshResponse: type: object additionalProperties: true description: ProcessorTransactionsRefreshResponse defines the response schema for `/processor/transactions/refresh` properties: request_id: $ref: '#/components/schemas/RequestID' required: - request_id Originator: type: object title: Originator additionalProperties: true description: Originator and their status. properties: client_id: type: string description: Originator’s client ID. transfer_diligence_status: $ref: '#/components/schemas/TransferDiligenceStatus' required: - client_id - transfer_diligence_status ProgramArchived: type: boolean example: false title: Archived description: Archived programs are read-only and cannot screen new customers nor participate in ongoing monitoring. WatchlistScreeningIndividualReviewCreateRequest: type: object description: Request input for creating a screening review properties: confirmed_hits: type: array items: $ref: '#/components/schemas/WatchlistScreeningHitID' description: Hits to mark as a true positive after thorough manual review. These hits will never recur or be updated once dismissed. In most cases, confirmed hits indicate that the customer should be rejected. dismissed_hits: type: array items: $ref: '#/components/schemas/WatchlistScreeningHitID' description: Hits to mark as a false positive after thorough manual review. These hits will never recur or be updated once dismissed. comment: $ref: '#/components/schemas/ReviewComment' client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' watchlist_screening_id: $ref: '#/components/schemas/WatchlistScreeningIndividualID' required: - confirmed_hits - dismissed_hits - watchlist_screening_id CreditPayStubPayBasisType: type: string description: The explicit pay basis on the paystub (if present). enum: - SALARY - HOURLY - COMMISSION TransactionsEnrichRequest: type: object description: TransactionsEnrichRequest defines the request schema for `/transactions/enrich`. properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' account_type: type: string description: The account type for the requested transactions (either `depository` or `credit`). transactions: type: array description: An array of transaction objects to be enriched by Plaid. Maximum of 100 transactions per request. items: $ref: '#/components/schemas/ClientProvidedTransaction' options: $ref: '#/components/schemas/TransactionsEnrichRequestOptions' required: - account_type - transactions TransferIntentGetResponse: title: TransferIntentGetResponse type: object additionalProperties: true description: Defines the response schema for `/transfer/intent/get` properties: transfer_intent: $ref: '#/components/schemas/TransferIntentGet' request_id: $ref: '#/components/schemas/RequestID' required: - transfer_intent - request_id BankTransferListRequest: title: BankTransferListRequest type: object description: Defines the request schema for `/bank_transfer/list` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' start_date: type: - string - 'null' format: date-time description: The start datetime of bank transfers to list. This should be in RFC 3339 format (i.e. `2019-12-06T22:35:49Z`) end_date: type: - string - 'null' format: date-time description: The end datetime of bank transfers to list. This should be in RFC 3339 format (i.e. `2019-12-06T22:35:49Z`) count: type: integer minimum: 1 maximum: 25 default: 25 description: The maximum number of bank transfers to return. offset: type: integer default: 0 minimum: 0 description: The number of bank transfers to skip before returning results. origination_account_id: type: - string - 'null' description: Filter bank transfers to only those originated through the specified origination account. direction: $ref: '#/components/schemas/BankTransferDirection' HostedLinkURLLifetimeSeconds: type: integer description: 'How many seconds the link will be valid for. Must be positive. Cannot be longer than 21 days. The default lifetime is 4 hours. ' PaymentProfileGetRequest: type: object description: PaymentProfileGetRequest defines the request schema for `/payment_profile/get` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' payment_profile_token: $ref: '#/components/schemas/PaymentProfileToken' required: - payment_profile_token ScreeningHitDocumentsItems: description: Analyzed document information for the associated hit type: object properties: analysis: $ref: '#/components/schemas/MatchSummary' data: $ref: '#/components/schemas/WatchlistScreeningDocument' additionalProperties: true BeaconDuplicateGetRequest: description: Request input for getting a Beacon Duplicate type: object properties: beacon_duplicate_id: $ref: '#/components/schemas/BeaconDuplicateID' client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' required: - beacon_duplicate_id CreditPayStubEarnings: title: CreditPayStubEarnings type: object description: An object representing both a breakdown of earnings on a pay stub and the total earnings. additionalProperties: true properties: breakdown: type: array items: $ref: '#/components/schemas/PayStubEarningsBreakdown' total: $ref: '#/components/schemas/PayStubEarningsTotal' required: - breakdown - total TransferEvent: title: TransferEvent type: object additionalProperties: true description: Represents an event in the Transfers API. properties: event_id: type: integer description: Plaid’s unique identifier for this event. IDs are sequential unsigned 64-bit integers. minimum: 0 timestamp: type: string format: date-time description: The datetime when this event occurred. This will be of the form `2006-01-02T15:04:05Z`. event_type: $ref: '#/components/schemas/TransferEventType' account_id: type: string description: The account ID associated with the transfer. This field is omitted for Plaid Ledger Sweep events. funding_account_id: $ref: '#/components/schemas/TransferFundingAccountIDResponseNullable' transfer_id: type: string description: Plaid’s unique identifier for a transfer. This field is `null` for Plaid Ledger Sweep events. origination_account_id: type: - string - 'null' description: The ID of the origination account that this balance belongs to. deprecated: true x-hidden-from-docs: true transfer_type: $ref: '#/components/schemas/OmittableTransferType' transfer_amount: title: TransferAmount type: string description: The amount of the transfer (decimal string with two digits of precision e.g. "10.00"). This field is omitted for Plaid Ledger Sweep events. failure_reason: $ref: '#/components/schemas/TransferFailure' sweep_id: $ref: '#/components/schemas/TransferSweepIDNullable' sweep_amount: $ref: '#/components/schemas/TransferSweepAmount' refund_id: type: - string - 'null' description: Plaid’s unique identifier for a refund. A non-null value indicates the event is for the associated refund of the transfer. originator_client_id: type: - string - 'null' description: The Plaid client ID that is the originator of the transfer that this event applies to. Only present if the transfer was created on behalf of another client as a third-party sender (TPS). required: - event_id - timestamp - event_type - transfer_id - origination_account_id - failure_reason - sweep_id - sweep_amount - refund_id - originator_client_id - funding_account_id BaseReport: title: BaseReport type: object additionalProperties: true description: An object representing a Base Report x-hidden-from-docs: true properties: report_id: $ref: '#/components/schemas/BaseReportId' date_generated: type: string format: date-time description: The date and time when the Base Report was created, in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format (e.g. "2018-04-12T03:32:11Z"). days_requested: type: number description: The number of days of transaction history requested. client_report_id: type: - string - 'null' description: Client-generated identifier, which can be used by lenders to track loan applications. items: type: array description: Data returned by Plaid about each of the Items included in the Base Report. items: $ref: '#/components/schemas/BaseReportItem' required: - report_id - date_generated - days_requested - items CreditBankIncomeAccount: type: object description: The Item's bank accounts that have the selected data. properties: account_id: type: string description: Plaid's unique identifier for the account. mask: type: - string - 'null' description: 'The last 2-4 alphanumeric characters of an account''s official account number. Note that the mask may be non-unique between an Item''s accounts, and it may also not match the mask that the bank displays to the user.' name: type: string description: The name of the bank account. official_name: type: - string - 'null' description: The official name of the bank account. subtype: $ref: '#/components/schemas/DepositoryAccountSubtype' type: $ref: '#/components/schemas/CreditBankIncomeAccountType' owners: type: array description: Data returned by the financial institution about the account owner or owners. Identity information is optional, so field may return an empty array. items: $ref: '#/components/schemas/Owner' required: - account_id - mask - name - official_name - subtype - type - owners CraLoanStatus: type: string description: The status of the loan. enum: - APPROVED - DECLINED - BOOKED - CURRENT - DELINQUENT - DEFAULT - CHARGED_OFF - TRANSFERRED - PAID_OFF - OTHER EntityWatchlistCode: type: string enum: - CA_CON - EU_CON - IZ_SOE - IZ_UNC - IZ_WBK - US_CAP - US_FSE - US_MBS - US_SDN - US_SSI - US_CMC - US_UVL - AU_CON - UK_HMC example: EU_CON description: "Shorthand identifier for a specific screening list for entities.\n `AU_CON`: Australia Department of Foreign Affairs and Trade Consolidated List\n `CA_CON`: Government of Canada Consolidated List of Sanctions\n `EU_CON`: European External Action Service Consolidated List\n `IZ_SOE`: State Owned Enterprise List\n `IZ_UNC`: United Nations Consolidated Sanctions\n `IZ_WBK`: World Bank Listing of Ineligible Firms and Individuals\n `US_CAP`: US OFAC Correspondent Account or Payable-Through Account Sanctions\n `US_FSE`: US OFAC Foreign Sanctions Evaders\n `US_MBS`: US Non-SDN Menu-Based Sanctions\n `US_SDN`: US Specially Designated Nationals List\n `US_SSI`: US OFAC Sectoral Sanctions Identifications\n `US_CMC`: US OFAC Non-SDN Chinese Military-Industrial Complex List\n `US_UVL`: Bureau of Industry and Security Unverified List\n `UK_HMC`: UK HM Treasury Consolidated List" title: EntityWatchlistCode TransferLedgerDepositResponse: title: TransferLedgerDepositResponse type: object additionalProperties: true description: Defines the response schema for `/transfer/ledger/deposit` properties: sweep: $ref: '#/components/schemas/TransferSweep' request_id: $ref: '#/components/schemas/RequestID' required: - sweep - request_id CraPredictionInterval: description: The object containing prediction interval data. type: object additionalProperties: true properties: lower_bound: type: - number - 'null' description: The lower bound of the predicted attribute for the given probability. upper_bound: type: - number - 'null' description: The upper bound of the predicted attribute for the given probability. probability: type: - number - 'null' description: 'The probability of the actual value of the attribute falling within the upper and lower bound. This is a percentage represented as a value between 0 and 1.' AddressMatchScore: title: AddressMatchScore type: - object - 'null' additionalProperties: true description: Score found by matching address provided by the API with the address on the account at the financial institution. The score can range from 0 to 100 where 100 is a perfect match and 0 is a no match. If the account contains multiple owners, the maximum match score is filled. properties: score: type: - integer - 'null' description: Match score for address. 100 is a perfect match, 99-90 is a strong match, 89-70 is a partial match, anything below 70 is considered a weak match. Typically, the match threshold should be set to a score of 70 or higher. If the address is missing from either the API or financial institution, this is null. is_postal_code_match: type: - boolean - 'null' description: postal code was provided for both and was a match ProcessorTransactionsRecurringGetRequest: type: object description: ProcessorTransactionsRecurringGetRequest defines the request schema for `/processor/transactions/recurring/get` properties: client_id: $ref: '#/components/schemas/APIClientID' processor_token: $ref: '#/components/schemas/ProcessorToken' secret: $ref: '#/components/schemas/APISecret' options: $ref: '#/components/schemas/TransactionsRecurringGetRequestOptions' required: - processor_token IdentityVerificationDocumentStreet: type: string example: 123 Main St. Unit 42 title: IdentityVerificationDocumentStreet description: The full street address extracted from the document. CreditBankEmploymentWarning: type: object description: The warning associated with the data that was unavailable for the Bank Employment Report. properties: warning_type: $ref: '#/components/schemas/CreditBankEmploymentWarningType' warning_code: $ref: '#/components/schemas/CreditBankIncomeWarningCode' cause: $ref: '#/components/schemas/CreditBankIncomeCause' required: - warning_type - warning_code - cause AssetReportAuditCopyRemoveRequest: type: object description: AssetReportAuditCopyRemoveRequest defines the request schema for `/asset_report/audit_copy/remove` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' audit_copy_token: type: string description: The `audit_copy_token` granting access to the Audit Copy you would like to revoke. required: - audit_copy_token DepositSwitchCreateRequestOptions: type: object title: DepositSwitchCreateRequestOptions description: Options to configure the `/deposit_switch/create` request. If provided, cannot be `null`. x-private-visibility: false properties: webhook: type: - string - 'null' description: 'The URL registered to receive webhooks when the status of a deposit switch request has changed. ' transaction_item_access_tokens: type: array description: An array of access tokens corresponding to transaction items to use when attempting to match the user to their Payroll Provider. These tokens must be created by the same client id as the one creating the switch, and have access to the transactions product. items: $ref: '#/components/schemas/AccessToken' minItems: 1 maxItems: 99 Employer: title: Employer type: object additionalProperties: true description: Data about the employer. properties: employer_id: type: string description: Plaid's unique identifier for the employer. name: type: string description: The name of the employer address: $ref: '#/components/schemas/AddressDataNullable' confidence_score: type: number format: double description: A number from 0 to 1 indicating Plaid's level of confidence in the pairing between the employer and the institution (not yet implemented). required: - employer_id - name - address - confidence_score Enhancements: title: Enhancements type: object description: A grouping of the Plaid produced transaction enhancement fields. additionalProperties: true properties: merchant_name: type: - string - 'null' description: The name of the primary counterparty, such as the merchant or the financial institution, as extracted by Plaid from the raw description. website: type: - string - 'null' description: The website associated with this transaction, if available. logo_url: type: - string - 'null' description: The URL of a logo associated with this transaction, if available. The logo will always be 100×100 pixel PNG file. check_number: type: - string - 'null' description: The check number of the transaction. This field is only populated for check transactions. payment_channel: $ref: '#/components/schemas/PaymentChannel' category_id: description: The ID of the category to which this transaction belongs. For a full list of categories, see [`/categories/get`](https://plaid.com/docs/api/products/transactions/#categoriesget). type: - string - 'null' category: type: array description: A hierarchical array of the categories to which this transaction belongs. For a full list of categories, see [`/categories/get`](https://plaid.com/docs/api/products/transactions/#categoriesget). items: type: string location: $ref: '#/components/schemas/Location' personal_finance_category: $ref: '#/components/schemas/PersonalFinanceCategory' personal_finance_category_icon_url: type: string description: The URL of an icon associated with the primary personal finance category. The icon will always be 100×100 pixel PNG file. counterparties: type: array description: The counterparties present in the transaction. Counterparties, such as the merchant or the financial institution, are extracted by Plaid from the raw description. items: $ref: '#/components/schemas/Counterparty' required: - payment_channel - location - category - category_id TransferConfigurationGetResponse: title: TransferConfigurationGetResponse type: object additionalProperties: true description: Defines the response schema for `/transfer/configuration/get` properties: request_id: $ref: '#/components/schemas/RequestID' max_single_transfer_amount: type: string description: The max limit of dollar amount of a single transfer (decimal string with two digits of precision e.g. "10.00"). deprecated: true x-hidden-from-docs: true max_single_transfer_credit_amount: type: string description: The max limit of dollar amount of a single credit transfer (decimal string with two digits of precision e.g. "10.00"). max_single_transfer_debit_amount: type: string description: The max limit of dollar amount of a single debit transfer (decimal string with two digits of precision e.g. "10.00"). max_daily_credit_amount: type: string description: The max limit of sum of dollar amount of credit transfers in last 24 hours (decimal string with two digits of precision e.g. "10.00"). max_daily_debit_amount: type: string description: The max limit of sum of dollar amount of debit transfers in last 24 hours (decimal string with two digits of precision e.g. "10.00"). max_monthly_amount: type: string description: The max limit of sum of dollar amount of credit and debit transfers in one calendar month (decimal string with two digits of precision e.g. "10.00"). deprecated: true x-hidden-from-docs: true max_monthly_credit_amount: type: string description: The max limit of sum of dollar amount of credit transfers in one calendar month (decimal string with two digits of precision e.g. "10.00"). max_monthly_debit_amount: type: string description: The max limit of sum of dollar amount of debit transfers in one calendar month (decimal string with two digits of precision e.g. "10.00"). iso_currency_code: type: string description: The currency of the dollar amount, e.g. "USD". required: - request_id - max_single_transfer_amount - max_single_transfer_credit_amount - max_single_transfer_debit_amount - max_daily_credit_amount - max_daily_debit_amount - max_monthly_amount - max_monthly_credit_amount - max_monthly_debit_amount - iso_currency_code TransactionsUserInsightsGetRequest: type: object description: TransactionsUserInsightsGetRequest defines the request schema for `/beta/transactions/user_insights/v1/get`. properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' client_user_id: type: string description: A unique client-provided user_id to retrieve insights for. required: - client_user_id BeaconReportSyndicationAnalysis: type: object title: BeaconReportSyndicationAnalysis description: Analysis of which fields matched between the originally reported Beacon User and the Beacon User that the report was syndicated to. properties: address: $ref: '#/components/schemas/BeaconMatchSummaryCode' date_of_birth: $ref: '#/components/schemas/BeaconMatchSummaryCode' email_address: $ref: '#/components/schemas/BeaconMatchSummaryCode' name: $ref: '#/components/schemas/BeaconMatchSummaryCode' id_number: $ref: '#/components/schemas/BeaconMatchSummaryCode' ip_address: $ref: '#/components/schemas/BeaconMatchSummaryCode' phone_number: $ref: '#/components/schemas/BeaconMatchSummaryCode' required: - address - date_of_birth - email_address - name - id_number - ip_address - phone_number additionalProperties: true TransferLedgerDistributeResponse: title: TransferLedgerDistributeResponse type: object additionalProperties: true description: Defines the response schema for `/transfer/ledger/distribute` properties: request_id: $ref: '#/components/schemas/RequestID' required: - request_id SandboxTransferSimulateRequest: title: SandboxTransferSimulateRequest type: object description: Defines the request schema for `/sandbox/transfer/simulate` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' transfer_id: $ref: '#/components/schemas/TransferID' test_clock_id: type: - string - 'null' description: Plaid’s unique identifier for a test clock. If provided, the event to be simulated is created at the `virtual_time` on the provided `test_clock`. event_type: type: string description: 'The asynchronous event to be simulated. May be: `posted`, `settled`, `failed`, or `returned`. An error will be returned if the event type is incompatible with the current transfer status. Compatible status --> event type transitions include: `pending` --> `failed` `pending` --> `posted` `posted` --> `returned` `posted` --> `settled` ' failure_reason: $ref: '#/components/schemas/TransferFailure' required: - transfer_id - event_type CreditAccountSubtype: type: string description: Valid account subtypes for credit accounts. For a list containing descriptions of each subtype, see [Account schemas](https://plaid.com/docs/api/accounts/#StandaloneAccountType-credit). enum: - credit card - paypal - all LinkTokenCreateRequest: type: object description: LinkTokenCreateRequest defines the request schema for `/link/token/create` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' client_name: type: string description: The name of your application, as it should be displayed in Link. Maximum length of 30 characters. If a value longer than 30 characters is provided, Link will display "This Application" instead. minLength: 1 language: type: string description: 'The language that Link should be displayed in. When initializing with Identity Verification, this field is not used; for more details, see [Identity Verification supported languages](https://www.plaid.com/docs/identity-verification/#supported-languages). Supported languages are: - Danish (`''da''`) - Dutch (`''nl''`) - English (`''en''`) - Estonian (`''et''`) - French (`''fr''`) - German (`''de''`) - Italian (`''it''`) - Latvian (`''lv''`) - Lithuanian (`''lt''`) - Norwegian (`''no''`) - Polish (`''pl''`) - Portuguese (`''pt''`) - Romanian (`''ro''`) - Spanish (`''es''`) - Swedish (`''sv''`) When using a Link customization, the language configured here must match the setting in the customization, or the customization will not be applied.' minLength: 1 country_codes: type: array description: 'Specify an array of Plaid-supported country codes using the ISO-3166-1 alpha-2 country code standard. Institutions from all listed countries will be shown. For a complete mapping of supported products by country, see https://plaid.com/global/. If using Identity Verification, `country_codes` should be set to the country where your company is based, not the country where your user is located. For all other products, `country_codes` represents the location of your user''s financial institution. If Link is launched with multiple country codes, only products that you are enabled for in all countries will be used by Link. Note that while all countries are enabled by default in Sandbox and Development, in Production only US and Canada are enabled by default. Access to European institutions requires additional compliance steps. To request access to European institutions in the Production environment, [file a product access Support ticket](https://dashboard.plaid.com/support/new/product-and-development/product-troubleshooting/request-product-access) via the Plaid dashboard. If you initialize with a European country code, your users will see the European consent panel during the Link flow. If using a Link customization, make sure the country codes in the customization match those specified in `country_codes`, or the customization may not be applied. If using the Auth features Instant Match, Same-day Micro-deposits, or Automated Micro-deposits, `country_codes` must be set to `[''US'']`.' items: $ref: '#/components/schemas/CountryCode' minItems: 1 user: $ref: '#/components/schemas/LinkTokenCreateRequestUser' products: type: - array - 'null' description: 'List of Plaid product(s) you wish to use. If launching Link in update mode, should be omitted (unless you are using update mode to add Income or Assets to an Item); required otherwise. `balance` is *not* a valid value, the Balance product does not require explicit initialization and will automatically be initialized when any other product is initialized. The products specified here will determine which institutions will be available to your users in Link. Only institutions that support *all* requested products can be selected; a if a user attempts to select an institution that does not support a listed product, a "Connectivity not supported" error message will appear in Link. To maximize the number of institutions available, initialize Link with the minimal product set required for your use case. Additional products can be included via the [`optional_products`](https://plaid.com/docs/api/tokens/#link-token-create-request-optional-products) or [`required_if_supported_products`](https://plaid.com/docs/api/tokens/#link-token-create-request-required-if-supported-products) fields, or can be initialized by calling the endpoint after obtaining an access token. For details and exceptions, see [Choosing when to initialize products](https://plaid.com/docs/link/initializing-products/). Note that, unless you have opted to disable Instant Match support, institutions that support Instant Match will also be shown in Link if `auth` is specified as a product, even though these institutions do not contain `auth` in their product array. In Production, you will be billed for each product that you specify when initializing Link. Note that a product cannot be removed from an Item once the Item has been initialized with that product. To stop billing on an Item for subscription-based products, such as Liabilities, Investments, and Transactions, remove the Item via `/item/remove`.' items: $ref: '#/components/schemas/Products' x-override-enum-values-shown: - assets - auth - employment - identity - income_verification - identity_verification - investments - liabilities - payment_initiation - standing_orders - transactions - transfer - signal required_if_supported_products: type: - array - 'null' description: 'List of Plaid product(s) you wish to use only if the institution and account(s) selected by the user support the product. Institutions that do not support these products will still be shown in Link. The products will only be extracted and billed if the user selects an institution and account type that supports them. There should be no overlap between this array and the `products`, `optional_products`, or `additional_consented_products` arrays. The `products` array must have at least one product. For more details on using this feature, see [Required if Supported Products](https://www.plaid.com/docs/link/initializing-products/#required-if-supported-products).' items: $ref: '#/components/schemas/Products' x-override-enum-values-shown: - auth - identity - investments - liabilities - transactions - statements optional_products: type: - array - 'null' description: 'List of Plaid product(s) that you may wish to use but that are not required for your use case. Plaid will attempt to fetch data for these products on a best-effort basis, and failure to support these products will not affect Item creation. There should be no overlap between this array and the `products`, `required_if_supported_products`, or `additional_consented_products` arrays. The `products` array must have at least one product. For more details on using this feature, see [Optional Products](https://www.plaid.com/docs/link/initializing-products/#optional-products).' items: $ref: '#/components/schemas/Products' x-override-enum-values-shown: - auth - identity - investments - liabilities - statements - transactions additional_consented_products: type: - array - 'null' description: '(Beta) This field has no effect unless you are participating in the [Data Transparency](https://plaid.com/docs/link/data-transparency-messaging-migration-guide) beta program. List of additional Plaid product(s) you wish to collect consent for. These products will not be billed until you start using them by calling the relevant endpoints. `balance` is *not* a valid value, the Balance product does not require explicit initialization and will automatically have consent collected. Institutions that do not support these products will still be shown in Link. There should be no overlap between this array and the `products` or `required_if_supported_products` arrays.' items: $ref: '#/components/schemas/Products' x-override-enum-values-shown: - auth - identity - investments - liabilities - transactions - signal webhook: type: string description: The destination URL to which any webhooks should be sent. Note that webhooks for Payment Initiation (e-wallet transactions only), Transfer, Bank Transfer (including Auth micro-deposit notification webhooks) and Identity Verification are configured via the Dashboard instead. access_token: type: - string - 'null' description: The `access_token` associated with the Item to update or reference, used when updating, modifying, or accessing an existing `access_token`. Used when launching Link in update mode, when completing the Same-day (manual) Micro-deposit flow, or (optionally) when initializing Link for a returning user as part of the Transfer UI flow. minLength: 1 access_tokens: x-hidden-from-docs: true type: array description: A list of access tokens associated with the items to update in Link update mode for the Assets product. Using this instead of the `access_token` field allows the updating of multiple items at once. This feature is in closed beta, please contact your account manager for more info. items: type: string link_customization_name: type: string description: The name of the Link customization from the Plaid Dashboard to be applied to Link. If not specified, the `default` customization will be used. When using a Link customization, the language in the customization must match the language selected via the `language` parameter, and the countries in the customization should match the country codes selected via `country_codes`. redirect_uri: type: string description: A URI indicating the destination where a user should be forwarded after completing the Link flow; used to support OAuth authentication flows when launching Link in the browser or another app. The `redirect_uri` should not contain any query parameters. When used in Production or Development, must be an https URI. To specify any subdomain, use `*` as a wildcard character, e.g. `https://*.example.com/oauth.html`. Note that any redirect URI must also be added to the Allowed redirect URIs list in the [developer dashboard](https://dashboard.plaid.com/team/api). If initializing on Android, `android_package_name` must be specified instead and `redirect_uri` should be left blank. If using Hosted Link, the `redirect_uri` must be set to `https://secure.plaid.com/oauth/redirect`. android_package_name: type: string description: The name of your app's Android package. Required if using the `link_token` to initialize Link on Android. Any package name specified here must also be added to the Allowed Android package names setting on the [developer dashboard](https://dashboard.plaid.com/team/api). When creating a `link_token` for initializing Link on other platforms, `android_package_name` must be left blank and `redirect_uri` should be used instead. institution_data: $ref: '#/components/schemas/LinkTokenCreateInstitutionData' card_switch: $ref: '#/components/schemas/LinkTokenCreateCardSwitch' account_filters: $ref: '#/components/schemas/LinkTokenAccountFilters' eu_config: $ref: '#/components/schemas/LinkTokenEUConfig' institution_id: type: string description: Used for certain Europe-only configurations, as well as certain legacy use cases in other regions. payment_initiation: $ref: '#/components/schemas/LinkTokenCreateRequestPaymentInitiation' deposit_switch: $ref: '#/components/schemas/LinkTokenCreateRequestDepositSwitch' employment: $ref: '#/components/schemas/LinkTokenCreateRequestEmployment' income_verification: $ref: '#/components/schemas/LinkTokenCreateRequestIncomeVerification' base_report: $ref: '#/components/schemas/LinkTokenCreateRequestBaseReport' credit_partner_insights: $ref: '#/components/schemas/LinkTokenCreateRequestCreditPartnerInsights' consumer_report_permissible_purpose: $ref: '#/components/schemas/ConsumerReportPermissiblePurpose' auth: $ref: '#/components/schemas/LinkTokenCreateRequestAuth' transfer: $ref: '#/components/schemas/LinkTokenCreateRequestTransfer' update: $ref: '#/components/schemas/LinkTokenCreateRequestUpdate' identity_verification: $ref: '#/components/schemas/LinkTokenCreateRequestIdentityVerification' statements: $ref: '#/components/schemas/LinkTokenCreateRequestStatements' user_token: type: string description: A user token generated using `/user/create`. Any Item created during the Link session will be associated with the user. investments: $ref: '#/components/schemas/LinkTokenInvestments' investments_auth: $ref: '#/components/schemas/LinkTokenInvestmentsAuth' hosted_link: $ref: '#/components/schemas/LinkTokenCreateHostedLink' transactions: $ref: '#/components/schemas/LinkTokenTransactions' cra_enabled: x-hidden-from-docs: true type: boolean description: If `true`, request a CRA connection. Defaults to `false`. identity: $ref: '#/components/schemas/LinkTokenCreateIdentity' financekit_supported: x-hidden-from-docs: true type: boolean description: If `true`, indicates that client supports linking FinanceKit / AppleCard items. Defaults to `false`. enable_multi_item_link: x-hidden-from-docs: true type: boolean description: If `true`, enable linking multiple items in the same Link session. Defaults to `false`. required: - client_name - language - country_codes - user BeaconReport: type: object title: BeaconReport description: 'A Beacon Report describes the type of fraud committed by a user as well as the date the fraud was committed and the total amount of money lost due to the fraud incident. This information is used to block similar fraud attempts on your platform as well as alert other companies who screen a user with matching identity information. Other companies will not receive any new identity information, just what matched, plus information such as industry, type of fraud, and date of fraud. You can manage your fraud reports by adding, deleting, or editing reports as you get additional information on fraudulent users.' properties: id: $ref: '#/components/schemas/BeaconReportID' beacon_user_id: $ref: '#/components/schemas/BeaconUserID' created_at: $ref: '#/components/schemas/Timestamp' type: $ref: '#/components/schemas/BeaconReportType' fraud_date: $ref: '#/components/schemas/ISO8601Date' fraud_amount: $ref: '#/components/schemas/FraudAmount' audit_trail: $ref: '#/components/schemas/BeaconAuditTrail' required: - id - beacon_user_id - created_at - type - fraud_date - fraud_amount - audit_trail additionalProperties: true CraLoansUpdateRequest: type: object description: CraLoansUpdateRequest defines the request schema for `/cra/loans/update` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' loans: type: array description: A list of loans to update. items: $ref: '#/components/schemas/CraLoanUpdate' required: - loans TransferPaymentProfileToken: description: The payment profile token associated with the Payment Profile that will be debited or credited. Required if not using `access_token`. type: string x-hidden-from-docs: true BaseReportItem: title: BaseReportItem type: object additionalProperties: true description: A representation of an Item within a Base Report. x-hidden-from-docs: true properties: institution_name: type: string description: The full financial institution name associated with the Item. institution_id: description: The id of the financial institution associated with the Item. type: string date_last_updated: type: string format: date-time description: The date and time when this Item’s data was last retrieved from the financial institution, in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format. accounts: type: array description: Data about each of the accounts open on the Item. items: $ref: '#/components/schemas/BaseReportAccount' required: - institution_name - institution_id - date_last_updated - accounts EmploymentDetails: title: EmploymentDetails type: object deprecated: true description: An object representing employment details found on a paystub. additionalProperties: true properties: annual_salary: $ref: '#/components/schemas/Pay' hire_date: type: - string - 'null' format: date description: Date on which the employee was hired, in the YYYY-MM-DD format. IdentityVerificationDocumentPostalCode: type: - string - 'null' example: '46001' title: IdentityVerificationDocumentPostalCode description: The postal code extracted from the document. Between 2 and 10 alphanumeric characters. For US-based addresses this must be 5 numeric digits. WatchlistScreeningSearchTerms: type: object description: Search terms for creating an individual watchlist screening properties: watchlist_program_id: $ref: '#/components/schemas/WatchlistProgramID' legal_name: $ref: '#/components/schemas/WatchlistScreeningIndividualName' date_of_birth: $ref: '#/components/schemas/ISO8601DateNullable' document_number: $ref: '#/components/schemas/WatchlistScreeningDocumentValueNullable' country: $ref: '#/components/schemas/GenericCountryCodeNullable' version: type: integer description: The current version of the search terms. Starts at `1` and increments with each edit to `search_terms`. example: 1 required: - watchlist_program_id - legal_name - date_of_birth - document_number - country - version additionalProperties: true LinkTokenInvestments: description: Configuration parameters for the Investments product type: object properties: allow_unverified_crypto_wallets: type: boolean description: If `true`, allow self-custody crypto wallets to be added without requiring signature verification. Defaults to `false`. allow_manual_entry: type: boolean description: If `true`, allow users to manually enter Investments account and holdings information. Defaults to `false`. PaymentInitiationConsentPaymentExecuteResponse: type: object additionalProperties: true description: PaymentInitiationConsentPaymentExecuteResponse defines the response schema for `/payment_initiation/consent/payment/execute` properties: payment_id: type: string description: A unique ID identifying the payment status: $ref: '#/components/schemas/PaymentInitiationPaymentStatus' request_id: $ref: '#/components/schemas/RequestID' required: - payment_id - status - request_id WatchlistScreeningAuditTrail: title: WatchlistScreeningAuditTrail description: Information about the last change made to the parent object specifying what caused the change as well as when it occurred. type: object properties: source: $ref: '#/components/schemas/Source' dashboard_user_id: $ref: '#/components/schemas/DashboardUserIDNullable' timestamp: $ref: '#/components/schemas/Timestamp' required: - source - dashboard_user_id - timestamp additionalProperties: true BankTransferNetwork: type: string title: BankTransferNetwork description: The network or rails used for the transfer. Valid options are `ach`, `same-day-ach`, or `wire`. enum: - ach - same-day-ach - wire FDXNotification: title: FDX Notification entity type: object description: Provides the base fields of a notification. Clients will read the `type` property to determine the expected notification payload properties: notificationId: type: string description: Id of notification type: $ref: '#/components/schemas/FDXNotificationType' sentOn: $ref: '#/components/schemas/FDXTimestamp' category: $ref: '#/components/schemas/FDXNotificationCategory' severity: $ref: '#/components/schemas/FDXNotificationSeverity' priority: $ref: '#/components/schemas/FDXNotificationPriority' publisher: $ref: '#/components/schemas/FDXParty' subscriber: $ref: '#/components/schemas/FDXParty' notificationPayload: $ref: '#/components/schemas/FDXNotificationPayload' url: $ref: '#/components/schemas/FDXHateoasLink' required: - notificationId - type - sentOn - category - notificationPayload BankTransferSweepGetRequest: title: BankTransferSweepGetRequest type: object description: Defines the request schema for `/bank_transfer/sweep/get` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' sweep_id: type: string description: Identifier of the sweep. required: - sweep_id TaxpayerIdentifier: title: TaxpayerIdentifier type: object additionalProperties: true description: Information about the Taxpayer identification values assigned to the individual or legal entity.Information about the Taxpayer identification values assigned to the individual or legal entity. properties: TaxpayerIdentifierType: $ref: '#/components/schemas/TaxpayerIdentifierType' TaxpayerIdentifierValue: type: - string - 'null' description: The value of the taxpayer identifier as assigned by the IRS to the individual or legal entity. required: - TaxpayerIdentifierType - TaxpayerIdentifierValue CounterpartyInsights: type: object description: Insights around a user's counterparties additionalProperties: true properties: financial_institution_insights: type: array description: Insights related to a user’s transactions with other financial institutions, including detected account types. items: $ref: '#/components/schemas/FinancialInstitutionInsights' merchant_insights: type: array description: Insights about a user’s top merchants, ranked by spend. items: $ref: '#/components/schemas/MerchantInsights' ProcessorTokenPermissionsGetRequest: type: object description: ProcessorTokenPermissionsGetRequest defines the request schema for `/processor/token/permissions/get` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' processor_token: $ref: '#/components/schemas/ProcessorToken' required: - processor_token AddressDataNotRequired: title: AddressData type: object additionalProperties: true description: Data about the components comprising an address. properties: city: type: - string - 'null' description: The full city name region: type: - string - 'null' description: 'The region or state. In API versions 2018-05-22 and earlier, this field is called `state`. Example: `"NC"`' street: type: string description: 'The full street address Example: `"564 Main Street, APT 15"`' postal_code: type: - string - 'null' description: The postal code. In API versions 2018-05-22 and earlier, this field is called `zip`. country: type: - string - 'null' description: The ISO 3166-1 alpha-2 country code ProcessorTokenPermissionsSetResponse: type: object additionalProperties: true description: ProcessorTokenPermissionsSetResponse defines the response schema for `/processor/token/permissions/set` properties: request_id: $ref: '#/components/schemas/RequestID' required: - request_id ProcessorTransactionsGetResponse: type: object additionalProperties: true description: ProcessorTransactionsGetResponse defines the response schema for `/processor/transactions/get` properties: account: $ref: '#/components/schemas/AccountBase' transactions: type: array description: An array containing transactions from the account. Transactions are returned in reverse chronological order, with the most recent at the beginning of the array. The maximum number of transactions returned is determined by the `count` parameter. items: $ref: '#/components/schemas/Transaction' total_transactions: type: integer description: The total number of transactions available within the date range specified. If `total_transactions` is larger than the size of the `transactions` array, more transactions are available and can be fetched via manipulating the `offset` parameter. request_id: $ref: '#/components/schemas/RequestID' required: - account - transactions - total_transactions - request_id PaymentAmountCurrency: type: string enum: - GBP - EUR - PLN - SEK - DKK - NOK description: The ISO-4217 currency code of the payment. For standing orders and payment consents, `"GBP"` must be used. For Poland, Denmark, Sweden and Norway, only the local currency is currently supported. minLength: 3 maxLength: 3 PaymentAmountToRefund: description: The amount and currency of a payment allOf: - $ref: '#/components/schemas/PaymentAmountNullable' - type: object description: An amount to refund the payment partially. If this amount is not specified, the payment is refunded fully for the remaining amount. TransferMigrateAccountResponse: title: TransferMigrateAccountResponse type: object additionalProperties: true description: Defines the response schema for `/transfer/migrate_account` properties: access_token: type: string description: The Plaid `access_token` for the newly created Item. account_id: type: string description: The Plaid `account_id` for the newly created Item. request_id: $ref: '#/components/schemas/RequestID' required: - access_token - account_id - request_id CraPartnerInsightsItem: type: object additionalProperties: true description: The details and metadata for an end user's Item. properties: institution_id: type: string description: The ID for the institution that the user linked. institution_name: type: string description: The name of the institution the user linked. item_id: type: string description: The identifier for the item. accounts: type: array description: A list of accounts in the item items: $ref: '#/components/schemas/CraPartnerInsightsItemAccount' PaymentProfileGetResponse: type: object additionalProperties: true description: PaymentProfileGetResponse defines the response schema for `/payment_profile/get` properties: updated_at: type: string format: date-time description: Timestamp in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format (`YYYY-MM-DDTHH:mm:ssZ`) indicating the last time the given Payment Profile was updated at created_at: type: string format: date-time description: Timestamp in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format (`YYYY-MM-DDTHH:mm:ssZ`) indicating the time the given Payment Profile was created at deleted_at: type: - string - 'null' format: date-time description: Timestamp in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format (`YYYY-MM-DDTHH:mm:ssZ`) indicating the time the given Payment Profile was deleted at. Always `null` if the Payment Profile has not been deleted status: $ref: '#/components/schemas/PaymentProfileStatus' request_id: $ref: '#/components/schemas/RequestID' required: - request_id - status - created_at - updated_at - deleted_at DocumentNameMatchCode: description: A match summary describing the cross comparison between the subject's name, extracted from the document image, and the name they separately provided to identity verification attempt. type: string enum: - match - partial_match - no_match - no_data example: match CreditSessionsGetRequest: type: object description: CreditSessionsGetRequest defines the request schema for `/credit/sessions/get` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' user_token: $ref: '#/components/schemas/UserToken' required: - user_token WatchlistScreeningIndividualProgramListRequest: description: Request input for listing watchlist screening programs for individuals type: object properties: secret: $ref: '#/components/schemas/APISecret' client_id: $ref: '#/components/schemas/APIClientID' cursor: $ref: '#/components/schemas/Cursor' WatchlistScreeningEntityGetRequest: description: Request input for fetching an entity watchlist screening type: object properties: entity_watchlist_screening_id: $ref: '#/components/schemas/EntityWatchlistScreeningID' secret: $ref: '#/components/schemas/APISecret' client_id: $ref: '#/components/schemas/APIClientID' required: - entity_watchlist_screening_id PaymentInitiationRecipientListResponse: type: object additionalProperties: true description: PaymentInitiationRecipientListResponse defines the response schema for `/payment_initiation/recipient/list` properties: recipients: type: array description: An array of payment recipients created for Payment Initiation items: $ref: '#/components/schemas/PaymentInitiationRecipient' request_id: $ref: '#/components/schemas/RequestID' required: - recipients - request_id PaymentAmountNullable: title: PaymentAmount type: - object - 'null' additionalProperties: true properties: currency: $ref: '#/components/schemas/PaymentAmountCurrency' value: type: number format: double minimum: 0.01 description: The amount of the payment. Must contain at most two digits of precision e.g. `1.23`. required: - currency - value description: The amount and currency of a payment EntityWatchlistScreeningReview: title: EntityWatchlistScreeningReview type: object description: 'A review submitted by a team member for an entity watchlist screening. A review can be either a comment on the current screening state, actions taken against hits attached to the watchlist screening, or both.' properties: id: $ref: '#/components/schemas/EntityWatchlistScreeningReviewID' confirmed_hits: type: array description: Hits marked as a true positive after thorough manual review. These hits will never recur or be updated once dismissed. In most cases, confirmed hits indicate that the customer should be rejected. items: $ref: '#/components/schemas/EntityWatchlistScreeningHitID' dismissed_hits: type: array description: Hits marked as a false positive after thorough manual review. These hits will never recur or be updated once dismissed. items: $ref: '#/components/schemas/EntityWatchlistScreeningHitID' comment: $ref: '#/components/schemas/ReviewComment' audit_trail: $ref: '#/components/schemas/WatchlistScreeningAuditTrail' required: - id - confirmed_hits - dismissed_hits - comment - audit_trail additionalProperties: true BeaconAccountRiskEvaluateRequestOptions: type: object description: An optional object to filter `/beacon/account_risk/v1/evaluate` results to a subset of the accounts on the linked Item. properties: account_ids: type: array description: An array of `account_ids` for the specific accounts to evaluate. items: type: string ProcessorBalanceGetRequestOptions: type: object description: Optional parameters to `/processor/balance/get`. properties: min_last_updated_datetime: $ref: '#/components/schemas/MinLastUpdatedDatetime' OriginatorExpectedTransferFrequency: type: string title: OriginatorExpectedTransferFrequency description: The originator's expected transfer frequency. enum: - once_per_month - twice_per_month - once_per_week - daily BeaconUserRequestData: type: object title: BeaconUserRequestData description: A Beacon User's data which is used to check against duplicate records and the Beacon Fraud Network. properties: date_of_birth: $ref: '#/components/schemas/ISO8601Date' name: $ref: '#/components/schemas/BeaconUserName' address: $ref: '#/components/schemas/BeaconUserRequestAddress' email_address: $ref: '#/components/schemas/EmailAddress' phone_number: $ref: '#/components/schemas/BeaconUserPhoneNumber' id_number: $ref: '#/components/schemas/BeaconUserIDNumber' ip_address: $ref: '#/components/schemas/IPAddress' required: - date_of_birth - name additionalProperties: true CreditPayrollIncomeRefreshStatus: type: string title: CreditPayrollIncomeRefreshStatus description: 'The verification refresh status. One of the following: `"USER_PRESENCE_REQUIRED"` User presence is required to refresh an income verification. `"SUCCESSFUL"` The income verification refresh was successful. `"NOT_FOUND"` No new data was found after the income verification refresh.' x-override-enum-values-shown: - USER_PRESENCE_REQUIRED - SUCCESSFUL - NOT_FOUND EarningsTotal: title: EarningsTotal type: object description: An object representing both the current pay period and year to date amount for an earning category. additionalProperties: true properties: current_amount: type: - number - 'null' format: double description: Total amount of the earnings for this pay period current_pay: $ref: '#/components/schemas/Pay' ytd_pay: $ref: '#/components/schemas/Pay' hours: type: - number - 'null' description: Total number of hours worked for this pay period iso_currency_code: type: - string - 'null' description: The ISO-4217 currency code of the line item. Always `null` if `unofficial_currency_code` is non-null. unofficial_currency_code: type: - string - 'null' description: 'The unofficial currency code associated with the security. Always `null` if `iso_currency_code` is non-`null`. Unofficial currency codes are used for currencies that do not have official ISO currency codes, such as cryptocurrencies and the currencies of certain countries. See the [currency code schema](https://plaid.com/docs/api/accounts#currency-code-schema) for a full listing of supported `iso_currency_code`s.' ytd_amount: type: - number - 'null' format: double description: The total year-to-date amount of the earnings FDXParty: title: Party entity description: FDX Participant - an entity or person that is a part of a FDX API transaction type: object required: - name - type properties: name: description: Human recognizable common name type: string type: $ref: '#/components/schemas/FDXPartyType' homeUri: description: URI for party, where an end user could learn more about the company or application involved in the data sharing chain type: string format: uri logoUri: description: URI for a logo asset to be displayed to the end user type: string format: uri registry: $ref: '#/components/schemas/FDXPartyRegistry' registeredEntityName: description: Registered name of party type: string registeredEntityId: description: Registered id of party type: string InvestmentsHoldingsGetRequest: type: object description: InvestmentsHoldingsGetRequest defines the request schema for `/investments/holdings/get` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' access_token: $ref: '#/components/schemas/AccessToken' options: $ref: '#/components/schemas/InvestmentHoldingsGetRequestOptions' required: - access_token ScopesNullable: description: The scopes object allOf: - $ref: '#/components/schemas/Scopes' - type: object additionalProperties: true PayrollIncomeObject: title: PayrollIncomeObject type: object additionalProperties: true description: An object representing payroll data. properties: account_id: type: - string - 'null' description: ID of the payroll provider account. pay_stubs: description: Array of pay stubs for the user. type: array items: $ref: '#/components/schemas/CreditPayStub' w2s: description: Array of tax form W-2s. type: array items: $ref: '#/components/schemas/CreditW2' form1099s: description: Array of tax form 1099s. type: array items: $ref: '#/components/schemas/Credit1099' required: - account_id - pay_stubs - w2s - form1099s IdentityVerificationAutofillUserData: description: User information that was autofilled. All this information should be confirmed by the user before using. type: - object - 'null' properties: name: $ref: '#/components/schemas/IdentityVerificationResponseUserName' address: $ref: '#/components/schemas/IdentityVerificationAutofillAddress' id_number: $ref: '#/components/schemas/UserIDNumber' required: - name - address - id_number additionalProperties: true CreditBankStatementUploadTransaction: title: CreditBankStatementUploadTransaction type: object description: An object containing data about a transaction appearing on a user-uploaded bank statement. properties: amount: type: - number - 'null' description: The value of the transaction. A negative amount indicates that money moved into the account (such as a paycheck being deposited). date: type: - string - 'null' format: date description: The date of when the transaction was made, in ISO 8601 format (YYYY-MM-DD). original_description: type: - string - 'null' description: The raw description of the transaction as it appears on the bank statement. account_id: type: - string - 'null' description: The unique id of the bank account that this transaction occurs in required: - amount - date - original_description - account_id AccountsBalanceGetRequestOptions: type: object description: Optional parameters to `/accounts/balance/get`. properties: account_ids: type: array description: 'A list of `account_ids` to retrieve for the Item. The default value is `null`. Note: An error will be returned if a provided `account_id` is not associated with the Item.' items: type: string min_last_updated_datetime: $ref: '#/components/schemas/MinLastUpdatedDatetime' BaseReportAverageFlowInsights: title: BaseReportAverageFlowInsights description: Average dollar amount of credit or debit transactions out of the account. This field will only added for depository accounts x-hidden-from-docs: true type: object additionalProperties: true properties: start_date: type: string format: date description: 'The start date of this time period. The date will be returned in an ISO 8601 format (YYYY-MM-DD).' end_date: type: string format: date description: 'The end date of this time period. The date will be returned in an ISO 8601 format (YYYY-MM-DD).' total_amount: $ref: '#/components/schemas/CreditAmountWithCurrency' InstitutionsGetRequestOptions: type: object description: An optional object to filter `/institutions/get` results. properties: products: type: - array - 'null' description: 'Filter the Institutions based on which products they support. ' minItems: 1 items: $ref: '#/components/schemas/Products' x-override-enum-values-shown: - assets - auth - balance - employment - identity - income_verification - identity_verification - investments - liabilities - payment_initiation - standing_orders - transactions - transfer routing_numbers: type: - array - 'null' description: Specify an array of routing numbers to filter institutions. The response will only return institutions that match all of the routing numbers in the array. Routing number records used for this matching are generally comprehensive; however, failure to match a given routing number to an institution does not necessarily mean that the institution is unsupported by Plaid. items: type: string oauth: type: - boolean - 'null' description: Limit results to institutions with or without OAuth login flows. Note that institutions will have `oauth` set to `true` if some Items associated with that institution are required to use OAuth flows; institutions in a state of migration to OAuth will have the `oauth` attribute set to `true`. include_optional_metadata: type: boolean description: 'When `true`, return the institution''s homepage URL, logo and primary brand color. Note that Plaid does not own any of the logos shared by the API, and that by accessing or using these logos, you agree that you are doing so at your own risk and will, if necessary, obtain all required permissions from the appropriate rights holders and adhere to any applicable usage guidelines. Plaid disclaims all express or implied warranties with respect to the logos.' include_auth_metadata: type: boolean default: false description: When `true`, returns metadata related to the Auth product indicating which auth methods are supported. include_payment_initiation_metadata: type: boolean default: false description: When `true`, returns metadata related to the Payment Initiation product indicating which payment configurations are supported. WatchlistScreeningIndividualReviewListResponse: description: Paginated list of screening reviews additionalProperties: true properties: watchlist_screening_reviews: description: List of screening reviews type: array items: $ref: '#/components/schemas/WatchlistScreeningReview' next_cursor: $ref: '#/components/schemas/Cursor' request_id: $ref: '#/components/schemas/RequestID' required: - watchlist_screening_reviews - next_cursor - request_id type: object HostedLinkDeliveryMethod: type: string description: 'How Plaid should deliver the Plaid Link session to the customer. Only available to customers enabled for Link Delivery (beta). To request Link Delivery access, contact your account manager. ''sms'' will deliver via SMS. Must pass `user.phone_number`. ''email'' will deliver via email. Must pass `user.email_address`. In the Sandbox environment, this field will be ignored; use the Production or Development environment to test Link Delivery instead. ' enum: - sms - email EntityScreeningHitUrlsItems: type: object description: Analyzed URLs for the associated hit properties: analysis: $ref: '#/components/schemas/MatchSummary' data: $ref: '#/components/schemas/EntityScreeningHitUrls' additionalProperties: true FDXNotificationCategory: type: string title: Notification Category enum: - SECURITY - MAINTENANCE - FRAUD - CONSENT - NEW_DATA description: Category of Notification CreditFreddieMacLoan: title: CreditFreddieMacLoan type: object additionalProperties: true description: Information specific to a mortgage loan agreement between one or more borrowers and a mortgage lender. properties: LOAN_IDENTIFIERS: $ref: '#/components/schemas/CreditFreddieMacLoanIdentifiers' LoanRoleType: type: string description: Type of loan. The value can only be "SubjectLoan" required: - LOAN_IDENTIFIERS - LoanRoleType IdentityMatchRequest: type: object description: IdentityMatchRequest defines the request schema for `/identity/match` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' access_token: $ref: '#/components/schemas/AccessToken' user: $ref: '#/components/schemas/IdentityMatchUser' options: $ref: '#/components/schemas/IdentityMatchRequestOptions' required: - access_token RecurringTransferID: type: string title: RecurringTransferID description: Plaid’s unique identifier for a recurring transfer. Email: title: Email type: object additionalProperties: true properties: data: type: string description: The email address. primary: type: boolean description: When `true`, identifies the email address as the primary email on an account. type: type: string enum: - primary - secondary - other description: The type of email account as described by the financial institution. required: - data - primary - type description: An object representing an email address CreditBankIncomeSummary: type: object description: Summary for bank income across all income sources and items (max history of 730 days). additionalProperties: true properties: total_amount: type: number description: 'Total amount of earnings across all the income sources in the end user''s Items for the days requested by the client. This may return an incorrect value if the summary includes income sources in multiple currencies. Please use [`total_amounts`](https://plaid.com/docs/api/products/income/#credit-bank_income-get-response-bank-income-bank-income-summary-total-amounts) instead.' deprecated: true iso_currency_code: type: - string - 'null' description: 'The ISO 4217 currency code of the amount or balance. Please use [`total_amounts`](https://plaid.com/docs/api/products/income/#credit-bank_income-get-response-bank-income-bank-income-summary-total-amounts) instead.' deprecated: true unofficial_currency_code: type: - string - 'null' description: 'The unofficial currency code associated with the amount or balance. Always `null` if `iso_currency_code` is non-null. Unofficial currency codes are used for currencies that do not have official ISO currency codes, such as cryptocurrencies and the currencies of certain countries. Please use [`total_amounts`](https://plaid.com/docs/api/products/income/#credit-bank_income-get-response-bank-income-bank-income-summary-total-amounts) instead.' deprecated: true total_amounts: type: array description: 'Total amount of earnings across all the income sources in the end user''s Items for the days requested by the client. This can contain multiple amounts, with each amount denominated in one unique currency.' items: $ref: '#/components/schemas/CreditAmountWithCurrency' start_date: type: string format: date description: 'The earliest date within the days requested in which all income sources identified by Plaid appear in a user''s account. The date will be returned in an ISO 8601 format (YYYY-MM-DD).' end_date: type: string format: date description: 'The latest date in which all income sources identified by Plaid appear in the user''s account. The date will be returned in an ISO 8601 format (YYYY-MM-DD).' income_sources_count: type: integer description: Number of income sources per end user. income_categories_count: type: integer description: Number of income categories per end user. income_transactions_count: type: integer description: Number of income transactions per end user. historical_summary: type: array items: $ref: '#/components/schemas/CreditBankIncomeHistoricalSummary' PartnerCustomerGetRequest: description: Request schema for `/partner/customer/get`. properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' end_customer_client_id: type: string required: - end_customer_client_id ExternalPaymentScheduleBase: title: ExternalPaymentScheduleBase type: - object - 'null' additionalProperties: true description: The schedule that the payment will be executed on. If a schedule is provided, the payment is automatically set up as a standing order. If no schedule is specified, the payment will be executed only once. properties: interval: $ref: '#/components/schemas/PaymentScheduleInterval' interval_execution_day: description: 'The day of the interval on which to schedule the payment. If the payment interval is weekly, `interval_execution_day` should be an integer from 1 (Monday) to 7 (Sunday). If the payment interval is monthly, `interval_execution_day` should be an integer indicating which day of the month to make the payment on. Integers from 1 to 28 can be used to make a payment on that day of the month. Negative integers from -1 to -5 can be used to make a payment relative to the end of the month. To make a payment on the last day of the month, use -1; to make the payment on the second-to-last day, use -2, and so on.' type: integer start_date: format: date type: string description: 'A date in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format (YYYY-MM-DD). Standing order payments will begin on the first `interval_execution_day` on or after the `start_date`. If the first `interval_execution_day` on or after the start date is also the same day that `/payment_initiation/payment/create` was called, the bank *may* make the first payment on that day, but it is not guaranteed to do so.' end_date: format: date type: - string - 'null' description: 'A date in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format (YYYY-MM-DD). Standing order payments will end on the last `interval_execution_day` on or before the `end_date`. If the only `interval_execution_day` between the start date and the end date (inclusive) is also the same day that `/payment_initiation/payment/create` was called, the bank *may* make a payment on that day, but it is not guaranteed to do so.' adjusted_start_date: format: date type: - string - 'null' description: The start date sent to the bank after adjusting for holidays or weekends. Will be provided in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format (YYYY-MM-DD). If the start date did not require adjustment, this field will be `null`. AuthSupportedMethods: title: AuthSupportedMethods type: - object - 'null' additionalProperties: true description: Metadata specifically related to which auth methods an institution supports. properties: instant_auth: type: boolean description: Indicates if instant auth is supported. instant_match: type: boolean description: Indicates if instant match is supported. automated_micro_deposits: type: boolean description: Indicates if automated microdeposits are supported. instant_micro_deposits: type: boolean description: Indicates if instant microdeposits are supported. required: - instant_auth - instant_match - automated_micro_deposits - instant_micro_deposits RiskCheckStolenIdentity: description: 'Field containing the data used in determining the outcome of the stolen identity risk check. Contains the following fields: `score` - A score from 0 to 100 indicating the likelihood that the user is a stolen identity.' type: - object - 'null' properties: score: description: A score from 0 to 100 indicating the likelihood that the user is a stolen identity. type: integer example: 0 required: - score additionalProperties: true WalletListResponse: type: object additionalProperties: true description: WalletListResponse defines the response schema for `/wallet/list` properties: wallets: type: array description: An array of e-wallets items: $ref: '#/components/schemas/Wallet' next_cursor: type: string description: Cursor used for fetching e-wallets created before the latest e-wallet provided in this response request_id: $ref: '#/components/schemas/RequestID' required: - wallets - request_id SignalPaymentMethod: type: - string - 'null' enum: - SAME_DAY_ACH - NEXT_DAY_ACH - STANDARD_ACH - REAL_TIME_PAYMENTS - DEBIT_CARD - MULTIPLE_PAYMENT_METHODS description: 'The payment method to complete the transaction after the risk assessment. It may be different from the default payment method. `SAME_DAY_ACH`: Same Day ACH by NACHA. The debit transaction is processed and settled on the same day `NEXT_DAY_ACH`: Next Day ACH settlement for debit transactions, offered by some payment processors `STANDARD_ACH`: standard ACH by NACHA `REAL_TIME_PAYMENTS`: real-time payments such as RTP and FedNow `DEBIT_CARD`: if the default payment is over debit card networks `MULTIPLE_PAYMENT_METHODS`: if there is no default debit rail or there are multiple payment methods Possible values: `SAME_DAY_ACH`, `NEXT_DAY_ACH`, `STANDARD_ACH`, `REAL_TIME_PAYMENTS`, `DEBIT_CARD`, `MULTIPLE_PAYMENT_METHODS` ' CreditCategory: title: CreditCategory type: - object - 'null' additionalProperties: true description: 'Information describing the intent of the transaction. Most relevant for credit use cases, but not limited to such use cases. See the [`taxonomy csv file`](https://plaid.com/documents/credit-category-taxonomy.csv) for a full list of credit categories.' properties: primary: type: string description: A high level category that communicates the broad category of the transaction. detailed: type: string description: A granular category conveying the transaction's intent. This field can also be used as a unique identifier for the category. required: - primary - detailed UserUpdateResponse: x-hidden-from-docs: true type: object additionalProperties: true description: UserUpdateResponse defines the response schema for `/user/update` properties: request_id: $ref: '#/components/schemas/RequestID' required: - request_id TransferAccountID: type: string description: The Plaid `account_id` corresponding to the end-user account that will be debited or credited. BeaconUserCreateRequest: description: 'Request input for creating a Beacon User. The primary use for this endpoint is to add a new end user to Beacon for fraud and duplicate scanning. Some fields are optional, but it is recommended to provide as much information as possible to improve the accuracy of the fraud and duplicate scanning.' type: object properties: program_id: $ref: '#/components/schemas/BeaconProgramID' client_user_id: $ref: '#/components/schemas/ClientUserID' user: $ref: '#/components/schemas/BeaconUserRequestData' client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' required: - program_id - client_user_id - user WalletTransactionIdempotencyKey: title: WalletTransactionIdempotencyKey type: string maxLength: 128 minLength: 1 description: 'A random key provided by the client, per unique wallet transaction. Maximum of 128 characters. The API supports idempotency for safely retrying requests without accidentally performing the same operation twice. If a request to execute a wallet transaction fails due to a network connection error, then after a minimum delay of one minute, you can retry the request with the same idempotency key to guarantee that only a single wallet transaction is created. If the request was successfully processed, it will prevent any transaction that uses the same idempotency key, and was received within 24 hours of the first request, from being processed.' PartnerEndCustomerWithSecrets: description: The details for the newly created end customer, including secrets for non-Production environments. type: object additionalProperties: true allOf: - $ref: '#/components/schemas/PartnerEndCustomer' - type: object properties: secrets: $ref: '#/components/schemas/PartnerEndCustomerSecrets' EntityScreeningHitPhoneNumbers: type: object description: Phone number information associated with the entity screening hit properties: type: $ref: '#/components/schemas/PhoneType' phone_number: $ref: '#/components/schemas/WatchlistScreeningPhoneNumber' required: - type - phone_number additionalProperties: true NumbersIBAN: type: string description: International Bank Account Number (IBAN). minLength: 15 maxLength: 34 TransferAccessToken: description: The Plaid `access_token` for the account that will be debited or credited. type: string DashboardUserStatus: type: string example: active description: The current status of the user. enum: - invited - active - deactivated SandboxPaymentProfileResetLoginResponse: type: object additionalProperties: true description: SandboxPaymentProfileResetLoginResponse defines the response schema for `/sandbox/payment_profile/reset_login` properties: reset_login: type: boolean description: '`true` if the call succeeded' request_id: $ref: '#/components/schemas/RequestID' required: - reset_login - request_id TransferLedgerSweepSimulateEventType: type: string title: TransferLedgerSweepSimulateEventType description: 'The asynchronous event to be simulated. May be: `posted`, `settled`, `failed`, or `returned`. An error will be returned if the event type is incompatible with the current ledger sweep status. Compatible status --> event type transitions include: `sweep.pending` --> `sweep.posted` `sweep.pending` --> `sweep.failed` `sweep.posted` --> `sweep.settled` `sweep.posted` --> `sweep.returned` `sweep.settled` --> `sweep.returned` ' enum: - sweep.posted - sweep.settled - sweep.returned - sweep.failed PaymentScheduleInterval: type: string title: PaymentScheduleInterval enum: - WEEKLY - MONTHLY description: The frequency interval of the payment. minLength: 1 TaxpayerIdentifierType: title: TaxpayerIdentifierType type: - string - 'null' description: A value from a MISMO prescribed list that classifies identification numbers used by the Internal Revenue Service (IRS) in the administration of tax laws. A Social Security number (SSN) is issued by the SSA; all other taxpayer identification numbers are issued by the IRS. enum: - IndividualTaxpayerIdentificationNumber - SocialSecurityNumber TransferOriginatorCreateRequest: title: TransferOriginatorCreateRequest type: object description: Defines the request schema for `/transfer/originator/create` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' company_name: type: string description: The company name of the end customer being created. This will be displayed in public-facing surfaces, e.g. Plaid Dashboard. minLength: 1 required: - company_name Location: title: Transaction Location type: object additionalProperties: true description: A representation of where a transaction took place properties: address: type: - string - 'null' description: The street address where the transaction occurred. city: type: - string - 'null' description: The city where the transaction occurred. region: type: - string - 'null' description: The region or state where the transaction occurred. In API versions 2018-05-22 and earlier, this field is called `state`. postal_code: type: - string - 'null' description: The postal code where the transaction occurred. In API versions 2018-05-22 and earlier, this field is called `zip`. country: type: - string - 'null' description: The ISO 3166-1 alpha-2 country code where the transaction occurred. lat: type: - number - 'null' format: double description: The latitude where the transaction occurred. lon: type: - number - 'null' format: double description: The longitude where the transaction occurred. store_number: type: - string - 'null' description: The merchant defined store number where the transaction occurred. required: - address - city - region - postal_code - country - lat - lon - store_number PayStubPayPeriodDetails: title: PayStubPayPeriodDetails type: object additionalProperties: true description: Details about the pay period. properties: pay_amount: type: - number - 'null' format: double description: The amount of the paycheck. distribution_breakdown: type: array items: $ref: '#/components/schemas/PayStubDistributionBreakdown' end_date: type: - string - 'null' format: date description: The date on which the pay period ended, in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format ("yyyy-mm-dd"). gross_earnings: type: - number - 'null' format: double description: Total earnings before tax/deductions. iso_currency_code: type: - string - 'null' description: The ISO-4217 currency code of the net pay. Always `null` if `unofficial_currency_code` is non-null. pay_date: type: - string - 'null' format: date description: The date on which the pay stub was issued, in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format ("yyyy-mm-dd"). pay_frequency: type: - string - 'null' description: The frequency at which an individual is paid. x-override-enum-values-shown: - UNKNOWN - WEEKLY - BIWEEKLY - SEMI_MONTHLY - MONTHLY - null pay_basis: $ref: '#/components/schemas/CreditPayStubPayBasisType' start_date: type: - string - 'null' format: date description: The date on which the pay period started, in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format ("yyyy-mm-dd"). unofficial_currency_code: type: - string - 'null' description: 'The unofficial currency code associated with the net pay. Always `null` if `iso_currency_code` is non-`null`. Unofficial currency codes are used for currencies that do not have official ISO currency codes, such as cryptocurrencies and the currencies of certain countries. See the [currency code schema](https://plaid.com/docs/api/accounts#currency-code-schema) for a full listing of supported `iso_currency_code`s.' required: - pay_amount - distribution_breakdown - end_date - gross_earnings - iso_currency_code - pay_date - pay_frequency - start_date - unofficial_currency_code WatchlistScreeningPhoneNumberNullable: type: - string - 'null' description: A phone number in E.164 format. example: '+14025671234' title: WatchlistScreeningPhoneNumber TransferFundingAccount: type: object title: TransferFundingAccount description: The originator's funding account, linked with Plaid Link or `/transfer/migrate_account`. properties: access_token: $ref: '#/components/schemas/AccessToken' account_id: type: string description: The Plaid `account_id` for the newly created Item. required: - access_token - account_id AccountProductAccessNullable: description: Allow the application to access specific products on this account allOf: - $ref: '#/components/schemas/AccountProductAccess' - type: object additionalProperties: true IncomeVerificationCreateRequest: title: IncomeVerificationCreateRequest type: object description: IncomeVerificationCreateRequest defines the request schema for `/income/verification/create` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' webhook: type: string description: The URL endpoint to which Plaid should send webhooks related to the progress of the income verification process. precheck_id: type: string description: The ID of a precheck created with `/income/verification/precheck`. Will be used to improve conversion of the income verification flow. options: $ref: '#/components/schemas/IncomeVerificationCreateRequestOptions' required: - webhook ProcessorTokenCreateRequest: type: object description: ProcessorTokenCreateRequest defines the request schema for `/processor/token/create` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' access_token: $ref: '#/components/schemas/AccessToken' account_id: type: string description: The `account_id` value obtained from the `onSuccess` callback in Link processor: type: string enum: - dwolla - galileo - modern_treasury - ocrolus - vesta - drivewealth - vopay - achq - check - checkbook - circle - sila_money - rize - svb_api - unit - wyre - lithic - alpaca - astra - moov - treasury_prime - marqeta - checkout - solid - highnote - gemini - apex_clearing - gusto - adyen - atomic - i2c - wepay - riskified - utb - adp_roll - fortress_trust - bond - bakkt - teal - zero_hash - taba_pay - knot - sardine - alloy - finix description: The processor you are integrating with. required: - access_token - account_id - processor TransferDiligenceDocumentUploadResponse: title: TransferDiligenceDocumentUploadResponse type: object additionalProperties: true description: Defines the response schema for `/transfer/diligence/document/upload` properties: request_id: $ref: '#/components/schemas/RequestID' required: - request_id Form1099Type: title: Form1099Type type: string description: Form 1099 Type enum: - FORM_1099_TYPE_UNKNOWN - FORM_1099_TYPE_MISC - FORM_1099_TYPE_K AccountVerificationInsightsAccountNumberFormat: title: VerificationInsightsAccountNumberFormat type: string enum: - valid - invalid - unknown description: 'Indicator of account number format validity for institution. `valid`: indicates that the account number has a correct format for the institution. `invalid`: indicates that the account number has an incorrect format for the institution. `unknown`: indicates that there was not enough information to determine whether the format is correct for the institution.' ClientProvidedEnhancedTransaction: title: ClientProvidedEnhancedTransaction type: object description: A client-provided transaction that Plaid has enhanced. x-examples: {} additionalProperties: true properties: id: type: string description: Unique transaction identifier to tie transactions back to clients' systems. description: type: string description: The raw description of the transaction. amount: type: number format: double description: The value of the transaction, denominated in the account's currency, as stated in `iso_currency_code`. 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. iso_currency_code: type: string description: The ISO-4217 currency code of the transaction. enhancements: $ref: '#/components/schemas/Enhancements' required: - id - description - amount - iso_currency_code - enhancements LinkProfileEligibilityCheckUser: type: object x-hidden-from-docs: true additionalProperties: true description: 'An object specifying information about the end user who will be sharing their profile in this Link session ' properties: phone_number: type: string description: The user's phone number in [E.164](https://en.wikipedia.org/wiki/E.164) format required: - phone_number KYCCheckAddressSummary: type: object description: Result summary object specifying how the `address` field matched. properties: summary: $ref: '#/components/schemas/MatchSummaryCode' po_box: $ref: '#/components/schemas/POBoxStatus' type: $ref: '#/components/schemas/AddressPurposeLabel' required: - summary - po_box - type additionalProperties: true TransferAuthorizationID: type: string title: TransferAuthorizationID description: Plaid’s unique identifier for a transfer authorization. ProcessorTokenCreateResponse: type: object additionalProperties: true description: ProcessorTokenCreateResponse defines the response schema for `/processor/token/create` and `/processor/apex/processor_token/create` properties: processor_token: type: string description: The `processor_token` that can then be used by the Plaid partner to make API requests request_id: $ref: '#/components/schemas/RequestID' required: - processor_token - request_id EntityWatchlistProgram: type: object description: A program that configures the active lists, search parameters, and other behavior for initial and ongoing screening of entities. title: EntityWatchlistProgram properties: id: $ref: '#/components/schemas/EntityWatchlistProgramID' created_at: $ref: '#/components/schemas/Timestamp' is_rescanning_enabled: description: Indicator specifying whether the program is enabled and will perform daily rescans. type: boolean example: true lists_enabled: description: Watchlists enabled for the associated program type: array example: - EU_CON uniqueItems: true items: $ref: '#/components/schemas/EntityWatchlistCode' name: $ref: '#/components/schemas/EntityWatchlistScreeningProgramName' name_sensitivity: $ref: '#/components/schemas/ProgramNameSensitivity' audit_trail: $ref: '#/components/schemas/WatchlistScreeningAuditTrail' is_archived: $ref: '#/components/schemas/ProgramArchived' required: - id - created_at - is_rescanning_enabled - lists_enabled - name - name_sensitivity - audit_trail - is_archived additionalProperties: true WatchlistScreeningDocumentValue: type: string title: WatchlistScreeningDocumentValue minLength: 4 example: C31195855 description: The numeric or alphanumeric identifier associated with this document. ProcessorIdentityGetRequest: type: object description: ProcessorIdentityGetRequest defines the request schema for `/processor/identity/get` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' processor_token: $ref: '#/components/schemas/ProcessorToken' required: - processor_token WatchlistScreeningEntityReviewListRequest: description: Request input for listing reviews for an entity watchlist screening type: object properties: secret: $ref: '#/components/schemas/APISecret' client_id: $ref: '#/components/schemas/APIClientID' entity_watchlist_screening_id: $ref: '#/components/schemas/EntityWatchlistScreeningID' cursor: $ref: '#/components/schemas/Cursor' required: - entity_watchlist_screening_id IndividualName: title: NAME type: object additionalProperties: true description: Parent container for name that allows for choice group between parsed and unparsed containers.Parent container for name that allows for choice group between parsed and unparsed containers. properties: FirstName: type: string description: The first name of the individual represented by the parent object. LastName: type: string description: The last name of the individual represented by the parent object. required: - FirstName - LastName PaymentProfileRemoveResponse: type: object additionalProperties: true description: PaymentProfileRemoveResponse defines the response schema for `/payment_profile/remove` properties: request_id: $ref: '#/components/schemas/RequestID' required: - request_id TransferFailure: title: TransferFailure type: - object - 'null' additionalProperties: true description: The failure reason if the event type for a transfer is `"failed"` or `"returned"`. Null value otherwise. properties: ach_return_code: type: - string - 'null' description: The ACH return code, e.g. `R01`. A return code will be provided if and only if the transfer status is `returned`. For a full listing of ACH return codes, see [Transfer errors](https://plaid.com/docs/errors/transfer/#ach-return-codes). description: type: string description: A human-readable description of the reason for the failure or reversal. InstitutionsGetByIdRequestOptions: type: object description: Specifies optional parameters for `/institutions/get_by_id`. If provided, must not be `null`. properties: include_optional_metadata: default: false type: boolean description: 'When `true`, return an institution''s logo, brand color, and URL. When available, the bank''s logo is returned as a base64 encoded 152x152 PNG, the brand color is in hexadecimal format. The default value is `false`. Note that Plaid does not own any of the logos shared by the API and that by accessing or using these logos, you agree that you are doing so at your own risk and will, if necessary, obtain all required permissions from the appropriate rights holders and adhere to any applicable usage guidelines. Plaid disclaims all express or implied warranties with respect to the logos.' include_status: type: boolean default: false description: If `true`, the response will include status information about the institution. Default value is `false`. include_auth_metadata: type: boolean default: false description: When `true`, returns metadata related to the Auth product indicating which auth methods are supported. include_payment_initiation_metadata: type: boolean default: false description: When `true`, returns metadata related to the Payment Initiation product indicating which payment configurations are supported. CreditFreddieMacParties: title: CreditFreddieMacParties type: object additionalProperties: true description: A collection of objects that define specific parties to a deal. This includes the direct participating parties, such as borrower and seller and the indirect parties such as the credit report provider. properties: PARTY: type: array items: $ref: '#/components/schemas/CreditFreddieMacParty' required: - PARTY CraBankIncomeItem: type: object description: The details and metadata for an end user's Item. properties: bank_income_accounts: type: array description: The Item's accounts that have Bank Income data. items: $ref: '#/components/schemas/CraBankIncomeAccount' bank_income_sources: type: array description: The income sources for this Item. Each entry in the array is a single income source. items: $ref: '#/components/schemas/CraBankIncomeSource' last_updated_time: type: string description: The time when this Item's data was last retrieved from the financial institution. format: date-time institution_id: type: string description: The unique identifier of the institution associated with the Item. institution_name: type: string description: The name of the institution associated with the Item. required: - bank_income_sources - bank_income_accounts AccountsGetRequestOptions: type: object description: An optional object to filter `/accounts/get` results. properties: account_ids: type: array description: An array of `account_ids` to retrieve for the Account. items: type: string EntityDocument: title: EntityDocument type: object description: An official document, usually issued by a governing body or institution, with an associated identifier. properties: type: $ref: '#/components/schemas/EntityDocumentType' number: $ref: '#/components/schemas/WatchlistScreeningDocumentValue' required: - type - number additionalProperties: true Transfer: title: Transfer type: object additionalProperties: true description: Represents a transfer within the Transfers API. properties: id: $ref: '#/components/schemas/TransferID' authorization_id: $ref: '#/components/schemas/TransferAuthorizationID' ach_class: $ref: '#/components/schemas/ACHClass' account_id: type: string description: The Plaid `account_id` corresponding to the end-user account that will be debited or credited. funding_account_id: $ref: '#/components/schemas/TransferFundingAccountIDResponseNullable' type: $ref: '#/components/schemas/TransferType' user: $ref: '#/components/schemas/TransferUserInResponse' amount: $ref: '#/components/schemas/TransferAmount' description: type: string description: The description of the transfer. created: type: string format: date-time description: The datetime when this transfer was created. This will be of the form `2006-01-02T15:04:05Z` status: $ref: '#/components/schemas/TransferStatus' sweep_status: $ref: '#/components/schemas/TransferSweepStatus' network: $ref: '#/components/schemas/TransferNetwork' wire_details: $ref: '#/components/schemas/TransferWireDetails' cancellable: type: boolean description: When `true`, you can still cancel this transfer. failure_reason: $ref: '#/components/schemas/TransferFailure' metadata: $ref: '#/components/schemas/TransferMetadata' origination_account_id: type: string description: Plaid’s unique identifier for the origination account that was used for this transfer. deprecated: true x-hidden-from-docs: true guarantee_decision: $ref: '#/components/schemas/TransferAuthorizationGuaranteeDecision' guarantee_decision_rationale: $ref: '#/components/schemas/TransferAuthorizationGuaranteeDecisionRationale' iso_currency_code: type: string description: The currency of the transfer amount, e.g. "USD" standard_return_window: type: - string - 'null' description: 'The date 3 business days from settlement date indicating the following ACH returns can no longer happen: R01, R02, R03, R29. This will be of the form YYYY-MM-DD.' format: date unauthorized_return_window: type: - string - 'null' description: 'The date 61 business days from settlement date indicating the following ACH returns can no longer happen: R05, R07, R10, R11, R51, R33, R37, R38, R51, R52, R53. This will be of the form YYYY-MM-DD.' format: date expected_settlement_date: type: - string - 'null' description: The expected date when the full amount of the transfer settles at the consumers’ account, if the transfer is credit; or at the customer's business checking account, if the transfer is debit. Only set for ACH transfers and is null for non-ACH transfers. Only set for ACH transfers. This will be of the form YYYY-MM-DD. format: date originator_client_id: type: - string - 'null' description: The Plaid client ID that is the originator of this transfer. Only present if created on behalf of another client as a [Platform customer](https://plaid.com/docs/transfer/application/#originators-vs-platforms). refunds: type: array description: A list of refunds associated with this transfer. items: $ref: '#/components/schemas/TransferRefund' recurring_transfer_id: type: - string - 'null' description: The id of the recurring transfer if this transfer belongs to a recurring transfer. expected_sweep_settlement_schedule: type: array description: The expected sweep settlement schedule of this transfer, assuming this transfer is not `returned`. Only applies to ACH debit transfers. items: $ref: '#/components/schemas/TransferExpectedSweepSettlementScheduleItem' credit_funds_source: deprecated: true allOf: - $ref: '#/components/schemas/TransferCreditFundsSource' facilitator_fee: $ref: '#/components/schemas/TransferFacilitatorFee' network_trace_id: $ref: '#/components/schemas/TransferNetworkTraceID' required: - id - authorization_id - type - user - amount - description - created - status - network - cancellable - failure_reason - metadata - origination_account_id - guarantee_decision - guarantee_decision_rationale - iso_currency_code - standard_return_window - unauthorized_return_window - expected_settlement_date - originator_client_id - refunds - recurring_transfer_id - funding_account_id - credit_funds_source CraLoanStatusEffectiveDate: type: string format: date description: The effective date for the status of the loan. The date should be in ISO 8601 format (YYYY-MM-DD). SandboxPublicTokenCreateRequest: type: object description: SandboxPublicTokenCreateRequest defines the request schema for `/sandbox/public_token/create` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' institution_id: type: string description: The ID of the institution the Item will be associated with initial_products: type: array description: The products to initially pull for the Item. May be any products that the specified `institution_id` supports. This array may not be empty. items: $ref: '#/components/schemas/Products' minItems: 1 x-override-enum-values-shown: - assets - auth - balance - employment - identity - income_verification - identity_verification - investments - liabilities - payment_initiation - standing_orders - statements - transactions - transfer options: $ref: '#/components/schemas/SandboxPublicTokenCreateRequestOptions' user_token: $ref: '#/components/schemas/UserToken' required: - institution_id - initial_products PaymentInitiationConsentStatus: type: string enum: - UNAUTHORISED - AUTHORISED - REVOKED - REJECTED - EXPIRED description: 'The status of the payment consent. `UNAUTHORISED`: Consent created, but requires user authorisation. `REJECTED`: Consent authorisation was rejected by the user and/or the bank. `AUTHORISED`: Consent is active and ready to be used. `REVOKED`: Consent has been revoked and can no longer be used. `EXPIRED`: Consent is no longer valid.' TransactionsRefreshRequest: type: object description: TransactionsRefreshRequest defines the request schema for `/transactions/refresh` properties: client_id: $ref: '#/components/schemas/APIClientID' access_token: $ref: '#/components/schemas/AccessToken' secret: $ref: '#/components/schemas/APISecret' required: - access_token WatchlistScreeningEntityUpdateResponse: description: 'The entity screening object allows you to represent an entity in your system, update its profile, and search for it on various watchlists. Note: Rejected entity screenings will not receive new hits, regardless of entity program configuration.' additionalProperties: true properties: id: $ref: '#/components/schemas/EntityWatchlistScreeningID' search_terms: $ref: '#/components/schemas/EntityWatchlistScreeningSearchTerms' assignee: $ref: '#/components/schemas/DashboardUserIDNullable' status: $ref: '#/components/schemas/WatchlistScreeningStatus' client_user_id: $ref: '#/components/schemas/ClientUserIDNullable' audit_trail: $ref: '#/components/schemas/WatchlistScreeningAuditTrail' request_id: $ref: '#/components/schemas/RequestID' required: - id - search_terms - assignee - status - client_user_id - audit_trail - request_id type: object WatchlistScreeningIndividualUpdateRequestResettableFieldList: type: - array - 'null' items: $ref: '#/components/schemas/WatchlistScreeningIndividualUpdateRequestResettableField' description: A list of fields to reset back to null FamilyNameField: type: string example: Knope title: FamilyName description: A string with at least one non-whitespace character, with a max length of 100 characters. ISO8601DateNullable: type: - string - 'null' format: date title: ISO8601Date example: '1990-05-29' description: A date in the format YYYY-MM-DD (RFC 3339 Section 5.6). LoanIdentifiers: title: LoanIdentifiers type: object additionalProperties: true description: Collection of current and previous identifiers for this loan. properties: LOAN_IDENTIFIER: $ref: '#/components/schemas/LoanIdentifier' required: - LOAN_IDENTIFIER BankTransfer: title: BankTransfer type: object additionalProperties: true description: Represents a bank transfer within the Bank Transfers API. properties: id: $ref: '#/components/schemas/BankTransferID' ach_class: $ref: '#/components/schemas/ACHClass' account_id: type: string description: The account ID that should be credited/debited for this bank transfer. type: $ref: '#/components/schemas/BankTransferType' user: $ref: '#/components/schemas/BankTransferUser' amount: $ref: '#/components/schemas/BankTransferAmount' iso_currency_code: type: string description: The currency of the transfer amount, e.g. "USD" description: type: string description: The description of the transfer. created: type: string format: date-time description: The datetime when this bank transfer was created. This will be of the form `2006-01-02T15:04:05Z` status: $ref: '#/components/schemas/BankTransferStatus' network: $ref: '#/components/schemas/BankTransferNetwork' cancellable: type: boolean description: When `true`, you can still cancel this bank transfer. failure_reason: $ref: '#/components/schemas/BankTransferFailure' custom_tag: type: - string - 'null' description: A string containing the custom tag provided by the client in the create request. Will be null if not provided. metadata: $ref: '#/components/schemas/BankTransferMetadata' origination_account_id: type: string description: Plaid’s unique identifier for the origination account that was used for this transfer. direction: $ref: '#/components/schemas/BankTransferDirection' required: - id - ach_class - account_id - type - user - amount - iso_currency_code - description - created - status - network - cancellable - failure_reason - custom_tag - metadata - origination_account_id - direction TransferOriginatorFundingAccountUpdateResponse: title: TransferOriginatorFundingAccountUpdateResponse type: object additionalProperties: true description: Defines the response schema for `/transfer/originator/funding_account/update` properties: request_id: $ref: '#/components/schemas/RequestID' required: - request_id CreditBankIncomeRefreshRequest: title: CreditBankIncomeRefreshRequest type: object description: CreditBankIncomeRefreshRequest defines the request schema for `/credit/bank_income/refresh`. properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' user_token: $ref: '#/components/schemas/UserToken' options: $ref: '#/components/schemas/CreditBankIncomeRefreshRequestOptions' required: - user_token CreditPayrollIncomeRefreshRequest: title: CreditPayrollIncomeRefreshRequest type: object description: CreditPayrollIncomeRefreshRequest defines the request schema for `/credit/payroll_income/refresh` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' user_token: $ref: '#/components/schemas/UserToken' options: $ref: '#/components/schemas/CreditPayrollIncomeRefreshRequestOptions' required: - user_token IncidentUpdate: title: IncidentUpdate description: An update on the health incident type: object additionalProperties: true properties: description: type: string description: The content of the update. status: type: string description: The status of the incident. enum: - INVESTIGATING - IDENTIFIED - SCHEDULED - RESOLVED - UNKNOWN updated_date: type: string format: date-time description: The date when the update was published, in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format, e.g. `"2020-10-30T15:26:48Z"`. Earnings: title: Earnings type: object description: An object representing both a breakdown of earnings on a paystub and the total earnings. additionalProperties: true properties: subtotals: deprecated: true type: array items: $ref: '#/components/schemas/EarningsTotal' totals: deprecated: true type: array items: $ref: '#/components/schemas/EarningsTotal' breakdown: type: array items: $ref: '#/components/schemas/EarningsBreakdown' total: $ref: '#/components/schemas/EarningsTotal' CreditSessionBankIncomeResult: type: object description: The details of a bank income verification in Link properties: status: $ref: '#/components/schemas/CreditSessionBankIncomeStatus' item_id: description: 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. type: string institution_id: description: The Plaid Institution ID associated with the Item. type: string LiabilitiesGetRequest: type: object description: LiabilitiesGetRequest defines the request schema for `/liabilities/get` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' access_token: $ref: '#/components/schemas/AccessToken' options: $ref: '#/components/schemas/LiabilitiesGetRequestOptions' required: - access_token DocumentStatus: type: string enum: - success - failed - manually_approved example: success title: DocumentStatus description: An outcome status for this specific document submission. Distinct from the overall `documentary_verification.status` that summarizes the verification outcome from one or more documents. Transaction: title: Transaction description: A representation of a transaction x-examples: {} allOf: - $ref: '#/components/schemas/TransactionBase' - type: object additionalProperties: true properties: authorized_date: type: - string - 'null' format: date description: 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](https://wikipedia.org/wiki/ISO_8601) format ( `YYYY-MM-DD` ). authorized_datetime: type: - string - 'null' format: date-time description: 'Date and time when a transaction was authorized in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format ( `YYYY-MM-DDTHH:mm:ssZ` ). For posted transactions, the `datetime` field will indicate the posted date, but `authorized_datetime` will indicate the day the transaction was authorized by the financial institution. If presenting transactions to the user in a UI, the `authorized_datetime`, when available, is generally preferable to use over the `datetime` field for posted transactions, as it will generally represent the date the user actually made the transaction. 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.' datetime: type: - string - 'null' format: date-time description: 'Date and time when a transaction was posted in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format ( `YYYY-MM-DDTHH:mm:ssZ` ). For the date that the transaction was initiated, rather than posted, see the `authorized_datetime` field. 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.' payment_channel: type: string enum: - online - in store - other description: 'The channel used to make a payment. `online:` transactions that took place online. `in store:` transactions that were made at a physical location. `other:` transactions that relate to banks, e.g. fees or deposits. This field replaces the `transaction_type` field. ' personal_finance_category: $ref: '#/components/schemas/PersonalFinanceCategory' transaction_code: $ref: '#/components/schemas/TransactionCode' personal_finance_category_icon_url: type: string description: The URL of an icon associated with the primary personal finance category. The icon will always be 100×100 pixel PNG file. counterparties: type: array description: The counterparties present in the transaction. Counterparties, such as the merchant or the financial institution, are extracted by Plaid from the raw description. items: $ref: '#/components/schemas/TransactionCounterparty' merchant_entity_id: type: - string - 'null' description: 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. required: - account_owner - pending_transaction_id - payment_channel - payment_meta - name - location - authorized_date - authorized_datetime - datetime - category_id - category - transaction_code PartnerCustomerCreateRequest: description: Request schema for `/partner/customer/create`. properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' company_name: description: The company name of the end customer being created. This will be used to display the end customer in the Plaid Dashboard. It will not be shown to end users. type: string is_diligence_attested: description: Denotes whether or not the partner has completed attestation of diligence for the end customer to be created. type: boolean products: description: The products to be enabled for the end customer. If empty or `null`, this field will default to the products enabled for the reseller at the time this endpoint is called. type: array items: $ref: '#/components/schemas/Products' x-override-enum-values-shown: - assets - auth - balance - identity - income_verification - investments - liabilities - transactions - employment create_link_customization: description: If `true`, the end customer's default Link customization will be set to match the partner's. You can always change the end customer's Link customization in the Plaid Dashboard. See the [Link Customization docs](https://plaid.com/docs/link/customization/) for more information. type: boolean logo: description: Base64-encoded representation of the end customer's logo. Must be a PNG of size 1024x1024 under 4MB. The logo will be shared with financial institutions and shown to the end user during Link flows. A logo is required if `create_link_customization` is `true`. If `create_link_customization` is `false` and the logo is omitted, the partner's logo will be used if one exists, otherwise a stock logo will be used. type: string legal_entity_name: description: The end customer's legal name. This will be shared with financial institutions as part of the OAuth registration process. It will not be shown to end users. type: string website: description: The end customer's website. type: string application_name: description: The name of the end customer's application. This will be shown to end users when they go through the Plaid Link flow. type: string technical_contact: $ref: '#/components/schemas/PartnerEndCustomerTechnicalContact' billing_contact: $ref: '#/components/schemas/PartnerEndCustomerBillingContact' customer_support_info: $ref: '#/components/schemas/PartnerEndCustomerCustomerSupportInfo' address: $ref: '#/components/schemas/PartnerEndCustomerAddress' is_bank_addendum_completed: description: Denotes whether the partner has forwarded the Plaid bank addendum to the end customer. type: boolean assets_under_management: $ref: '#/components/schemas/PartnerEndCustomerAssetsUnderManagement' redirect_uris: description: A list of URIs indicating the destination(s) where a user can be forwarded after completing the Link flow; used to support OAuth authentication flows when launching Link in the browser or another app. URIs should not contain any query parameters. When used in Production or Development, URIs must use https. To specify any subdomain, use `*` as a wildcard character, e.g. `https://*.example.com/oauth.html`. To modify redirect URIs for an end customer after creating them, go to the end customer's [API page](https://dashboard.plaid.com/team/api) in the Dashboard. type: array items: type: string registration_number: description: The unique identifier assigned to a financial institution by regulatory authorities, if applicable. For banks, this is the FDIC Certificate Number. For credit unions, this is the Credit Union Charter Number. type: string required: - company_name - is_diligence_attested - legal_entity_name - website - application_name - address - is_bank_addendum_completed SandboxTransferTestClockAdvanceResponse: title: SandboxTransferTestClockAdvanceResponse type: object additionalProperties: true description: Defines the response schema for `/sandbox/transfer/test_clock/advance` properties: request_id: $ref: '#/components/schemas/RequestID' required: - request_id CreditSessionBankIncomeStatus: type: string enum: - APPROVED - NO_DEPOSITS_FOUND - USER_REPORTED_NO_INCOME description: 'Status of the Bank Income Link session. `APPROVED`: User has approved and verified their income `NO_DEPOSITS_FOUND`: We attempted, but were unable to find any income in the connected account. `USER_REPORTED_NO_INCOME`: The user explicitly indicated that they don''t receive income in the connected account. `STARTED`: The user began the bank income portion of the link flow. `INTERNAL_ERROR`: The user encountered an internal error.' BeaconUserRequestAddressNullable: type: - object - 'null' title: BeaconUserRequestAddress description: Home address for the associated user. For more context on this field, see [Input Validation by Country](https://plaid.com/docs/identity-verification/hybrid-input-validation/#input-validation-by-country). properties: street: $ref: '#/components/schemas/Street' street2: $ref: '#/components/schemas/Street2' city: $ref: '#/components/schemas/City' region: $ref: '#/components/schemas/Region' postal_code: $ref: '#/components/schemas/PostalCode' country: $ref: '#/components/schemas/GenericCountryCode' required: - street - city - country additionalProperties: true CreditFreddieMacReportingInformation: title: CreditFreddieMacReportingInformation type: object additionalProperties: true description: Information about an report identifier and a report name. properties: ReportDateTime: type: string description: Documentation not found in the MISMO model viewer and not provided by Freddie Mac. ReportIdentifierType: type: string description: Documentation not found in the MISMO model viewer and not provided by Freddie Mac. The value can only be "ReportID" ReportingInformationParentIdentifier: type: string description: Documentation not found in the MISMO model viewer and not provided by Freddie Mac. ReportingInformationIdentifier: type: string description: Documentation not found in the MISMO model viewer and not provided by Freddie Mac. required: - ReportingInformationIdentifier NumbersACATS: x-hidden-from-docs: true title: NumbersACATS type: object additionalProperties: true description: Identifying information for transferring holdings to an investments account via ACATS. properties: account_id: type: string description: The Plaid account ID associated with the account numbers account: type: string description: The full account number for the account dtc_numbers: type: array description: Identifiers for the clearinghouses that are assocciated with the account in order of relevance. This array will be empty if we can't provide any account level data. Institution level data can be retrieved from the institutions/get endpoints. items: type: string required: - account_id - account - dtc_numbers WalletTransactionCounterparty: title: WalletTransactionCounterparty type: object additionalProperties: true description: An object representing the e-wallet transaction's counterparty properties: name: type: string description: The name of the counterparty minLength: 1 numbers: $ref: '#/components/schemas/WalletTransactionCounterpartyNumbers' address: $ref: '#/components/schemas/PaymentInitiationAddress' date_of_birth: type: - string - 'null' format: date description: The counterparty's birthdate, in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) (YYYY-MM-DD) format. required: - name - numbers ExternalPaymentInitiationConsentOptions: type: - object - 'null' title: ExternalPaymentInitiationConsentOptions description: Additional payment consent options properties: request_refund_details: type: - boolean - 'null' description: When `true`, Plaid will attempt to request refund details from the payee's financial institution. Support varies between financial institutions and will not always be available. If refund details could be retrieved, they will be available in the `/payment_initiation/payment/get` response. iban: type: - string - 'null' minLength: 15 maxLength: 34 description: The International Bank Account Number (IBAN) for the payer's account. Where possible, the end user will be able to set up payment consent using only the specified bank account if provided. bacs: $ref: '#/components/schemas/PaymentInitiationOptionalRestrictionBacs' AssetReportGetRequest: type: object description: AssetReportGetRequest defines the request schema for `/asset_report/get` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' asset_report_token: $ref: '#/components/schemas/AssetReportTokenNullable' user_token: type: string description: The user token associated with the User for which to create an asset report for. The latest asset report associated with the User will be returned x-hidden-from-docs: true include_insights: type: boolean default: false description: '`true` if you would like to retrieve the Asset Report with Insights, `false` otherwise. This field defaults to `false` if omitted.' fast_report: type: boolean default: false description: '`true` to fetch "fast" version of asset report. Defaults to false if omitted. Can only be used if `/asset_report/create` was called with `options.add_ons` set to `["fast_assets"]`.' options: $ref: '#/components/schemas/AssetReportGetRequestOptions' DashboardUser: title: DashboardUser type: object description: Account information associated with a team member with access to the Plaid dashboard. properties: id: $ref: '#/components/schemas/DashboardUserID' created_at: $ref: '#/components/schemas/Timestamp' email_address: $ref: '#/components/schemas/EmailAddress' status: $ref: '#/components/schemas/DashboardUserStatus' required: - id - created_at - email_address - status additionalProperties: true CraBankIncomeEmployer: description: The object containing employer data. type: object additionalProperties: true properties: name: type: - string - 'null' description: The name of the employer. required: - name TransferRecurringNetwork: type: string title: TransferRecurrinngNetwork description: Networks eligible for recurring transfers. enum: - ach - same-day-ach - rtp StatementsRefreshResponse: title: StatementsRefreshResponse type: object additionalProperties: true description: StatementsRefreshResponse defines the response schema for `/statements/refresh` properties: request_id: $ref: '#/components/schemas/RequestID' required: - request_id KYCCheckNameSummary: description: Result summary object specifying how the `name` field matched. type: object properties: summary: $ref: '#/components/schemas/MatchSummaryCode' required: - summary additionalProperties: true TransferOriginatorAddress: description: The originator's address. type: object properties: city: type: string description: The full city name. street: type: string description: The full street address. region: type: string description: The two-letter code for the state or province (e.g., "CA"). postal_code: description: The postal code (e.g., "94103"). type: string country_code: description: ISO-3166-1 alpha-2 country code standard. type: string required: - city - street - region - postal_code - country_code Assets: title: Assets type: object additionalProperties: true description: Documentation not found in the MISMO model viewer and not provided by Freddie Mac. properties: ASSET: type: array items: $ref: '#/components/schemas/Asset' description: Documentation not found in the MISMO model viewer and not provided by Freddie Mac. required: - ASSET LinkTokenEUConfig: description: Configuration parameters for EU flows type: object properties: headless: type: boolean description: If `true`, open Link without an initial UI. Defaults to `false`. Statuses: title: Statuses type: object additionalProperties: true description: A collection of STATUS containers. properties: STATUS: $ref: '#/components/schemas/Status' required: - STATUS RiskCheckBehaviorUserInteractionsLabel: description: 'Field describing the overall user interaction signals of a behavior risk check. This value represents how familiar the user is with the personal data they provide, based on a number of signals that are collected during their session. `genuine` indicates the user has high familiarity with the data they are providing, and that fraud is unlikely. `neutral` indicates some signals are present in between `risky` and `genuine`, but there are not enough clear signals to determine an outcome. `risky` indicates the user has low familiarity with the data they are providing, and that fraud is likely. `no_data` indicates there is not sufficient information to give an accurate signal.' type: string enum: - genuine - neutral - risky - no_data example: risky TransferCreateRequest: title: TransferCreateRequest type: object description: Defines the request schema for `/transfer/create` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' idempotency_key: $ref: '#/components/schemas/TransferCreateIdempotencyKey' access_token: $ref: '#/components/schemas/TransferAccessToken' account_id: $ref: '#/components/schemas/TransferAccountID' authorization_id: type: string description: Plaid’s unique identifier for a transfer authorization. This parameter also serves the purpose of acting as an idempotency identifier. type: x-hidden-from-docs: true deprecated: true allOf: - $ref: '#/components/schemas/TransferType' network: x-hidden-from-docs: true deprecated: true allOf: - $ref: '#/components/schemas/TransferNetwork' amount: $ref: '#/components/schemas/TransferAmount' description: type: string description: The transfer description. Maximum of 15 characters. If reprocessing a returned transfer, please note that the `description` field must be `"Retry 1"` or `"Retry 2"` to indicate that it's a retry of a previously returned transfer. You may retry a transfer up to 2 times, within 180 days of creating the original transfer. Only transfers that were returned with code `R01` or `R09` may be retried. For a full listing of ACH return codes, see [Transfer errors](https://plaid.com/docs/errors/transfer/#ach-return-codes). maxLength: 15 ach_class: x-hidden-from-docs: true deprecated: true allOf: - $ref: '#/components/schemas/ACHClass' user: $ref: '#/components/schemas/TransferUserInRequestDeprecated' metadata: $ref: '#/components/schemas/TransferMetadata' origination_account_id: type: - string - 'null' x-hidden-from-docs: true deprecated: true description: Plaid’s unique identifier for the origination account for this transfer. If you have more than one origination account, this value must be specified. Otherwise, this field should be left blank. iso_currency_code: type: string x-hidden-from-docs: true deprecated: true description: The currency of the transfer amount. The default value is "USD". test_clock_id: type: - string - 'null' description: Plaid’s unique identifier for a test clock. This field may only be used when using `sandbox` environment. If provided, the `transfer` is created at the `virtual_time` on the provided `test_clock`. facilitator_fee: $ref: '#/components/schemas/TransferFacilitatorFee' required: - access_token - account_id - authorization_id - description ClientProvidedRawTransaction: title: ClientProvidedRawTransaction type: object description: A client-provided transaction for Plaid to enhance. additionalProperties: true properties: id: type: string description: A unique ID for the transaction used to help you tie data back to your systems. description: type: string description: The raw description of the transaction. amount: type: number format: double description: "The value of the transaction with direction. (NOTE: this will affect enrichment results, so directions are important):.\n Negative (-) for credits (e.g., incoming transfers, refunds)\n Positive (+) for debits (e.g., purchases, fees, outgoing transfers)" iso_currency_code: type: string description: The ISO-4217 currency code of the transaction e.g. USD. required: - id - description - amount - iso_currency_code MortgagePropertyAddress: title: MortgagePropertyAddress type: object additionalProperties: true description: Object containing fields describing property address. properties: city: type: - string - 'null' description: The city name. country: type: - string - 'null' description: The ISO 3166-1 alpha-2 country code. postal_code: type: - string - 'null' description: The five or nine digit postal code. region: type: - string - 'null' description: The region or state (example "NC"). street: type: - string - 'null' description: The full street address (example "564 Main Street, Apt 15"). required: - city - country - postal_code - region - street AddressDataNullable: description: Data about the components comprising an address. allOf: - $ref: '#/components/schemas/AddressData' - type: object additionalProperties: true SandboxOauthSelectAccountsRequest: title: SandboxOauthSelectAccountsRequest type: object description: Defines the request schema for `sandbox/oauth/select_accounts` properties: oauth_state_id: type: string accounts: type: array items: type: string required: - oauth_state_id - accounts TransactionBase: title: TransactionBase type: object additionalProperties: true description: A representation of a transaction x-examples: {} properties: account_id: type: string description: The ID of the account in which this transaction occurred. amount: type: number format: double description: The settled value of the transaction, denominated in the transactions's currency, as stated in `iso_currency_code` or `unofficial_currency_code`. 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. iso_currency_code: type: - string - 'null' description: The ISO-4217 currency code of the transaction. Always `null` if `unofficial_currency_code` is non-null. unofficial_currency_code: type: - string - 'null' description: 'The unofficial currency code associated with the transaction. Always `null` if `iso_currency_code` is non-`null`. Unofficial currency codes are used for currencies that do not have official ISO currency codes, such as cryptocurrencies and the currencies of certain countries. See the [currency code schema](https://plaid.com/docs/api/accounts#currency-code-schema) for a full listing of supported `iso_currency_code`s.' category: deprecated: true type: - array - 'null' description: 'A hierarchical array of the categories to which this transaction belongs. For a full list of categories, see [`/categories/get`](https://plaid.com/docs/api/products/transactions/#categoriesget). All Transactions implementations are recommended to use the new `personal_finance_category` instead of `category`, as it provides greater accuracy and more meaningful categorization. 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.' items: type: string category_id: deprecated: true description: 'The ID of the category to which this transaction belongs. For a full list of categories, see [`/categories/get`](https://plaid.com/docs/api/products/transactions/#categoriesget). All Transactions implementations are recommended to use the new `personal_finance_category` instead of `category`, as it provides greater accuracy and more meaningful categorization. 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.' type: - string - 'null' check_number: type: - string - 'null' description: The check number of the transaction. This field is only populated for check transactions. date: type: string format: date description: 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](https://wikipedia.org/wiki/ISO_8601) format ( `YYYY-MM-DD` ). To receive information about the date that a posted transaction was initiated, see the `authorized_date` field. location: $ref: '#/components/schemas/Location' name: type: string description: 'The merchant name or transaction description. If the `transactions` object was returned by a Transactions endpoint such as `/transactions/sync` or `/transactions/get`, this field will always appear. 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.' merchant_name: type: - string - 'null' description: 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`. original_description: type: - string - 'null' description: The string returned by the financial institution to describe the transaction. For transactions returned by `/transactions/sync` or `/transactions/get`, this field will be omitted unless the client has set `options.include_original_description` to `true`. payment_meta: $ref: '#/components/schemas/PaymentMeta' pending: type: boolean description: When `true`, identifies the transaction as pending or unsettled. Pending transaction details (name, type, amount, category ID) may change before they are settled. pending_transaction_id: type: - string - 'null' description: The ID of a posted transaction's associated pending transaction, where applicable. account_owner: type: - string - 'null' description: The name of the account owner. This field is not typically populated and only relevant when dealing with sub-accounts. transaction_id: type: string description: The unique ID of the transaction. Like all Plaid identifiers, the `transaction_id` is case sensitive. transaction_type: type: string enum: - digital - place - special - unresolved description: 'Please use the `payment_channel` field, `transaction_type` will be deprecated in the future. `digital:` transactions that took place online. `place:` transactions that were made at a physical location. `special:` transactions that relate to banks, e.g. fees or deposits. `unresolved:` transactions that do not fit into the other three types. ' deprecated: true logo_url: type: - string - 'null' description: The URL of a logo associated with this transaction, if available. The logo will always be 100×100 pixel PNG file. website: type: - string - 'null' description: The website associated with this transaction, if available. required: - transaction_id - pending - date - unofficial_currency_code - iso_currency_code - amount - account_id TransactionsEnrichRequestOptions: type: object description: An optional object to be used with the request. properties: include_legacy_category: type: boolean default: false description: 'Include `legacy_category` and `legacy_category_id` in the response (in addition to the default `personal_finance_category`). Categories are based on Plaid''s legacy taxonomy. For a full list of legacy categories, see [`/categories/get`](https://plaid.com/docs/api/products/transactions/#categoriesget).' PaystubAddress: title: Address description: Address on the paystub type: object additionalProperties: true properties: city: type: - string - 'null' description: The full city name. country: type: - string - 'null' description: The ISO 3166-1 alpha-2 country code. postal_code: type: - string - 'null' description: The postal code of the address. region: type: - string - 'null' description: 'The region or state Example: `"NC"`' street: type: - string - 'null' description: The full street address. line1: deprecated: true type: - string - 'null' description: Street address line 1. line2: deprecated: true type: - string - 'null' description: Street address line 2. state_code: deprecated: true type: - string - 'null' description: 'The region or state Example: `"NC"`' SimulatedTransferSweep: title: SimulatedTransferSweep type: object additionalProperties: true description: 'A sweep returned from the `/sandbox/transfer/sweep/simulate` endpoint. Can be null if there are no transfers to include in a sweep.' allOf: - $ref: '#/components/schemas/TransferSweep' - type: - object - 'null' IdentityVerificationAutofillCreateRequest: type: object description: Request input to autofill an Identity Verification properties: identity_verification_id: $ref: '#/components/schemas/IdentityVerificationID' client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' required: - identity_verification_id CraBankIncomeSummary: type: object description: Summary for bank income across all income sources and items (max history of 730 days). additionalProperties: true properties: total_amounts: type: array description: 'Total amount of earnings across all the income sources in the end user''s Items for the days requested by the client. This can contain multiple amounts, with each amount denominated in one unique currency.' items: $ref: '#/components/schemas/CreditAmountWithCurrency' start_date: type: string format: date description: 'The earliest date within the days requested in which all income sources identified by Plaid appear in a user''s account. The date will be returned in an ISO 8601 format (YYYY-MM-DD).' end_date: type: string format: date description: 'The latest date in which all income sources identified by Plaid appear in the user''s account. The date will be returned in an ISO 8601 format (YYYY-MM-DD).' income_sources_count: type: integer description: Number of income sources per end user. income_categories_count: type: integer description: Number of income categories per end user. income_transactions_count: type: integer description: Number of income transactions per end user. historical_average_monthly_gross_income: type: array description: An estimate of the average gross monthly income based on the historical net amount and income category for the income source(s). items: $ref: '#/components/schemas/CreditAmountWithCurrency' historical_average_monthly_income: type: array description: The average monthly income amount estimated based on the historical data for the income source(s). items: $ref: '#/components/schemas/CreditAmountWithCurrency' forecasted_average_monthly_income: type: array description: The predicted average monthly income amount for the income source(s). items: $ref: '#/components/schemas/CreditAmountWithCurrency' historical_annual_gross_income: type: array x-hidden-from-docs: true description: An estimate of the annual gross income based on the historical net amount and income category for the income source(s). items: $ref: '#/components/schemas/CreditAmountWithCurrency' historical_annual_income: type: array x-hidden-from-docs: true description: The annual income amount estimated based on the historical data for the income source(s). items: $ref: '#/components/schemas/CreditAmountWithCurrency' forecasted_annual_income: type: array x-hidden-from-docs: true description: The predicted average annual income amount for the income source(s). items: $ref: '#/components/schemas/CreditAmountWithCurrency' historical_summary: type: array items: $ref: '#/components/schemas/CraBankIncomeHistoricalSummary' WatchlistScreeningEntityListRequest: description: Request input for listing entity watchlist screenings type: object properties: secret: $ref: '#/components/schemas/APISecret' client_id: $ref: '#/components/schemas/APIClientID' entity_watchlist_program_id: $ref: '#/components/schemas/EntityWatchlistProgramID' client_user_id: $ref: '#/components/schemas/ClientUserID' status: $ref: '#/components/schemas/WatchlistScreeningStatus' assignee: $ref: '#/components/schemas/DashboardUserID' cursor: $ref: '#/components/schemas/Cursor' required: - entity_watchlist_program_id InstitutionsSearchRequest: type: object description: InstitutionsSearchRequest defines the request schema for `/institutions/search` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' query: type: string description: The search query. Institutions with names matching the query are returned minLength: 1 products: type: - array - 'null' description: Filter the Institutions based on whether they support all products listed in `products`. Provide `null` to get institutions regardless of supported products. Note that when `auth` is specified as a product, if you are enabled for Instant Match or Automated Micro-deposits, institutions that support those products will be returned even if `auth` is not present in their product array. minItems: 1 items: $ref: '#/components/schemas/Products' x-override-enum-values-shown: - assets - auth - balance - employment - identity - income_verification - investments - liabilities - identity_verification - payment_initiation - standing_orders - transactions - transfer country_codes: type: array description: 'Specify which country or countries to include institutions from, using the ISO-3166-1 alpha-2 country code standard. In API versions 2019-05-29 and earlier, the `country_codes` parameter is an optional parameter within the `options` object and will default to `[US]` if it is not supplied. ' items: $ref: '#/components/schemas/CountryCode' options: $ref: '#/components/schemas/InstitutionsSearchRequestOptions' required: - query - country_codes BeaconUserRevision: type: object title: BeaconUserRevision description: A Beacon User Revision identifies a Beacon User at some point in its revision history. properties: id: $ref: '#/components/schemas/BeaconUserID' version: type: integer description: The `version` field begins with 1 and increments with each subsequent revision. example: 1 required: - id - version additionalProperties: true ACHClass: type: string title: ACHClass enum: - ccd - ppd - tel - web description: 'Specifies the use case of the transfer. Required for transfers on an ACH network. Codes supported for credits: `ccd`, `ppd` Codes supported for debits: `ccd`, `tel`, `web` `"ccd"` - Corporate Credit or Debit - fund transfer between two corporate bank accounts `"ppd"` - Prearranged Payment or Deposit - the transfer is part of a pre-existing relationship with a consumer, e.g. bill payment `"tel"` - Telephone-Initiated Entry `"web"` - Internet-Initiated Entry - debits from a consumer’s account where their authorization is obtained over the Internet' TransferRefundGetResponse: title: TransferRefundCreateResponse type: object additionalProperties: true description: Defines the response schema for `/transfer/refund/get` properties: refund: $ref: '#/components/schemas/TransferRefund' request_id: $ref: '#/components/schemas/RequestID' required: - refund - request_id SandboxIncomeWebhookFireRequestWebhookCode: type: string enum: - INCOME_VERIFICATION - INCOME_VERIFICATION_RISK_SIGNALS description: The webhook codes that can be fired by this test endpoint. SelfieCheck: description: Additional information for the `selfie_check` step. This field will be `null` unless `steps.selfie_check` has reached a terminal state of either `success` or `failed`. title: SelfieCheck type: - object - 'null' properties: status: $ref: '#/components/schemas/SelfieCheckStatus' selfies: description: An array of selfies submitted to the `selfie_check` step. Each entry represents one user submission. type: array items: $ref: '#/components/schemas/SelfieCheckSelfie' required: - status - selfies additionalProperties: true CreditBankEmploymentGetRequest: title: CreditBankEmploymentGetRequest type: object description: CreditBankEmploymentGetRequest defines the request schema for `/beta/credit/v1/bank_employment/get`. properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' user_token: $ref: '#/components/schemas/UserToken' required: - user_token ProcessorAccountGetRequest: type: object description: ProcessorAccountGetRequest defines the request schema for `/processor/account/get` properties: client_id: $ref: '#/components/schemas/APIClientID' processor_token: $ref: '#/components/schemas/ProcessorToken' secret: $ref: '#/components/schemas/APISecret' required: - processor_token WalletBalance: title: WalletBalance type: object additionalProperties: true description: An object representing the e-wallet balance properties: iso_currency_code: type: string description: The ISO-4217 currency code of the balance current: type: number format: double description: The total amount of funds in the account available: type: number format: double description: The total amount of funds in the account after subtracting pending debit transaction amounts required: - iso_currency_code - current - available DepositoryAccountSubtype: type: string description: Valid account subtypes for depository accounts. For a list containing descriptions of each subtype, see [Account schemas](https://plaid.com/docs/api/accounts/#StandaloneAccountType-depository). enum: - checking - savings - hsa - cd - money market - paypal - prepaid - cash management - ebt - all WebhookVerificationKeyGetRequest: type: object description: WebhookVerificationKeyGetRequest defines the request schema for `/webhook_verification_key/get` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' key_id: type: string description: The key ID ( `kid` ) from the JWT header. required: - key_id SelfieAnalysis: type: object description: High level descriptions of how the associated selfie was processed. If a selfie fails verification, the details in the `analysis` object should help clarify why the selfie was rejected. properties: document_comparison: $ref: '#/components/schemas/SelfieAnalysisDocumentComparison' required: - document_comparison additionalProperties: true CreditDocumentType: title: CreditDocumentType type: - string - 'null' description: 'The type of document. `PAYSTUB`: A paystub. `BANK_STATEMENT`: A bank statement. `US_TAX_W2`: A W-2 wage and tax statement provided by a US employer reflecting wages earned by the employee. `US_MILITARY_ERAS`: An electronic Retirement Account Statement (eRAS) issued by the US military. `US_MILITARY_LES`: A Leave and Earnings Statement (LES) issued by the US military. `US_MILITARY_CLES`: A Civilian Leave and Earnings Statment (CLES) issued by the US military. `GIG`: Used to indicate that the income is related to gig work. Does not necessarily correspond to a specific document type. `PLAID_GENERATED_PAYSTUB_PDF`: Used to indicate that the PDF for the paystub was generated by Plaid. `NONE`: Used to indicate that there is no underlying document for the data. `UNKNOWN`: Document type could not be determined.' x-override-enum-values-shown: - UNKNOWN - PAYSTUB - BANK_STATEMENT - US_TAX_W2 - US_MILITARY_ERAS - US_MILITARY_LES - US_MILITARY_CLES - GIG - PLAID_GENERATED_PAYSTUB_PDF - NONE TransferGetResponse: title: TransferGetResponse type: object additionalProperties: true description: Defines the response schema for `/transfer/get` properties: transfer: $ref: '#/components/schemas/Transfer' request_id: $ref: '#/components/schemas/RequestID' required: - transfer - request_id EmailAddressNullable: type: - string - 'null' format: email example: user@example.com title: EmailAddress description: A valid email address. HostedLinkIsMobileApp: type: boolean default: false description: 'This indicates whether the client is opening hosted Link in a mobile app in an out of process web view (OOPWV) (i.e., an `AsWebAuthenticationSession` / `SFSafariViewController` or Android Custom Tab). ' DepositoryFilter: title: DepositoryFilter description: A filter to apply to `depository`-type accounts type: object additionalProperties: true properties: account_subtypes: $ref: '#/components/schemas/DepositoryAccountSubtypes' required: - account_subtypes SandboxTransferSimulateResponse: title: SandboxTransferSimulateResponse type: object additionalProperties: true description: Defines the response schema for `/sandbox/transfer/simulate` properties: request_id: $ref: '#/components/schemas/RequestID' required: - request_id TransactionsRefreshResponse: type: object additionalProperties: true description: TransactionsRefreshResponse defines the response schema for `/transactions/refresh` properties: request_id: $ref: '#/components/schemas/RequestID' required: - request_id RiskCheckIdentityAbuseSignals: type: - object - 'null' description: Result summary object capturing abuse signals related to `identity abuse`, e.g. stolen and synthetic identity fraud. These attributes are only available for US identities and some signals may not be available depending on what information was collected. properties: synthetic_identity: $ref: '#/components/schemas/RiskCheckSyntheticIdentity' stolen_identity: $ref: '#/components/schemas/RiskCheckStolenIdentity' required: - synthetic_identity - stolen_identity additionalProperties: true EmailAddress: type: string format: email example: user@example.com title: EmailAddress description: A valid email address. Institution: title: Institution type: object additionalProperties: true description: Details relating to a specific financial institution properties: institution_id: type: string description: Unique identifier for the institution. Note that the same institution may have multiple records, each with different institution IDs; for example, if the institution has migrated to OAuth, there may be separate `institution_id`s for the OAuth and non-OAuth versions of the institution. Institutions that operate in different countries or with multiple login portals may also have separate `institution_id`s for each country or portal. name: type: string description: The official name of the institution. products: type: array description: A list of the Plaid products supported by the institution. Note that only institutions that support Instant Auth will return `auth` in the product array; institutions that do not list `auth` may still support other Auth methods such as Instant Match or Automated Micro-deposit Verification. To identify institutions that support those methods, use the `auth_metadata` object. For more details, see [Full Auth coverage](https://plaid.com/docs/auth/coverage/). The `income_verification` product here indicates support for Bank Income. items: $ref: '#/components/schemas/Products' country_codes: type: array description: A list of the country codes supported by the institution. items: $ref: '#/components/schemas/CountryCode' url: type: - string - 'null' description: The URL for the institution's website primary_color: type: - string - 'null' description: Hexadecimal representation of the primary color used by the institution logo: type: - string - 'null' description: Base64 encoded representation of the institution's logo, returned as a base64 encoded 152x152 PNG. Not all institutions' logos are available. routing_numbers: type: array description: A list of routing numbers known to be associated with the institution. This list is provided for the purpose of looking up institutions by routing number. It is generally comprehensive but is not guaranteed to be a complete list of routing numbers for an institution. items: type: string dtc_numbers: type: array description: A partial list of DTC numbers associated with the institution. items: type: string oauth: type: boolean description: Indicates that the institution has an OAuth login flow. This will be `true` if OAuth is supported for any Items associated with the institution, even if the institution also supports non-OAuth connections. status: $ref: '#/components/schemas/InstitutionStatus' payment_initiation_metadata: $ref: '#/components/schemas/PaymentInitiationMetadata' auth_metadata: $ref: '#/components/schemas/AuthMetadata' required: - institution_id - name - products - country_codes - routing_numbers - oauth GenericCountryCode: type: string title: GenericCountryCode minLength: 2 example: US description: Valid, capitalized, two-letter ISO code representing the country of this object. Must be in ISO 3166-1 alpha-2 form. InstitutionStatus: title: InstitutionStatus type: - object - 'null' additionalProperties: true properties: item_logins: $ref: '#/components/schemas/ProductStatus' transactions_updates: $ref: '#/components/schemas/ProductStatus' auth: $ref: '#/components/schemas/ProductStatus' identity: $ref: '#/components/schemas/ProductStatus' investments_updates: $ref: '#/components/schemas/ProductStatus' liabilities_updates: $ref: '#/components/schemas/ProductStatus' liabilities: $ref: '#/components/schemas/ProductStatus' investments: $ref: '#/components/schemas/ProductStatus' health_incidents: type: - array - 'null' description: Details of recent health incidents associated with the institution. items: $ref: '#/components/schemas/HealthIncident' description: 'The status of an institution is determined by the health of its Item logins, Transactions updates, Investments updates, Liabilities updates, Auth requests, Balance requests, Identity requests, Investments requests, and Liabilities requests. A login attempt is conducted during the initial Item add in Link. If there is not enough traffic to accurately calculate an institution''s status, Plaid will return null rather than potentially inaccurate data. Institution status is accessible in the Dashboard and via the API using the `/institutions/get_by_id` endpoint with the `include_status` option set to true. Note that institution status is not available in the Sandbox environment. ' x-examples: example-1: status: item_logins: status: HEALTHY last_status_change: '2019-02-15T15:53:00Z' breakdown: success: 0.9 error_plaid: 0.01 error_institution: 0.09 transactions_updates: status: HEALTHY last_status_change: '2019-02-12T08:22:00Z' breakdown: success: 0.95 error_plaid: 0.02 error_institution: 0.03 refresh_interval: NORMAL auth: status: HEALTHY last_status_change: '2019-02-15T15:53:00Z' breakdown: success: 0.91 error_plaid: 0.01 error_institution: 0.08 identity: status: DEGRADED last_status_change: '2019-02-15T15:50:00Z' breakdown: success: 0.42 error_plaid: 0.08 error_institution: 0.5 investments: status: HEALTHY last_status_change: '2019-02-15T15:53:00Z' breakdown: success: 0.89 error_plaid: 0.02 error_institution: 0.09 liabilities: status: HEALTHY last_status_change: '2019-02-15T15:53:00Z' breakdown: success: 0.89 error_plaid: 0.02 error_institution: 0.09 investments_updates: status: HEALTHY last_status_change: '2019-02-12T08:22:00Z' breakdown: success: 0.95 error_plaid: 0.02 error_institution: 0.03 refresh_interval: NORMAL liabilities_updates: status: HEALTHY last_status_change: '2019-02-12T08:22:00Z' breakdown: success: 0.95 error_plaid: 0.02 error_institution: 0.03 refresh_interval: NORMAL PaymentConsentPeriodicAmount: type: object title: PaymentConsentPeriodicAmount description: Defines consent payments limitations per period. properties: amount: $ref: '#/components/schemas/PaymentConsentPeriodicAmountAmount' interval: $ref: '#/components/schemas/PaymentConsentPeriodicInterval' alignment: $ref: '#/components/schemas/PaymentConsentPeriodicAlignment' required: - amount - interval - alignment CreditBankIncome: type: object description: The report of the Bank Income data for an end user. properties: bank_income_id: type: string description: The unique identifier associated with the Bank Income Report. generated_time: type: string description: The time when the Bank Income Report was generated. format: date-time days_requested: type: integer description: The number of days requested by the customer for the Bank Income Report. items: type: array description: The list of Items in the report along with the associated metadata about the Item. items: $ref: '#/components/schemas/CreditBankIncomeItem' bank_income_summary: $ref: '#/components/schemas/CreditBankIncomeSummary' warnings: type: array description: If data from the Bank Income report was unable to be retrieved, the warnings will contain information about the error that caused the data to be incomplete. items: $ref: '#/components/schemas/CreditBankIncomeWarning' UserCreateResponse: type: object additionalProperties: true description: UserCreateResponse defines the response schema for `/user/create` properties: user_token: $ref: '#/components/schemas/UserToken' user_id: $ref: '#/components/schemas/UserId' request_id: $ref: '#/components/schemas/RequestID' required: - user_token - user_id - request_id TransferIntentGet: title: TransferIntentGet type: object additionalProperties: true description: Represents a transfer intent within Transfer UI. properties: id: type: string description: Plaid's unique identifier for a transfer intent object. created: type: string format: date-time description: The datetime the transfer was created. This will be of the form `2006-01-02T15:04:05Z`. status: $ref: '#/components/schemas/TransferIntentStatus' transfer_id: type: - string - 'null' description: Plaid's unique identifier for the transfer created through the UI. Returned only if the transfer was successfully created. Null value otherwise. failure_reason: $ref: '#/components/schemas/TransferIntentGetFailureReason' authorization_decision: $ref: '#/components/schemas/TransferIntentAuthorizationDecision' authorization_decision_rationale: $ref: '#/components/schemas/TransferAuthorizationDecisionRationale' account_id: type: - string - 'null' description: The Plaid `account_id` for the account that will be debited or credited. Returned only if `account_id` was set on intent creation. origination_account_id: type: string description: Plaid’s unique identifier for the origination account used for the transfer. deprecated: true x-hidden-from-docs: true funding_account_id: $ref: '#/components/schemas/TransferFundingAccountIDResponse' amount: $ref: '#/components/schemas/TransferAmount' mode: $ref: '#/components/schemas/TransferIntentCreateMode' network: $ref: '#/components/schemas/TransferIntentCreateNetwork' ach_class: $ref: '#/components/schemas/ACHClass' user: $ref: '#/components/schemas/TransferUserInResponse' description: type: string description: A description for the underlying transfer. Maximum of 8 characters. metadata: $ref: '#/components/schemas/TransferMetadata' iso_currency_code: type: string description: The currency of the transfer amount, e.g. "USD" require_guarantee: type: - boolean - 'null' x-hidden-from-docs: true description: When `true`, the transfer requires a `GUARANTEED` decision by Plaid to proceed (Guarantee customers only). guarantee_decision: $ref: '#/components/schemas/TransferAuthorizationGuaranteeDecision' guarantee_decision_rationale: $ref: '#/components/schemas/TransferAuthorizationGuaranteeDecisionRationale' required: - id - created - status - transfer_id - failure_reason - authorization_decision - authorization_decision_rationale - origination_account_id - funding_account_id - amount - mode - user - description - iso_currency_code - guarantee_decision - guarantee_decision_rationale ItemImportRequest: type: object description: ItemImportRequest defines the request schema for `/item/import` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' products: type: array description: Array of product strings items: $ref: '#/components/schemas/Products' minItems: 1 x-override-enum-values-shown: - assets - auth - balance - employment - identity - income_verification - investments - liabilities - payment_initiation - standing_orders - transactions - transfer user_auth: $ref: '#/components/schemas/ItemImportRequestUserAuth' options: $ref: '#/components/schemas/ItemImportRequestOptions' required: - products - user_auth AssetReportItem: title: AssetReportItem type: object additionalProperties: true description: A representation of an Item within an Asset Report. properties: item_id: $ref: '#/components/schemas/ItemId' institution_name: type: string description: The full financial institution name associated with the Item. institution_id: description: The id of the financial institution associated with the Item. type: string date_last_updated: type: string format: date-time description: The date and time when this Item’s data was last retrieved from the financial institution, in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format. accounts: type: array description: Data about each of the accounts open on the Item. items: $ref: '#/components/schemas/AccountAssets' required: - item_id - institution_name - institution_id - date_last_updated - accounts PartnerEndCustomerAssetsUnderManagement: description: Assets under management for the given end customer. Required for end customers with monthly service commitments. type: object additionalProperties: true properties: amount: type: number format: double iso_currency_code: type: string required: - amount - iso_currency_code InvestmentsAuthGetRequest: type: object x-hidden-from-docs: true description: InvestmentsAuthGetRequest defines the request schema for `/investments/auth/get` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' access_token: $ref: '#/components/schemas/AccessToken' options: $ref: '#/components/schemas/InvestmentsAuthGetRequestOptions' required: - access_token Cursor: description: An identifier that determines which page of results you receive. type: - string - 'null' example: eyJkaXJlY3Rpb24iOiJuZXh0Iiwib2Zmc2V0IjoiMTU5NDM IdentityVerificationRetryRequest: type: object description: Request input for retrying an identity verification attempt properties: client_user_id: $ref: '#/components/schemas/ClientUserID' template_id: $ref: '#/components/schemas/IdentityVerificationTemplateID' strategy: $ref: '#/components/schemas/Strategy' user: $ref: '#/components/schemas/IdentityVerificationRequestUser' steps: $ref: '#/components/schemas/IdentityVerificationRetryRequestStepsObject' client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' required: - client_user_id - strategy - template_id SignalEvaluateResponse: title: SignalEvaluateResponse description: SignalEvaluateResponse defines the response schema for `/signal/income/evaluate` type: object additionalProperties: true properties: request_id: $ref: '#/components/schemas/RequestID' scores: $ref: '#/components/schemas/SignalScores' core_attributes: $ref: '#/components/schemas/SignalEvaluateCoreAttributes' risk_profile: $ref: '#/components/schemas/RiskProfile' warnings: type: array description: If bank information was not available to be used in the Signal model, this array contains warnings describing why bank data is missing. If you want to receive an API error instead of Signal scores in the case of missing bank data, file a support ticket or contact your Plaid account manager. items: $ref: '#/components/schemas/SignalWarning' required: - request_id - scores - warnings WatchlistScreeningEntityProgramListResponse: description: Paginated list of entity watchlist screening programs additionalProperties: true properties: entity_watchlist_programs: description: List of entity watchlist screening programs type: array items: $ref: '#/components/schemas/EntityWatchlistProgram' next_cursor: $ref: '#/components/schemas/Cursor' request_id: $ref: '#/components/schemas/RequestID' required: - entity_watchlist_programs - next_cursor - request_id type: object BankTransferType: type: string title: BankTransferType description: The type of bank transfer. This will be either `debit` or `credit`. A `debit` indicates a transfer of money into the origination account; a `credit` indicates a transfer of money out of the origination account. enum: - debit - credit TransferMetadata: type: - object - 'null' additionalProperties: type: string title: TransferMetadata maxProperties: 50 description: 'The Metadata object is a mapping of client-provided string fields to any string value. The following limitations apply: The JSON values must be Strings (no nested JSON objects allowed) Only ASCII characters may be used Maximum of 50 key/value pairs Maximum key length of 40 characters Maximum value length of 500 characters ' IncomeVerificationPrecheckEmployerAddressData: title: AddressData type: object additionalProperties: true description: Data about the components comprising an address. properties: city: type: string description: The full city name country: type: string description: The ISO 3166-1 alpha-2 country code postal_code: type: string description: The postal code. In API versions 2018-05-22 and earlier, this field is called `zip`. region: type: string description: 'The region or state. In API versions 2018-05-22 and earlier, this field is called `state`. Example: `"NC"`' street: type: string description: 'The full street address Example: `"564 Main Street, APT 15"`' TransferRecurringCreateRequest: title: TransferRecurringCreateRequest type: object description: Defines the request schema for `/transfer/recurring/create` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' access_token: $ref: '#/components/schemas/TransferAccessToken' idempotency_key: $ref: '#/components/schemas/TransferRecurringIdempotencyKey' account_id: $ref: '#/components/schemas/TransferAccountID' funding_account_id: type: - string - 'null' description: Specify the account used to fund the transfer. Customers can find a list of `funding_account_id`s in the Accounts page of your Plaid Dashboard, under the "Account ID" column. If this field is left blank, it will default to the default `funding_account_id` specified during onboarding. deprecated: true x-hidden-from-docs: true type: $ref: '#/components/schemas/TransferType' network: $ref: '#/components/schemas/TransferRecurringNetwork' ach_class: $ref: '#/components/schemas/ACHClass' amount: $ref: '#/components/schemas/TransferAmount' user_present: type: - boolean - 'null' description: If the end user is initiating the specific transfer themselves via an interactive UI, this should be `true`; for automatic recurring payments where the end user is not actually initiating each individual transfer, it should be `false`. iso_currency_code: type: string x-hidden-from-docs: true deprecated: true description: The currency of the transfer amount. The default value is "USD". description: type: string description: The description of the recurring transfer. test_clock_id: type: - string - 'null' description: Plaid’s unique identifier for a test clock. This field may only be used when using `sandbox` environment. If provided, the created `recurring_transfer` is associated with the `test_clock`. New originations are automatically generated when the associated `test_clock` advances. schedule: $ref: '#/components/schemas/TransferRecurringSchedule' user: $ref: '#/components/schemas/TransferUserInRequest' device: $ref: '#/components/schemas/TransferDevice' required: - access_token - idempotency_key - account_id - type - network - amount - user - schedule - description CreditFreddieMacAsset: title: CreditFreddieMacAsset type: object additionalProperties: true description: Documentation not found in the MISMO model viewer and not provided by Freddie Mac. properties: ASSET_DETAIL: $ref: '#/components/schemas/AssetDetail' ASSET_OWNERS: $ref: '#/components/schemas/AssetOwners' ASSET_HOLDER: $ref: '#/components/schemas/AssetHolder' ASSET_TRANSACTIONS: $ref: '#/components/schemas/CreditFreddieMacAssetTransactions' VALIDATION_SOURCES: $ref: '#/components/schemas/ValidationSources' required: - ASSET_DETAIL - ASSET_OWNERS - ASSET_HOLDER - ASSET_TRANSACTIONS - VALIDATION_SOURCES IdentityVerificationDocumentCountryCode: type: string title: IdentityVerificationDocumentCountryCode minLength: 2 example: US description: Valid, capitalized, two-letter ISO code representing the country extracted from the document. Must be in ISO 3166-1 alpha-2 form. CreditBankIncomeItem: type: object description: The details and metadata for an end user's Item. properties: bank_income_accounts: type: array description: The Item's accounts that have Bank Income data. items: $ref: '#/components/schemas/CreditBankIncomeAccount' bank_income_sources: type: array description: The income sources for this Item. Each entry in the array is a single income source. items: $ref: '#/components/schemas/CreditBankIncomeSource' last_updated_time: type: string description: The time when this Item's data was last retrieved from the financial institution. format: date-time institution_id: type: string description: The unique identifier of the institution associated with the Item. institution_name: type: string description: The name of the institution associated with the Item. item_id: type: string description: The unique identifier for the Item. BeaconReportSyndicationOriginalReport: type: object title: BeaconReportSyndicationOriginalReport description: 'A subset of information from a Beacon Report that has been syndicated to a matching Beacon User in your program. The `id` field in the response is the ID of the original report that was syndicated. If the original report was created by your organization, the field will be filled with the ID of the report. Otherwise, the field will be `null` indicating that the original report was created by another Beacon customer.' properties: id: $ref: '#/components/schemas/BeaconReportIDNullable' created_at: $ref: '#/components/schemas/Timestamp' type: $ref: '#/components/schemas/BeaconReportType' fraud_date: $ref: '#/components/schemas/ISO8601Date' required: - id - created_at - type - fraud_date additionalProperties: true LinkTokenGetSessionsResponse: type: object description: An object containing information about a link session. Session data will be provided for up to six hours after the session has ended. additionalProperties: true properties: link_session_id: type: string description: The unique ID for the link session. started_at: type: string format: date-time description: The timestamp at which the link session was first started, in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format. finished_at: type: - string - 'null' format: date-time description: The timestamp at which the link session was finished, if available, in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format. on_success: $ref: '#/components/schemas/LinkSessionSuccess' on_exit: $ref: '#/components/schemas/LinkSessionExitDeprecated' exit: $ref: '#/components/schemas/LinkSessionExit' events: type: array description: List of customer-related Link events items: $ref: '#/components/schemas/LinkEvent' results: $ref: '#/components/schemas/LinkSessionResults' required: - link_session_id TransferScheduleIntervalUnit: type: string title: TransferScheduleIntervalUnit enum: - week - month description: The unit of the recurring interval. minLength: 1 CraBankIncomeWarning: type: object description: The warning associated with the data that was unavailable for the Bank Income Report. properties: warning_type: $ref: '#/components/schemas/CreditBankIncomeWarningType' warning_code: $ref: '#/components/schemas/CraBankIncomeWarningCode' cause: $ref: '#/components/schemas/CraBankIncomeCause' BankTransferMigrateAccountRequest: title: BankTransferMigrateAccountRequest type: object description: Defines the request schema for `/bank_transfer/migrate_account` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' account_number: type: string description: The user's account number. routing_number: type: string description: The user's routing number. wire_routing_number: type: string description: The user's wire transfer routing number. This is the ABA number; for some institutions, this may differ from the ACH number used in `routing_number`. account_type: type: string description: The type of the bank account (`checking` or `savings`). required: - account_number - routing_number - account_type PrismCashScoreMetadata: type: object additionalProperties: true description: An object containing metadata about the provided transactions. properties: max_age: type: - integer - 'null' description: Number of days since the oldest transaction. min_age: type: - integer - 'null' description: Number of days since the latest transaction. min_age_credit: type: - integer - 'null' description: Number of days since the latest credit transaction. min_age_debit: type: - integer - 'null' description: Number of days since the latest debit transaction. max_age_debit: type: - integer - 'null' description: Number of days since the oldest debit transaction. max_age_credit: type: - integer - 'null' description: Number of days since the oldest credit transaction. num_trxn_credit: type: - integer - 'null' description: Number of credit transactions. num_trxn_debit: type: - integer - 'null' description: Number of debit transactions. l1m_credit_value_cnt: type: - integer - 'null' description: Number of credit transactions in the last 30 days. l1m_debit_value_cnt: type: - integer - 'null' description: Number of debit transactions in the last 30 days. required: - max_age - min_age - min_age_credit - min_age_debit - max_age_debit - max_age_credit - num_trxn_credit - num_trxn_debit - l1m_credit_value_cnt - l1m_debit_value_cnt Paystub: title: Paystub type: object additionalProperties: true description: An object representing data extracted from the end user's paystub. properties: deductions: $ref: '#/components/schemas/Deductions' doc_id: type: string description: An identifier of the document referenced by the document metadata. earnings: $ref: '#/components/schemas/Earnings' employee: $ref: '#/components/schemas/Employee' employer: $ref: '#/components/schemas/PaystubEmployer' employment_details: $ref: '#/components/schemas/EmploymentDetails' net_pay: $ref: '#/components/schemas/NetPay' pay_period_details: $ref: '#/components/schemas/PayPeriodDetails' paystub_details: $ref: '#/components/schemas/PaystubDetails' income_breakdown: type: array deprecated: true items: $ref: '#/components/schemas/IncomeBreakdown' ytd_earnings: $ref: '#/components/schemas/PaystubYTDDetails' required: - deductions - doc_id - earnings - employee - employer - net_pay - pay_period_details TransferUserAddressInResponse: title: TransferUserAddressInResponse type: - object - 'null' additionalProperties: true description: The address associated with the account holder. properties: street: type: - string - 'null' description: The street number and name (i.e., "100 Market St."). city: type: - string - 'null' description: Ex. "San Francisco" region: type: - string - 'null' description: The state or province (e.g., "CA"). postal_code: type: - string - 'null' description: The postal code (e.g., "94103"). country: type: - string - 'null' description: A two-letter country code (e.g., "US"). required: - street - city - region - postal_code - country ValidationSource: title: ValidationSource type: object additionalProperties: true description: Documentation not found in the MISMO model viewer and not provided by Freddie Mac. properties: ValidationSourceName: type: - string - 'null' description: Documentation not found in the MISMO model viewer and not provided by Freddie Mac. ValidationSourceReferenceIdentifier: type: - string - 'null' description: Documentation not found in the MISMO model viewer and not provided by Freddie Mac. required: - ValidationSourceName - ValidationSourceReferenceIdentifier CreditBankIncomePayFrequency: type: string description: The income pay frequency. enum: - WEEKLY - BIWEEKLY - SEMI_MONTHLY - MONTHLY - DAILY - UNKNOWN LinkSessionSuccessMetadataAccount: type: object description: An account attached to the connected Item. properties: id: type: string description: 'The Plaid `account_id` ' name: type: string description: The official account name mask: type: - string - 'null' description: The last 2-4 alphanumeric characters of an account's official account number. Note that the mask may be non-unique between an Item's accounts. It may also not match the mask that the bank displays to the user. type: type: string description: The account type. See the [Account schema](/docs/api/accounts#account-type-schema) for a full list of possible values subtype: type: string description: The account subtype. See the [Account schema](/docs/api/accounts#account-type-schema) for a full list of possible values verification_status: type: - string - 'null' description: 'Indicates an Item''s micro-deposit-based verification or database verification status. Possible values are: `pending_automatic_verification`: The Item is pending automatic verification `pending_manual_verification`: The Item is pending manual micro-deposit verification. Items remain in this state until the user successfully verifies the code. `automatically_verified`: The Item has successfully been automatically verified `manually_verified`: The Item has successfully been manually verified `verification_expired`: Plaid was unable to automatically verify the deposit within 7 calendar days and will no longer attempt to validate the Item. Users may retry by submitting their information again through Link. `verification_failed`: The Item failed manual micro-deposit verification because the user exhausted all 3 verification attempts. Users may retry by submitting their information again through Link. `database_matched`: The Item has successfully been verified using Plaid''s data sources. `database_insights_pending`: The Database Insights result is pending and will be available upon Auth request. Note: Database Insights is currently a beta feature, please contact your account manager for more information. `null`: Neither micro-deposit-based verification nor database verification are being used for the Item. ' class_type: type: - string - 'null' description: If micro-deposit verification is being used, indicates whether the account being verified is a `business` or `personal` account. CreditBankIncomeGetRequest: title: CreditBankIncomeGetRequest type: object description: CreditBankIncomeGetRequest defines the request schema for `/credit/bank_income/get`. properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' user_token: $ref: '#/components/schemas/UserToken' options: $ref: '#/components/schemas/CreditBankIncomeGetRequestOptions' WalletTransactionListRequestOptions: type: - object - 'null' description: Additional wallet transaction options properties: start_time: type: string description: Timestamp in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format (YYYY-MM-DDThh:mm:ssZ) for filtering transactions, inclusive of the provided date. format: date-time end_time: type: string description: Timestamp in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format (YYYY-MM-DDThh:mm:ssZ) for filtering transactions, inclusive of the provided date. format: date-time Credit1099Recipient: title: Credit1099Recipient type: object additionalProperties: true description: An object representing a recipient used in both 1099-K and 1099-MISC tax documents. properties: address: $ref: '#/components/schemas/CreditPayStubAddress' name: type: - string - 'null' description: Name of recipient. tin: type: - string - 'null' description: Tax identification number of recipient. account_number: type: - string - 'null' description: Account number number of recipient. facta_filing_requirement: type: - string - 'null' description: Checked if FACTA is a filing requirement. x-override-enum-values-shown: - CHECKED - NOT CHECKED second_tin_exists: type: - string - 'null' description: Checked if 2nd TIN exists. x-override-enum-values-shown: - CHECKED - NOT CHECKED IdentityDocumentsUploadsGetRequest: title: IdentityDocumentsUploadsGetRequest description: IdentityDocumentsUploadsGetRequest defines the request schema for `/identity/documents/uploads/get` x-hidden-from-docs: true properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' access_token: $ref: '#/components/schemas/AccessToken' options: $ref: '#/components/schemas/IdentityDocumentsUploadsGetRequestOptions' required: - access_token AssetReportPDFGetRequestOptions: type: object description: An optional object to filter or add data to `/asset_report/get` results. If provided, must be non-`null`. properties: days_to_include: type: - integer - 'null' maximum: 731 minimum: 0 description: The maximum integer number of days of history to include in the Asset Report. Region: type: - string - 'null' example: IN title: Region description: An ISO 3166-2 subdivision code. Related terms would be "state", "province", "prefecture", "zone", "subdivision", etc. PrismProduct: title: PrismProduct x-hidden-from-docs: true enum: - detect - scores description: The prism products that can be returned by the Plaid API type: string BankTransferIdempotencyKey: title: BankTransferIdempotencyKey type: string maxLength: 50 description: 'A random key provided by the client, per unique bank transfer. Maximum of 50 characters. The API supports idempotency for safely retrying requests without accidentally performing the same operation twice. For example, if a request to create a bank transfer fails due to a network connection error, you can retry the request with the same idempotency key to guarantee that only a single bank transfer is created.' ItemStatus: description: An object with information about the status of the Item. type: - object - 'null' additionalProperties: true x-examples: example-1: {} title: ItemStatus properties: investments: $ref: '#/components/schemas/ItemStatusInvestments' transactions: $ref: '#/components/schemas/ItemStatusTransactions' last_webhook: $ref: '#/components/schemas/ItemStatusLastWebhook' LinkTokenCreateRequestIncomeVerification: title: LinkTokenCreateRequestIncomeVerification type: object description: Specifies options for initializing Link for use with the Income product. This field is required if `income_verification` is included in the `products` array. properties: income_verification_id: type: string deprecated: true description: The `income_verification_id` of the verification instance, as provided by `/income/verification/create`. asset_report_id: type: string description: The `asset_report_id` of an asset report associated with the user, as provided by `/asset_report/create`. Providing an `asset_report_id` is optional and can be used to verify the user through a streamlined flow. If provided, the bank linking flow will be skipped. access_tokens: type: - array - 'null' items: $ref: '#/components/schemas/AccessToken' description: 'An array of access tokens corresponding to Items that a user has previously connected with. Data from these institutions will be cross-referenced with document data received during the Document Income flow to help verify that the uploaded documents are accurate. If the `transactions` product was not initialized for these Items during link, it will be initialized after this Link session. This field should only be used with the `payroll` income source type.' income_source_types: type: array description: The types of source income data that users will be permitted to share. Options include `bank` and `payroll`. Currently you can only specify one of these options. items: $ref: '#/components/schemas/IncomeVerificationSourceType' bank_income: $ref: '#/components/schemas/LinkTokenCreateRequestIncomeVerificationBankIncome' payroll_income: $ref: '#/components/schemas/LinkTokenCreateRequestIncomeVerificationPayrollIncome' stated_income_sources: type: array description: A list of user stated income sources items: $ref: '#/components/schemas/LinkTokenCreateRequestUserStatedIncomeSource' SandboxTransferTestClockGetResponse: title: SandboxTransferTestClockGetResponse type: object additionalProperties: true description: Defines the response schema for `/sandbox/transfer/test_clock/get` properties: test_clock: $ref: '#/components/schemas/TransferTestClock' request_id: $ref: '#/components/schemas/RequestID' required: - test_clock - request_id ShareableURL: type: - string - 'null' example: https://flow.plaid.com/verify/idv_4FrXJvfQU3zGUR?key=e004115db797f7cc3083bff3167cba30644ef630fb46f5b086cde6cc3b86a36f description: A shareable URL that can be sent directly to the user to complete verification CraLoanUnregister: type: object description: Contains loan data for the loan being unregistered. additionalProperties: true properties: loan_id: $ref: '#/components/schemas/CraLoanID' closed_with_status: $ref: '#/components/schemas/CraLoanClosedStatus' required: - loan_id - closed_with_status ProfileItem: description: ProfileItem defines an Item created during a profile authorization session. type: object additionalProperties: true x-hidden-from-docs: true properties: item_id: description: 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. type: string access_token: $ref: '#/components/schemas/AccessToken' StatementsListResponse: title: StatementsListResponse type: object additionalProperties: true description: StatementsListResponse defines the response schema for `/statements/list` properties: accounts: type: array items: $ref: '#/components/schemas/StatementsAccount' institution_id: description: The Plaid Institution ID associated with the Item. type: string institution_name: description: The name of the institution associated with the Item. type: string item_id: description: 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. type: string request_id: $ref: '#/components/schemas/RequestID' required: - accounts - institution_id - institution_name - item_id - request_id ProcessorNumber: type: object additionalProperties: true description: An object containing identifying numbers used for making electronic transfers to and from the `account`. The identifying number type (ACH, EFT, IBAN, or BACS) used will depend on the country of the account. An account may have more than one number type. If a particular identifying number type is not used by the `account` for which auth data has been requested, a null value will be returned. properties: ach: $ref: '#/components/schemas/NumbersACHNullable' eft: $ref: '#/components/schemas/NumbersEFTNullable' international: $ref: '#/components/schemas/NumbersInternationalNullable' bacs: $ref: '#/components/schemas/NumbersBACSNullable' IdentityVerificationDocumentCity: type: string example: Pawnee title: IdentityVerificationDocumentCity description: City extracted from the document. ExternalPaymentOptions: title: PaymentOptions description: Additional payment options type: - object - 'null' properties: request_refund_details: type: - boolean - 'null' description: When `true`, Plaid will attempt to request refund details from the payee's financial institution. Support varies between financial institutions and will not always be available. If refund details could be retrieved, they will be available in the `/payment_initiation/payment/get` response. iban: type: - string - 'null' minLength: 15 maxLength: 34 description: The International Bank Account Number (IBAN) for the payer's account. Where possible, the end user will be able to send payments only from the specified bank account if provided. bacs: $ref: '#/components/schemas/PaymentInitiationOptionalRestrictionBacs' scheme: $ref: '#/components/schemas/PaymentScheme' KYCCheckPhoneSummary: description: Result summary object specifying how the `phone` field matched. type: object properties: summary: $ref: '#/components/schemas/MatchSummaryCode' area_code: $ref: '#/components/schemas/MatchSummaryCode' required: - summary - area_code additionalProperties: true CreditRelayGetRequest: title: CreditRelayGetRequest type: object description: CreditRelayGetRequest defines the request schema for `/credit/relay/get` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' relay_token: type: string description: The `relay_token` granting access to the report you would like to get. report_type: $ref: '#/components/schemas/ReportType' include_insights: type: boolean default: false description: '`true` if you would like to retrieve the Asset Report with Insights, `false` otherwise. This field defaults to `false` if omitted.' required: - relay_token - report_type CreditFreddieMacPartyIndividual: title: CreditFreddieMacPartyIndividual type: object additionalProperties: true description: Documentation not found in the MISMO model viewer and not provided by Freddie Mac. properties: NAME: $ref: '#/components/schemas/CreditFreddieMacIndividualName' required: - NAME BaseReportLongestGapInsights: title: BaseReportLongestGapInsights description: Largest number of days between sequential transactions per calendar month x-hidden-from-docs: true type: object additionalProperties: true properties: start_date: type: string format: date description: 'The start date of this time period. The date will be returned in an ISO 8601 format (YYYY-MM-DD).' end_date: type: string format: date description: 'The end date of this time period. The date will be returned in an ISO 8601 format (YYYY-MM-DD).' days: type: integer description: Largest number of days between sequential transactions for this time period. DocumentImage__CroppedBack: type: - string - 'null' example: https://example.plaid.com/verifications/idv_52xR9LKo77r1Np/documents/1/cropped_back.jpeg description: Temporary URL that expires after 60 seconds for downloading a cropped image containing just the back of the document. Might be null if the back of the document was not collected. RoleDetail: title: RoleDetail type: object additionalProperties: true description: Documentation not found in the MISMO model viewer and not provided by Freddie Mac. properties: PartyRoleType: $ref: '#/components/schemas/PartyRoleType' required: - PartyRoleType WatchlistScreeningHit: type: object description: Data from a government watchlist or PEP list that has been attached to the screening. title: WatchlistScreeningHit properties: id: $ref: '#/components/schemas/WatchlistScreeningHitID' review_status: $ref: '#/components/schemas/WatchlistScreeningHitStatus' first_active: $ref: '#/components/schemas/Timestamp' inactive_since: $ref: '#/components/schemas/TimestampNullable' historical_since: $ref: '#/components/schemas/TimestampNullable' list_code: $ref: '#/components/schemas/IndividualWatchlistCode' plaid_uid: $ref: '#/components/schemas/InternalUID' source_uid: $ref: '#/components/schemas/SourceUID' analysis: $ref: '#/components/schemas/ScreeningHitAnalysis' data: $ref: '#/components/schemas/ScreeningHitData' required: - id - review_status - first_active - inactive_since - historical_since - list_code - plaid_uid - source_uid additionalProperties: true ProcessorSignalPrepareRequest: title: ProcessorSignalPrepareRequest description: ProcessorSignalPrepareRequest defines the request schema for `/processor/signal/prepare` type: object properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' processor_token: $ref: '#/components/schemas/ProcessorToken' required: - processor_token AssetReportCreateRequest: type: object description: AssetReportCreateRequest defines the request schema for `/asset_report/create` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' access_tokens: type: array description: An array of access tokens corresponding to the Items that will be included in the report. The `assets` product must have been initialized for the Items during link; the Assets product cannot be added after initialization. items: $ref: '#/components/schemas/AccessToken' minItems: 1 maxItems: 99 days_requested: type: integer maximum: 731 minimum: 0 description: 'The maximum integer number of days of history to include in the Asset Report. If using Fannie Mae Day 1 Certainty, `days_requested` must be at least 61 for new originations or at least 31 for refinancings. An Asset Report requested with "Additional History" (that is, with more than 61 days of transaction history) will incur an Additional History fee.' options: $ref: '#/components/schemas/AssetReportCreateRequestOptions' required: - days_requested InvestmentHoldingsGetRequestOptions: type: object description: An optional object to filter `/investments/holdings/get` results. If provided, must not be `null`. properties: account_ids: type: array description: An array of `account_id`s to retrieve for the Item. An error will be returned if a provided `account_id` is not associated with the Item. items: type: string AssetReportPDFGetRequest: type: object description: AssetReportPDFGetRequest defines the request schema for `/asset_report/pdf/get` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' asset_report_token: $ref: '#/components/schemas/AssetReportToken' options: $ref: '#/components/schemas/AssetReportPDFGetRequestOptions' required: - asset_report_token LedgerDistributeIdempotencyKey: title: LedgerDistributeIdempotencyKey type: string maxLength: 50 description: 'A unique key provided by the client, per unique ledger distribute. Maximum of 50 characters. The API supports idempotency for safely retrying the request without accidentally performing the same operation twice. For example, if a request to create a ledger distribute fails due to a network connection error, you can retry the request with the same idempotency key to guarantee that only a single distribute is created.' AccountSubtype: type: - string - 'null' title: AccountSubtype description: See the [Account type schema](https://plaid.com/docs/api/accounts/#account-type-schema) for a full listing of account types and corresponding subtypes. enum: - 401a - 401k - 403B - 457b - '529' - brokerage - cash isa - crypto exchange - education savings account - ebt - fixed annuity - gic - health reimbursement arrangement - hsa - isa - ira - lif - life insurance - lira - lrif - lrsp - non-custodial wallet - non-taxable brokerage account - other - other insurance - other annuity - prif - rdsp - resp - rlif - rrif - pension - profit sharing plan - retirement - roth - roth 401k - rrsp - sep ira - simple ira - sipp - stock plan - thrift savings plan - tfsa - trust - ugma - utma - variable annuity - credit card - paypal - cd - checking - savings - money market - prepaid - auto - business - commercial - construction - consumer - home equity - loan - mortgage - overdraft - line of credit - student - cash management - keogh - mutual fund - recurring - rewards - safe deposit - sarsep - payroll - null RiskCheckBehaviorFraudRingDetectedLabel: description: 'Field describing the outcome of a fraud ring behavior risk check. `yes` indicates that fraud ring activity was detected. `no` indicates that fraud ring activity was not detected. `no_data` indicates there was not enough information available to give an accurate signal.' type: string enum: - 'yes' - 'no' - no_data IdentityDocumentUploadRiskInsights: title: IdentityDocumentUploadRiskInsights type: object additionalProperties: true description: In closed beta. Object representing fraud risk data of the document properties: risk_summary: $ref: '#/components/schemas/IdentityDocumentUploadRiskSummary' risk_signals: title: RiskSignals type: array description: an array of risk signals items: $ref: '#/components/schemas/IdentityDocumentUploadRiskSignal' DepositSwitchGetRequest: title: DepositSwitchGetRequest description: DepositSwitchGetRequest defines the request schema for `/deposit_switch/get` type: object x-examples: {} properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' deposit_switch_id: type: string description: The ID of the deposit switch required: - deposit_switch_id RecurringTransactionFrequency: type: string description: 'Describes the frequency of the transaction stream. `WEEKLY`: Assigned to a transaction stream that occurs approximately every week. `BIWEEKLY`: Assigned to a transaction stream that occurs approximately every 2 weeks. `SEMI_MONTHLY`: Assigned to a transaction stream that occurs approximately twice per month. This frequency is typically seen for inflow transaction streams. `MONTHLY`: Assigned to a transaction stream that occurs approximately every month. `ANNUALLY`: Assigned to a transaction stream that occurs approximately every year. `UNKNOWN`: Assigned to a transaction stream that does not fit any of the pre-defined frequencies.' title: RecurringTransactionFrequency enum: - UNKNOWN - WEEKLY - BIWEEKLY - SEMI_MONTHLY - MONTHLY - ANNUALLY ScreeningHitData: description: Information associated with the watchlist hit type: object properties: dates_of_birth: description: Dates of birth associated with the watchlist hit type: array items: $ref: '#/components/schemas/ScreeningHitDateOfBirthItem' documents: description: Documents associated with the watchlist hit type: array items: $ref: '#/components/schemas/ScreeningHitDocumentsItems' locations: description: Locations associated with the watchlist hit type: array items: $ref: '#/components/schemas/GenericScreeningHitLocationItems' names: description: Names associated with the watchlist hit type: array items: $ref: '#/components/schemas/ScreeningHitNamesItems' additionalProperties: true ScreeningHitAnalysis: description: Analysis information describing why a screening hit matched the provided user information type: object properties: dates_of_birth: $ref: '#/components/schemas/MatchSummaryCode' documents: $ref: '#/components/schemas/MatchSummaryCode' locations: $ref: '#/components/schemas/MatchSummaryCode' names: $ref: '#/components/schemas/MatchSummaryCode' search_terms_version: type: integer description: The version of the screening's `search_terms` that were compared when the screening hit was added. screening hits are immutable once they have been reviewed. If changes are detected due to updates to the screening's `search_terms`, the associated program, or the list's source data prior to review, the screening hit will be updated to reflect those changes. example: 1 required: - search_terms_version additionalProperties: true TransferListResponse: title: TransferListResponse type: object additionalProperties: true description: Defines the response schema for `/transfer/list` properties: transfers: type: array items: $ref: '#/components/schemas/Transfer' request_id: $ref: '#/components/schemas/RequestID' required: - transfers - request_id LinkTokenCreateRequestEmployment: title: LinkTokenCreateRequestEmployment type: object x-hidden-from-docs: true description: Specifies options for initializing Link for use with the Employment product. This field is required if `employment` is included in the `products` array. properties: employment_source_types: type: array description: The types of source employment data that users will be permitted to share. Options include `bank` and `payroll`. Currently you can only specify one of these options. items: $ref: '#/components/schemas/EmploymentSourceType' bank_employment: $ref: '#/components/schemas/LinkTokenCreateRequestEmploymentBankIncome' CreditAuditCopyTokenUpdateRequest: type: object description: CreditAuditCopyTokenUpdateRequest defines the request schema for `/credit/audit_copy_token/update` properties: client_id: $ref: '#/components/schemas/APIClientID' secret: $ref: '#/components/schemas/APISecret' audit_copy_token: type: string description: The `audit_copy_token` you would like to update. report_tokens: type: array description: Array of tokens which the specified Audit Copy Token will be updated with. The types of token supported are asset report token and employment report token. There can be at most 1 of each token type in the array. items: $ref: '#/components/schemas/AssetReportToken' required: - audit_copy_token - report_tokens ServiceProductFulfillmentDetail: title: ServiceProductFulfillmentDetail type: object additionalProperties: true description: Documentation not found in the MISMO model viewer and not provided by Freddie Mac. properties: VendorOrderIdentifier: type: - string - 'null' description: A string that uniquely identifies a type of order Verification of Asset. ServiceProductFulfillmentIdentifier: $ref: '#/components/schemas/ServiceProductFulfillmentIdentifier' required: - VendorOrderIdentifier - ServiceProductFulfillmentIdentifier securitySchemes: clientId: type: apiKey in: header name: PLAID-CLIENT-ID secret: type: apiKey in: header name: PLAID-SECRET plaidVersion: type: apiKey in: header name: Plaid-Version x-refined-from: - plaid-accounts--openapi-original.yml - plaid-accounts--openapi.yml - plaid-application--openapi-original.yml - plaid-asset-report--openapi-original.yml - plaid-asset-report--openapi.yml - plaid-auth--openapi-original.yml - plaid-auth--openapi.yml - plaid-bank-transfer--openapi-original.yml - plaid-bank-transfer--openapi.yml - plaid-beacon--openapi-original.yml - plaid-beacon--openapi.yml - plaid-beta--openapi-original.yml - plaid-categories--openapi-original.yml - plaid-categories--openapi.yml - plaid-cra--openapi-original.yml - plaid-cra--openapi.yml - plaid-credit--openapi-original.yml - plaid-credit--openapi.yml - plaid-dashboard-user--openapi-original.yml - plaid-deposit-switch--openapi-original.yml - plaid-deposit-switch--openapi.yml - plaid-employers--openapi-original.yml - plaid-employers--openapi.yml - plaid-fdx--openapi-original.yml - plaid-fdx--openapi.yml - plaid-identity--openapi-original.yml - plaid-identity--openapi.yml - plaid-identity-verification--openapi-original.yml - plaid-identity-verification--openapi.yml - plaid-income--openapi-original.yml - plaid-income--openapi.yml - plaid-institutions--openapi-original.yml - plaid-institutions--openapi.yml - plaid-investments--openapi-original.yml - plaid-investments--openapi.yml - plaid-item--openapi-original.yml - plaid-item--openapi.yml - plaid-liabilities--openapi-original.yml - plaid-liabilities--openapi.yml - plaid-link--openapi-original.yml - plaid-link--openapi.yml - plaid-link-delivery--openapi-original.yml - plaid-link-delivery--openapi.yml - plaid-openapi-original.yml - plaid-partner--openapi-original.yml - plaid-partner--openapi.yml - plaid-payment-initiation--openapi-original.yml - plaid-payment-initiation--openapi.yml - plaid-payment-profile--openapi-original.yml - plaid-payment-profile--openapi.yml - plaid-processor--openapi-original.yml - plaid-processor--openapi.yml - plaid-profile--openapi-original.yml - plaid-sandbox--openapi-original.yml - plaid-sandbox--openapi.yml - plaid-signal--openapi-original.yml - plaid-signal--openapi.yml - plaid-statements--openapi-original.yml - plaid-statements--openapi.yml - plaid-transactions--openapi-original.yml - plaid-transactions--openapi.yml - plaid-transfer--openapi-original.yml - plaid-transfer--openapi.yml - plaid-user--openapi-original.yml - plaid-wallet--openapi-original.yml - plaid-wallet--openapi.yml - plaid-watchlist-screening--openapi-original.yml - plaid-watchlist-screening--openapi.yml