> ## Documentation Index > Fetch the complete documentation index at: https://docs.spherepay.co/llms.txt > Use this file to discover all available pages before exploring further. # Recuperar una Cuenta Bancaria por ID > Get information about a bank account by its ID Usa este endpoint para recuperar una única cuenta bancaria por su ID. La respuesta incluye detalles de cuenta enmascarados (como un número de cuenta parcialmente redactado), las redes de pago registradas para la cuenta y el ID del cliente propietario. ## OpenAPI ````yaml openapi/spherepay.yaml GET /v2/bank-account/{id} openapi: 3.0.0 info: title: '' description: '' version: 1.0.0 contact: {} servers: - url: https://api.spherepay.co description: Production security: - bearer: [] tags: [] paths: /v2/bank-account/{id}: get: summary: Get a Bank Account description: Get information about a bank account by its ID parameters: - name: id required: true in: path description: The bank account ID schema: minLength: 1 example: bankAccount_ce745ef7f3df4b9a8bff1301ce24b045 type: string responses: '200': description: '' content: application/json: schema: oneOf: - title: USD type: object properties: id: description: The unique identifier of the bank account. example: bankAccount_ce745ef7f3df4b9a8bff1301ce24b045 type: string status: description: The current status of the bank account. example: active type: string enum: - pending - active - inactive - invalid x-enumNames: - Pending - Active - Inactive - Invalid customerId: description: >- The unique identifier of the customer who owns this bank account. example: customer_66c4168d418a410eae282b83883bdc39 type: string created: description: >- The ISO 8601 timestamp when the bank account was created. example: '2025-01-01T00:00:00Z' type: string updated: description: >- The ISO 8601 timestamp when the bank account was last updated. example: '2025-01-01T00:00:00Z' type: string bankName: description: >- The name of the financial institution where the account is held. example: Bank of America type: string accountName: description: A descriptive name for this bank account. example: Checking Account type: string currency: description: The currency of the bank account. example: usd type: string enum: - usd accountDetails: description: >- USD account details. For ACH/Wire: accountNumber, routingNumber, accountType. For SWIFT: accountNumber (masked), bic. oneOf: - type: object properties: accountNumber: description: >- The bank account number for the US bank account (masked, last 4 characters visible). Present when currency is usd. example: '****7890' type: string routingNumber: description: >- The 9-digit ABA routing number (also known as routing transit number) that identifies the US financial institution. Present when currency is usd. example: '021000021' type: string accountType: description: >- The type of US bank account. Present when currency is usd. example: checking type: string enum: - checking - savings - instapay - pesonet x-enumNames: - Checking - Savings - Instapay - Pesonet required: - accountNumber - routingNumber - accountType - type: object properties: accountNumber: description: >- The account number for SWIFT transfers (masked, last 4 characters visible). Present when currency is usd and networks is ["swift"]. example: '******7890' type: string bic: description: >- The BIC/SWIFT code of the beneficiary bank. Present when currency is usd and networks is ["swift"]. example: DEUTDEFF type: string intermediaryBics: description: >- Ordered list of BIC/SWIFT codes for intermediary correspondent banks, if any were set on this account. Omitted from the response when no intermediary BICs are set. example: - CHASUS33 type: array items: type: string required: - accountNumber - bic accountOwner: description: >- Information about the account owner, including their name and relationship to the customer. type: object properties: accountHolderName: description: >- The name of the account holder as it appears on the bank account. example: John Doe type: string relationship: description: >- The relationship of the account owner to the customer. example: self type: string enum: - self - holding_company - subsidiary_company - branch_office - business_partner - supplier - customer - creditor - debtor - franchisee - unknown required: - accountHolderName - relationship networks: description: >- The payment networks supported by this bank account. For USD ACH/Wire accounts, includes at least one of "ach" or "wire". For USD SWIFT accounts, is exactly ["swift"]. example: - wire - ach oneOf: - type: array items: type: string enum: - ach - wire - type: array items: oneOf: - type: string enum: - swift required: - id - status - customerId - created - updated - bankName - accountName - currency - accountDetails - accountOwner - networks - title: EUR type: object properties: id: description: The unique identifier of the bank account. example: bankAccount_ce745ef7f3df4b9a8bff1301ce24b045 type: string status: description: The current status of the bank account. example: active type: string enum: - pending - active - inactive - invalid x-enumNames: - Pending - Active - Inactive - Invalid customerId: description: >- The unique identifier of the customer who owns this bank account. example: customer_66c4168d418a410eae282b83883bdc39 type: string created: description: >- The ISO 8601 timestamp when the bank account was created. example: '2025-01-01T00:00:00Z' type: string updated: description: >- The ISO 8601 timestamp when the bank account was last updated. example: '2025-01-01T00:00:00Z' type: string bankName: description: >- The name of the financial institution where the account is held. example: Deutsche Bank type: string accountName: description: A descriptive name for this bank account. example: Hauptkonto type: string currency: description: The currency of the bank account. example: eur type: string enum: - eur accountDetails: description: EUR/SEPA account details including iban and bic. type: object properties: iban: description: >- The International Bank Account Number (IBAN) for SEPA transfers (masked). Country code, check digits, and last 4 characters are unmasked. Present when currency is eur. example: GB29****************6819 type: string bic: description: >- The Bank Identifier Code (BIC), also known as SWIFT code. Present when currency is eur. example: COBADEFFXXX type: string required: - iban - bic accountOwner: description: >- Information about the account owner, including their name and relationship to the customer. type: object properties: accountHolderName: description: >- The name of the account holder as it appears on the bank account. example: John Doe type: string relationship: description: >- The relationship of the account owner to the customer. example: self type: string enum: - self - holding_company - subsidiary_company - branch_office - business_partner - supplier - customer - creditor - debtor - franchisee - unknown required: - accountHolderName - relationship networks: description: >- The payment networks supported by this bank account. For EUR accounts, is exactly ["sepa"]. example: - sepa type: array items: type: string enum: - sepa required: - id - status - customerId - created - updated - bankName - accountName - currency - accountDetails - accountOwner - networks - title: BRL type: object properties: id: description: The unique identifier of the bank account. example: bankAccount_ce745ef7f3df4b9a8bff1301ce24b045 type: string status: description: The current status of the bank account. example: active type: string enum: - pending - active - inactive - invalid x-enumNames: - Pending - Active - Inactive - Invalid customerId: description: >- The unique identifier of the customer who owns this bank account. example: customer_66c4168d418a410eae282b83883bdc39 type: string created: description: >- The ISO 8601 timestamp when the bank account was created. example: '2025-01-01T00:00:00Z' type: string updated: description: >- The ISO 8601 timestamp when the bank account was last updated. example: '2025-01-01T00:00:00Z' type: string bankName: description: >- The name of the financial institution where the account is held. example: Itaú type: string accountName: description: A descriptive name for this bank account. example: Conta PIX Alice Santos type: string currency: description: The currency of the bank account. example: brl type: string enum: - brl accountDetails: description: >- BRL/PIX account details including pixKey and pixKeyType. type: object properties: pixKey: description: >- The masked PIX key for Brazilian PIX transfers. Present when currency is brl. example: a*c@g***l.com type: string pixKeyType: description: The type of PIX key. Present when currency is brl. example: email type: string enum: - cpf - cnpj - email - phone - random required: - pixKey - pixKeyType accountOwner: description: >- Information about the account owner, including their name and relationship to the customer. type: object properties: accountHolderName: description: >- The name of the account holder as it appears on the bank account. example: John Doe type: string relationship: description: >- The relationship of the account owner to the customer. example: self type: string enum: - self - holding_company - subsidiary_company - branch_office - business_partner - supplier - customer - creditor - debtor - franchisee - unknown required: - accountHolderName - relationship networks: description: >- The payment networks supported by this bank account. For BRL accounts, is exactly ["pix"]. example: - pix type: array items: type: string enum: - pix required: - id - status - customerId - created - updated - bankName - accountName - currency - accountDetails - accountOwner - networks '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/ProblemDetailsDto' examples: Bad Request: summary: Bad Request value: status: 400 detail: Invalid request parameters code: address/invalid correlationId: 28c61e885c6e5eaa78c1a2183a9b883c '404': description: Not Found content: application/json: schema: $ref: '#/components/schemas/ProblemDetailsDto' examples: Not Found: summary: Not Found value: status: 404 detail: Resource not found code: resource/not-found correlationId: 28c61e885c6e5eaa78c1a2183a9b883c '422': description: Unprocessable Entity - Validation Error content: application/json: schema: $ref: '#/components/schemas/ProblemDetailsDto' examples: Validation Error: summary: Validation Error value: status: 422 detail: Validation failed code: validation/failed correlationId: 28c61e885c6e5eaa78c1a2183a9b883c errors: - detail: Invalid email format pointer: /email - detail: Name is required pointer: /name components: schemas: ProblemDetailsDto: type: object properties: title: type: string status: type: integer detail: type: string code: type: string errors: type: array items: type: object properties: detail: type: string pointer: type: string parameter: type: string header: type: string required: - detail correlationId: type: string required: - status - detail securitySchemes: bearer: scheme: bearer bearerFormat: JWT type: http ````