Skip to main content
GET
/
v1
/
transfers
/
grants
/
partner
/
fund
/
{id}
List fund grants by ID
curl --request GET \
  --url https://api.endaoment.org/v1/transfers/grants/partner/fund/{id} \
  --header 'x-api-key: <api-key>'
[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "type": "grant",
    "status": "approved",
    "transactionHash": "0x1234567890abcdef",
    "netAmount": "1000000",
    "fee": "10000",
    "createdAtUtc": "2024-03-20T10:30:00Z",
    "requestedAmount": "1000000",
    "updatedAtUtc": "2024-03-20T10:30:00Z",
    "asyncStatus": "pending",
    "chainId": 1,
    "destinationOrg": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "ein": "530196605",
      "name": "American Red Cross",
      "description": "Providing disaster relief and emergency assistance",
      "address": {
        "line1": "123 Main St",
        "city": "San Francisco",
        "state": "CA",
        "zip": "94105",
        "country": "USA"
      },
      "website": "https://www.redcross.org",
      "logo": "https://example.com/logo.png",
      "nteeCode": "E91",
      "nteeDescription": "Nursing, Convalescent (Geriatric and Nursing)",
      "featuredIndex": 100,
      "claimedDateUtc": "2024-03-20T10:30:00Z",
      "claimedType": "DIRECT",
      "claimed": true,
      "contractAddress": "0x1234567890123456789012345678901234567890",
      "deployments": [
        {
          "chainId": 1,
          "contractAddress": "0x1234567890123456789012345678901234567890",
          "usdcBalance": "2000000",
          "isDeployed": true
        }
      ]
    },
    "destinationSubproject": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "sponsorOrgId": "123e4567-e89b-12d3-a456-426614174000",
      "sponsorOrgEin": "123456789",
      "ein": "123456789",
      "name": "Education Initiative",
      "description": "Supporting educational programs in underserved communities",
      "website": "https://example.org/initiative",
      "logo": "https://example.org/images/logo.png",
      "nteeCode": "E91",
      "nteeDescription": "Nursing, Convalescent (Geriatric and Nursing)",
      "featuredIndex": 100,
      "lifetimeContributionsUsdc": "1000000"
    },
    "recommender": "John Doe",
    "purpose": "Supporting educational programs",
    "specialInstructions": "Funds must be used exclusively for the summer education program"
  }
]

Authorizations

​
x-api-key
string
header
required

Headers

​
x-api-key
string
required

Partner API key used for authentication

Path Parameters

Response

List of grants for the partner-owned fund successfully retrieved

​
id
string<uuid>
required

Unique identifier of the transfer

Example:

"123e4567-e89b-12d3-a456-426614174000"

​
type
enum<string>
required

Type of transfer, always "grant" for GrantTransferDto

Available options:
GrantTransfer,
EntityTransfer
Example:

"grant"

​
status
enum<string>
required
deprecated

Status of the transfer (deprecated)

Available options:
PendingReview,
Approved,
Rejected
Example:

"approved"

​
transactionHash
object
required

Transaction hash of the donation made to the target entity

Example:

"0x1234567890abcdef"

​
netAmount
object
required

Net output amount for the transfer (total - fees) in USDC smallest currency unit (1000000 = 1 USD)

Example:

"1000000"

​
fee
object
required

Fee charged on this transfer in USDC smallest currency unit (1000000 = 1 USD)

Example:

"10000"

​
createdAtUtc
string<date-time>
required

UTC timestamp when the transfer was created

Example:

"2024-03-20T10:30:00Z"

​
requestedAmount
object
required

Requested amount for the transfer in USDC smallest currency unit (1000000 = 1 USD) (only for async transfers)

Example:

"1000000"

​
updatedAtUtc
string<date-time>
required

UTC timestamp when the transfer was last updated

Example:

"2024-03-20T10:30:00Z"

​
asyncStatus
enum<string>
required

Current status of the async transfer request

Available options:
PendingLiquidation,
Liquidated,
Cancelled
Example:

"pending"

​
chainId
object
required

Chain ID where the transfer occurred (null for async transfers)

Example:

1

​
destinationOrg
object
required

Organization receiving the grant. Null if the grant is for a subproject.

​
destinationSubproject
object
required

Subproject receiving the grant. Null if the grant is for an organization.

​
recommender
object
required

Name of the person who recommended the grant

Example:

"John Doe"

​
purpose
object
required

Purpose of the grant

Example:

"Supporting educational programs"

​
specialInstructions
object
required

Special instructions for the use of granted assets

Example:

"Funds must be used exclusively for the summer education program"