Strivacity Account Event API

The Account Event API from Strivacity — 5 operation(s) for account event.

Documentation GitHub OpenAPI

Operations 5

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /admin/api/v1/events/account List customer account events · List account events #

Ask an LLM

“What login and registration events happened for a customer account?”

“Can I filter account events by IP address, event type or date range?”

Tell an agent

List account events for account {account}.

Show account events from IP {ip} between {start} and {end}.

GET /admin/api/v1/events/account/{eventId} Get a customer account event · Get an account event #

Ask an LLM

“What exactly happened in a single account event?”

“Can I open one account event by its ID?”

Tell an agent

Get account event {event}.

Show the details of customer account event {event}.

GET /admin/api/v1/events/descriptor List account event type descriptors · List descriptors for account events #

Ask an LLM

“What event types can appear in the account event log?”

“Which success and failure descriptors exist for account events?”

Tell an agent

List the descriptors for account events.

Show every possible account event type.

GET /admin/api/v1/events/notification List customer notification events · List notification events #

Ask an LLM

“Was a notification email or SMS actually delivered to a customer?”

“Can I filter notification events to only failed deliveries?”

Tell an agent

List notification events for account {account}.

Show notification events sent to {target} that failed.

GET /admin/api/v1/events/notification/{eventId} Get a customer notification event · Get a notification event #

Ask an LLM

“What happened with one specific notification that was sent?”

“Can I look up a single notification event?”

Tell an agent

Get notification event {event}.

Show delivery details for customer notification event {event}.

Documentation

📖

Documentation

https://docs.strivacity.com/docs/apis-and-sdks

📖

APIReference

https://docs.strivacity.com/reference/getting-started-with-the-admin-api

📖

GettingStarted

https://docs.strivacity.com/reference/getting-started-1

📖

APIReference

https://docs.strivacity.com/reference/getting-started-1

📖

Documentation

https://docs.strivacity.com/docs/oidc-client-using-the-journey-flow-api

Specifications

⚙

OpenAPI

https://raw.githubusercontent.com/api-evangelist/strivacity/refs/heads/main/openapi/strivacity-account-event-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/strivacity:strivacity-account-event-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  description: API documentation of Admin Portal
  title: Admin Portal Account Event API
  version: v0.0.1
servers:
- url: https://{tenant}
  variables:
    tenant:
      default: example.strivacity.com
      description: Your Strivacity tenant
