Fetch a Single Event by trcid
Look up a specific event using its stable trcid identifier
Every TRCItem has a trcid — a stable identifier that persists across systems. Use it to fetch a specific event when you know its ID.
Fetch by trcid
Use the trcid query parameter on GET /events:
curl -H "Authorization: Bearer YOUR_API_TOKEN" \
"https://app.eventconnectors.nl/api/events?trcid=e_abc123"const trcid = "e_abc123";
const response = await fetch(
`https://app.eventconnectors.nl/api/events?trcid=${trcid}`,
{ headers: { Authorization: "Bearer YOUR_API_TOKEN" } }
);
const events = await response.json();
const event = events[0]; // trcid lookup returns an arrayThe trcid query parameter returns an array, even for a single match. Access the first element to get your event.
Fetch by Internal ID
If you have the internal UUID (id field), you can fetch the event directly:
curl -H "Authorization: Bearer YOUR_API_TOKEN" \
"https://app.eventconnectors.nl/api/events/550e8400-e29b-41d4-a716-446655440000"const id = "550e8400-e29b-41d4-a716-446655440000";
const response = await fetch(
`https://app.eventconnectors.nl/api/events/${id}`,
{ headers: { Authorization: "Bearer YOUR_API_TOKEN" } }
);
const event = await response.json();The GET /events/{id} endpoint returns a single event object directly (not wrapped in an array).
When to Use Which
| Identifier | Endpoint | Returns |
|---|---|---|
trcid | GET /events?trcid=... | Array (filter result) |
id (UUID) | GET /events/{id} | Single object |
externalid | GET /events?externalid=... | Array (filter result) |
See the API Reference for the full GET /events and GET /events/{id} documentation.