Skip to main content
GET
/
builders
/
{builderId}
/
meetings
cURL
curl --request GET \
  --url https://api.buildpass.global/builders/{builderId}/meetings \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "extapitoolboxmeeting01",
      "builderId": "buil_clgbsb90b001qjy0f0eo1hspp",
      "projectId": "proj_clgbsb90b001qjy0f0eo1hscp",
      "projectName": "Downtown Mall Construction",
      "projectTimezone": "Australia/Brisbane",
      "title": "External API seeded meeting",
      "name": "External API seeded meeting",
      "meetingTitle": "External API seeded meeting",
      "meetingTypeId": null,
      "meetingTypeName": null,
      "date": "2026-01-15T09:00:00.000Z",
      "startAt": "2026-01-15T09:00:00.000Z",
      "scheduledAt": "2026-01-15T09:00:00.000Z",
      "status": "DISTRIBUTED",
      "meetingStatus": "DISTRIBUTED",
      "agenda": "External API integration test agenda",
      "description": "Seeded meeting for External API integration tests",
      "notes": "Seeded meeting for External API integration tests",
      "updatedAt": "2026-01-15T09:00:00.000Z"
    }
  ],
  "meta": {
    "totalCount": 100,
    "totalPages": 4,
    "offset": 0,
    "limit": 25
  }
}

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

builderId
string
required
Example:

"buil_clgbsb90b001qjy0f0eo1hspp"

Query Parameters

from
string<date-time>

Filter meetings from this date-time

Example:

"2026-01-01T00:00:00.000Z"

to
string<date-time>

Filter meetings until this date-time

Example:

"2026-01-31T23:59:59.999Z"

status
enum<string>[]

Filter by meeting status. Repeat the parameter for multiple values.

Available options:
DRAFT,
DISTRIBUTED,
COMPLETED,
RUNNING
offset
integer
default:0

The number of items to skip before starting to collect the result set

Example:

0

limit
integer
default:25

The number of items to return.

Required range: x <= 25
Example:

25

Response

A list of meetings

data
object[]
meta
object