Skip to main content
GET
https://api.vomo.org/v1
/
projects
List / Find Projects
curl --request GET \
  --url https://api.vomo.org/v1/projects \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "type": "project",
      "id": "4001",
      "project_name": "Saturday Pantry Pack",
      "description": "Pack weekend food bags for students at risk of hunger.",
      "details": "Wear closed-toe shoes. Bring a water bottle.",
      "url": "https://app.vomo.org/opportunity/saturday-pantry-pack",
      "organization_id": 50,
      "organization": "Riverside Hope Foundation",
      "organization_slug": "riverside-hope",
      "author_id": 7903,
      "owners": [
        {
          "id": 7903,
          "is_primary_owner": true,
          "send_notifications": true
        }
      ],
      "address": {
        "lat": "33.214561",
        "lng": "-96.614456",
        "country": "United States",
        "locality": "McKinney",
        "timezone": "America/Chicago",
        "postal_code": "75069",
        "country_short": "US",
        "locality_short": "McKinney",
        "formatted_address": "610 Elm St, McKinney, TX 75069, USA",
        "postal_code_short": "75069",
        "administrative_area_level_1": "Texas",
        "administrative_area_level_1_short": "TX"
      },
      "anytime": 0,
      "anywhere": 0,
      "draft": false,
      "created_at": "2025-11-01T09:00:00+00:00",
      "updated_at": "2025-11-05T14:22:00+00:00",
      "published_at": "2025-11-01T09:00:00+00:00",
      "campaigns": [],
      "certificates": [],
      "form_completions": [],
      "next_date": {
        "type": "project_date",
        "id": 40001,
        "starts_at": "2025-11-15T09:00:00+00:00",
        "ends_at": "2025-11-15T12:00:00+00:00",
        "participant_count": 8
      },
      "images": [
        "https://vomo-cdn.com/media/2025/11/pantry-pack-l.jpg"
      ]
    },
    {
      "type": "project",
      "id": "4002",
      "project_name": "Neighborhood Cleanup Drive",
      "description": "Beautify local parks and streetways across McKinney.",
      "details": null,
      "url": "https://app.vomo.org/opportunity/neighborhood-cleanup-drive",
      "organization_id": 50,
      "organization": "Riverside Hope Foundation",
      "organization_slug": "riverside-hope",
      "author_id": 7821,
      "owners": [
        {
          "id": 7821,
          "is_primary_owner": true,
          "send_notifications": true
        }
      ],
      "address": {
        "lat": "33.196800",
        "lng": "-96.615400",
        "country": "United States",
        "locality": "McKinney",
        "timezone": "America/Chicago",
        "postal_code": "75069",
        "country_short": "US",
        "locality_short": "McKinney",
        "formatted_address": "Oak St Park, McKinney, TX 75069, USA",
        "postal_code_short": "75069",
        "administrative_area_level_1": "Texas",
        "administrative_area_level_1_short": "TX"
      },
      "anytime": 0,
      "anywhere": 0,
      "draft": false,
      "created_at": "2025-11-03T10:15:00+00:00",
      "updated_at": "2025-11-07T08:00:00+00:00",
      "published_at": "2025-11-03T10:15:00+00:00",
      "campaigns": [],
      "certificates": [],
      "form_completions": [],
      "next_date": {
        "type": "project_date",
        "id": 40002,
        "starts_at": "2025-11-22T08:00:00+00:00",
        "ends_at": "2025-11-22T11:00:00+00:00",
        "participant_count": 12
      },
      "images": []
    }
  ],
  "links": {
    "first": "https://api.vomo.org/v1/projects?page=1",
    "last": "https://api.vomo.org/v1/projects?page=3",
    "prev": null,
    "next": "https://api.vomo.org/v1/projects?page=2"
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 3,
    "to": 15,
    "path": "https://api.vomo.org/v1/projects",
    "per_page": 15,
    "total": 34
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
page
integer

Page number (if paging results).

​
active
enum<string>

When set to true, limits results to currently active projects; when set to false, to past projects. Omit the parameter to return projects regardless of state — no filter is applied by default.

Available options:
true,
false
​
published
enum<string>

When set to true, limits results to published projects; when set to false, to unpublished (draft) projects. Omit the parameter to return projects regardless of publish state — no filter is applied by default.

Available options:
true,
false
​
anytime
enum<string>

When set to true, limits results to anytime (open-ended) projects; when set to false, to projects with definite scheduled times. Omit the parameter to return both — no filter is applied by default.

Available options:
true,
false
​
org_slug
string

One or more org slugs (comma separated) projects should belong to.

​
name_like
string

The project name, or part of a name, to search for.

​
created_before
string<date-time>

Date the Project was created on or before.

​
created_after
string<date-time>

Date the Project was created on or after

​
updated_before
string<date-time>

Date the Project was updated on or before.

​
updated_after
string<date-time>

Date the Project was updated on or after

​
dates_before
string<date-time>

Projects that have dates that started at or before the given date and time

​
dates_after
string<date-time>

Projects that have dates that started at or after the given date and time

Response

Returns the paginated list of projects for your organization family, filtered by the provided query parameters. The response includes pagination links and meta fields to navigate additional pages.

​
data
object[]
​
links
object

Pagination navigation links returned on every paginated list response. Each URL points at the specific list endpoint being called.

​
meta
object

Pagination metadata returned on every paginated list response.

Last modified on June 5, 2026