Skip to main content
POST
/
v1
/
donation-pledges
/
partner
/
stock-settled
Create a partner-settled stock donation pledge
curl --request POST \
  --url https://api.endaoment.org/v1/donation-pledges/partner/stock-settled \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --header 'x-endaoment-user-id: <x-endaoment-user-id>' \
  --data '
{
  "stockPledgeData": {
    "shares": 100,
    "ticker": "AAPL",
    "lots": [
      {
        "numberOfShares": 50,
        "purchasePrice": 150.75,
        "purchaseDate": "2023-01-15T00:00:00.000Z",
        "employeeStockPlan": "RSU",
        "lotId": "LOT123"
      }
    ]
  },
  "receivingFundId": "123e4567-e89b-12d3-a456-426614174000",
  "idempotencyKey": "123e4567-e89b-12d3-a456-426614174000",
  "donationValueMicroDollars": "50000000000",
  "partnerOperationId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}
'
{
  "id": "123e4567-e89b-12d3-a456-426614174000"
}

Headers

​
x-endaoment-user-id
string
required

UUID of the Endaoment user for this partner-settled operation

​
x-api-key
string
required

Partner API key used for authentication

Body

application/json
​
stockPledgeData
object
required

Settled stock pledge details reported by the partner

​
receivingFundId
string<uuid>
required

Unique identifier of the receiving fund

Example:

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

​
idempotencyKey
string<uuid>
required

Client-generated key to ensure idempotency of the request

Example:

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

​
donationValueMicroDollars
string
required

Settled donation value in microdollars

Example:

"50000000000"

​
partnerOperationId
string
required

Partner-owned reference for this operation

Maximum string length: 36
Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

Response

Partner-settled stock donation pledge successfully created

​
id
string<uuid>
required

Unique identifier of the created donation pledge

Example:

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