fastify.xplaid.items.getInstitution(
  institutionId: string,
  countryCodes?: string[]   // default: ["US"]
): Promise<{ institution: Institution; requestId: string }>

{ institution: Institution; requestId: string }

const { institution } = await fastify.xplaid.items.getInstitution("ins_3");
console.log(institution.name);          // "Chase"
console.log(institution.primary_color); // "#107EBF"
// logo is a base64 PNG string

fastify.post("/plaid/connect", async (request, reply) => {
  const { publicToken, institutionId } = request.body;

  const { accessToken, itemId } = await fastify.xplaid.link.exchangePublicToken(publicToken);
  const { institution } = await fastify.xplaid.items.getInstitution(institutionId);

  await db.plaidItems.create({
    data: {
      userId: request.user.id,
      itemId,
      accessToken: encrypt(accessToken),
      institutionId,
      institutionName: institution.name,
      institutionLogo: institution.logo,
      institutionColor: institution.primary_color,
    },
  });

  return reply.code(201).send({ itemId, institutionName: institution.name });
});

package: "@xenterprises/fastify-xplaid"
method: fastify.xplaid.items.getInstitution(institutionId, countryCodes?)
use-when: Retrieve display metadata for a bank — name, logo, color, OAuth support — after Link or for UI enrichment
returns: { institution: { institution_id, name, products, country_codes, logo, primary_color, oauth, url }, requestId }