> ## Documentation Index > Fetch the complete documentation index at: https://docs.services.payward.com/llms.txt > Use this file to discover all available pages before exploring further. # List conversion transactions > Lists transactions produced by a single conversion, ordered by `created_at` descending. Each conversion (rule) accumulates zero-or-more transactions over its lifetime as deposits arrive and trades execute. Use `ListConversions` to enumerate the rules themselves. ## OpenAPI ````yaml /api-reference/openapi_v3_pws.json get /v1/accounts/{account_id}/conversions/{conversion_id}/transactions openapi: 3.1.0 info: title: Payward Services API description: >- The Payward Services (PWS) public API. PWS exposes Swaps (institutional FX-style trading), Conversions (rule-driven and one-shot fiat ↔ crypto value movement), retail-style Quotes and Price Trigger Swaps, end-user Users / Verifications, Funds (deposits, withdrawals, addresses, transactions), Portfolio, Earn, Reports, Webhooks, and Ramp (hosted fiat-to-crypto on-ramp checkout). All requests must be authenticated. All monetary values are decimal strings; all timestamps are ISO 8601 UTC. List endpoints are cursor-paginated. Errors follow a uniform shape (see `*ErrorResponse` schemas). version: v1 contact: name: Payward Services API Support url: https://docs.payward.com email: api-support@payward.com servers: - url: https://api.services.payward.com description: Production security: - ApiKey: [] ApiNonce: [] ApiSign: [] tags: - name: Users description: >- Users and headless-user onboarding flows that the partner manages. - **Create User** provisions a user with full identity verification fields collected up front. - **Create Headless User** provisions a lightweight user when your licensing agreement allows you to manage KYC data outside Payward. - **Get User** retrieves the user's profile, verification status, and required actions. - **Update User** updates user profile fields and may re-trigger verification. Use the returned user `id` for calls that require the user's identifier. - name: Assets description: >- Catalog of assets available on the platform with retail-display metadata (logos, market data, descriptions). - name: Conversions description: >- Rule-driven and one-shot fiat ↔ crypto value movement, including conversion rules, deposits, and whitelisted wallets. - name: Earn description: >- Manage auto-earn preferences and retrieve allocation and reward information. - name: Funds description: >- Deposits, withdrawals, addresses, methods, and the consolidated funding-transactions ledger. - name: Portfolio description: End-user portfolio summary, history, and transaction views. - name: Price Trigger Swaps description: Limit-style orders that execute when a configured price trigger is met. - name: On-chain Swaps description: >- Wallet-funded onchain quote trading for xStock and USDC pairs. On-chain quotes settle on-chain through the Payward on-chain proxy contract. - name: Ramp description: >- Hosted fiat-to-crypto on-ramp checkout: country / fiat / payment-method / cryptocurrency-asset discovery, transaction limits and prospective quotes, and the hosted checkout URL. - name: Reports description: Settlement and reconciliation reports for the partner. - name: Swaps description: >- Direct partner-to-Payward swap quotes and executions (institutional FX-style trading). - name: Verifications description: Identity verification (KYC) submission and status for end users. - name: Webhooks description: Manage webhook subscriptions for asynchronous event delivery. paths: /v1/accounts/{account_id}/conversions/{conversion_id}/transactions: get: tags: - Conversions summary: List conversion transactions description: |- Lists transactions produced by a single conversion, ordered by `created_at` descending. Each conversion (rule) accumulates zero-or-more transactions over its lifetime as deposits arrive and trades execute. Use `ListConversions` to enumerate the rules themselves. operationId: listConversionTransactions parameters: - in: path name: account_id required: true schema: description: >- Internet International Bank Account Number identifying the PWS account the conversion belongs to. type: string minLength: 14 maxLength: 42 style: simple example: AA23N84GGQN4WE6I - in: path name: conversion_id required: true schema: description: Identifier of the conversion whose transactions to list. type: string format: uuid style: simple example: 12345678-1234-1234-1234-123456789012 - in: query name: page_size schema: description: >- Maximum number of results to return on a single page. Defaults to 20, maximum 25. type: integer format: int32 minimum: 1 maximum: 25 default: 20 style: form example: 20 - in: query name: page_token schema: description: >- Opaque cursor returned by a previous response's `next_page_token`. Omit to start from the beginning. type: string minLength: 1 maxLength: 256 style: form example: MjoyRHuBXSgoe0mDHt-iFALROW46EGdvk_trgja31Vwr7H4 responses: '200': description: Successful response content: application/json: schema: type: object properties: data: description: >- Per-transaction summaries on this page, ordered by `created_at` descending. type: array items: description: >- Per-transaction summary returned by `ListConversionTransactions`. type: object properties: id: description: Unique identifier for this transaction. type: string status: description: Lifecycle state of the transaction. type: string enum: - pending_deposit - converting - settling - completed - failed - held conversion_rule_id: description: >- Identifier of the conversion that produced this transaction. type: string from: description: >- Source side: asset symbol/amount and funding rail. Absent on in-progress transactions before the inbound deposit has been observed. type: object properties: symbol: description: >- Asset ticker symbol of the source side (e.g. "EUR"). type: string amount: description: >- Decimal amount once the deposit has been observed. type: string type: description: Endpoint type (wallet, bank, balance). type: string enum: - wallet - bank via: description: >- Rail or network identifier (e.g. "ethereum", "sepa"). type: string status: description: Status of the inbound deposit. type: string enum: - pending - held - settled - failed title: ConversionSettlementStatus required: - amount - type - status title: ConversionSummaryFrom to: description: >- Destination side: asset symbol/amount and settlement rail. Absent on in-progress transactions before the outbound trade has produced withdrawal data. type: object properties: symbol: description: >- Asset ticker symbol of the destination side (e.g. "BTC"). type: string amount: description: Decimal amount once the trade has filled. type: string status: description: Status of the outbound withdrawal. type: string enum: - pending - held - settled - failed via: description: >- Rail or network identifier (e.g. "bitcoin", "sepa"). type: string required: - amount - status title: ConversionSummaryTo chain_references: description: >- On-chain transaction references for inbound and outbound legs. type: object properties: deposit_txid: description: Inbound (deposit) transaction ID. type: string withdraw_txid: description: Outbound (withdrawal) transaction ID. type: string title: ChainReferences created_at: $ref: '#/components/schemas/google.protobuf.Timestamp' required: - status - conversion_rule_id - chain_references - created_at title: ConversionSummary next_page_token: description: >- Opaque cursor for the next page of results. Absent when there are no more pages. type: string required: - data examples: id-list-conversion-transactions-ok: summary: >- ListConversionTransactions returns the parrot-stubbed transaction summaries value: data: - id: conv_smoke_001 status: completed conversion_rule_id: 12345678-1234-1234-1234-123456789012 from: symbol: EUR amount: '100.00' type: bank via: sepa status: settled to: symbol: BTC amount: '0.002' status: settled via: bitcoin chain_references: deposit_txid: deposit-eur-001 withdraw_txid: withdraw-btc-001 created_at: '2026-04-01T12:00:00Z' - id: conv_smoke_002 status: pending_deposit conversion_rule_id: 12345678-1234-1234-1234-123456789012 chain_references: {} created_at: '2026-04-02T09:30:00Z' - id: conv_smoke_003 status: held conversion_rule_id: 12345678-1234-1234-1234-123456789012 from: symbol: EUR amount: '250.00' type: bank via: sepa status: held chain_references: deposit_txid: deposit-held-001 created_at: '2026-04-03T14:15:00Z' '400': description: Validation error content: application/json: schema: $ref: '#/components/schemas/BadRequestError' '401': description: Authentication required content: application/json: schema: $ref: '#/components/schemas/UnauthenticatedError' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/ForbiddenError' '404': description: Not found content: application/json: schema: $ref: '#/components/schemas/ConversionsNotFoundErrorResponse' '429': description: Rate limit exceeded content: application/json: schema: $ref: '#/components/schemas/ResourceExhaustedError' '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/InternalError' '501': description: Error response content: application/json: schema: $ref: '#/components/schemas/UnimplementedError' '503': description: Service unavailable content: application/json: schema: $ref: '#/components/schemas/UnavailableError' '504': description: Deadline exceeded content: application/json: schema: $ref: '#/components/schemas/DeadlineExceededError' security: - ApiKey: [] ApiNonce: [] ApiSign: [] components: schemas: google.protobuf.Timestamp: description: RFC 3339 timestamp. type: string format: date-time BadRequestError: description: Request validation failed or the request could not be processed. allOf: - $ref: '#/components/schemas/PwsValidationErrorEnvelope' - type: object required: - error properties: error: allOf: - $ref: '#/components/schemas/PwsValidationError' - type: object required: - status - code properties: status: type: integer format: int32 enum: - 400 code: type: string enum: - bad_request UnauthenticatedError: description: Authentication credentials are missing, invalid, or not accepted. allOf: - $ref: '#/components/schemas/PwsGeneralErrorEnvelope' - type: object required: - error properties: error: allOf: - $ref: '#/components/schemas/PwsGeneralError' - type: object required: - status - code properties: status: type: integer format: int32 enum: - 401 code: type: string enum: - unauthenticated ForbiddenError: description: The authenticated caller is not allowed to perform this operation. allOf: - $ref: '#/components/schemas/PwsGeneralErrorEnvelope' - type: object required: - error properties: error: allOf: - $ref: '#/components/schemas/PwsGeneralError' - type: object required: - status - code properties: status: type: integer format: int32 enum: - 403 code: type: string enum: - forbidden ConversionsNotFoundErrorResponse: description: The requested resource does not exist. allOf: - $ref: '#/components/schemas/PwsGeneralErrorEnvelope' - type: object required: - error properties: error: allOf: - $ref: '#/components/schemas/PwsGeneralError' - type: object required: - status - code properties: status: type: integer format: int32 enum: - 404 code: type: string enum: - not_found ResourceExhaustedError: description: The request was rate limited or a resource quota was exhausted. allOf: - $ref: '#/components/schemas/PwsGeneralErrorEnvelope' - type: object required: - error properties: error: allOf: - $ref: '#/components/schemas/PwsGeneralError' - type: object required: - status - code properties: status: type: integer format: int32 enum: - 429 code: type: string enum: - resource_exhausted InternalError: description: An unexpected server-side error occurred. allOf: - $ref: '#/components/schemas/PwsGeneralErrorEnvelope' - type: object required: - error properties: error: allOf: - $ref: '#/components/schemas/PwsGeneralError' - type: object required: - status - code properties: status: type: integer format: int32 enum: - 500 code: type: string enum: - internal UnimplementedError: description: The operation is not implemented by the upstream service. allOf: - $ref: '#/components/schemas/PwsGeneralErrorEnvelope' - type: object required: - error properties: error: allOf: - $ref: '#/components/schemas/PwsGeneralError' - type: object required: - status - code properties: status: type: integer format: int32 enum: - 501 code: type: string enum: - unimplemented UnavailableError: description: The service is temporarily unavailable. allOf: - $ref: '#/components/schemas/PwsGeneralErrorEnvelope' - type: object required: - error properties: error: allOf: - $ref: '#/components/schemas/PwsGeneralError' - type: object required: - status - code properties: status: type: integer format: int32 enum: - 503 code: type: string enum: - unavailable DeadlineExceededError: description: The upstream service did not complete the request before the deadline. allOf: - $ref: '#/components/schemas/PwsGeneralErrorEnvelope' - type: object required: - error properties: error: allOf: - $ref: '#/components/schemas/PwsGeneralError' - type: object required: - status - code properties: status: type: integer format: int32 enum: - 504 code: type: string enum: - deadline_exceeded PwsValidationErrorEnvelope: description: Error envelope for request validation failures. type: object required: - error properties: error: $ref: '#/components/schemas/PwsValidationError' PwsValidationError: description: Standard PWS API error object for request validation failures. type: object required: - type - status - instance - code properties: type: description: Machine-readable error class. type: string status: description: HTTP status code returned for this error. type: integer format: int32 instance: description: Request identifier for this specific error occurrence. type: string code: description: Stable machine-readable error code. type: string doc_url: description: Optional link to documentation for this error. type: string format: uri causes: description: Validation failures that contributed to the error. type: array items: $ref: '#/components/schemas/PwsErrorCause' PwsGeneralErrorEnvelope: description: Error envelope for operational or domain failures. type: object required: - error properties: error: $ref: '#/components/schemas/PwsGeneralError' PwsGeneralError: description: Standard PWS API error object for non-validation failures. allOf: - $ref: '#/components/schemas/PwsErrorBase' - type: object properties: causes: description: Additional error details, when present. type: array items: type: object additionalProperties: true PwsErrorCause: description: A single request validation failure. type: object required: - field - message properties: field: description: Dot-notation path to the offending request field. type: string message: description: Human-readable explanation of the failed validation rule. type: string PwsErrorBase: description: Common fields present on every PWS API error object. type: object required: - type - status - instance - code properties: type: description: Machine-readable error class. type: string status: description: HTTP status code returned for this error. type: integer format: int32 instance: description: Request identifier for this specific error occurrence. type: string code: description: Stable machine-readable error code. type: string doc_url: description: Optional link to documentation for this error. type: string format: uri securitySchemes: ApiKey: type: apiKey name: API-Key in: header description: Your public API key. Identifies the partner making the request. ApiNonce: type: apiKey name: API-Nonce in: header description: Monotonically increasing nonce included in the request signature. ApiSign: type: apiKey name: API-Sign in: header description: HMAC signature over the request, computed with your private key. ````