Skip to content
Pidgely Docs

API reference · Events

List event names

GEThttps://api.pidgely.com/events/names
View as Markdown

The event names your organization has sent, most recently seen first (up to 500). Useful to pick the event of a trigger, a goal or a wait-for-event step.

The event names the organization has sent, most recently seen first (up to 500). Full access keys.

Authorization: Bearer pdg_…. An API key with full_access. A sending_access key gets 401 restricted_api_key.

Request

This endpoint is not in the SDKs yet; call it over HTTP.

cURL
curl -X GET 'https://api.pidgely.com/events/names' \
  -H "Authorization: Bearer $PIDGELY_API_KEY"

Response

200 OK

JSON
{
  "object": "list",
  "data": [
    {
      "name": "trial_started",
      "first_seen_at": "2026-09-02T14:10:00Z",
      "last_seen_at": "2026-10-22T12:00:00Z"
    }
  ]
}

Response fields

Name Type Required Description
object string Yes Object type. One of list.
data object[] Yes Items of this page.
data[].name string Yes Display name.
data[].first_seen_at string Yes Format: date-time.
data[].last_seen_at string Yes Format: date-time.

Errors

Errors have the shape {"statusCode", "name", "message"}. See Errors for the full list.

Status Name When
401 missing_api_key, restricted_api_key No Authorization: Bearer header, or a sending_access key called an endpoint that needs full_access.
403 invalid_api_key, validation_error The API key is invalid or revoked, or the request is not allowed for this account (unverified domain, plan limit, paused account).
429 rate_limit_exceeded Too many requests per second. Wait for Retry-After seconds.