tags:
- name: Account Event
paths:
  /admin/api/v1/events/account:
    get:
      description: 'You can list the account events by calling this endpoint.


        | REQUIRED API PERMISSION |

        |:------------------------|

        | read:event_account |'
      operationId: getAccountEvents
      parameters:
      - description: The applications in which the events occurred (specified by ID)
        in: query
        name: actorApplicationIds
        required: false
        schema:
          type: array
          items:
            type: string
      - description: The applications in which the events occurred (specified by name)
        in: query
        name: actorApplicationNames
        required: false
        schema:
          type: array
          items:
            type: string
      - description: The identity stores in which the events occurred (specified by ID)
        in: query
        name: subjectIdentityStores
        required: false
        schema:
          type: array
          items:
            type: string
      - description: Labels indicating the type of events. Filter events that contain all the listed labels.
        in: query
        name: labels
        required: false
        schema:
          type: array
          items:
            type: string
      - description: The accounts that were involved in the events
        in: query
        name: subjectAccountIds
        required: false
        schema:
          type: array
          items:
            type: string
      - description: Filter against the given variant IDs or 'null'. Explicit 'null' means baseline variant.
        in: query
        name: variantIds
        required: false
        schema:
          type: array
          items:
            type: string
      - description: 'The IP addresses from which the events have been initiated. This represents a list of subnet ranges (CIDR). See: [RFC 4632](https://www.rfc-editor.org/rfc/rfc4632)'
        example: 1.1.1.1/32
        in: query
        name: actorIps
        required: false
        schema:
          type: array
          items:
            type: string
      - description: The sessions in which the events occurred (`sid` claim in ID token)
        in: query
        name: loginSessionIds
        required: false
        schema:
          type: array
          items:
            type: string
      - description: Types of account events to filter, if not defined every type is returned
        in: query
        name: eventTypes
        required: false
        schema:
          type: array
          items:
            type: string
            enum:
            - customerFlow
            - selfService
            - administrative
            - scheduled
            - bulkOperation
            - systemInitiatedOperation
      - description: Outbound provisioning targets to filter events by (specified by ID). If provided, only events associated with one of these outboundProvisionTargetId values are returned.
        in: query
        name: outboundProvisionTargetIds
        required: false
        schema:
          type: array
          items:
            type: string
      - description: Start date used for filtering
        in: query
        name: startDate
        required: false
        schema:
          type: string
          format: date-time
      - description: End date used for filtering
        in: query
        name: endDate
        required: false
        schema:
          type: string
          format: date-time
      - description: Zero-based page index (0..N)
        in: query
        name: page
        schema:
          type: integer
          format: int64
          default: 0
      - description: The size of the page to be returned
        in: query
        name: size
        schema:
          type: integer
          format: int64
          default: 20
      - description: 'Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.'
        in: query
        name: sort
        schema:
          type: array
          items:
            type: string
      responses:
        '200':
          content:
            '*/*':
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/AccountEventHeaderResponse'
          description: OK
        '401':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemJson'
          description: Unauthorized
        '403':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemJson'
          description: Forbidden
      security:
      - securityScheme:
        - read:event_account
      summary: List account events
      tags:
      - Account Event
  /admin/api/v1/events/account/{eventId}:
    get:
      description: 'You can get an account event by calling this endpoint.


        | REQUIRED API PERMISSION |

        |:------------------------|

        | read:event_account |'
      operationId: getAccountEventById
      parameters:
      - in: path
        name: eventId
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/AccountEventResponse'
          description: OK
        '401':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemJson'
          description: Unauthorized
        '403':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemJson'
          description: Forbidden
        '404':
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ProblemJson'
          description: Not Found
      security:
      - securityScheme:
        - read:event_account
      summary: Get an account event
      tags:
      - Account Event
  /admin/api/v1/events/descriptor:
    get:
      description: 'You can list the possible descriptors for account events by calling this endpoint. Descriptors for account events are in the following format: `(failure|success):{eventType}`.


        | REQUIRED API PERMISSION |

        |:------------------------|

        | read:event_account |'
      operationId: getDescriptor
      responses:
        '200':
          content:
            '*/*':
              schema:
                type: array
                items:
                  type: string
                  example: success:login
          description: OK
        '401':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemJson'
          description: Unauthorized
        '403':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemJson'
          description: Forbidden
      security:
      - securityScheme:
        - read:event_account
      summary: List descriptors for account events
      tags:
      - Account Event
  /admin/api/v1/events/notification:
    get:
      description: 'You can list the notification events by calling this endpoint.


        | REQUIRED API PERMISSION |

        |:------------------------|

        | read:event_account |'
      operationId: getNotificationEvents
      parameters:
      - description: The identity stores in which the notification events occurred (specified by ID)
        in: query
        name: identityStores
        required: false
        schema:
          type: array
          items:
            type: string
      - description: The email address or phone number to which the notifications were sent
        in: query
        name: target
        required: false
        schema:
          type: string
      - description: The accounts associated with the notification events
        in: query
        name: accountIds
        required: false
        schema:
          type: array
          items:
            type: string
      - description: The invitations associated with the notification events
        in: query
        name: invitationIds
        required: false
        schema:
          type: array
          items:
            type: string
      - description: The account events associated with the notification events
        in: query
        name: accountEventIds
        required: false
        schema:
          type: array
          items:
            type: string
      - description: Whether the notification sending was successful or not
        in: query
        name: success
        required: false
        schema:
          type: boolean
      - description: Zero-based page index (0..N)
        in: query
        name: page
        schema:
          type: integer
          format: int64
          default: 0
      - description: The size of the page to be returned
        in: query
        name: size
        schema:
          type: integer
          format: int64
          default: 20
      - description: 'Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.'
        in: query
        name: sort
        schema:
          type: array
          items:
            type: string
      responses:
        '200':
          content:
            '*/*':
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/NotificationEventListResponse'
          description: OK
        '401':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemJson'
          description: Unauthorized
        '403':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemJson'
          description: Forbidden
      security:
      - securityScheme:
        - read:event_account
      summary: List notification events
      tags:
      - Account Event
  /admin/api/v1/events/notification/{eventId}:
    get:
      description: 'You can get a notification event by calling this endpoint.


        | REQUIRED API PERMISSION |

        |:------------------------|

        | read:event_account |'
      operationId: getNotificationEventById
      parameters:
      - in: path
        name: eventId
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/NotificationEventResponse'
          description: OK
        '401':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemJson'
          description: Unauthorized
        '403':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemJson'
          description: Forbidden
        '404':
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ProblemJson'
          description: Not Found
      security:
      - securityScheme:
        - read:event_account
      summary: Get a notification event
      tags:
      - Account Event
