> ## Documentation Index > Fetch the complete documentation index at: https://docs.getasset.com/llms.txt > Use this file to discover all available pages before exploring further. # Get a single Transaction > **Scopes:** `transaction:read` ## OpenAPI ````yaml /api-reference/openapi.json get /v0/business/{business_id}/transactions/{transaction_id} openapi: 3.1.0 info: title: Asset API version: '0.1' servers: - url: https://api.sandbox.getasset.com description: Sandbox - url: https://api.getasset.com description: Production security: [] paths: /v0/business/{business_id}/transactions/{transaction_id}: get: tags: - Transaction summary: Get a single Transaction description: '**Scopes:** `transaction:read`' operationId: >- get_business_transaction_v0_business__business_id__transactions__transaction_id__get parameters: - name: business_id in: path required: true schema: description: The id of the business examples: - biz_GA6EG2qFxA97NZHtxeLPUy type: string format: biz_string title: Business Id description: The id of the business - name: transaction_id in: path required: true schema: description: The id of the transaction examples: - txn_WQMDNUHpBThYSNh4AprDBo type: string format: txn_string title: Transaction Id description: The id of the transaction - name: includes in: query required: false schema: anyOf: - type: string - items: type: string type: array - type: 'null' description: >- Comma-separated list of related objects to include. Supported: invoice_payments.invoice title: Includes description: >- Comma-separated list of related objects to include. Supported: invoice_payments.invoice responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/TransactionSuccess' '401': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Unauthorized '403': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Forbidden '404': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Not Found '422': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Unprocessable Content '503': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Service Unavailable security: - OAuth2PasswordBearer: - transaction:read components: schemas: TransactionSuccess: properties: data: $ref: '#/components/schemas/TransactionPublic' type: object required: - data title: TransactionSuccess ErrorResponse: properties: error: anyOf: - type: string - type: 'null' title: Error description: A description of the error data: title: Data description: Data associated with the error type: object required: - error - data title: ErrorResponse TransactionPublic: properties: external_id: anyOf: - type: string maxLength: 255 - type: 'null' title: External Id examples: - '1234567890' amount: type: number title: Amount examples: - 520.56 datetime: type: string format: date-time title: Datetime description: type: string maxLength: 512 title: Description description: The description of the Transaction examples: - Payment from Acme Corp posted: type: boolean title: Posted type: $ref: '#/components/schemas/TransactionType' description: The type of the Transaction examples: - business - personal reviewed: type: boolean title: Reviewed metadata_: anyOf: - additionalProperties: true type: object - type: 'null' title: Metadata id: type: string format: txn_string title: Id description: The ID of the Transaction examples: - txn_WQMDNUHpBThYSNh4AprDBo external_account_id: type: string format: eac_string title: External Account Id description: The ID of the External Account associated with the Transaction examples: - eac_WQMDNUHpBThYSNh4AprDBo invoice_payments: anyOf: - items: $ref: '#/components/schemas/InvoicePaymentPublic' type: array - type: 'null' title: Invoice Payments description: The invoice payments associated with the Transaction examples: - null refund_payments: anyOf: - items: $ref: '#/components/schemas/RefundPaymentPublic' type: array - type: 'null' title: Refund Payments description: The refund payments associated with the Transaction examples: - null bill_payments: anyOf: - items: $ref: '#/components/schemas/BillPaymentPublic' type: array - type: 'null' title: Bill Payments description: The bill payments associated with the Transaction examples: - null tags: anyOf: - additionalProperties: items: $ref: '#/components/schemas/TransactionTagValueInput-Output' type: array type: object - type: 'null' title: Tags description: >- Tag field name to the list of values attached to the transaction. Each value carries its allocated amount and, when pinned, its ledger; a single-value field is still returned as a one-element list. examples: - Job: - amount: '3000.00' value: Maple Street Remodel - amount: '1500.00' value: Downtown Office Rewire type: object required: - external_id - amount - datetime - description - posted - type - reviewed - id - external_account_id title: TransactionPublic TransactionType: type: string enum: - business - personal title: TransactionType InvoicePaymentPublic: properties: invoice_id: type: string format: inv_string title: Invoice Id description: The ID of the invoice that the payment is associated with examples: - inv_GkBo16N66u2teKfFuFMMwf transaction_id: anyOf: - type: string format: txn_string - type: 'null' title: Transaction Id description: >- The ID of the transaction that the payment is associated with. Null for credit-source payments. examples: - txn_WQMDNUHpBThYSNh4AprDBo credit_journal_entry_id: anyOf: - type: string format: uuid - type: 'null' title: Credit Journal Entry Id description: >- Journal entry created for this payment. Populated for credit-source payments; null for transaction-source payments (whose JE is keyed off the transaction). credit_memo_id: anyOf: - type: string format: uuid - type: 'null' title: Credit Memo Id description: >- Credit memo that backs this payment. Set for write-off payments; null otherwise. payment_id: type: string maxLength: 255 title: Payment Id description: The external identifier of the payment examples: - inp_ErisumsAc7qgmbTctM7zKK datetime: type: string format: date-time title: Datetime description: The date and time the payment was made examples: - '2021-01-01T00:00:00Z' payment_amount: type: number title: Payment Amount description: The amount of the payment examples: - 520.56 id: type: string format: inp_string title: Id description: The ID of the invoice payment examples: - inp_WQMDNUHpBThYSNh4AprDBo invoice: anyOf: - $ref: '#/components/schemas/InvoicePublic' - type: 'null' description: The invoice that the payment is associated with is_write_off: type: boolean title: Is Write Off description: >- True when the payment was created by writing off the invoice as uncollectible. default: false type: object required: - invoice_id - payment_id - datetime - payment_amount - id title: InvoicePaymentPublic RefundPaymentPublic: properties: amount: type: number title: Amount description: The amount of the refund that has been paid id: type: string format: rfp_string title: Id description: The ID of the payment examples: - rfp_WQMDNUHpBThYSNh4AprDBo transaction_id: type: string format: txn_string title: Transaction Id description: The ID of the transaction that the refund payment is associated with examples: - txn_WQMDNUHpBThYSNh4AprDBo type: object required: - amount - id - transaction_id title: RefundPaymentPublic BillPaymentPublic: properties: bill_id: type: string format: bil_string title: Bill Id description: The ID of the bill that the payment is associated with examples: - bil_WQMDNUHpBThYSNh4AprDBo transaction_id: anyOf: - type: string format: txn_string - type: 'null' title: Transaction Id description: >- The ID of the transaction that the payment is associated with. Null for credit-source payments. examples: - txn_WQMDNUHpBThYSNh4AprDBo credit_journal_entry_id: anyOf: - type: string format: uuid - type: 'null' title: Credit Journal Entry Id description: >- Journal entry created for this payment. Populated for credit-source payments; null for transaction-source payments (whose JE is keyed off the transaction). payment_id: type: string maxLength: 255 title: Payment Id description: The external identifier of the payment examples: - blp_WQMDNUHpBThYSNh4AprDBo datetime: type: string format: date-time title: Datetime description: The date and time the payment was made examples: - '2021-01-01T00:00:00Z' payment_amount: type: number title: Payment Amount description: The amount of the payment examples: - '89.23' id: type: string format: blp_string title: Id description: The ID of the bill payment examples: - blp_WQMDNUHpBThYSNh4AprDBo bill: anyOf: - $ref: '#/components/schemas/BillPublic' - type: 'null' description: The bill that the payment is associated with type: object required: - bill_id - payment_id - datetime - payment_amount - id title: BillPaymentPublic TransactionTagValueInput-Output: properties: value: type: string title: Value description: The tag value (option string) examples: - NYC amount: anyOf: - type: number - type: 'null' title: Amount description: >- Portion of the source object allocated to this tag value. If omitted: with one value on a field the full source amount is used; with multiple values on a field the amount is split evenly. Mixed (some amounts set, some omitted) is rejected. examples: - '75.00' ledger_id: anyOf: - type: string format: ldg_string - type: 'null' title: Ledger Id description: >- Optional P&L ledger to pin this value's amount to. When set, the amount attributes entirely to that ledger instead of being pro-rated across the journal entry's P&L ledgers; an explicit amount is required and a field's values must be either all pinned or all unpinned. Transaction tags only. examples: - ldg_WQMDNUHpBThYSNh4AprDBo type: object required: - value title: TransactionTagValueInput description: |- Tag value input for transactions, which additionally support pinning a value's amount to a specific P&L ledger. InvoicePublic: properties: business_id: type: string format: biz_string title: Business Id description: The ID of the Business that the invoice is associated with examples: - biz_Pk2fNFDd8wj7EFeLWJywc7 number: type: string maxLength: 255 title: Number description: >- The number of the invoice. Must be unique across all invoices for a business. examples: - INV-1234567890 description: type: string maxLength: 512 title: Description description: The description of the invoice examples: - Invoice from Acme Corp total_amount: type: number title: Total Amount description: The amount of the invoice examples: - 520.56 total_paid: type: number title: Total Paid description: The amount of the invoice that has been paid default: 0 examples: - 520.56 source: $ref: '#/components/schemas/InvoiceSource' description: The source of the invoice due_at: type: string format: date-time title: Due At description: The due date of the invoice sent_at: type: string format: date-time title: Sent At description: The date the invoice was sent voided_at: anyOf: - type: string format: date-time - type: 'null' title: Voided At description: The date the invoice was voided status: $ref: '#/components/schemas/InvoiceStatus' description: The status of the invoice examples: - paid metadata: anyOf: - additionalProperties: true type: object - type: 'null' title: Metadata id: type: string format: inv_string title: Id description: The ID of the invoice examples: - inv_GkBo16N66u2teKfFuFMMwf lines: anyOf: - items: $ref: '#/components/schemas/InvoiceLinePublic' type: array - type: 'null' title: Lines description: The lines of the invoice payments: anyOf: - items: $ref: '#/components/schemas/InvoicePaymentPublic' type: array - type: 'null' title: Payments description: The payments of the invoice customer_id: type: string format: cus_string title: Customer Id description: The ID of the Customer that the invoice is associated with examples: - cus_WxcM3ypJ5boFxsNQzcqRXe tags: anyOf: - additionalProperties: items: $ref: '#/components/schemas/TagValueInput-Output' type: array type: object - type: 'null' title: Tags description: >- Tag field name to the list of values attached to the invoice. Each value carries its allocated amount; a single-value field is still returned as a one-element list. examples: - Job: - amount: '3000.00' value: Maple Street Remodel - amount: '1500.00' value: Downtown Office Rewire type: object required: - business_id - number - description - total_amount - source - due_at - sent_at - status - id - customer_id title: InvoicePublic BillPublic: properties: business_id: type: string format: biz_string title: Business Id description: The ID of the Business that the bill is associated with examples: - biz_Pk2fNFDd8wj7EFeLWJywc7 vendor_id: type: string format: ven_string title: Vendor Id description: The ID of the Vendor that the bill is associated with examples: - ven_ErisumsAc7qgmbTctM7zKK number: type: string maxLength: 255 title: Number description: The id or number of the bill examples: - BILL-001 description: type: string maxLength: 512 title: Description description: The description of the bill examples: - Cleaning services total_amount: type: number title: Total Amount description: The amount of the bill total_paid: type: number title: Total Paid description: The amount of the bill that has been paid due_at: type: string format: date-time title: Due At description: The due date of the bill issued_at: type: string format: date-time title: Issued At description: The date the bill was sent voided_at: anyOf: - type: string format: date-time - type: 'null' title: Voided At description: The date the bill was voided status: $ref: '#/components/schemas/BillStatus' description: The status of the bill metadata_: anyOf: - additionalProperties: true type: object - type: 'null' title: Metadata id: type: string format: bil_string title: Id description: The ID of the bill examples: - bil_WQMDNUHpBThYSNh4AprDBo lines: anyOf: - items: $ref: '#/components/schemas/BillLinePublic' type: array - type: 'null' title: Lines description: The lines of the bill payments: anyOf: - items: $ref: '#/components/schemas/BillPaymentPublic' type: array - type: 'null' title: Payments description: The payments associated with the bill tags: anyOf: - additionalProperties: items: $ref: '#/components/schemas/TagValueInput-Output' type: array type: object - type: 'null' title: Tags description: >- Tag field name to the list of values attached to the bill. Each value carries its allocated amount; a single-value field is still returned as a one-element list. examples: - Job: - amount: '3000.00' value: Maple Street Remodel - amount: '1500.00' value: Downtown Office Rewire type: object required: - business_id - vendor_id - number - description - total_amount - total_paid - due_at - issued_at - status - id title: BillPublic InvoiceSource: type: string enum: - manual - stripe title: InvoiceSource InvoiceStatus: type: string enum: - open - paid - uncollectible - voided - refunded - partially_refunded title: InvoiceStatus InvoiceLinePublic: properties: description: type: string maxLength: 512 title: Description description: The description of the line item examples: - Web development services ledger_id: anyOf: - type: string format: ldg_string - type: 'null' title: Ledger Id description: The ID of the ledger that the line item is associated with examples: - ldg_ErisumsAc7qgmbTctM7zKK amount: type: number title: Amount description: The amount of the line item examples: - 520.56 metadata: anyOf: - additionalProperties: true type: object - type: 'null' title: Metadata id: type: string format: inl_string title: Id description: The ID of the invoice line examples: - inl_GkBo16N66u2teKfFuFMMwf invoice_id: type: string format: inv_string title: Invoice Id description: The ID of the invoice that the line item is associated with examples: - inv_WQMDNUHpBThYSNh4AprDBo type: object required: - description - ledger_id - amount - id - invoice_id title: InvoiceLinePublic TagValueInput-Output: properties: value: type: string title: Value description: The tag value (option string) examples: - NYC amount: anyOf: - type: number - type: 'null' title: Amount description: >- Portion of the source object allocated to this tag value. If omitted: with one value on a field the full source amount is used; with multiple values on a field the amount is split evenly. Mixed (some amounts set, some omitted) is rejected. examples: - '75.00' type: object required: - value title: TagValueInput BillStatus: type: string enum: - open - paid - voided title: BillStatus BillLinePublic: properties: description: type: string maxLength: 512 title: Description description: The description of the line item examples: - Cleaning services ledger_id: anyOf: - type: string format: ldg_string - type: 'null' title: Ledger Id description: The ID of the ledger that the line item is associated with examples: - ldg_ErisumsAc7qgmbTctM7zKK amount: type: number title: Amount description: The amount of the line item examples: - 120.52 metadata_: anyOf: - additionalProperties: true type: object - type: 'null' title: Metadata id: type: string format: bln_string title: Id description: The ID of the bill line examples: - bln_GkBo16N66u2teKfFuFMMwf bill_id: type: string format: bil_string title: Bill Id description: The ID of the bill that the line item is associated with examples: - bil_WxcM3ypJ5boFxsNQzcqRXe type: object required: - description - ledger_id - amount - id - bill_id title: BillLinePublic securitySchemes: OAuth2PasswordBearer: type: oauth2 flows: password: scopes: {} tokenUrl: /v0/auth/token ````