InternalTransferService

Get Internal Transfer

Read an accepted transfer by exactly one of requestId or transferId. JWT session authentication only.

Method

GET

Path

/v1/trading/internal-transfers

Visibility

Authentication required

Authentication

Session token

MFA Requirement

Not required

GET

/v1/trading/internal-transfers

Request

Testnet

curl --request GET \ \
  --url 'https://api.testnet.polyester.com/v1/trading/internal-transfers?requestId=internal_transfer%3Add1ccb2fafd401e4c8c071f55bd1b803&subaccountId=45LUmqjT' \
  --header 'Accept: */*' \
  --header 'X-API-KEY-ID: YOUR_API_KEY_ID' \
  --header 'X-API-TIMESTAMP: YOUR_API_TIMESTAMP' \
  --header 'X-API-SIGNATURE: YOUR_API_SIGNATURE'

Responses

{
  "acceptedAtTsNs": "1735689600000000000",
  "flowId": "flow_7YWHMfk9JZeLMgZauHuiSxhJ",
  "requestId": "request_01J0EXAMPLE",
  "transferId": "9155001234569"
}

requestId string 1-128 chars

Accepted request ID. Send exactly one of requestId or transferId.

subaccountId string /^[1-9A…m-z]+$/

Source subaccount public ID; omit to read the caller's root account. Public ID, as a base58 string.

transferId string 1-39 chars /^[1-9][0-9]*$/

Accepted ledger transfer ID. Send exactly one of requestId or transferId.

acceptedAtTsNs string /^[0-9]+$/

Acceptance timestamp in nanoseconds since epoch (UTC).

Example 1735689600000000000

flowId string

Authoritative lifecycle identifier for GetFlowById. The flow's ledger settlement step links back through milestone_tx_ref.

Example flow_7YWHMfk9JZeLMgZauHuiSxhJ

requestId string

Stable server-owned intake request identifier.

Example request_01J0EXAMPLE

transferId string

Stable transfer identifier shared by its debit and credit ledger entries.

Example 9155001234569

Possible errors: 5

Key	HTTP status	Connect code	Error	When
unauthenticated	401	unauthenticated	Unauthenticated	Authentication required.
permission-denied	403	permission_denied	Permission Denied	Permission denied.
invalid-argument	400	invalid_argument	Invalid Argument	Invalid argument.
not-found	404	not_found	Not Found	Not found.
unavailable	503	unavailable	Unavailable	Service unavailable.