components:
  schemas:
    Detail:
      type: object
      properties:
        label:
          type: string
        metadata:
          type: object
          additionalProperties:
            type: object
        name:
          type: string
        notifications:
          type: array
          items:
            $ref: '#/components/schemas/Notification'
        outcome:
          type: string
        timestamp:
          type: string
          format: date-time
        type:
          type: string
      description: Represents the details of an event
    ActionResponse:
      type: object
      properties:
        actor:
          $ref: '#/components/schemas/EventActor'
        details:
          type: array
          items:
            $ref: '#/components/schemas/Detail'
        http:
          $ref: '#/components/schemas/Http'
        notifications:
          type: array
          items:
            $ref: '#/components/schemas/Notification'
        timestamp:
          type: string
          format: date-time
        type:
          type: string
          description: 'Gives additional context for an account event. An example for each event type: `customerFlow` - an account tries to log in, `selfService` - an account modifies their own metadata, `administrative` - an admin modifies metadata for an account'
          enum:
          - customerFlow
          - selfService
          - administrative
          - scheduled
          - bulkOperation
          - systemInitiatedOperation
    Notification:
      type: object
      properties:
        id:
          type: string
        target:
          type: string
    NotificationEventListResponse:
      type: object
      properties:
        accountEventId:
          type: string
        accountId:
          type: string
        channel:
          type: string
        id:
          type: string
        identityStore:
          type: string
        invitationId:
          type: string
        notificationPolicyId:
          type: string
        notificationTemplate:
          $ref: '#/components/schemas/DisplayNameAndIdResponse'
        success:
          type: boolean
        target:
          type: string
        timestamp:
          type: string
        validUntil:
          type: string
      description: Represents a notification event briefly. Fields with empty values are not included in the response.
    ResolvedApplication:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
      description: Represents the resolved application of a token exchange account event
    Response:
      type: object
      properties:
        body:
          type: string
        code:
          type: integer
          format: int32
        location:
          type: string
      description: Represents the HTTP response for an event
    ResolvedClient:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
      description: Represents the resolved client of a token exchange account event
    EventActor:
      type: object
      properties:
        accountId:
          type: string
        bulkJobId:
          type: string
        inboundConnectionId:
          type: string
        ip:
          type: string
        location:
          $ref: '#/components/schemas/FeatureResponse'
        outboundProvisionTargetId:
          type: string
        resolvedApplication:
          $ref: '#/components/schemas/ResolvedApplication'
        resolvedClient:
          $ref: '#/components/schemas/ResolvedClient'
        ruleId:
          type: string
        store:
          type: string
          description: Name of the represented identity store
        token:
          $ref: '#/components/schemas/Token'
        userAgent:
          type: string
          description: Information about the browser the actor used
        userName:
          type: string
          description: Username or email of the actor (email for email-only identity stores)
      description: Actor of the event, which account initiated the event
    ErrorMessage:
      type: object
      properties:
        message:
          type: string
        retryCount:
          type: integer
          format: int32
    GeometryResponse:
      type: object
      properties:
        coordinates:
          type: array
          items:
            type: number
            format: double
        type:
          type: string
      description: Represents a geometry object according to the [RFC 7946](https://www.rfc-editor.org/rfc/rfc7946#section-3.1) standard
    DisplayNameAndIdResponse:
      type: object
      properties:
        displayName:
          type: string
        id:
          type: string
    NotificationEventResponse:
      type: object
      properties:
        accountEventId:
          type: string
        accountId:
          type: string
        channel:
          type: string
        errorMessages:
          type: array
          items:
            $ref: '#/components/schemas/ErrorMessage'
        id:
          type: string
        identityStore:
          type: string
        invitationId:
          type: string
        message:
          type: string
        messagePlainText:
          type: string
        notificationPolicyId:
          type: string
        notificationTemplate:
          $ref: '#/components/schemas/DisplayNameAndIdResponse'
        providerMessageId:
          type: string
        success:
          type: boolean
        target:
          type: string
        timestamp:
          type: string
        validUntil:
          type: string
      description: Represents a notification event. Fields with empty values are not included in the response.
    AccountEventActorClient:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
      description: Client in which the actor initiated the event
    FieldError:
      type: object
      properties:
        field:
          type: string
        message:
          type: string
        objectName:
          type: string
    Subject:
      type: object
      properties:
        accountId:
          type: string
        requestedSubject:
          type: string
        resolvedApplication:
          $ref: '#/components/schemas/ResolvedApplication'
        resolvedClient:
          $ref: '#/components/schemas/ResolvedClient'
        store:
          type: string
          description: Name of the identity store
        token:
          $ref: '#/components/schemas/Token'
        userName:
          type: string
      description: Represents the subject of an account event by additional context
    ProblemJson:
      type: object
      properties:
        detail:
          type: string
        entityName:
          type: string
          description: The name of the entity within the error has occurred
        errorKey:
          type: string
          description: A unique identifier of the error
        fieldErrors:
          type: array
          description: Field constraint violation errors
          items:
            $ref: '#/components/schemas/FieldError'
        message:
          type: string
          description: A unique identifier in format of 'error.{errorKey}'
        params:
          type: array
          description: Further information related to the actual error
          items:
            type: object
            additionalProperties:
              type: object
        path:
          type: string
          description: Request URI
        status:
          type: integer
          description: Status code
          format: int32
        title:
          type: string
      description: Based on [RFC 7807](https://datatracker.ietf.org/doc/html/rfc7807)
    FeatureResponse:
      type: object
      properties:
        geometry:
          $ref: '#/components/schemas/GeometryResponse'
        properties:
          type: object
          additionalProperties:
            type: string
        type:
          type: string
      description: Represents a feature object according to the [RFC 7946](https://www.rfc-editor.org/rfc/rfc7946#section-3.2) standard
    Token:
      type: object
      properties:
        iss:
          type: string
        sub:
          type: string
      description: Represents the token of a token exchange account event
    Http:
      type: object
      properties:
        request:
          $ref: '#/components/schemas/Request'
        response:
          $ref: '#/components/schemas/Response'
      description: Represents the HTTP communication for an event
    Request:
      type: object
      properties:
        body:
          type: string
        method:
          type: string
        url:
          type: string
      description: Represents the HTTP request for an event
    ActorApplication:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
      description: Application in which the actor initiated the event
    AccountEventHeaderResponse:
      type: object
      properties:
        actor:
          $ref: '#/components/schemas/EventActor'
        actorApplication:
          $ref: '#/components/schemas/ActorApplication'
        actorClient:
          $ref: '#/components/schemas/AccountEventActorClient'
        endTimestamp:
          type: string
          format: date-time
        eventId:
          type: string
          format: uuid
        labels:
          type: array
          description: 'Labels indicating what happened during the occurrence of the event.Labels are in the following format: `(failure|success):{eventType}`'
          items:
            type: string
            example: success:login
        loginSessionId:
          type: string
        startTimestamp:
          type: string
          format: date-time
        subject:
          $ref: '#/components/schemas/Subject'
        type:
          type: string
          description: 'Gives additional context for an account event. An example for each event type: `customerFlow` - an account tries to log in, `selfService` - an account modifies their own metadata, `administrative` - an admin modifies metadata for an account'
          enum:
          - customerFlow
          - selfService
          - administrative
          - scheduled
          - bulkOperation
          - systemInitiatedOperation
        variantId:
          type: string
      description: Represents an account event header. Fields with empty values are not included in the response.
    AccountEventResponse:
      type: object
      properties:
        actions:
          type: array
          items:
            $ref: '#/components/schemas/ActionResponse'
        actor:
          $ref: '#/components/schemas/EventActor'
        actorApplication:
          $ref: '#/components/schemas/ActorApplication'
        actorClient:
          $ref: '#/components/schemas/AccountEventActorClient'
        endTimestamp:
          type: string
          format: date-time
        eventId:
          type: string
          format: uuid
        labels:
          type: array
          description: 'Labels indicating what happened during the occurrence of the event.Labels are in the following format: `(failure|success):{eventType}`'
          items:
            type: string
            example: success:login
        loginSessionId:
          type: string
        startTimestamp:
          type: string
          format: date-time
        subject:
          $ref: '#/components/schemas/Subject'
        type:
          type: string
          description: 'Gives additional context for an account event. An example for each event type: `customerFlow` - an account tries to log in, `selfService` - an account modifies their own metadata, `administrative` - an admin modifies metadata for an account'
          enum:
          - customerFlow
          - selfService
          - administrative
          - scheduled
          - bulkOperation
          - systemInitiatedOperation
        variantId:
          type: string
      description: Represents an account event. Fields with empty values are not included in the response.
  securitySchemes:
    securityScheme:
      scheme: bearer
      type: http