---
title: "BankAccountListItemV2"
url: "https://developer-staging.agentsync.io/apis/identity/versions/1ed33a2c-924a-434c-9643-fbc531dea1b8/schemas/BankAccountListItemV2"
---

> Full API specification: https://developer-staging.agentsync.io/apis/identity/versions/1ed33a2c-924a-434c-9643-fbc531dea1b8.md

# BankAccountListItemV2

Per-row shape returned by V2 bank-account list endpoints. Carries owner context (personId or firmId, plus the producer NPN where known) for reconciliation use cases. The account number is always masked here; the unmasked value is reachable only via GET /v2/bank-accounts/{id} behind an elevated scope.

## OpenAPI definition

```yaml
openapi: 3.0.1
info:
  title: Identity API
  version: v1.275.8
servers:
  - url: https://api.sandbox.agentsync.io/id
    description: Sandbox server
  - url: https://api.agentsync.io/id
    description: Production server
components:
  schemas:
    BankAccountType:
      title: BankAccountType
      type: string
      description: The type of bank account
      enum:
        - SAVINGS
        - CHECKING
      example: CHECKING
    BankAccountListItemV2:
      title: BankAccountListItemV2
      type: object
      description: >
        Per-row shape returned by V2 bank-account list endpoints. Carries owner
        context (personId or firmId, plus the producer NPN where known) for
        reconciliation use cases. The account number is always masked here; the
        unmasked value is reachable only via GET /v2/bank-accounts/{id} behind
        an elevated scope.
      required:
        - id
        - type
        - bankName
        - number
        - primaryAccount
        - updatedAt
      properties:
        id:
          type: string
          format: uuid
          description: Bank account identifier.
          example: 550e8400-e29b-41d4-a716-446655440000
        personId:
          type: string
          format: uuid
          nullable: true
          description: Owning person id. Set when this is a person-owned bank account;
            null for firm-owned.
        firmId:
          type: string
          format: uuid
          nullable: true
          description: Owning firm id. Set when this is a firm-owned bank account; null
            for person-owned.
        npn:
          type: string
          nullable: true
          description: National Producer Number of the owning person or firm, when known.
          example: "1234567"
        type:
          $ref: "#/components/schemas/BankAccountType"
        bankName:
          type: string
          description: Name of the bank.
          example: Chase Bank
        number:
          type: string
          description: Account number masked to ****<last4>.
          example: "****7890"
        primaryAccount:
          type: boolean
          description: Indicates if this is the owner's primary bank account.
          example: true
        updatedAt:
          type: string
          format: date-time
          description: RFC3339 UTC timestamp of the bank account's last modification.
          example: 2026-05-21T14:00:00Z
```