Events

Endpoints

GET/v1/events/{event}
GET/v1/events

The Event object

Attributes

idstring
Unique identifier of the object (prefixed, opaque).
objectstring
event
typestring
api_versionstring
createdinteger
Time at which the object was created (unix timestamp, seconds).
livemodeboolean
true for live data, false for the test-mode sandbox.
brandstringnullable
The brand the object belongs to (br_…).
dataobject
Show child attributes
- objectobject
  String representing the object type.
- previous_attributesobject

The Event object


{
  "id": "evt_034wK3aZBwxdUFxpXoBNdT",
  "object": "event",
  "type": "string",
  "api_version": "v1",
  "created": 1790000000,
  "livemode": true,
  "brand": "br_034CyfRFSXUqzrbzV6MAfZ",
  "data": {
    "object": {},
    "previous_attributes": {}
  }
}

Retrieve an event

GET/v1/events/{event}

Parameters

eventstringrequired
Event id (evt_…).

Returns

Returns the event object. Raises an error if something goes wrong.

curl


curl https://api.skoup.ai/v1/events/evt_034wK3aZBwxdUFxpXoBNdT \
  -H "Authorization: Bearer skoup_test_4eC39HqLyjWDarjtT1zdp7dc"

Node.js


const response = await fetch('https://api.skoup.ai/v1/events/evt_034wK3aZBwxdUFxpXoBNdT', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.SKOUP_API_KEY}`,
  },
})
const data = await response.json()

PHP


$client = new GuzzleHttp\Client(['base_uri' => 'https://api.skoup.ai/v1/']);
$response = $client->request('GET', 'events/evt_034wK3aZBwxdUFxpXoBNdT', [
    'headers' => ['Authorization' => 'Bearer '.getenv('SKOUP_API_KEY')],
]);
$data = json_decode((string) $response->getBody(), true);

Python


import os, requests
 
response = requests.get(
    "https://api.skoup.ai/v1/events/evt_034wK3aZBwxdUFxpXoBNdT",
    headers={"Authorization": f"Bearer {os.environ['SKOUP_API_KEY']}"},
)
data = response.json()

Response


{
  "id": "evt_034wK3aZBwxdUFxpXoBNdT",
  "object": "event",
  "type": "string",
  "api_version": "v1",
  "created": 1790000000,
  "livemode": true,
  "brand": "br_034CyfRFSXUqzrbzV6MAfZ",
  "data": {
    "object": {},
    "previous_attributes": {}
  }
}

List events

GET/v1/events

Events of the last 30 days, newest first — the same objects your webhook endpoints receive. Use it to catch up after downtime.