Transfers
Create an async grant request
Quickstart
Endpoints
- Organizations
- Transfers
- Recommendations
- Activity
- Funds
- Donation Pledges
Transactions
Subgraph Documentation
Transfers
Create an async grant request
Creates a pending (async) grant request that will be processed by Endaoment. The grant will be in a pending state until it is fully processed.
This endpoint requires authentication and the user must have permission to create grants from the specified fund.
POST
/
v1
/
transfers
/
async-grants
curl --request POST \
--url https://api.endaoment.org/v1/transfers/async-grants \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"idempotencyKey": "123e4567-e89b-12d3-a456-426614174000",
"originFundId": "123e4567-e89b-12d3-a456-426614174000",
"destinationOrgId": "123e4567-e89b-12d3-a456-426614174000",
"destinationSubprojectId": "123e4567-e89b-12d3-a456-426614174000",
"requestedAmount": "1000000",
"purpose": "Supporting educational programs",
"recommender": "John Doe",
"specialInstructions": "Funds must be used exclusively for the summer education program",
"shareMyEmail": false,
"recommendationIds": [
"123e4567-e89b-12d3-a456-426614174000"
]
}'
{
"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"
},
"contactInfo": {
"email": "contact@organization.org",
"name": "John Doe",
"phone": "+1 (555) 123-4567",
"title": "Executive Director"
},
"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"
}
]
},
"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
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Body
application/json
Response
200
application/json
Async grant request successfully created
The response is of type object
.
Was this page helpful?
curl --request POST \
--url https://api.endaoment.org/v1/transfers/async-grants \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"idempotencyKey": "123e4567-e89b-12d3-a456-426614174000",
"originFundId": "123e4567-e89b-12d3-a456-426614174000",
"destinationOrgId": "123e4567-e89b-12d3-a456-426614174000",
"destinationSubprojectId": "123e4567-e89b-12d3-a456-426614174000",
"requestedAmount": "1000000",
"purpose": "Supporting educational programs",
"recommender": "John Doe",
"specialInstructions": "Funds must be used exclusively for the summer education program",
"shareMyEmail": false,
"recommendationIds": [
"123e4567-e89b-12d3-a456-426614174000"
]
}'
{
"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"
},
"contactInfo": {
"email": "contact@organization.org",
"name": "John Doe",
"phone": "+1 (555) 123-4567",
"title": "Executive Director"
},
"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"
}
]
},
"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"
}