> 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/persistent-addresses-api-reference/get-persistent-address-data.md).

# Get persistent address data

## GET /api/persistent-deposit-addresses/{apiKey}

> Returns a paginated, filterable, sortable list of the persistent deposit addresses created with this API key. Use \`/api/persistent-deposit-address-data/:apiKey\` to fetch a single address by its value.

```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/persistent-deposit-addresses/{apiKey}":{"get":{"tags":["deposit"],"description":"Returns a paginated, filterable, sortable list of the persistent deposit addresses created with this API key. Use `/api/persistent-deposit-address-data/:apiKey` to fetch a single address by its value.","parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"recipient","required":false,"description":"Filter by exact recipient (destination chain address)."},{"schema":{"type":"string","minLength":1},"in":"query","name":"sender","required":false,"description":"Filter by exact sender (the integrator-supplied user id)."},{"schema":{"type":"string","enum":["sui","xrp","btc","doge","tron","ton","near","sol","zec","ltc","cardano","stellar","aleo","bch","dash","starknet","coca","evm"]},"in":"query","name":"depositChain","required":false,"description":"Filter by deposit chain. A non-EVM shortcut (e.g. \"near\", \"sol\", \"btc\") matches that chain exactly; the special value \"evm\" matches addresses created on any EVM chain."},{"schema":{"type":"string","enum":["eth","bera","base","gnosis","arb","bsc","avax","op","pol","monad","adi","plasma","scroll","xlayer","sui","xrp","btc","doge","tron","ton","near","sol","zec","ltc","cardano","stellar","aleo","bch","dash","starknet","coca"]},"in":"query","name":"recipientChain","required":false,"description":"Filter by the chain the funds are received on (any shortcut, EVM chains separately). Resolved against the tokens list: matches addresses whose destination asset lives on this chain."},{"schema":{"type":"string","minLength":1},"in":"query","name":"destinationAsset","required":false,"description":"Filter by destination token SYMBOL (e.g. \"USDC\"). When a symbol maps to multiple asset ids, addresses for ALL of them are returned."},{"schema":{"default":"created","type":"string","enum":["created","used"]},"in":"query","name":"sort","required":false,"description":"Sort order (newest first). \"created\" sorts by created_at then last_time_used; \"used\" sorts by last_time_used then created_at."},{"schema":{"default":1,"type":"integer","exclusiveMinimum":true,"maximum":9007199254740991},"in":"query","name":"page","required":false,"description":"1-based page number. Default: 1."},{"schema":{"default":50,"type":"integer","exclusiveMinimum":true,"maximum":1000},"in":"query","name":"perPage","required":false,"description":"Items per page. Default: 50. Max: 1000."},{"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":"A paginated page of deposit address records","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"depositAddress":{"type":"string","description":"Chain-specific deposit address."},"recipient":{"type":"string","description":"Target address on the destination chain."},"sender":{"type":"string","description":"Integrator-supplied user id the address was generated for."},"depositChain":{"nullable":true,"description":"Deposit chain in shortcut format. EVM chains share one address, so any EVM deposit chain is reported as the single value \"evm\".","type":"string"},"destinationSymbol":{"nullable":true,"description":"Symbol of the destination asset the address is bound to. Null for legacy rows whose asset could not be resolved.","type":"string"},"recipientChain":{"nullable":true,"description":"Chain the funds are received on (the chain the destination asset lives on), in shortcut format. Null for legacy rows whose asset could not be resolved.","type":"string"},"memo":{"description":"Deposit memo required by some chains (currently only Stellar). Deposits to this address on such chains MUST include it. Omitted for chains that do not use a memo.","type":"string"},"createdAt":{"type":"string","description":"When the address was first created (ISO 8601)."},"lastTimeUsed":{"type":"string","description":"When the address was last requested (ISO 8601)."}},"required":["depositAddress","recipient","sender","depositChain","destinationSymbol","recipientChain","createdAt","lastTimeUsed"],"additionalProperties":false},"description":"Page of deposit address records."},"page":{"type":"number","description":"Current page number."},"perPage":{"type":"number","description":"Items per page."},"total":{"type":"number","description":"Total records matching the query."},"totalPages":{"type":"number","description":"Total number of pages."},"nextPage":{"nullable":true,"description":"Next page number, or null if none.","type":"number"},"prevPage":{"nullable":true,"description":"Previous page number, or null if none.","type":"number"}},"required":["data","page","perPage","total","totalPages","nextPage","prevPage"],"additionalProperties":false,"description":"A paginated page of deposit address records"}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"error":{"type":"string"},"data":{"type":"object","additionalProperties":{}},"statusCode":{"type":"number"}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Application key is not assigned","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"error":{"type":"string"},"data":{"type":"object","additionalProperties":{}},"statusCode":{"type":"number","enum":[404]}},"required":["message","statusCode"],"additionalProperties":false,"description":"Application key is not assigned"}}}},"500":{"description":"Internal Server Error - Failed to reach an upstream 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 an upstream service"}}}}}}}}}
```

## GET /api/persistent-deposit-address-data/{apiKey}

> Returns the details of a single persistent deposit address by its value, scoped to this API key (404 if the address was not created with this key).

```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/persistent-deposit-address-data/{apiKey}":{"get":{"tags":["deposit"],"description":"Returns the details of a single persistent deposit address by its value, scoped to this API key (404 if the address was not created with this key).","parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"address","required":true,"description":"The exact deposit address to look up. Must belong to this API key (otherwise 404)."},{"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":"The deposit address record","content":{"application/json":{"schema":{"type":"object","properties":{"depositAddress":{"type":"string","description":"Chain-specific deposit address."},"recipient":{"type":"string","description":"Target address on the destination chain."},"sender":{"type":"string","description":"Integrator-supplied user id the address was generated for."},"depositChain":{"nullable":true,"description":"Deposit chain in shortcut format. EVM chains share one address, so any EVM deposit chain is reported as the single value \"evm\".","type":"string"},"destinationSymbol":{"nullable":true,"description":"Symbol of the destination asset the address is bound to. Null for legacy rows whose asset could not be resolved.","type":"string"},"recipientChain":{"nullable":true,"description":"Chain the funds are received on (the chain the destination asset lives on), in shortcut format. Null for legacy rows whose asset could not be resolved.","type":"string"},"memo":{"description":"Deposit memo required by some chains (currently only Stellar). Deposits to this address on such chains MUST include it. Omitted for chains that do not use a memo.","type":"string"},"createdAt":{"type":"string","description":"When the address was first created (ISO 8601)."},"lastTimeUsed":{"type":"string","description":"When the address was last requested (ISO 8601)."}},"required":["depositAddress","recipient","sender","depositChain","destinationSymbol","recipientChain","createdAt","lastTimeUsed"],"additionalProperties":false,"description":"The deposit address record"}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"error":{"type":"string"},"data":{"type":"object","additionalProperties":{}},"statusCode":{"type":"number"}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Application key is not assigned, or no address matches `address` for this key","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"error":{"type":"string"},"data":{"type":"object","additionalProperties":{}},"statusCode":{"type":"number","enum":[404]}},"required":["message","statusCode"],"additionalProperties":false,"description":"Application key is not assigned, or no address matches `address` for this key"}}}},"500":{"description":"Internal Server Error - Failed to reach an upstream 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 an upstream 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/persistent-addresses-api-reference/get-persistent-address-data.md?ask=<question>&goal=<endgoal>
```

`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.