Skip to main content
POST
/
v1
/
recommendations
/
donation
Create a crypto donation recommendation
curl --request POST \
  --url https://api.endaoment.org/v1/recommendations/donation \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "donorName": "Anonymous Donor",
  "donorIdentity": {
    "firstName": "John",
    "lastName": "Doe",
    "email": "john.doe@example.com",
    "address": {
      "line1": "123 Main Street",
      "line2": "Suite 100",
      "city": "San Francisco",
      "state": "CA",
      "zip": "94105",
      "country": "USA"
    }
  },
  "updateIdentity": true,
  "shareMyEmail": false,
  "collaboratingFundId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "tokenId": 1,
  "chainId": 1,
  "inputAmount": "1000000000000000000",
  "offsetFee": true,
  "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
​
tokenId
number
required

Recommended token to be donated

Example:

1

​
chainId
number
required

The chain ID where the donation should occur.

Example:

1

​
inputAmount
string
required

Amount of input token used by the donation, denominated in its smallest currency unit

Example:

"1000000000000000000"

​
offsetFee
boolean
required

Whether the advisor wants to offset the donation fee

Example:

true

​
uuid
string<uuid>
required

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

​
donorName
string

Optional donor name to expose to the receiving entity. Not to be confused with donorIdentity which is the PII/tax receipt information of the donor

Example:

"Anonymous Donor"

​
donorIdentity
object

Optional identity information for the donation receipt.

​
updateIdentity
boolean

Whether to update the user's global identity with the provided donation identity.

Example:

true

​
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"

⌘I