> For the complete documentation index, see [llms.txt](https://docs.xdao.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.xdao.app/xdao-ton-api-reference/dao-details.md).
# DAO Details
Read-only DAO-scoped endpoints accessible with DAO tokens.
## Get DAO details
> Returns detailed information about a single DAO.
```json
{"openapi":"3.0.3","info":{"title":"XDAO TON API docs","version":"1.1.0"},"tags":[{"name":"DAO-details","description":"Read-only DAO-scoped endpoints accessible with DAO tokens."}],"servers":[{"url":"https://ton.xdao.app"}],"security":[{"DaoBearerAuth":[]}],"components":{"securitySchemes":{"DaoBearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"DAO service token in Bearer format.\nThe token must be valid, not revoked, and authorized for the same `dao_address` as in path.\n"}},"parameters":{"DaoAddressPath":{"name":"dao_address","in":"path","required":true,"description":"DAO address in raw format.","schema":{"type":"string"}}},"schemas":{"Dao":{"type":"object","required":["address","owner_address","name","jetton_address","jetton_metadata","success_percentage","total_supply","plugins","date_create","crowdfunding_status"],"properties":{"address":{"type":"string"},"owner_address":{"type":"string"},"name":{"type":"string"},"jetton_address":{"type":"string"},"jetton_metadata":{"type":"object","additionalProperties":true},"success_percentage":{"type":"number"},"total_supply":{"type":"string"},"date_create":{"type":"string"},"plugins":{"type":"array","items":{"$ref":"#/components/schemas/Plugin"}},"crowdfunding_status":{"type":"string","enum":["legacy","enabled","ready"]}}},"Plugin":{"type":"object","required":["address","type"],"properties":{"address":{"type":"string"},"type":{"type":"string"},"lp_manager_index":{"type":"integer","nullable":true,"description":"LP Manager index (v6.1+), null for other plugin types."},"lp_jetton_master_address":{"type":"string","nullable":true,"description":"LP token jetton master address (only for LP Manager)."},"lp_token_name":{"type":"string","nullable":true},"lp_token_symbol":{"type":"string","nullable":true},"lp_token_image":{"type":"string","nullable":true},"subaccount_index":{"type":"integer","nullable":true},"subaccount_name":{"type":"string","nullable":true}}},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}},"responses":{"UnauthorizedError":{"description":"Token is missing, invalid, expired, or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Forbidden":{"description":"Token does not have access to this DAO or endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"NotFound":{"description":"Requested resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"InternalError":{"description":"Internal server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/api/v1/daos/{dao_address}":{"get":{"tags":["DAO-details"],"summary":"Get DAO details","description":"Returns detailed information about a single DAO.","operationId":"getDaoInfo","parameters":[{"$ref":"#/components/parameters/DaoAddressPath"}],"responses":{"200":{"description":"DAO details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Dao"}}}},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}}}}
```
## Get DAO holders
> Returns paginated list of DAO holders.
```json
{"openapi":"3.0.3","info":{"title":"XDAO TON API docs","version":"1.1.0"},"tags":[{"name":"DAO-details","description":"Read-only DAO-scoped endpoints accessible with DAO tokens."}],"servers":[{"url":"https://ton.xdao.app"}],"security":[{"DaoBearerAuth":[]}],"components":{"securitySchemes":{"DaoBearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"DAO service token in Bearer format.\nThe token must be valid, not revoked, and authorized for the same `dao_address` as in path.\n"}},"parameters":{"DaoAddressPath":{"name":"dao_address","in":"path","required":true,"description":"DAO address in raw format.","schema":{"type":"string"}},"LimitQuery":{"name":"limit","in":"query","required":false,"description":"Page size.","schema":{"type":"integer","minimum":1,"maximum":1000,"default":100}},"OffsetQuery":{"name":"offset","in":"query","required":false,"description":"Pagination offset.","schema":{"type":"integer","minimum":0,"default":0}}},"schemas":{"DaoHoldersList":{"type":"object","required":["total","items"],"properties":{"total":{"type":"integer","format":"int64"},"items":{"type":"array","items":{"$ref":"#/components/schemas/Holder"}}}},"Holder":{"type":"object","required":["jetton_wallet_address","owner_address","balance"],"properties":{"jetton_wallet_address":{"type":"string"},"owner_address":{"type":"string"},"balance":{"type":"string"}}},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}},"responses":{"UnauthorizedError":{"description":"Token is missing, invalid, expired, or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Forbidden":{"description":"Token does not have access to this DAO or endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"InternalError":{"description":"Internal server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/api/v1/daos/{dao_address}/holders":{"get":{"tags":["DAO-details"],"summary":"Get DAO holders","description":"Returns paginated list of DAO holders.","operationId":"getDaoHolders","parameters":[{"$ref":"#/components/parameters/DaoAddressPath"},{"$ref":"#/components/parameters/LimitQuery"},{"$ref":"#/components/parameters/OffsetQuery"}],"responses":{"200":{"description":"DAO holder list","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DaoHoldersList"}}}},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/Forbidden"},"500":{"$ref":"#/components/responses/InternalError"}}}}}}
```
## Get DAO proposals
> Returns paginated list of proposals for a DAO.
```json
{"openapi":"3.0.3","info":{"title":"XDAO TON API docs","version":"1.1.0"},"tags":[{"name":"DAO-details","description":"Read-only DAO-scoped endpoints accessible with DAO tokens."}],"servers":[{"url":"https://ton.xdao.app"}],"security":[{"DaoBearerAuth":[]}],"components":{"securitySchemes":{"DaoBearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"DAO service token in Bearer format.\nThe token must be valid, not revoked, and authorized for the same `dao_address` as in path.\n"}},"parameters":{"DaoAddressPath":{"name":"dao_address","in":"path","required":true,"description":"DAO address in raw format.","schema":{"type":"string"}},"LimitQuery":{"name":"limit","in":"query","required":false,"description":"Page size.","schema":{"type":"integer","minimum":1,"maximum":1000,"default":100}},"OffsetQuery":{"name":"offset","in":"query","required":false,"description":"Pagination offset.","schema":{"type":"integer","minimum":0,"default":0}}},"schemas":{"ProposalList":{"type":"object","required":["total","items"],"properties":{"total":{"type":"integer","format":"int64"},"items":{"type":"array","items":{"$ref":"#/components/schemas/Proposal"}}}},"Proposal":{"type":"object","required":["proposal_id","address","dao_address","jetton_master_address","initiated_by_address","success_amount","current_amount","total_supply","success_percentage","date_start","date_expire","type","data","status","raw_data","dao"],"properties":{"proposal_id":{"type":"integer","format":"int64"},"name":{"type":"string"},"is_user_voted":{"type":"boolean"},"description":{"type":"string"},"address":{"type":"string"},"dao_address":{"type":"string","deprecated":true},"jetton_master_address":{"type":"string"},"initiated_by_address":{"type":"string"},"success_amount":{"type":"string"},"current_amount":{"type":"string"},"total_supply":{"type":"string"},"success_percentage":{"type":"number"},"date_start":{"type":"string"},"date_expire":{"type":"string"},"type":{"type":"string"},"data":{"type":"object","additionalProperties":true},"status":{"$ref":"#/components/schemas/ProposalStatus"},"raw_data":{"type":"string"},"dao":{"$ref":"#/components/schemas/Dao"}}},"ProposalStatus":{"type":"string","enum":["active","rejected","executed","mine","unknown"]},"Dao":{"type":"object","required":["address","owner_address","name","jetton_address","jetton_metadata","success_percentage","total_supply","plugins","date_create","crowdfunding_status"],"properties":{"address":{"type":"string"},"owner_address":{"type":"string"},"name":{"type":"string"},"jetton_address":{"type":"string"},"jetton_metadata":{"type":"object","additionalProperties":true},"success_percentage":{"type":"number"},"total_supply":{"type":"string"},"date_create":{"type":"string"},"plugins":{"type":"array","items":{"$ref":"#/components/schemas/Plugin"}},"crowdfunding_status":{"type":"string","enum":["legacy","enabled","ready"]}}},"Plugin":{"type":"object","required":["address","type"],"properties":{"address":{"type":"string"},"type":{"type":"string"},"lp_manager_index":{"type":"integer","nullable":true,"description":"LP Manager index (v6.1+), null for other plugin types."},"lp_jetton_master_address":{"type":"string","nullable":true,"description":"LP token jetton master address (only for LP Manager)."},"lp_token_name":{"type":"string","nullable":true},"lp_token_symbol":{"type":"string","nullable":true},"lp_token_image":{"type":"string","nullable":true},"subaccount_index":{"type":"integer","nullable":true},"subaccount_name":{"type":"string","nullable":true}}},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}},"responses":{"UnauthorizedError":{"description":"Token is missing, invalid, expired, or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Forbidden":{"description":"Token does not have access to this DAO or endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"InternalError":{"description":"Internal server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/api/v1/daos/{dao_address}/proposals":{"get":{"tags":["DAO-details"],"summary":"Get DAO proposals","description":"Returns paginated list of proposals for a DAO.","operationId":"getDaoProposals","parameters":[{"$ref":"#/components/parameters/DaoAddressPath"},{"$ref":"#/components/parameters/LimitQuery"},{"$ref":"#/components/parameters/OffsetQuery"}],"responses":{"200":{"description":"DAO proposal list","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProposalList"}}}},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/Forbidden"},"500":{"$ref":"#/components/responses/InternalError"}}}}}}
```
## Get proposal votes
> Returns paginated votes for a DAO proposal.
```json
{"openapi":"3.0.3","info":{"title":"XDAO TON API docs","version":"1.1.0"},"tags":[{"name":"DAO-details","description":"Read-only DAO-scoped endpoints accessible with DAO tokens."}],"servers":[{"url":"https://ton.xdao.app"}],"security":[{"DaoBearerAuth":[]}],"components":{"securitySchemes":{"DaoBearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"DAO service token in Bearer format.\nThe token must be valid, not revoked, and authorized for the same `dao_address` as in path.\n"}},"parameters":{"DaoAddressPath":{"name":"dao_address","in":"path","required":true,"description":"DAO address in raw format.","schema":{"type":"string"}},"ProposalAddressPath":{"name":"proposal_address","in":"path","required":true,"description":"Proposal address in raw format.","schema":{"type":"string"}},"LimitQuery":{"name":"limit","in":"query","required":false,"description":"Page size.","schema":{"type":"integer","minimum":1,"maximum":1000,"default":100}},"OffsetQuery":{"name":"offset","in":"query","required":false,"description":"Pagination offset.","schema":{"type":"integer","minimum":0,"default":0}}},"schemas":{"ProposalVotesList":{"type":"object","required":["total","items"],"properties":{"total":{"type":"integer","format":"int64"},"items":{"type":"array","items":{"$ref":"#/components/schemas/Vote"}}}},"Vote":{"type":"object","required":["proposal_address","voter_address","amount","date_create"],"properties":{"proposal_address":{"type":"string"},"voter_address":{"type":"string"},"amount":{"type":"string"},"date_create":{"type":"string"}}},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}},"responses":{"UnauthorizedError":{"description":"Token is missing, invalid, expired, or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Forbidden":{"description":"Token does not have access to this DAO or endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"InternalError":{"description":"Internal server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/api/v1/daos/{dao_address}/proposals/{proposal_address}/votes":{"get":{"tags":["DAO-details"],"summary":"Get proposal votes","description":"Returns paginated votes for a DAO proposal.","operationId":"getDaoProposalVotes","parameters":[{"$ref":"#/components/parameters/DaoAddressPath"},{"$ref":"#/components/parameters/ProposalAddressPath"},{"$ref":"#/components/parameters/LimitQuery"},{"$ref":"#/components/parameters/OffsetQuery"}],"responses":{"200":{"description":"Proposal votes list","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProposalVotesList"}}}},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/Forbidden"},"500":{"$ref":"#/components/responses/InternalError"}}}}}}
```
## Get DAO crowdfunding campaigns
> Returns paginated crowdfunding campaigns for a DAO.
```json
{"openapi":"3.0.3","info":{"title":"XDAO TON API docs","version":"1.1.0"},"tags":[{"name":"DAO-details","description":"Read-only DAO-scoped endpoints accessible with DAO tokens."}],"servers":[{"url":"https://ton.xdao.app"}],"security":[{"DaoBearerAuth":[]}],"components":{"securitySchemes":{"DaoBearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"DAO service token in Bearer format.\nThe token must be valid, not revoked, and authorized for the same `dao_address` as in path.\n"}},"parameters":{"DaoAddressPath":{"name":"dao_address","in":"path","required":true,"description":"DAO address in raw format.","schema":{"type":"string"}},"LimitQuery":{"name":"limit","in":"query","required":false,"description":"Page size.","schema":{"type":"integer","minimum":1,"maximum":1000,"default":100}},"OffsetQuery":{"name":"offset","in":"query","required":false,"description":"Pagination offset.","schema":{"type":"integer","minimum":0,"default":0}}},"schemas":{"CrowdfundingCampaignList":{"type":"object","required":["total","items"],"properties":{"total":{"type":"integer","format":"int64"},"items":{"type":"array","items":{"$ref":"#/components/schemas/CrowdfundingCampaign"}}}},"CrowdfundingCampaign":{"type":"object","required":["address","daoAddress","status"],"properties":{"address":{"type":"string"},"daoAddress":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"daoName":{"type":"string"},"isNative":{"type":"boolean"},"jettonSymbol":{"type":"string","nullable":true},"jettonDecimals":{"type":"integer","nullable":true},"jettonImage":{"type":"string","nullable":true},"jettonMasterAddress":{"type":"string"},"lpManagerAddress":{"type":"string"},"lpJettonMasterAddress":{"type":"string"},"destinationAddress":{"type":"string"},"feeManagerAddress":{"type":"string"},"minTotalAmount":{"type":"string"},"maxTotalAmount":{"type":"string"},"minAmountPerUser":{"type":"string"},"maxAmountPerUser":{"type":"string"},"startTime":{"type":"string","format":"date-time"},"endTime":{"type":"string","format":"date-time"},"lpPrice":{"type":"string"},"managementFee":{"type":"integer"},"status":{"$ref":"#/components/schemas/CampaignStatus"},"paused":{"type":"boolean"},"totalAmount":{"type":"string"},"totalClaimed":{"type":"string"},"totalRefunded":{"type":"string"},"isEmergencyWithdrawn":{"type":"boolean"},"hasWhitelist":{"type":"boolean"},"whitelist":{"type":"array","items":{"type":"string"}},"contributors":{"type":"array","items":{"$ref":"#/components/schemas/CrowdfundingContributor"}},"participantsCount":{"type":"integer"},"progressPercentage":{"type":"number","format":"float"},"updatedAt":{"type":"string","format":"date-time"},"finishedAt":{"type":"string","format":"date-time"},"dao":{"$ref":"#/components/schemas/Dao"},"userHelper":{"$ref":"#/components/schemas/CrowdfundingParticipant"},"daoFeeClaimed":{"type":"boolean"},"daoFeeClaimedAt":{"type":"string","format":"date-time","nullable":true},"daoFeeAmount":{"type":"string"}}},"CampaignStatus":{"type":"string","enum":["active","successful","failed","emergency_withdrawn"]},"CrowdfundingContributor":{"type":"object","required":["address","amount"],"properties":{"address":{"type":"string"},"amount":{"type":"string"}}},"Dao":{"type":"object","required":["address","owner_address","name","jetton_address","jetton_metadata","success_percentage","total_supply","plugins","date_create","crowdfunding_status"],"properties":{"address":{"type":"string"},"owner_address":{"type":"string"},"name":{"type":"string"},"jetton_address":{"type":"string"},"jetton_metadata":{"type":"object","additionalProperties":true},"success_percentage":{"type":"number"},"total_supply":{"type":"string"},"date_create":{"type":"string"},"plugins":{"type":"array","items":{"$ref":"#/components/schemas/Plugin"}},"crowdfunding_status":{"type":"string","enum":["legacy","enabled","ready"]}}},"Plugin":{"type":"object","required":["address","type"],"properties":{"address":{"type":"string"},"type":{"type":"string"},"lp_manager_index":{"type":"integer","nullable":true,"description":"LP Manager index (v6.1+), null for other plugin types."},"lp_jetton_master_address":{"type":"string","nullable":true,"description":"LP token jetton master address (only for LP Manager)."},"lp_token_name":{"type":"string","nullable":true},"lp_token_symbol":{"type":"string","nullable":true},"lp_token_image":{"type":"string","nullable":true},"subaccount_index":{"type":"integer","nullable":true},"subaccount_name":{"type":"string","nullable":true}}},"CrowdfundingParticipant":{"type":"object","required":["address","masterAddress","ownerAddress","amount"],"properties":{"address":{"type":"string"},"masterAddress":{"type":"string"},"ownerAddress":{"type":"string"},"amount":{"type":"string"},"isClaimed":{"type":"boolean"},"isRefunded":{"type":"boolean"},"claimedAt":{"type":"string","format":"date-time"},"refundedAt":{"type":"string","format":"date-time"},"dateCreate":{"type":"string","format":"date-time"}}},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}},"responses":{"UnauthorizedError":{"description":"Token is missing, invalid, expired, or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Forbidden":{"description":"Token does not have access to this DAO or endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"InternalError":{"description":"Internal server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/api/v1/daos/{dao_address}/crowdfundings":{"get":{"tags":["DAO-details"],"summary":"Get DAO crowdfunding campaigns","description":"Returns paginated crowdfunding campaigns for a DAO.","operationId":"getDaoCrowdfundings","parameters":[{"$ref":"#/components/parameters/DaoAddressPath"},{"$ref":"#/components/parameters/LimitQuery"},{"$ref":"#/components/parameters/OffsetQuery"}],"responses":{"200":{"description":"DAO crowdfunding campaign list","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrowdfundingCampaignList"}}}},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/Forbidden"},"500":{"$ref":"#/components/responses/InternalError"}}}}}}
```
## Get DAO LP masters with LP holders
> Returns LP masters and nested LP holders for a DAO.
```json
{"openapi":"3.0.3","info":{"title":"XDAO TON API docs","version":"1.1.0"},"tags":[{"name":"DAO-details","description":"Read-only DAO-scoped endpoints accessible with DAO tokens."}],"servers":[{"url":"https://ton.xdao.app"}],"security":[{"DaoBearerAuth":[]}],"components":{"securitySchemes":{"DaoBearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"DAO service token in Bearer format.\nThe token must be valid, not revoked, and authorized for the same `dao_address` as in path.\n"}},"parameters":{"DaoAddressPath":{"name":"dao_address","in":"path","required":true,"description":"DAO address in raw format.","schema":{"type":"string"}},"MastersLimitQuery":{"name":"masters_limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":1000,"default":100}},"MastersOffsetQuery":{"name":"masters_offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0}},"HoldersLimitQuery":{"name":"holders_limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":1000,"default":100}},"HoldersOffsetQuery":{"name":"holders_offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0}}},"schemas":{"DaoLpMasterWithLpHoldersList":{"type":"object","required":["total","items"],"properties":{"total":{"type":"integer","format":"int64"},"items":{"type":"array","items":{"$ref":"#/components/schemas/DaoLpMasterWithLpHolders"}}}},"DaoLpMasterWithLpHolders":{"type":"object","required":["lpJettonMasterAddress","campaignAddresses","holdersTotal","holders"],"properties":{"lpJettonMasterAddress":{"type":"string"},"campaignAddresses":{"type":"array","items":{"type":"string"}},"holdersTotal":{"type":"integer","format":"int64"},"holders":{"type":"array","items":{"$ref":"#/components/schemas/CrowdfundingLpHolder"}}}},"CrowdfundingLpHolder":{"type":"object","required":["lpJettonWalletAddress","ownerAddress","balance"],"properties":{"lpJettonWalletAddress":{"type":"string"},"ownerAddress":{"type":"string"},"balance":{"type":"string"}}},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}},"responses":{"UnauthorizedError":{"description":"Token is missing, invalid, expired, or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Forbidden":{"description":"Token does not have access to this DAO or endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"InternalError":{"description":"Internal server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/api/v1/daos/{dao_address}/lp-masters-with-lp-holders":{"get":{"tags":["DAO-details"],"summary":"Get DAO LP masters with LP holders","description":"Returns LP masters and nested LP holders for a DAO.","operationId":"getDaoLpMastersWithLpHolders","parameters":[{"$ref":"#/components/parameters/DaoAddressPath"},{"$ref":"#/components/parameters/MastersLimitQuery"},{"$ref":"#/components/parameters/MastersOffsetQuery"},{"$ref":"#/components/parameters/HoldersLimitQuery"},{"$ref":"#/components/parameters/HoldersOffsetQuery"}],"responses":{"200":{"description":"DAO LP masters with LP holders","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DaoLpMasterWithLpHoldersList"}}}},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/Forbidden"},"500":{"$ref":"#/components/responses/InternalError"}}}}}}
```
## Get a wallet's participation status across this DAO's campaigns
> Returns a single wallet's participation across all crowdfunding\
> campaigns owned by this DAO, in one call:\
> \- invested \`amount\` (collection currency) and \`lpBalance\` (LP held) per campaign,\
> \- \`isClaimed\` / \`isRefunded\` status,\
> \- the \`vesting\` block per campaign with \`vestingStart\` and a computed\
> \`vestingEnd\` (= vestingStart + cliffDuration + vestingDuration),\
> \- aggregates: \`totalInvested\`, \`totalLpHeld\`, \`totalLpVesting\`, \`activeCount\`.\
> \
> Auth: requires a DAO bearer token whose \`dao\_address\` matches the path.\
> Results are strictly scoped to this DAO — a wallet's participation in\
> other DAOs is never included.
```json
{"openapi":"3.0.3","info":{"title":"XDAO TON API docs","version":"1.1.0"},"tags":[{"name":"DAO-details","description":"Read-only DAO-scoped endpoints accessible with DAO tokens."}],"servers":[{"url":"https://ton.xdao.app"}],"security":[{"DaoBearerAuth":[]}],"components":{"securitySchemes":{"DaoBearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"DAO service token in Bearer format.\nThe token must be valid, not revoked, and authorized for the same `dao_address` as in path.\n"}},"parameters":{"DaoAddressPath":{"name":"dao_address","in":"path","required":true,"description":"DAO address in raw format.","schema":{"type":"string"}},"OwnerAddressPath":{"name":"owner_address","in":"path","required":true,"description":"Wallet (owner) address; raw or user-friendly format.","schema":{"type":"string"}}},"schemas":{"DaoParticipantStatus":{"type":"object","required":["daoAddress","ownerAddress","campaigns","totalInvested","totalLpHeld","totalLpVesting","activeCount"],"properties":{"daoAddress":{"type":"string"},"ownerAddress":{"type":"string"},"campaigns":{"type":"array","items":{"$ref":"#/components/schemas/DaoParticipantCampaign"}},"totalInvested":{"type":"string","description":"Sum of invested amounts across this DAO's campaigns."},"totalLpHeld":{"type":"string","description":"Sum of LP held in the wallet across this DAO's campaigns."},"totalLpVesting":{"type":"string","description":"Sum of LP still locked in vesting vaults."},"activeCount":{"type":"integer","description":"Campaigns not yet claimed nor refunded."}}},"DaoParticipantCampaign":{"type":"object","required":["campaignAddress","helperAddress","amount","lpBalance","isClaimed","isRefunded"],"properties":{"campaignAddress":{"type":"string","description":"Crowdfunding master address."},"helperAddress":{"type":"string","description":"Per-user helper contract address."},"campaignName":{"type":"string"},"isNative":{"type":"boolean","description":"True for native TON campaigns, false for jetton campaigns."},"jettonSymbol":{"type":"string","description":"Collection-currency jetton symbol (jetton campaigns)."},"amount":{"type":"string","description":"Invested amount in collection currency."},"lpBalance":{"type":"string","description":"LP held in the wallet for this campaign (0 if none)."},"isClaimed":{"type":"boolean"},"isRefunded":{"type":"boolean"},"claimedAt":{"type":"string","format":"date-time"},"refundedAt":{"type":"string","format":"date-time"},"dateCreate":{"type":"string","format":"date-time"},"vesting":{"$ref":"#/components/schemas/ParticipantVesting"}}},"ParticipantVesting":{"type":"object","required":["vaultAddress","totalLpAmount","claimedLpAmount","isInitialized","isEmergencyReleased"],"properties":{"vaultAddress":{"type":"string"},"totalLpAmount":{"type":"string","description":"Total LP locked into the vesting vault."},"claimedLpAmount":{"type":"string","description":"LP already claimed out of the vesting vault."},"vestingStart":{"type":"string","format":"date-time"},"cliffDuration":{"type":"integer","description":"Cliff duration in seconds."},"vestingDuration":{"type":"integer","description":"Linear vesting duration in seconds."},"tgeUnlockBps":{"type":"integer","description":"TGE unlock in basis points (1/100 of a percent)."},"vestingEnd":{"type":"string","format":"date-time","description":"Computed end = vestingStart + cliffDuration + vestingDuration."},"isInitialized":{"type":"boolean"},"isEmergencyReleased":{"type":"boolean"}}},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}},"responses":{"BadRequest":{"description":"Request is malformed. Error codes used by `/contribution-link`:\n- `invalid_campaign_address` — campaign path segment cannot be parsed\n- `invalid_amount` — amount is not a positive integer, or outside\n `[minAmountPerUser, maxAmountPerUser]`\n- `missing_investor_address` — jetton campaign called without\n `investor_address`\n- `invalid_investor_address` / `invalid_response_address` — address\n cannot be parsed\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"UnauthorizedError":{"description":"Token is missing, invalid, expired, or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Forbidden":{"description":"Token does not have access to this DAO or endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"NotFound":{"description":"Requested resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"InternalError":{"description":"Internal server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/api/v1/daos/{dao_address}/participants/{owner_address}":{"get":{"tags":["DAO-details"],"summary":"Get a wallet's participation status across this DAO's campaigns","description":"Returns a single wallet's participation across all crowdfunding\ncampaigns owned by this DAO, in one call:\n- invested `amount` (collection currency) and `lpBalance` (LP held) per campaign,\n- `isClaimed` / `isRefunded` status,\n- the `vesting` block per campaign with `vestingStart` and a computed\n `vestingEnd` (= vestingStart + cliffDuration + vestingDuration),\n- aggregates: `totalInvested`, `totalLpHeld`, `totalLpVesting`, `activeCount`.\n\nAuth: requires a DAO bearer token whose `dao_address` matches the path.\nResults are strictly scoped to this DAO — a wallet's participation in\nother DAOs is never included.\n","operationId":"getDaoParticipantStatus","parameters":[{"$ref":"#/components/parameters/DaoAddressPath"},{"$ref":"#/components/parameters/OwnerAddressPath"}],"responses":{"200":{"description":"Wallet participation status across the DAO's campaigns","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DaoParticipantStatus"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}}}}
```
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.xdao.app/xdao-ton-api-reference/dao-details.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.