> ## Documentation Index > Fetch the complete documentation index at: https://docs.bastion.com/llms.txt > Use this file to discover all available pages before exploring further. # Get Payment Instructions > Get payment instructions by id ## OpenAPI ````yaml /v2/openapi.yaml get /v2/identities/{identity_id}/payment-instructions/{payment_instructions_id} openapi: 3.1.0 info: title: Bastion APIs version: '2.0' servers: - url: https://api.prod.bastion.com description: Production environment - url: https://api.sandbox.bastion.io description: Sandbox environment security: - auth: [] tags: - name: Bastion APIs paths: /v2/identities/{identity_id}/payment-instructions/{payment_instructions_id}: get: tags: - Payment Instructions summary: Get Payment Instructions description: Get payment instructions by id operationId: bastion.api.v2.API.GetPaymentInstructions parameters: - name: identity_id in: path description: Identity ID required: true schema: type: string title: identity_id - name: payment_instructions_id in: path description: Payment instructions ID required: true schema: type: string title: payment_instructions_id responses: '200': description: Success content: application/json: schema: $ref: >- #/components/schemas/bastion.api.v2.payment_instructions.PaymentInstructions '400': description: Bad request '401': description: Unauthorized Request '403': description: Request Forbidden '404': description: Resource not found '500': description: Internal Server Error components: schemas: bastion.api.v2.payment_instructions.PaymentInstructions: type: object properties: country: $ref: '#/components/schemas/bastion.common.Country' title: country description: Country of the bank account (ISO 3166-1 alpha-2). fiat_currency_symbol: $ref: >- #/components/schemas/bastion.api.v2.payment_instructions.PaymentInstructions.FiatCurrencySymbol title: fiat_currency_symbol description: Currency symbol of the fiat transaction account_name: type: string title: account_name description: >- Friendly name for the payment instructions (e.g., "John's Chase Account") payment_method: $ref: >- #/components/schemas/bastion.api.v2.payment_instructions.PaymentMethod title: payment_method description: Payment method for the fiat transaction bank_account_details: $ref: >- #/components/schemas/bastion.api.v2.payment_instructions.BankAccountDetails description: Bank account details id: type: string title: id description: Payment instructions ID readOnly: true beneficiary_type: $ref: >- #/components/schemas/bastion.api.v2.payment_instructions.BeneficiaryType title: beneficiary_type description: >- Whether these instructions pay the sender (FIRST_PARTY) or someone else (THIRD_PARTY). recipient: $ref: '#/components/schemas/bastion.api.v2.payment_instructions.Recipient' description: Recipient information. title: PaymentInstructions required: - country - fiat_currency_symbol - account_name - payment_method - bank_account_details - beneficiary_type - recipient additionalProperties: false description: Payment instructions for a conversion. bastion.common.Country: type: string title: Country enum: - US description: ISO 3166-1 alpha-2 country code. example: US bastion.api.v2.payment_instructions.PaymentInstructions.FiatCurrencySymbol: type: string title: FiatCurrencySymbol enum: - USD description: Fiat currency symbol. example: USD bastion.api.v2.payment_instructions.PaymentMethod: type: string title: PaymentMethod enum: - WIRE description: Payment method for the fiat transaction. example: WIRE bastion.api.v2.payment_instructions.BankAccountDetails: type: object allOf: - properties: name: type: string title: name description: >- Name of the bank (e.g., "Chase", "BBVA"). This is a top-level field of BankAccountDetails and a sibling of wire_details, not nested inside it. - oneOf: - type: object properties: wire_details: $ref: >- #/components/schemas/bastion.api.v2.payment_instructions.WireDetails title: wire_details title: wire_details required: - wire_details required: - name additionalProperties: false description: |- Bank account details for the transaction. Corridor-specific fields live inside the `details` oneof; exactly one variant must be set, matching the payment_method on the parent message. bastion.api.v2.payment_instructions.BeneficiaryType: type: string title: BeneficiaryType enum: - FIRST_PARTY - THIRD_PARTY description: Beneficiary type of the payment instructions. example: FIRST_PARTY bastion.api.v2.payment_instructions.Recipient: type: object allOf: - properties: name: type: string title: name description: |- (OPTIONAL) Full name of the recipient. It is declared optional because there are specialized Recipient structures with their own required name fields email: type: string title: email description: >- (OPTIONAL) Email address of the recipient. Required for THIRD_PARTY only. tax_id: type: string title: tax_id description: >- (OPTIONAL) Tax identification number. Required for MX (RFC) and BR (CPF/CNPJ). Deprecated: set tax_id on individual/business instead. Read during the migration window as a fallback when the nested field is unset. deprecated: true address: $ref: '#/components/schemas/bastion.common.Address' title: address description: |- (OPTIONAL) Recipient's address. It is declared optional because there are specialized Recipient structures with their own required address fields recipient_type: $ref: >- #/components/schemas/bastion.api.v2.payment_instructions.RecipientType title: recipient_type description: |- (OPTIONAL) Whether the recipient is an individual or a business. The value is optional if a more specialized Recipient structure is populated phone: type: string title: phone description: |- (OPTIONAL) Phone number required by some corridors. Deprecated: set phone on individual/business instead. Read during the migration window as a fallback when the nested field is unset. deprecated: true - oneOf: - type: object properties: business: $ref: >- #/components/schemas/bastion.api.v2.payment_instructions.BusinessRecipient title: business title: business required: - business - type: object properties: individual: $ref: >- #/components/schemas/bastion.api.v2.payment_instructions.IndividualRecipient title: individual title: individual required: - individual additionalProperties: false description: |- Recipient identifies the beneficiary of the payment instructions. Required on every PI registration. tax_id is required for MX and BR corridors; email is required only for THIRD_PARTY beneficiaries. bastion.api.v2.payment_instructions.WireDetails: type: object properties: account_number: type: string title: account_number description: Bank account number routing_number: type: string title: routing_number description: Bank routing number type: $ref: >- #/components/schemas/bastion.api.v2.payment_instructions.BankAccountDetails.BankAccountType title: type description: Type of the bank account address: $ref: '#/components/schemas/bastion.common.Address' title: address description: Address of the bank title: WireDetails required: - account_number - routing_number - type - address additionalProperties: false description: US domestic wire transfer details. bastion.common.Address: type: object properties: street_line_1: type: string title: street_line_1 maxLength: 100 minLength: 3 description: >- Street address line 1. Must not be a PO box, and must be between 3 and 100 characters inclusive. street_line_2: type: string title: street_line_2 description: Street address line 2. Must not be a PO box. city: type: string title: city maxLength: 50 minLength: 3 description: City postal_code: type: string title: postal_code maxLength: 20 description: Postal (zip) code. For US addresses, must be a valid US ZIP format. country: type: string title: country description: Two-letter ISO 3166-1 alpha-2 country code, e.g. "US". region_code: type: string title: region_code description: >- Two-letter subdivision code. For US addresses, must be a valid ISO 3166-2 US subdivision code without the country prefix, e.g. "CA" (not "US-CA"). title: Address required: - street_line_1 - city - postal_code - country - region_code additionalProperties: false bastion.api.v2.payment_instructions.RecipientType: type: string title: RecipientType enum: - INDIVIDUAL - BUSINESS description: Whether the recipient is an individual or a business. example: INDIVIDUAL bastion.api.v2.payment_instructions.BusinessRecipient: type: object properties: business_name: type: string title: business_name email: type: string title: email description: >- (OPTIONAL) Email address of the recipient. Required for THIRD_PARTY only. address: $ref: '#/components/schemas/bastion.common.Address' title: address tax_id: type: string title: tax_id description: |- (OPTIONAL) Tax identification number (e.g. CNPJ for BR, RFC for MX). Required for MX and BR corridors. phone: type: string title: phone description: (OPTIONAL) Phone number. Required by some corridors. title: BusinessRecipient required: - business_name - address additionalProperties: false bastion.api.v2.payment_instructions.IndividualRecipient: type: object properties: first_name: type: string title: first_name middle_name: type: string title: middle_name last_name: type: string title: last_name email: type: string title: email description: >- (OPTIONAL) Email address of the recipient. Required for THIRD_PARTY only. address: $ref: '#/components/schemas/bastion.common.Address' title: address tax_id: type: string title: tax_id description: |- (OPTIONAL) Tax identification number (e.g. CPF for BR, RFC for MX). Required for MX and BR corridors. phone: type: string title: phone description: (OPTIONAL) Phone number. Required by some corridors. title: IndividualRecipient required: - first_name - last_name - address additionalProperties: false bastion.api.v2.payment_instructions.BankAccountDetails.BankAccountType: type: string title: BankAccountType enum: - CHECKING - SAVINGS description: >- Type of the bank account (checking vs savings). Used by US Wire, Peru CCE, and bank-transfer corridors that route on account type (e.g. CO). example: CHECKING securitySchemes: auth: type: http description: Bearer authentication with an API token scheme: bearer ```` ## Related topics - [List Payment Instructions](/v2/api-reference/payment-instructions/list-payment-instructions.md) - [Get Mint Instructions](/v2/api-reference/issuance/get-mint-instructions.md) - [Create Payment Instructions](/v2/api-reference/payment-instructions/create-payment-instructions.md) - [Off-ramp: Withdraw stablecoin internationally](/guides/quickstarts/off-ramp/international-bank-account.md) - [Off-ramp: Withdraw stablecoin to a US bank account](/guides/quickstarts/off-ramp/withdraw-to-a-bank-account.md)