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

# Get a process rule

> Full detail for a single rule, including its structured condition.

Returns everything in a rule summary plus the structured `condition` (deterministic, LLM-evaluated, or compound) and the `evidence` the pipeline used to infer it. For the complete audit trail back to source records, use [Get the provenance chain](/api-reference/get-rule-provenance).


## OpenAPI

````yaml openapi.yaml GET /v1/rules/{id}
openapi: 3.1.0
info:
  title: Seyn API
  version: 1.0.0
  description: >
    Programmatic access to Seyn for your organization.


    - **Ingest** data from any source with the Ingestion endpoints (requires a
    key with the `ingest` scope).

    - **Read** extracted process knowledge: search, rules, libraries,
    provenance, and metrics.


    Authenticate with a bearer API key (`sk_live_*`); each key is scoped to a
    single organization.
  contact:
    name: Seyn Support
    email: support@seynlabs.com
    url: https://seynlabs.com
servers:
  - url: https://api.seynlabs.com
    description: Production
  - url: https://api-dev.seynlabs.com
    description: Staging
security:
  - bearerAuth: []
tags:
  - name: Ingestion
    description: >-
      Push data into Seyn from any source: register a custom source and stream
      records to it
  - name: Knowledge
    description: Natural-language search over extracted knowledge
  - name: Rules
    description: Process rules, the atomic knowledge units extracted by the pipeline
  - name: Libraries
    description: Versioned snapshots of extracted knowledge for your organization
  - name: Patterns
    description: Aggregate pipeline analytics
paths:
  /v1/rules/{id}:
    get:
      tags:
        - Rules
      summary: Get a process rule
      operationId: rulesGet
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: Rule detail.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuccessEnvelope_RuleDetail'
        '400':
          $ref: '#/components/responses/ValidationError'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/RateLimited'
components:
  schemas:
    SuccessEnvelope_RuleDetail:
      type: object
      properties:
        success:
          type: boolean
          enum:
            - true
        data:
          $ref: '#/components/schemas/RuleDetail'
        meta:
          $ref: '#/components/schemas/Meta'
      required:
        - success
        - data
        - meta
    RuleDetail:
      allOf:
        - $ref: '#/components/schemas/RuleSummary'
        - type: object
          properties:
            condition:
              description: >
                Structured representation of the rule's logic. Shape is one of
                three

                variants discriminated by `type`: `deterministic`
                (field/operator/value),

                `llm` (free-form description), or `compound` (AND/OR over nested
                conditions).

                Treat as opaque JSON if you don't need to interpret it.
            evidence:
              description: >
                Supporting evidence the LLM used to infer the rule. Contains
                references

                to source events, the inference-log ID, counter-examples, and
                frequency

                metadata. Use `GET /v1/rules/{id}/provenance` for the full audit
                chain.
            inferenceLogId:
              type:
                - string
                - 'null'
              format: uuid
              description: >-
                ID of the LLM call that produced this rule. Use it to look up
                the full inference log via the provenance endpoint.
            updatedAt:
              type:
                - string
                - 'null'
              format: date-time
          required:
            - condition
            - evidence
            - inferenceLogId
            - updatedAt
    Meta:
      type: object
      properties:
        requestId:
          type: string
          description: Per-request UUID; quote in support tickets.
      additionalProperties: true
      required:
        - requestId
    ErrorBody:
      type: object
      properties:
        success:
          type: boolean
          enum:
            - false
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - MISSING_AUTH_HEADER
                - INVALID_API_KEY
                - KEY_REVOKED
                - RATE_LIMITED
                - NOT_FOUND
                - LIBRARY_NOT_FOUND
                - SOURCE_NOT_FOUND
                - VALIDATION_ERROR
                - INSUFFICIENT_SCOPE
                - PAYLOAD_TOO_LARGE
                - INTERNAL_ERROR
            message:
              type: string
          required:
            - code
            - message
      required:
        - success
        - error
    RuleSummary:
      type: object
      properties:
        id:
          type: string
          format: uuid
        description:
          type: string
          description: >-
            Plain-English statement of the rule, produced by the extraction
            pipeline.
        processId:
          type:
            - string
            - 'null'
          description: ID of the process this rule belongs to, or null if process-wide.
        appliesAtStep:
          type:
            - string
            - 'null'
          description: Step within the parent process where this rule applies, or null.
        confidence:
          type: number
          format: float
          minimum: 0
          maximum: 1
          description: 0–1 heuristic confidence score from the LLM.
        frequency:
          type: number
          format: float
          minimum: 0
          maximum: 1
          description: 0–1 share of opportunities where the rule's conditions held.
        reviewStatus:
          type: string
          enum:
            - inferred
            - confirmed
            - rejected
            - modified
          description: >-
            Human-review state of the rule. See [Review
            Status](https://docs.seynlabs.com/concepts#review-status).
        createdAt:
          type:
            - string
            - 'null'
          format: date-time
          description: ISO-8601 timestamp; null if the row predates timestamping.
      required:
        - id
        - description
        - processId
        - appliesAtStep
        - confidence
        - frequency
        - reviewStatus
        - createdAt
  responses:
    ValidationError:
      description: Request parameters failed validation.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorBody'
          examples:
            validationError:
              value:
                success: false
                error:
                  code: VALIDATION_ERROR
                  message: Query parameter 'q' is required
    Unauthorized:
      description: Missing or invalid API key.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorBody'
          examples:
            missing:
              summary: No Authorization header
              value:
                success: false
                error:
                  code: MISSING_AUTH_HEADER
                  message: 'Authorization: Bearer <api-key> header is required'
            invalid:
              summary: Unrecognized key
              value:
                success: false
                error:
                  code: INVALID_API_KEY
                  message: API key is invalid or unrecognized
    Forbidden:
      description: API key was revoked.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorBody'
          examples:
            revoked:
              value:
                success: false
                error:
                  code: KEY_REVOKED
                  message: API key has been revoked
    NotFound:
      description: Resource not found in this organization.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorBody'
          examples:
            notFound:
              value:
                success: false
                error:
                  code: NOT_FOUND
                  message: Process rule not found
    RateLimited:
      description: Per-key rate limit exceeded (default 60 req/min/key).
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorBody'
          examples:
            rateLimited:
              value:
                success: false
                error:
                  code: RATE_LIMITED
                  message: Rate limit exceeded for this API key
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: sk_live_*
      description: |
        Bearer token from `app.seynlabs.com` → Settings → API Keys.
        Send as `Authorization: Bearer sk_live_...`.

````