List campaigns

​

Returns a flat list of all campaigns across the given instances with basic metadata.

What is included per campaign:

  • Campaign ID, name, description, and status
  • Start date, first post date, and last post date
  • Instance ID the campaign belongs to

No performance metrics are included — use GET /campaigns/performance for metrics.

Pagination

Results are paginated. Use pageSize (default: 50, max: 100) and pageNumber (1-indexed) to navigate pages. The response includes a pagination object with page, pageSize, totalPages, and totalItems.

Query Parameters
  • pageSize
    Type: number
    min:  
    1
    max:  
    100

    Number of items per page.

  • pageNumber
    Type: number
    min:  
    1
    max:  
    500

    Page number (1-indexed).

  • instanceIds
    Type: array string[]

    One or more instance IDs to limit the query scope. If not provided, the query includes all instances accessible with the API credentials.

    Supported array formats: param=a,b,c (comma-separated), param=a&param=b (repeated key), or param[]=a&param[]=b (bracket syntax).

Responses
  • application/json
  • application/json
  • application/json
Request Example for get/v2/campaigns
curl 'https://reporting.api.later.com/v2/campaigns?pageSize=50&pageNumber=1&instanceIds=instance_abc&instanceIds=instance_def' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "data": [
    {
      "campaignId": 49761,
      "campaignName": "Summer Collection 2024",
      "description": "Seasonal product launch",
      "firstPostDate": "2024-06-15T00:00:00.000Z",
      "instanceId": "instance_abc",
      "lastPostDate": "2024-08-15T00:00:00.000Z",
      "startDate": "2024-06-01T00:00:00.000Z",
      "status": "live"
    },
    {
      "campaignId": 49802,
      "campaignName": "Fall Influencer Push",
      "description": null,
      "firstPostDate": null,
      "instanceId": "instance_abc",
      "lastPostDate": null,
      "startDate": "2024-09-01T00:00:00.000Z",
      "status": "draft"
    }
  ],
  "pagination": {
    "page": 1,
    "pageSize": 50,
    "totalItems": 2,
    "totalPages": 1
  }
}

List of campaigns with metadata