> ## Documentation Index > Fetch the complete documentation index at: https://docs.meld.io/llms.txt > Use this file to discover all available pages before exploring further. # Get transaction by id > Search transaction by its Meld identifier ## OpenAPI ````yaml /openapi/payments-20260203.json get /payments/transactions/{id} openapi: 3.1.0 info: title: PAYMENTS termsOfService: urn:tos license: name: Apache 2.0 url: https://springdoc.org version: '2026-02-03' description: '' servers: - url: https://api-sb.meld.io description: Meld API sandbox - url: https://api.meld.io description: Meld API production security: [] tags: - name: Payment description: '' paths: /payments/transactions/{id}: get: tags: - Transactions summary: Get transaction by id description: Search transaction by its Meld identifier operationId: /payments-transactions-get parameters: - name: id in: path description: Unique identifier of the transaction to be fetched required: true schema: type: string responses: '200': description: Payment found content: '*/*': schema: $ref: '#/components/schemas/PaymentTransactionResponse20250304' '400': description: 'Bad Request : check request values and format' '401': description: Invalid credentials '403': description: Unauthenticated or authenticated with insufficient access '404': description: Payment transaction with the id informed was not found content: '*/*': schema: $ref: '#/components/schemas/PaymentTransactionResponse20250304' '500': description: >- Server Error. This applies to all 5xx errors, including but not limited to 500, 501, 502, 503, and 504 errors. You should treat all of these errors the same. security: - ApiKeyAuth: [] components: schemas: PaymentTransactionResponse20250304: type: object properties: transaction: description: Payment transaction information allOf: - $ref: '#/components/schemas/PaymentTransactionOutput20250304' PaymentTransactionOutput20250304: type: object properties: accountId: type: string description: Your account Id countryCode: type: string description: The ISO 3166 2-digit country code. createdAt: type: string format: date-time description: An ISO 8601 DateTime at which the object was created. cryptoDetails: description: Details of the crypto currency purchase, sale, or transfer allOf: - $ref: '#/components/schemas/CryptoDetails20250304' customer: description: Your customer's details allOf: - $ref: '#/components/schemas/CustomerOutput' description: type: string description: >- An arbitrary string which you can attach to this transaction. It is displayed when in the web interface alongside the charge. destinationAmount: type: number description: >- The destination amount of the transaction, e.g. the amount of crypto currency purchased destinationCurrencyCode: type: string description: Three-letter ISO currency code. Must be a supported currency externalCustomerId: type: string description: >- Your unique identifier for your customer. If maintaining your own customer management system this can also be used for tracking customer activity. externalReferenceId: type: string description: Your optional reference id provided during transaction creation externalSessionId: type: string description: The external Id of the session. externalSubaccountCustomerId: type: string description: >- Optional external identifier for the sub-account customer this transaction belongs to. Used for tracking when multiple businesses operate under one Meld account. A sub-account customer must be created first before it can be referenced. fiatAmountInUsd: type: number description: The fiat amount of the transaction in usd id: type: string description: Unique identifier for this transaction isImported: type: boolean description: Return ***True*** if this transaction was initiated outside Meld isPassthrough: type: boolean description: Return ***True*** if the passthrough credentials were used key: type: string description: >- Pagination key, may be used with the "after" parameter in search requests. Only set and relevant for paginated calls multiFactorAuthorizationStatus: type: array description: >- The transaction required multi-factor authentication methods, and their current status. When required, must be approved for the purchase tobe completed successfully. items: $ref: '#/components/schemas/MultiFactorAuthorizationStatusOutput' uniqueItems: true orderId: type: string description: >- Unique identifier for the order associated with this transaction, when applicable parentPaymentTransactionId: type: string description: The Id of the associated object for this line item passthroughReference: type: string description: >- The unique reference you use to identify the partner on whose behalf you created this transaction. This might be a String or UUID in your system to identify a merchant or partner. This is needed so that you can associate passthrough transactions to your partners who may not be registered with Meld paymentDetails: description: payment details allOf: - $ref: '#/components/schemas/PaymentDetails' paymentMethodType: type: string description: Payment Method type used for this transaction. serviceProvider: type: string description: The service provider used for this transaction serviceProviderCreatedAt: type: string format: date-time description: >- The ISO 8601 DateTime when the transaction was created on the service provider's side serviceProviderDetails: type: object additionalProperties: {} description: The service provider's details serviceProviderTransactionUrl: type: string description: A link to the resource on the Service Provider, may not be present serviceTransactionId: type: string description: The service provider's unique identifier for this transaction sessionClientTags: type: object additionalProperties: type: string description: A map of client tags sessionId: type: string description: The Id of the session. sourceAmount: type: number description: The amount of the transaction sourceCurrencyCode: type: string description: Three-letter ISO currency code. Must be a supported currency status: type: string description: The current status of the transaction subaccountCustomerId: type: string description: >- Optional Meld customer id used to track the business sub-account this transaction belongs to when multiple businesses operate under one Meld account. transactionType: type: string description: The transaction's type updatedAt: type: string format: date-time description: >- Time at which the object was last updated. Measured in seconds since the Unix epoch. required: - createdAt - id - serviceProvider - sessionId - status - transactionType - updatedAt CryptoDetails20250304: type: object properties: blockchainTransactionId: type: string description: The transaction id on the blockchain chainId: type: string description: >- A unique identifier that represents a blockchain network. The chainId of a particular network is standard everywhere. destinationWalletAddress: type: string description: >- The wallet address that the crypto is sent to. This is usually the user's wallet address for buy and transfer transactions, and the onramp's wallet address for sell transactions. institution: type: string description: >- The institution used to execute the transaction. Only applicable for transfers currently. networkFee: type: number description: >- This fee is paid to cryptocurrency miners, which are the systems that process the transactions networkFeeInUsd: type: number description: This network fee in USD partnerFee: type: number description: The partner fee amount partnerFeeInUsd: type: number description: The partner fee in USD sessionWalletAddress: type: string description: >- The wallet address passed into the /widget endpoint, typically of the user. This will often be the same as either the sourceWalletAddress or the destinationWalletAddress. sourceWalletAddress: type: string description: >- The wallet address that the crypto comes from. This is usually the onramp's wallet address for buy transactions, and the user's wallet address for transfer and sell transactions. swapFee: type: number description: >- The swap fee amount charged by the swap provider for ramp+swap transactions swapFeeInUsd: type: number description: The swap fee in USD totalFee: type: number description: The total amount of fees that will be charged totalFeeInUsd: type: number description: The total fee in USD transactionFee: type: number description: >- The fee amount charged by the service provider to process your customer's purchase transactionFeeInUsd: type: number description: The transaction fee in USD CustomerOutput: type: object properties: accountId: type: string description: Your Account Id addresses: type: array description: Your Customer's addresses, such as billing, shipping, etc. items: $ref: '#/components/schemas/CustomerAddressOutput' email: type: string description: Your Customer's email address externalId: type: string description: >- Your optionally supplied Id for your Customer, e.g. a Customer Id in your system id: type: string description: Meld's internal Id for the Customer name: description: Your Customer's name allOf: - $ref: '#/components/schemas/CustomerName' phone: type: string description: Your Customer's phone number serviceProviders: type: object additionalProperties: type: string description: >- A map of Service Providers and service provider IDs for this Customer status: type: string description: ACTIVE or INACTIVE, may not be set MultiFactorAuthorizationStatusOutput: type: object properties: method: type: string description: How the card details were authorized enum: - SMS - CARD - EMAIL - THREE_DS submitted: type: boolean description: Return ***True*** if the information was submitted successful: type: boolean description: Return ***True*** if the submitted information is a match url: type: string description: URL used to perform authorization (if applicable) PaymentDetails: type: object properties: authAmount: type: number description: >- The amount authorized to be charged (must be greater than the amount intended to be collected.) Note that the number of digits with a decimal point varies with the currency. Reference the list of active codes of official ISO 4217 currency names. captureAmount: type: number description: >- The amount captured (can be less than the amount intended to be collected.) Note that the number of digits with a decimal point varies with the currency. Reference the list of active codes of official ISO 4217 currency names. CustomerAddressOutput: type: object properties: addressDetails: description: Address details allOf: - $ref: '#/components/schemas/CustomerAddressDetails' type: type: string description: Address type such as BILLING, SHIPPING, RESIDENCE, etc. enum: - BILLING - SHIPPING - RESIDENCE CustomerName: type: object properties: firstName: type: string description: Your customer's first name lastName: type: string description: Your customer's last name CustomerAddressDetails: type: object properties: addressDetailsFields: type: object writeOnly: true city: type: string description: City, district, suburb, town, or village country: type: string description: Two-letter country code (ISO 3166-1 alpha-2) firstName: type: string description: The first name on the address lastName: type: string description: The last name on the address lineOne: type: string description: Address line 1 (e.g., street, PO Box, or company name) lineTwo: type: string description: Address line 2 (e.g., apartment, suite, unit, or building) postalCode: type: string description: ZIP or postal code region: type: string description: State, county, province, or region securitySchemes: ApiKeyAuth: type: apiKey in: header name: Authorization x-default: BASIC ````