Participants
A participant is a creator who joined your offer.
| Status | Meaning |
|---|---|
pending |
Joined and waiting for a code from you |
active |
Has a code and a link; can receive accruals |
rejected |
Declined by you; the creator sees your reason |
GET /participants
Section titled “GET /participants”curl -s "https://suly.gg/api/partner/v1/participants?status=pending&page=1" \ -H "Authorization: Bearer $SULY_KEY"status is pending, active, rejected or all (the default). 50 per page, newest first.
{ "participants": [ { "participantId": "…", "status": "pending", "creator": { "userId": "…", "name": "Andry" }, "channels": [ { "platform": "youtube", "name": "Andry Plays", "handle": "UC…", "url": "https://www.youtube.com/channel/UC…", "views": 120000, "periodDays": 28, "countries": [{ "country": "RU", "share": 41.5 }] } ], "code": null, "link": null, "rejectReason": null, "info": null, "joinedAt": "2026-11-03T10:00:00.000Z", "updatedAt": "2026-11-03T10:00:00.000Z", "accrued": "0.000000" } ], "total": 1, "page": 1, "pageSize": 50}| Field | Meaning |
|---|---|
participantId |
Stable id of this creator in your offer. Use it as the key in your system |
creator |
The creator’s name on suly.gg |
channels |
The creator’s verified channels. views and periodDays are the channel’s views for the last 28 or 30 days, or null; countries is the audience share in percent, or an empty list |
code, link |
What you gave the creator, or null |
rejectReason |
Your reason if you declined, or null |
info |
Your note to the creator: { "text", "updatedAt" }, or null |
accrued |
How much this creator has already been paid in this offer |
GET /participants/{participantId}
Section titled “GET /participants/{participantId}”One participant in the same form.
POST /participants/{participantId}/code
Section titled “POST /participants/{participantId}/code”Give a creator a code and a link, or replace them at any time.
curl -s https://suly.gg/api/partner/v1/participants/$ID/code \ -H "Authorization: Bearer $SULY_KEY" \ -H 'Content-Type: application/json' \ -d '{"code":"ANDRY","link":"https://partner.example/r/ANDRY"}'| Field | Rules |
|---|---|
code |
1–100 characters |
link |
An https:// address, up to 1,000 characters |
The answer is the participant, now active. The creator sees the new code and link at once. A code sent to a declined creator makes them a participant again.
POST /participants/{participantId}/reject
Section titled “POST /participants/{participantId}/reject”Decline a creator with a reason they will see.
curl -s https://suly.gg/api/partner/v1/participants/$ID/reject \ -H "Authorization: Bearer $SULY_KEY" \ -H 'Content-Type: application/json' \ -d '{"reason":"The audience does not fit"}'reason is 1–500 characters. The answer is the participant, now rejected. Declining never touches money that was already accrued.