> For the complete documentation index, see [llms.txt](https://docs.intents.aurora.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.intents.aurora.dev/api-reference/confidential-swaps-api-reference/get-transaction-history.md). # Get transaction history ## GET /api/account/history/{apiKey} > Get paginated transaction history for the authenticated user. Requires the user session token (JWT) issued by the authenticate endpoint, passed as \`Authorization: Bearer \\`. For the initial request, omit both cursors to retrieve the latest history; for subsequent requests, pass either \`nextCursor\` (newer) or \`prevCursor\` (older). ```json {"openapi":"3.0.3","info":{"title":"@aurora-is-near/intents-fee-service","version":"0.0.1"},"servers":[{"url":"https://intents-api.aurora.dev"}],"security":[],"paths":{"/api/account/history/{apiKey}":{"get":{"tags":["account"],"description":"Get paginated transaction history for the authenticated user. Requires the user session token (JWT) issued by the authenticate endpoint, passed as `Authorization: Bearer `. For the initial request, omit both cursors to retrieve the latest history; for subsequent requests, pass either `nextCursor` (newer) or `prevCursor` (older).","parameters":[{"schema":{"type":"string"},"in":"query","name":"prevCursor","required":false,"description":"Pass the `prevCursor` value from a previous response to fetch older items. Omit both cursors for the initial request. Do not pass together with `nextCursor`."},{"schema":{"type":"string"},"in":"query","name":"nextCursor","required":false,"description":"Pass the `nextCursor` value from a previous response to poll for newer items. Omit both cursors for the initial request. Do not pass together with `prevCursor`."},{"schema":{"type":"array","items":{"type":"string","enum":["PENDING_DEPOSIT","INCOMPLETE_DEPOSIT","PROCESSING","SUCCESS","REFUNDED","FAILED"]}},"in":"query","name":"status","required":true,"description":"Filter by one or more execution statuses."},{"schema":{"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false,"description":"Maximum number of items to return per page."},{"schema":{"type":"string"},"in":"query","name":"depositAddress","required":false,"description":"Filter by deposit address."},{"schema":{"type":"string"},"in":"query","name":"depositMemo","required":false,"description":"Filter by deposit memo. Only has effect when `depositAddress` is also provided."},{"schema":{"type":"string"},"in":"query","name":"search","required":false,"description":"Search by deposit address, recipient, sender, or tx hash."},{"schema":{"type":"array","items":{"type":"string","enum":["ORIGIN_CHAIN","INTENTS","CONFIDENTIAL_INTENTS"]}},"in":"query","name":"depositType","required":true,"description":"Filter by one or more deposit types."},{"schema":{"type":"array","items":{"type":"string","enum":["DESTINATION_CHAIN","INTENTS","CONFIDENTIAL_INTENTS"]}},"in":"query","name":"recipientType","required":true,"description":"Filter by one or more recipient types."},{"schema":{"type":"array","items":{"type":"string","enum":["ORIGIN_CHAIN","INTENTS","CONFIDENTIAL_INTENTS"]}},"in":"query","name":"refundType","required":true,"description":"Filter by one or more refund types."},{"schema":{"type":"string"},"in":"path","name":"apiKey","required":true,"description":"API key generated at [https://studio.aurora.dev](https://studio.aurora.dev)"}],"responses":{"200":{"description":"Transaction history retrieved successfully","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"status":{"type":"string","enum":["PENDING_DEPOSIT","INCOMPLETE_DEPOSIT","PROCESSING","SUCCESS","REFUNDED","FAILED"],"description":"Execution status of the swap."},"depositType":{"type":"string","enum":["ORIGIN_CHAIN","INTENTS","CONFIDENTIAL_INTENTS"],"description":"Type of deposit address."},"recipientType":{"type":"string","enum":["DESTINATION_CHAIN","INTENTS","CONFIDENTIAL_INTENTS"],"description":"Type of recipient address."},"createdAt":{"type":"string","description":"Creation timestamp in ISO 8601 format."},"depositAddress":{"type":"string","description":"Deposit address for the swap."},"depositMemo":{"description":"Deposit memo, when the deposit chain requires one.","nullable":true,"type":"string"},"originAsset":{"description":"ID of the origin asset.","type":"string"},"amountInFormatted":{"description":"Human-readable input amount.","type":"string"},"amountInUsd":{"description":"Estimated USD value of the input amount.","type":"string"},"destinationAsset":{"description":"ID of the destination asset.","type":"string"},"amountOutFormatted":{"description":"Human-readable output amount.","type":"string"},"amountOutUsd":{"description":"Estimated USD value of the output amount.","type":"string"},"recipient":{"description":"Recipient address.","type":"string"},"quoteTransactions":{"description":"Deposit transactions with sender and tx hash.","type":"array","items":{"type":"object","properties":{"sender":{"description":"Sender address of the deposit transaction.","type":"string"},"txHash":{"description":"Transaction hash of the deposit.","type":"string"}},"additionalProperties":false}},"refundTo":{"description":"Address used for refunds.","type":"string"},"refundType":{"type":"string","enum":["ORIGIN_CHAIN","INTENTS","CONFIDENTIAL_INTENTS"],"description":"Type of refund address."},"refundReason":{"description":"Reason for the refund, null when no refund occurred.","nullable":true,"type":"string"},"refundedAmountFormatted":{"description":"Human-readable refunded amount.","type":"string"},"refundedAmountUsd":{"description":"Estimated USD value of the refunded amount.","type":"string"},"refundFee":{"description":"Refund fee in the smallest unit of the origin asset.","nullable":true,"type":"string"},"refundFeeFormatted":{"description":"Human-readable refund fee.","type":"string"}},"required":["status","depositType","recipientType","createdAt","depositAddress","refundType"],"additionalProperties":false},"description":"Transaction history items for the current page."},"nextCursor":{"description":"Pass it back as `nextCursor` to poll for newer items.","type":"string"},"prevCursor":{"description":"Pass it back as `prevCursor` to fetch older items.","type":"string"}},"required":["items"],"additionalProperties":false,"description":"Transaction history retrieved successfully"}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"message":{"type":"string","description":"Error message returned by the upstream quote API."},"correlationId":{"type":"string","description":"Unique identifier for request tracing and debugging."},"timestamp":{"type":"string","description":"Timestamp in ISO format when the error response was generated."},"path":{"type":"string","description":"API path associated with the failed request."}},"required":["message","correlationId","timestamp","path"],"additionalProperties":false,"description":"API error or invalid request parameters"},{"type":"object","properties":{"message":{"type":"string"},"error":{"type":"string"},"data":{"type":"object","additionalProperties":{}},"statusCode":{"type":"number"}},"required":["message","statusCode"],"additionalProperties":false}]}}}},"401":{"description":"User session token is invalid or expired","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"error":{"type":"string"},"data":{"type":"object","additionalProperties":{}},"statusCode":{"type":"number","enum":[401]}},"required":["message","statusCode"],"additionalProperties":false,"description":"User session token is invalid or expired"}}}},"500":{"description":"Internal Server Error - Failed to reach the account service","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"error":{"type":"string"},"data":{"type":"object","additionalProperties":{}},"statusCode":{"type":"number","enum":[500]}},"required":["message","statusCode"],"additionalProperties":false,"description":"Internal Server Error - Failed to reach the account service"}}}}}}}}} ``` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.intents.aurora.dev/api-reference/confidential-swaps-api-reference/get-transaction-history.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.