Skip to main content
GET
/
events
List developer events
curl --request GET \
  --url https://api.social-api.ai/v1/events \
  --header 'Authorization: <api-key>'
{
  "events": [
    {
      "account_id": "<string>",
      "action": "publish",
      "category": "post",
      "created_at": "2026-03-27T10:00:00Z",
      "duration_ms": 230,
      "error_category": "validation",
      "error_message": "<string>",
      "id": "<string>",
      "metadata": {},
      "platform": "instagram",
      "resource_id": "<string>",
      "status": "success",
      "status_code": 400,
      "summary": "Published to Instagram"
    }
  ],
  "pagination": {
    "has_more": true,
    "limit": 25,
    "next_cursor": "<string>"
  },
  "retention_days": 30
}

Documentation Index

Fetch the complete documentation index at: https://docs.social-api.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

Prefix your API key with "Bearer ". Example: Authorization: Bearer sapi_key_...

Query Parameters

category
string

Filter by event category

status
string

Filter by status (ok, failed)

platform
string

Filter by platform

account_id
string

Filter by connected account ID

resource_id
string

Filter by resource ID (post, conversation, ...)

action
string

Filter by action (e.g. post.published)

from
string

Lower time bound (RFC3339)

to
string

Upper time bound (RFC3339)

cursor
string

Pagination cursor from a previous response

limit
integer

Page size (default 50)

Response

OK

events
object[]
pagination
object
retention_days
integer
Example:

30