> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getprescience.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get an event

> One event and its delivery state. Events from the other mode are not found.



## OpenAPI

````yaml /api-reference/openapi.json get /events/{eventId}
openapi: 3.1.0
info:
  title: Prescience Partner API
  version: 1.1.0
  description: >-
    Create employer groups, submit census records, generate preliminary
    market-rate quotes, create iframe sessions, create enrollments, and read
    aggregate account data.


    Money is always integer cents. Dates are `YYYY-MM-DD`; timestamps are ISO
    8601 UTC. Final pricing, eligibility, network availability, and plan
    documents are confirmed during underwriting and onboarding. A BAA and data
    processing agreement are executed before live mode is enabled.
  contact:
    name: Prescience partner engineering
    email: partners@getprescience.com
servers:
  - url: https://www.getprescience.com/api/partner/v1
    description: >-
      Production. Test and live traffic share this host; mode comes from your
      API key.
security:
  - bearerAuth: []
tags:
  - name: Health
    description: Connectivity and key checks.
  - name: Plans
    description: Static plan metadata.
  - name: Groups
    description: 'Employer groups: the root resource of every integration.'
  - name: Census
    description: Pre-enrollment census intake and ongoing member sync.
  - name: Quotes
    description: >-
      Preliminary quotes built from the stored census and current local
      market-plan snapshot.
  - name: Enrollments
    description: Plan selection and employer provisioning.
  - name: Account
    description: Aggregate, de-identified employer account data.
  - name: Webhooks
    description: Signed event delivery (standard-webhooks scheme).
paths:
  /events/{eventId}:
    get:
      tags:
        - Webhooks
      summary: Get an event
      description: >-
        One event and its delivery state. Events from the other mode are not
        found.
      operationId: getEvent
      parameters:
        - name: eventId
          in: path
          required: true
          schema:
            type: string
          example: evt_7c1d22e09b54
      responses:
        '200':
          description: The event.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WebhookEventWithDelivery'
              example:
                id: evt_7c1d22e09b54
                type: census.processed
                createdAt: '2026-06-10T17:15:09Z'
                mode: test
                data:
                  groupId: grp_8c2f41d09a3e
                  received: 12
                  accepted: 12
                  memberCount: 12
                  errorCount: 0
                delivery:
                  status: delivered
                  attempts: 1
                  lastAttemptAt: '2026-06-10T17:15:10Z'
                  lastStatusCode: 200
                  nextAttemptAt: null
                  deliveredAt: '2026-06-10T17:15:10Z'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/ServerError'
components:
  schemas:
    WebhookEventWithDelivery:
      allOf:
        - $ref: '#/components/schemas/WebhookEvent'
        - type: object
          required:
            - delivery
          properties:
            delivery:
              $ref: '#/components/schemas/WebhookDelivery'
    WebhookEvent:
      type: object
      required:
        - id
        - type
        - createdAt
        - mode
        - data
      properties:
        id:
          type: string
          description: >-
            Event ID. Also sent as the `webhook-id` header and part of the
            signed content.
          example: evt_9b21c7e4f60a
        type:
          type: string
          enum:
            - ping
            - quote.finalized
            - enrollment.created
            - group.state_changed
            - census.processed
            - group.market_rates_ready
            - group.market_rates_failed
        createdAt:
          type: string
          format: date-time
        mode:
          type: string
          enum:
            - test
            - live
        data:
          type: object
          description: Event-specific payload.
    WebhookDelivery:
      type: object
      required:
        - status
        - attempts
      properties:
        status:
          type: string
          enum:
            - pending
            - delivered
            - failed
            - dead
          description: >-
            `pending`: not yet attempted. `delivered`: your endpoint returned
            2xx. `failed`: the last attempt failed; `nextAttemptAt` says when it
            retries, or is null when no webhook was registered at the time.
            `dead`: retries exhausted; use redeliver.
        attempts:
          type: integer
        lastAttemptAt:
          type:
            - string
            - 'null'
          format: date-time
        lastStatusCode:
          type:
            - integer
            - 'null'
        nextAttemptAt:
          type:
            - string
            - 'null'
          format: date-time
        deliveredAt:
          type:
            - string
            - 'null'
          format: date-time
    Error:
      type: object
      required:
        - error
        - message
      properties:
        error:
          type: string
          enum:
            - invalid_request
            - unauthorized
            - live_mode_disabled
            - forbidden
            - not_found
            - conflict
            - rates_pending
            - quote_expired
            - market_unavailable
            - census_required
            - rate_limited
            - server_error
            - not_configured
            - email_not_allowed
            - verification_failed
          description: >-
            Stable machine-readable error code. `email_not_allowed` and
            `verification_failed` come only from the iframe's own endpoints,
            which partners do not call.
        message:
          type: string
          description: >-
            Human-readable explanation. Wording may change; branch on `error`,
            not `message`.
        details:
          type: array
          description: Present on `invalid_request`. One entry per failed field.
          items:
            type: object
            required:
              - field
              - message
            properties:
              field:
                type: string
                example: zip
              message:
                type: string
                example: zip must be a 5-digit ZIP code
              index:
                type: integer
                description: >-
                  For array payloads (census rows), the zero-based index of the
                  failing row.
                example: 7
  responses:
    Unauthorized:
      description: Missing, malformed, or revoked API key.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: unauthorized
            message: >-
              Provide a valid partner API key as `Authorization: Bearer
              psk_...`.
    NotFound:
      description: >-
        No such resource in this mode. Test keys only see test resources; live
        keys only see live resources.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: not_found
            message: No group grp_8c2f41d09a3e found.
    RateLimited:
      description: Rate limit exceeded. Honor `Retry-After`.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: rate_limited
            message: Too many requests. Please retry later.
      headers:
        Retry-After:
          description: Seconds to wait before retrying.
          schema:
            type: integer
          example: 12
    ServerError:
      description: >-
        Something failed on our side. Safe to retry with the same
        `Idempotency-Key`.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: server_error
            message: Internal error. The request was not applied.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Partner API key. `psk_test_<32 hex>` for test mode, `psk_live_<32 hex>`
        for live mode. Store them in your secrets manager on issue. Live keys
        are shown once; the scoped partner portal can show an active sandbox key
        again.

````