> ## Documentation Index > Fetch the complete documentation index at: https://commet.co/docs/llms.txt > Use this file to discover all available pages before exploring further. # Get transaction > Retrieve a single payment transaction by its public ID, including provider details. Retrieve a single payment transaction by its public ID, including provider details. ## OpenAPI ````yaml /openapi/es/rest/2026-08-27.json get /transactions/{id} openapi: 3.1.0 info: title: Commet API version: '2026-08-27' description: Billing and payments API for SaaS and AI products. servers: - url: https://commet.co/api/v1 security: - ApiKeyAuth: [] tags: - name: Test Clock description: >- Simulate the passage of time in sandbox to test billing flows. Mirrors Stripe test clocks: forward-only and sandbox-only. - name: Customers - name: Subscriptions - name: Plans - name: Markets description: >- Reusable country groups for market-specific prices and selectable price variants. - name: Offers - name: Promo Codes - name: Features - name: Usage - name: Seats - name: Quota - name: Add-ons - name: Portal - name: Credit Packs - name: Plan Groups - name: Invoices - name: Payments description: >- One-time payments with no subscription or plan. Charge a customer's saved payment method off-session, or create a payment link the customer opens to pay. Tax, invoice, and receipt are handled automatically. - name: Transactions - name: Webhooks - name: API Keys - name: Payouts description: >- Withdraw available balance to your bank and manage the payout account (verification + destination bank accounts). - name: Provisioning description: >- Take ownership of an organization an agent provisioned headlessly. The agent holds the API keys from the start; a human claims the account through a claim link. paths: /transactions/{id}: get: tags: - Transactions summary: Get transaction description: >- Retrieve a single payment transaction by its public ID, including provider details. operationId: get-transaction parameters: - name: id in: path required: true schema: type: string - name: Commet-Version in: header required: false description: >- API version used by this reference. Send this header to select this contract explicitly. schema: type: string default: '2026-08-27' example: '2026-08-27' responses: '200': description: Success headers: X-Request-Id: $ref: '#/components/headers/RequestId' RateLimit-Limit: description: Maximum number of requests allowed in the current window. schema: type: string RateLimit-Remaining: description: Requests remaining in the current window. schema: type: string content: application/json: schema: $ref: '#/components/schemas/Transaction' example: id: txn_1a2b3c4d invoiceId: inv_1a2b3c4d grossAmount: 2000 subtotal: 2000 taxAmount: 0 presentmentAmount: 2000 currency: usd provider: commet status: succeeded customerEmail: user@example.com customerName: user@example.com paidAt: '2026-09-07T12:00:00.000Z' createdAt: '2026-09-07T12:00:00.000Z' updatedAt: '2026-09-07T12:00:00.000Z' availableAt: null object: transaction livemode: false paymentContext: reason: recurring_billing paymentLinkId: null recovery: null '400': description: Bad request headers: X-Request-Id: $ref: '#/components/headers/RequestId' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: type: validation_error code: validation_error message: The request contains an invalid parameter. doc_url: >- https://commet.co/docs/api-reference/2026-08-27/errors/validation_error.md '401': description: Unauthorized headers: X-Request-Id: $ref: '#/components/headers/RequestId' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: type: authentication_error code: unauthorized message: A valid API key is required. doc_url: >- https://commet.co/docs/api-reference/2026-08-27/errors/unauthorized.md '403': description: Forbidden headers: X-Request-Id: $ref: '#/components/headers/RequestId' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: type: authentication_error code: forbidden message: You do not have permission to perform this operation. doc_url: >- https://commet.co/docs/api-reference/2026-08-27/errors/forbidden.md '404': description: Not found headers: X-Request-Id: $ref: '#/components/headers/RequestId' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: type: not_found_error code: not_found message: The requested resource was not found. doc_url: >- https://commet.co/docs/api-reference/2026-08-27/errors/not_found.md '429': description: Too many requests headers: X-Request-Id: $ref: '#/components/headers/RequestId' RateLimit-Limit: description: Maximum number of requests allowed in the current window. schema: type: string RateLimit-Remaining: description: Requests remaining in the current window. schema: type: string RateLimit-Reset: description: Seconds until the rate limit window resets. schema: type: string Retry-After: description: Seconds to wait before retrying the request. schema: type: string content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: type: rate_limit_error code: rate_limited message: >- Too many requests. Retry after the interval specified in the Retry-After header. doc_url: >- https://commet.co/docs/api-reference/2026-08-27/errors/rate_limited.md '500': description: Internal server error headers: X-Request-Id: $ref: '#/components/headers/RequestId' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: type: internal_error code: internal_error message: An unexpected error occurred while processing the request. doc_url: >- https://commet.co/docs/api-reference/2026-08-27/errors/internal_error.md x-codeSamples: - lang: typescript label: TypeScript source: >- import { Commet } from "@commet/node"; const commet = new Commet({ apiKey: "ck_xxx" }); const transaction = await commet.transactions.get({ id: "transaction_xxx" }); - lang: python label: Python source: |- from commet import Commet commet = Commet("ck_xxx") transaction = commet.transactions.get("transaction_xxx") - lang: go label: Go source: "client, err := commet.New(\"ck_xxx\")\nif err != nil {\n\tlog.Fatal(err)\n}\nctx := context.Background()\n\ntransaction, err := client.Transactions.Get(ctx, \"transaction_xxx\")\nif err != nil {\n\tlog.Fatal(err)\n}" - lang: java label: Java source: |- import co.commet.Commet; var commet = Commet.builder().apiKey("ck_xxx").build(); var transaction = commet.transactions().get("transaction_xxx"); - lang: php label: PHP source: |- use Commet\Commet; $commet = new Commet('ck_xxx'); $transaction = $commet->transactions->get(id: 'transaction_xxx'); components: headers: RequestId: description: >- Server-generated identifier that correlates this response with Platform logs. schema: type: string format: uuid schemas: Transaction: type: object properties: paymentContext: anyOf: - type: object properties: reason: type: string enum: - first_subscription_payment - trial_conversion - recurring_billing - plan_change - reactivation - subscription_resume - one_time_payment - overage - adjustment description: >- The original reason for the charge. Recovery never replaces this reason. paymentLinkId: anyOf: - type: string - type: 'null' description: >- The public payment link ID, independently of the reason, or null when no payment link originated the charge. recovery: anyOf: - oneOf: - type: object properties: type: type: string const: payment_recovery required: - type additionalProperties: false - type: object properties: type: type: string const: dunning_retry attempt: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 description: >- Current retry, starting at 1. The original decline is not a retry. maxAttempts: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 description: >- Total retries applicable to this charge's dunning schedule. required: - type - attempt - maxAttempts additionalProperties: false - type: 'null' required: - reason - paymentLinkId - recovery additionalProperties: false - type: 'null' description: >- Charge context captured for new payments. Null for historical payments with no captured context. id: type: string invoiceId: anyOf: - type: string - type: 'null' grossAmount: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: >- Gross amount in USD cents. Null when the provider has not reported an honest USD figure; see presentmentAmount. subtotal: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: >- Subtotal in USD cents (gross minus tax). Null when grossAmount is null. taxAmount: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' presentmentAmount: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: >- Amount in the charge currency's smallest unit, as presented to the customer. Set for non-USD charges; null when the charge was made in USD. currency: type: string provider: $ref: '#/components/schemas/PaymentProvider' description: >- The payment provider the charge was routed to: stripe, commet, or dlocal. paymentMethod: anyOf: - $ref: '#/components/schemas/PaymentMethod' - type: 'null' description: >- The method used for this charge: card, oxxo, or mercado_pago. Null when unknown. subPaymentMethod: anyOf: - $ref: '#/components/schemas/SubPaymentMethod' - type: 'null' description: >- The source of funds for this charge, when reported by the provider. Null when unavailable or unknown. status: $ref: '#/components/schemas/TransactionStatus' customerEmail: anyOf: - type: string - type: 'null' customerName: anyOf: - type: string - type: 'null' paidAt: anyOf: - type: string format: date-time - type: 'null' createdAt: type: string format: date-time updatedAt: type: string format: date-time availableAt: anyOf: - type: string format: date-time - type: 'null' object: type: string const: transaction livemode: type: boolean required: - paymentContext - id - invoiceId - grossAmount - subtotal - taxAmount - presentmentAmount - currency - provider - paymentMethod - subPaymentMethod - status - customerEmail - customerName - paidAt - createdAt - updatedAt - availableAt - object - livemode additionalProperties: false ErrorResponse: type: object properties: error: type: object properties: type: type: string code: type: string message: type: string param: type: string details: {} doc_url: type: string required: - type - code - message - doc_url additionalProperties: false required: - error additionalProperties: false PaymentProvider: type: string enum: - stripe - commet - dlocal PaymentMethod: type: string enum: - card - oxxo - mercado_pago SubPaymentMethod: type: string enum: - credit_card - debit_card - prepaid_card - bank_transfer - account_money TransactionStatus: type: string enum: - pending - succeeded - failed - refunded - disputed securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key ```` ## Related topics - [List transactions](/docs/es/api-reference/transactions/list-transactions.md) - [Retry transaction](/docs/es/api-reference/transactions/retry-transaction.md) - [Refund transaction](/docs/es/api-reference/transactions/refund-transaction.md) - [transaction_not_found](/docs/es/api-reference/errors/transaction_not_found.md) - [Get market](/docs/es/api-reference/markets/get-market.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.