POST
/
v1
/
recommendations
/
grant
Create a crypto donation recommendation
curl --request POST \
  --url https://api.endaoment.org/v1/recommendations/grant \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "recommender": "John Doe",
  "purpose": "General operating support",
  "specialInstructions": "Funds must be used for the specific project X.",
  "subprojectId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "shareMyEmail": false,
  "amountUsdc": "100000000",
  "orgId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "offsetFee": true,
  "collaboratingFundId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}'
{
  "id": "123e4567-e89b-12d3-a456-426614174000"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
purpose
string
required

Public declaration of this grant's purpose

Maximum length: 511
Example:

"General operating support"

​
amountUsdc
string
required

The amount in USDC for the recommendation (smallest unit)

Example:

"100000000"

​
orgId
string<uuid>
required

ID of the destination organization

​
offsetFee
boolean
required

Whether the advisor wants to offset the grant fee

Example:

true

​
uuid
string<uuid>
required

Unique identifier for the recommendation. Generated on the client side to ensure idempotency.

​
recommender
object

The name of the grant recommender

Example:

"John Doe"

​
specialInstructions
string

An optional, binding instruction for the use of the transferred assets. The receiving org must accept these instructions.

Example:

"Funds must be used for the specific project X."

​
subprojectId
string<uuid>

ID of the Subproject targeted by the grant. Must be sponsored by the receiving organization.

​
shareMyEmail
boolean

Whether the donor wants to share their email with the org

Example:

false

​
collaboratingFundId
string<uuid>

ID of the fund that the advisor is collaborating with

Response

Donation recommendation successfully created

​
id
string
required

The recommendation id

Example:

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