> For the complete documentation index, see [llms.txt](https://docs.deltadefi.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.deltadefi.io/start-trading/developers/api-documentation/account/transferal-records.md).

# Transferal records

## Get transferal records

> Get transferal records for the authenticated user, including both incoming and outgoing transfers with pagination. Each record has a 'direction' field indicating "incoming" or "outgoing", and a 'status' field indicating "pending" or "confirmed".

```json
{"openapi":"3.1.1","info":{"title":"Espresso API Server","version":"1.0"},"security":[{"ApiKeyAuth":[]}],"paths":{"/accounts/transferal-records":{"get":{"description":"Get transferal records for the authenticated user, including both incoming and outgoing transfers with pagination. Each record has a 'direction' field indicating \"incoming\" or \"outgoing\", and a 'status' field indicating \"pending\" or \"confirmed\".","parameters":[{"schema":{"type":"string"},"description":"API Key","in":"header","name":"X-API-KEY","required":true},{"schema":{"type":"integer"},"description":"Page number for pagination, default is 1","in":"query","name":"page"},{"schema":{"type":"integer"},"description":"Limit number of records per page, default is 10","in":"query","name":"limit"},{"schema":{"type":"string"},"description":"Filter by transfer status: 'pending' (not yet spent) or 'confirmed' (already spent). If omitted, returns all records.","in":"query","name":"status"}],"responses":{"200":{"description":"Paginated transferal records","content":{"application/json":{"schema":{"$ref":"#/components/schemas/espresso_internal_api_response.PaginatedResponse-espresso_internal_api_entities_TransferalRecord"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/espresso_internal_api_response.ErrorJSONWithCodeResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/espresso_internal_api_response.ErrorJSONWithCodeResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/espresso_internal_api_response.ErrorJSONWithCodeResponse"}}}}},"summary":"Get transferal records","tags":["accounts"]}}},"components":{"schemas":{"espresso_internal_api_response.PaginatedResponse-espresso_internal_api_entities_TransferalRecord":{"properties":{"data":{"items":{"$ref":"#/components/schemas/espresso_internal_api_entities.TransferalRecord"},"type":"array"},"total_count":{"type":"integer"},"total_page":{"type":"integer"}},"type":"object"},"espresso_internal_api_entities.TransferalRecord":{"properties":{"assets":{"items":{"$ref":"#/components/schemas/espresso_internal_api_entities.AssetRecord"},"type":"array"},"created_at":{"type":"string"},"direction":{"allOf":[{"$ref":"#/components/schemas/espresso_internal_api_entities.TransferDirection"}],"description":"\"incoming\" or \"outgoing\""},"status":{"allOf":[{"$ref":"#/components/schemas/espresso_internal_api_entities.TransferStatus"}],"description":"\"pending\" or \"confirmed\""},"transferal_type":{"$ref":"#/components/schemas/schema.TransferalType"},"tx_hash":{"type":"string"}},"type":"object"},"espresso_internal_api_entities.AssetRecord":{"properties":{"asset":{"type":"string"},"asset_unit":{"type":"string"},"qty":{"type":"number"}},"type":"object"},"espresso_internal_api_entities.TransferDirection":{"enum":["incoming","outgoing"],"type":"string"},"espresso_internal_api_entities.TransferStatus":{"enum":["pending","confirmed"],"type":"string"},"schema.TransferalType":{"enum":["normal","deposit","withdrawal"],"type":"string"},"espresso_internal_api_response.ErrorJSONWithCodeResponse":{"properties":{"code":{"type":"integer"},"error":{"type":"string"}},"type":"object"}}}}
```

## Get transferal record by transaction hash

> Get a single transferal record by its transaction hash. Returns the record with direction (incoming/outgoing) and status (pending/confirmed).

```json
{"openapi":"3.1.1","info":{"title":"Espresso API Server","version":"1.0"},"security":[{"ApiKeyAuth":[]}],"paths":{"/accounts/transferal-records/{tx_hash}":{"get":{"description":"Get a single transferal record by its transaction hash. Returns the record with direction (incoming/outgoing) and status (pending/confirmed).","parameters":[{"schema":{"type":"string"},"description":"API Key","in":"header","name":"X-API-KEY","required":true},{"schema":{"type":"string"},"description":"Transaction hash","in":"path","name":"tx_hash","required":true}],"responses":{"200":{"description":"Transferal record details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/espresso_internal_api_entities.TransferalRecord"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/espresso_internal_api_response.ErrorJSONWithCodeResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/espresso_internal_api_response.ErrorJSONWithCodeResponse"}}}},"404":{"description":"Intent not found or intent expired","content":{"application/json":{"schema":{"$ref":"#/components/schemas/espresso_internal_api_response.ErrorJSONWithCodeResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/espresso_internal_api_response.ErrorJSONWithCodeResponse"}}}}},"summary":"Get transferal record by transaction hash","tags":["accounts"]}}},"components":{"schemas":{"espresso_internal_api_entities.TransferalRecord":{"properties":{"assets":{"items":{"$ref":"#/components/schemas/espresso_internal_api_entities.AssetRecord"},"type":"array"},"created_at":{"type":"string"},"direction":{"allOf":[{"$ref":"#/components/schemas/espresso_internal_api_entities.TransferDirection"}],"description":"\"incoming\" or \"outgoing\""},"status":{"allOf":[{"$ref":"#/components/schemas/espresso_internal_api_entities.TransferStatus"}],"description":"\"pending\" or \"confirmed\""},"transferal_type":{"$ref":"#/components/schemas/schema.TransferalType"},"tx_hash":{"type":"string"}},"type":"object"},"espresso_internal_api_entities.AssetRecord":{"properties":{"asset":{"type":"string"},"asset_unit":{"type":"string"},"qty":{"type":"number"}},"type":"object"},"espresso_internal_api_entities.TransferDirection":{"enum":["incoming","outgoing"],"type":"string"},"espresso_internal_api_entities.TransferStatus":{"enum":["pending","confirmed"],"type":"string"},"schema.TransferalType":{"enum":["normal","deposit","withdrawal"],"type":"string"},"espresso_internal_api_response.ErrorJSONWithCodeResponse":{"properties":{"code":{"type":"integer"},"error":{"type":"string"}},"type":"object"}}}}
```