> ## Documentation Index
> Fetch the complete documentation index at: https://docs.equated.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Get one transaction

> Returns a single transaction by its provider-assigned ID (the ID from the bank feed, exposed as `providerTransactionId` in the list response). Includes postings, journal entries, linked documents, and transfer links.



## OpenAPI

````yaml /openapi.json get /api/transactions/{providerTransactionId}
openapi: 3.1.0
info:
  title: Equated API
  version: 1.0.0
  description: >-
    Agent-facing accounting API. Authenticate with a bearer token issued from
    Settings → API Tokens, or via the in-app session cookie when called from the
    web client.
servers:
  - url: https://app.equated.co
    description: API server
security: []
paths:
  /api/transactions/{providerTransactionId}:
    get:
      tags:
        - Transactions
      summary: Get one transaction
      description: >-
        Returns a single transaction by its provider-assigned ID (the ID from
        the bank feed, exposed as `providerTransactionId` in the list response).
        Includes postings, journal entries, linked documents, and transfer
        links.
      parameters:
        - schema:
            type: string
          required: true
          name: providerTransactionId
          in: path
      responses:
        '200':
          description: Transaction detail
          content:
            application/json:
              schema:
                type: object
                properties:
                  transaction:
                    $ref: '#/components/schemas/TransactionDetail'
                required:
                  - transaction
        '404':
          description: Not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
      security:
        - bearerAuth: []
components:
  schemas:
    TransactionDetail:
      allOf:
        - $ref: '#/components/schemas/TransactionSummary'
        - type: object
          properties:
            matchedDocuments:
              type: array
              items:
                $ref: '#/components/schemas/MatchedDocumentRelation'
          required:
            - matchedDocuments
          additionalProperties:
            nullable: true
    TransactionSummary:
      type: object
      properties:
        id:
          type: integer
          minimum: 0
          exclusiveMinimum: true
        providerTransactionId:
          type: string
        accountId:
          type: integer
          minimum: 0
          exclusiveMinimum: true
        name:
          type: string
        amount:
          type: string
        isoCurrencyCode:
          type: string
          nullable: true
        date:
          type: string
        status:
          type: string
        postingStatus:
          type: string
          enum:
            - UNSTAGED
            - DRAFT
            - POSTED
        orgMerchantId:
          type: integer
          nullable: true
          minimum: 0
          exclusiveMinimum: true
        merchant:
          type: object
          nullable: true
          properties:
            id:
              type: integer
              minimum: 0
              exclusiveMinimum: true
            name:
              type: string
            website:
              type: string
              nullable: true
          required:
            - id
            - name
            - website
          additionalProperties:
            nullable: true
        categoryAccountId:
          type: integer
          nullable: true
          minimum: 0
          exclusiveMinimum: true
        categoryAccountName:
          type: string
          nullable: true
        accountName:
          type: string
          nullable: true
        amountBase:
          type: string
          nullable: true
        baseCurrency:
          type: string
          nullable: true
        linkedDocumentTypes:
          type: array
          items:
            type: string
      required:
        - id
        - providerTransactionId
        - accountId
        - name
        - amount
        - isoCurrencyCode
        - date
        - status
        - postingStatus
        - orgMerchantId
        - merchant
        - categoryAccountId
        - categoryAccountName
        - accountName
        - amountBase
        - baseCurrency
      additionalProperties:
        nullable: true
    MatchedDocumentRelation:
      type: object
      properties:
        id:
          type: integer
          minimum: 0
          exclusiveMinimum: true
        documentType:
          type: string
        fileName:
          type: string
          nullable: true
        documentNumber:
          type: string
          nullable: true
        amount:
          type: string
          nullable: true
        currency:
          type: string
          nullable: true
        relationId:
          type: integer
          minimum: 0
          exclusiveMinimum: true
        relationType:
          type: string
          enum:
            - evidence
            - enrichment_source
            - accrual
            - settlement
            - credit_application
        fxJournalEntryId:
          type: integer
          nullable: true
          minimum: 0
          exclusiveMinimum: true
        paymentAmountBase:
          type: string
          nullable: true
        realizedFxBase:
          type: string
          nullable: true
      required:
        - id
        - documentType
        - fileName
        - documentNumber
        - amount
        - currency
        - relationId
        - relationType
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API token issued from the Equated app under Settings → API Tokens.

````