API template library

Plaid Institutions mock API and live sandbox

A WireMock simulation of Plaid's REST API — covering the institution directory, single-institution lookups, and institution health status.

Vendor
Plaid
Functionality
Institution search and details
Spec version
2020-09-14_1.688.6
Endpoints
3
Stubs
4
Protocol
REST
Validation
AI-validated Before publication, an AI agent exercised these endpoints against the real Plaid API through WireMock's recording proxy, and the recorded traffic was used to verify each stub's request and response shapes.

Live sandbox · no signup, no API key

Plaid Institutions

A running WireMock Cloud instance of this template, callable right now from a terminal, a script, or an AI agent.

Base URL
https://05qyy.wiremockapi.cloud

POST Get Institutions

curl -s -X POST 'https://05qyy.wiremockapi.cloud/institutions/get' \
  -H 'Content-Type: application/json' \
  -d '{}'

POST Search Institutions

curl -s -X POST 'https://05qyy.wiremockapi.cloud/institutions/search' \
  -H 'Content-Type: application/json' \
  -d '{}'

POST Get Institution by ID

curl -s -X POST 'https://05qyy.wiremockapi.cloud/institutions/get_by_id' \
  -H 'Content-Type: application/json' \
  -d '{}'
Method Path Summary
POST /institutions/get Get details of all supported institutions
POST /institutions/get_by_id Get details of an institution
POST /institutions/search Search institutions

Unauthenticated WireMock Cloud demo sandbox for Plaid — not an official Plaid sandbox, and it returns simulated example data only.

What's inside the Institutions template

The directory holds two banks and holds them consistently. First Platypus Bank is ins_109508 — the institution the rest of the Plaid template set hangs its fixtures on — and Second Platypus Bank exists to be different: it flies the oauth flag the first one lacks and carries its own routing number. /institutions/get returns both with product lists, country codes, and brand colors; /institutions/get_by_id narrows to the first and adds the one thing no other route carries, the health block — item_logins reporting HEALTHY over a success-rate breakdown — while /institutions/search answers a single-entry page.

  • Directory — both banks with products, routing numbers, OAuth flags, and branding fields
  • Single lookup — the get_by_id record with its item_logins status and breakdown percentages
  • Search — a fixed single-result page in the shape institution pickers consume

Frequently asked questions

No — any query string, product filter, or country list returns the same First Platypus page, so the route's value is contractual: your typeahead's request construction and response parsing run against the documented shape. When result filtering itself is the thing under test, a WireMock Cloud copy can match on the query field and serve different rosters per term.

A quirk of the stub data: the lookup record leaves the field blank where the directory entries say ins_109508. Assert on the name or routing number when reading this route, and on the id when reading the roster — or normalize the field away before comparison.

US institutions increasingly require OAuth-based linking, and linking flows branch on it — an OAuth handoff for one bank, credential fields for another. One roster read hands your router both cases, each attached to an otherwise-comparable institution.

Across the set. The Items & Webhooks template stamps it on every imported Item, and the data-product sandboxes report it as the institution behind their accounts, so a flow that joins directory metadata to account data keeps one consistent bank throughout.

Vendor names identify APIs represented by WireMock template sources. This page does not imply vendor endorsement, certification, partnership, or official integration status.