Skip to main content
GET
/
api
/
projects
/
{id}
/
approval-status
Approval Status
curl --request GET \
  --url https://api.example.com/api/projects/{id}/approval-status
{
  "balance": "<string>",
  "allowance": "<string>",
  "committed": "<string>",
  "available": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://shipyardprotocol.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Requires authentication. Founder only.
Returns the founder’s on-chain token balance, how much the platform is approved to spend (ERC-20 allowance), how much is committed to active bounties, and how much is available for new bounties.
​
id
string
required
Project ID.

​
Example

curl https://api.shipyardprotocol.com/api/projects/proj_m1n2o3/approval-status \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response

​
balance
string
Founder’s on-chain token balance (bigint as string).
​
allowance
string
ERC-20 allowance granted to the platform wallet (bigint as string).
​
committed
string
Total reward amount across all active bounties (open, claimed, in_review).
​
available
string
min(balance, allowance) - committed. The amount available for new bounties.
200
{
  "balance": "50000",
  "allowance": "50000",
  "committed": "5000",
  "available": "45000"
}

​
Errors

StatusDescription
400Project token not deployed yet
403Not the project founder
404Project not found