---
title: "List / find Campaigns"
method: GET
path: "/campaigns"
tags: ["Campaigns"]
---

# List / find Campaigns

`GET /campaigns`

Returns a paginated list of all campaigns belonging to your organization family. Use this endpoint to sync campaign records into an external system or to look up campaigns by name. You can scope results to specific organizations using the org_slug filter, or narrow by creation and update timestamps to retrieve only recently changed records.

## Query parameters

- `page` integer
- `org_slug` string
- `name_like` string
- `created_before` string, date-time
- `created_after` string, date-time
- `updated_before` string, date-time
- `updated_after` string, date-time

## Response `200`

Returns the paginated list of campaigns for your organization family. The response includes pagination links and meta fields to navigate additional pages.

- object
  - `data` CampaignResource[]
    - `type` string — The VOMO object type
    - `id` string — The VOMO campaign ID (cast to string)
    - `campaign_name` string — The name of the campaign
    - `description` string — The description for the campaign
    - `url` string — A URL to the campaign on VOMO
    - `organization` string — The organization name the campaign is in
    - `organization_id` integer, nullable — The Organization ID the campaign belongs to.
    - `organization_slug` string, nullable — The organization slug the campaign is in
    - `author_id` integer — The VOMO user ID of the person who created the campaign
    - `logo_url` string — The URL for the campaign logo image
    - `updated_at` string, date-time — The date and time the campaign was updated at
    - `created_at` string, date-time — The date and time the campaign was created at
  - `links` PaginationLinks — Pagination navigation links returned on every paginated list response. Each URL points at the specific list endpoint being called.
    - `first` string — A link to the first page of results
    - `last` string — A link to the last page of results
    - `prev` string, nullable — A link to the previous page of results, or null on the first page
    - `next` string, nullable — A link to the next page of results, or null on the last page
  - `meta` PaginationMeta — Pagination metadata returned on every paginated list response.
    - `current_page` integer — The current page
    - `from` integer — The index of the first result on this page
    - `last_page` integer — The number of the last page of results
    - `to` integer — The index of the last result on this page
    - `path` string — The base URL of the list endpoint
    - `per_page` integer — The number of results per page
    - `total` integer — The total number of results

## Other responses

- `401` — Authentication credentials are missing or invalid.
- `429` — You have exceeded the rate limit of 30 requests per minute per API key.
- `500` — An unexpected server error occurred.

---

[API](https://skmtc.net/vomo/apis/vomo-api.md) · [All operations](https://skmtc.net/vomo/apis/vomo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vomo/vomo-api/versions/1582d52b5f1f/schema)