All Campaigns
GEThttps://www.viso.li/api/campaign
Returns a paginated list of campaigns you own, including goal config and current progress. Attached links are omitted here. Use GET campaign for the full link set.
Filter by createdAt window, stored status, or template key.
Send Authorization: Bearer sk_api_your_api_key on every request. See authentication.
Query parameters
All filters are optional. Newest campaigns first.
| Field | Type | Description |
|---|---|---|
search | string | Case-insensitive match on name or description. |
status | string | DRAFT, ACTIVE, or ENDED. |
templateKey | string | Known template key, for example bio-evergreen. |
createdFrom | string | ISO 8601 inclusive start of the createdAt window. |
createdTo | string | ISO 8601 inclusive end of the createdAt window. Must be on or after createdFrom. |
page | number | Page number, starting at 1. Defaults to 1. |
pageSize | number | Items per page, max 100. Defaults to 20. |
Example request
This lists active campaigns created in 2026 through 23 August.
1curl "https://www.viso.li/api/campaign?createdFrom=2026-01-01T00:00:00.000Z&createdTo=2026-08-23T23:59:59.000Z&status=ACTIVE&page=1&pageSize=20" \
2 -H "Authorization: Bearer sk_api_your_api_key"
Success response
Returns 200 OK.
response.json
1{
2 "campaigns": [
3 {
4 "id": "3f1c0c2a-7b4e-4d91-9c2a-1b8e6f0d2a11",
5 "name": "Bio link",
6 "description": null,
7 "status": "ACTIVE",
8 "templateKey": "bio-evergreen",
9 "goal": {
10 "type": "CLICKS",
11 "config": {
12 "target": 10000,
13 "windowDays": 30
14 }
15 },
16 "progress": {
17 "type": "CLICKS",
18 "target": 10000,
19 "current": 1240,
20 "remaining": 8760,
21 "percent": 12,
22 "reached": false
23 },
24 "linkCount": 1,
25 "startsAt": null,
26 "endsAt": null,
27 "createdAt": "2026-08-22T14:00:00.000Z"
28 }
29 ],
30 "page": 1,
31 "pageSize": 20,
32 "total": 1,
33 "totalPages": 1
34}
Response fields
| Field | Type | Description |
|---|---|---|
campaigns | object[] | Required. Page of campaigns. Same fields as GET campaign, without links. |
campaigns[].id | string | Required. Campaign UUID. |
campaigns[].name | string | Required. Campaign name. |
campaigns[].description | string | null | Required. Short description, or null. |
campaigns[].status | string | Required. ACTIVE, DRAFT, or ENDED. |
campaigns[].templateKey | string | null | Required. Stored template key, or null. |
campaigns[].goal | object | null | Required. Typed goal settings stored for this campaign. |
campaigns[].progress | object | null | Required. Current vs target, when the goal is numeric. |
campaigns[].linkCount | number | Required. Number of attached links. |
campaigns[].startsAt | string | null | Required. ISO 8601 start, or null. |
campaigns[].endsAt | string | null | Required. ISO 8601 end, or null. |
campaigns[].createdAt | string | Required. ISO 8601 time the campaign was created. |
page | number | Required. Current page. |
pageSize | number | Required. Requested page size. |
total | number | Required. Total matching campaigns. |
totalPages | number | Required. Total pages at this page size. |
Errors
| Status | Error | Description |
|---|---|---|
| 400 | Bad Request | Invalid page, dates, status, or template key. |
| 401 | Unauthorized | Missing, malformed, or invalid Bearer token. |
| 403 | Forbidden | Campaigns are not available on the current plan. |
| 429 | Too Many Requests | More than 10 requests per minute and 50 requests per day. Some responses include a Retry-After header. |
| 500 | Internal Server Error | Unexpected server error. Retry the request. |