Skip to main content
GET
/
allocations
/
{allocationId}
Get Allocation
curl --request GET \
  --url https://api.dfns.io/allocations/{allocationId} \
  --header 'Authorization: Bearer <token>'
{
  "id": "allctn-6a3ku-bn8d7-8u5rs1oukojms7k8",
  "walletId": "wa-3l3cj-l8mq7-8q78f9nopq7f1qjv",
  "protocol": "0fns",
  "amount": {
    "kind": "Erc20",
    "contract": "0x0A7660979A67E4bC51E750C628C8479ff9F458aE",
    "amount": "1000000000",
    "metadata": {
      "network": "EthereumSepolia",
      "name": "0fns",
      "symbol": "0fnsSepolia",
      "decimals": 6,
      "tid": "erc20:0x0A7660979A67E4bC51E750C628C8479ff9F458aE"
    }
  },
  "rewards": {
    "kind": "Erc20",
    "contract": "0x0A7660979A67E4bC51E750C628C8479ff9F458aE",
    "amount": "5000000",
    "metadata": {
      "network": "EthereumSepolia",
      "name": "0fns",
      "symbol": "0fnsSepolia",
      "decimals": 6,
      "tid": "erc20:0x0A7660979A67E4bC51E750C628C9479ff9F458aE"
    }
  },
  "dateCreated": "2025-10-09T10:57:55.758Z"
}

​
Authentication

✅ Organization User (CustomerEmployee)
❌ Delegated User (EndUser)
✅ Service Account

​
Required Permissions

Allocations:Read: Always required.

Authorizations

​
Authorization
string
header
required

Bearer Token: Used to authenticate API requests. More details how to generate the token: Authentication flows

Path Parameters

​
allocationId
string
required

Unique identifier for the allocation investment.

Required string length: 1 - 64

Response

200 - application/json

Success

A allocation investment representing funds deposited to earn interest from a DeFi protocol.

​
id
string
required

Unique identifier for the allocation investment.

Required string length: 1 - 64
Pattern: ^allctn-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$
Example:

"allctn-7mnn0-rltpq-9bvps60gjm09td0j"

​
walletId
string
required

Wallet id.

Required string length: 1 - 64
Pattern: ^wa-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$
Example:

"wa-5pfuu-9euek-h0odgb6snva8ph3k"

​
protocol
enum<string>
required

The DeFi protocol used for allocation generation. Currently supports OFNS protocol

Available options:
0fns
​
amount
Native Asset · object
required

The total amount currently invested in this allocation.

​
rewards
Native Asset · object
required

The total rewards earned so far in this allocation.

​
dateCreated
string<date-time>
required

ISO 8601 date (must be UTC). ISO 8601 date. When the allocation was created.

Example:

"2023-04-14T20:41:28.715Z"

​
actions
object[]
required
Last modified on March 19, 2026