List Campaigns
Returns the list of active campaigns for the authenticated workspace with pagination options.
GET https://api.platica.mx/v1/campaignsQuery parameters
| Parameter | Type | Description | Required |
|---|---|---|---|
limit | number | Maximum number of campaigns in the response per workspace. Maximum: 500. Default: 50 | — |
pageToken | string | nextPageToken cursor from the previous response. Preferred over offset. Cannot be combined with offset, and is invalidated if you change the sort | — |
offset | number | Number of records to skip. Legacy alternative to pageToken; capped at 100000 | — |
sortBy | enum | Sort field: lastUpdate (default) or creationDate | — |
sortDirection | enum | Sort direction: desc (default) or asc | — |
Response
{
"workspaces": [
{
"id": "ws_abc123",
"name": "Empresa Principal",
"campaignsCount": 2,
"campaigns": [
{
"id": "EgIOvaKPmrQFfuh6D023",
"title": "solicitud_rfc_facturacion",
"category": "utility",
"platform": "whatsapp",
"templateName": "solicitud_rfc_facturacion",
"owners": [
"soporte@empresa.com"
],
"language": "es_MX",
"creationDate": "2026-02-11T18:55:52.061Z",
"lastUpdate": "2026-02-11T19:46:29.285Z"
},
{
"id": "FhJPrbLQnsRGgvi7E134",
"title": "Promo Verano",
"category": "marketing",
"platform": "whatsapp",
"templateName": "promo_verano_2026",
"owners": [],
"creationDate": "2026-02-14T10:00:00.000Z",
"lastUpdate": "2026-02-14T12:00:00.000Z"
}
],
"pagination": {
"limit": 50,
"offset": 0,
"hasMore": false
}
}
],
"nextPageToken": null
}Response fields
| Field | Description |
|---|---|
workspaces | List of workspaces with their campaigns |
nextPageToken | Cursor to request the next page; null when no results are left. A single token covers every workspace the key can read, which is why it sits at the root instead of inside each one |
Each item in workspaces[]
| Field | Description |
|---|---|
id | Workspace ID |
name | Workspace name |
campaigns | List of campaign objects |
Each item in campaigns[]
| Field | Description |
|---|---|
id | Internal campaign ID |
title | Campaign title |
category | Category: marketing or utility |
platform | Send platform |
templateName | Name of the associated template when one exists |
owners | List of responsible-user emails |
language | Template language when applicable (can be omitted) |
creationDate | Creation date in ISO 8601 format |
lastUpdate | Last update date in ISO 8601 format |
Pagination fields
| Field | Description |
|---|---|
campaignsCount | Total number of campaigns returned for that workspace |
pagination.limit | Maximum number of results requested |
pagination.offset | Number of results skipped |
pagination.hasMore | Indicates whether more results exist |