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

# Examiner Intelligence

Get an intelligence profile for a USPTO patent examiner, including historical
allowance rates, rejection patterns, and interview success rates.

## Name format

Examiner names must be in `LASTNAME, FIRSTNAME M` format and URL-encoded:

```
/v1/openclaw/examiner/SMITH%2C%20JOHN%20A
```

<Tip>
  Use the `/lookup` endpoint first to get the exact examiner name from a
  patent application. The `examiner_name` field in the lookup response is
  already in the correct format.
</Tip>

## Use cases

* **Pre-analysis**: Check examiner behavior before choosing a response strategy
* **Interview prep**: High `interview_success_rate` suggests scheduling an examiner interview
* **Workload assessment**: `avg_actions_to_allowance` indicates how many rounds to expect


## OpenAPI

````yaml api-reference/paid/openapi.json get /v1/openclaw/examiner/{examiner_name}
openapi: 3.1.0
info:
  title: Abigail API
  description: >-
    Patent prosecution AI API. Analyze office actions, draft response documents,
    and access examiner intelligence.
  version: 1.0.0
  contact:
    name: Abigail Support
    url: https://abigail.app
    email: support@abigail.app
servers:
  - url: https://api.abigail.app
    description: Production
security: []
paths:
  /v1/openclaw/examiner/{examiner_name}:
    get:
      tags:
        - Paid Endpoints
      summary: Examiner Intelligence
      description: >-
        Get an examiner intelligence profile including allowance rates,
        technology preferences, and historical behavior patterns.


        Examiner name format: `LASTNAME, FIRSTNAME M` (URL-encoded).


        **Billing:** Token-based. Metered against your credit balance.
      operationId: examiner_intelligence
      parameters:
        - name: examiner_name
          in: path
          required: true
          description: >-
            Examiner name in `LASTNAME, FIRSTNAME M` format. URL-encode spaces
            and commas.
          schema:
            type: string
          example: SMITH%2C%20JOHN%20A
        - name: X-API-Key
          in: header
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Examiner profile found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExaminerProfile'
              example:
                examiner_name: SMITH, JOHN A
                art_unit: '3621'
                allowance_rate: 0.34
                avg_actions_to_allowance: 2.8
                top_rejection_bases:
                  - 102(a)(1)
                  - '103'
                interview_success_rate: 0.67
                total_cases_analyzed: 142
        '404':
          description: Examiner not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - ApiKeyAuth: []
components:
  schemas:
    ExaminerProfile:
      type: object
      properties:
        examiner_name:
          type: string
        art_unit:
          type: string
        allowance_rate:
          type: number
          description: Historical allowance rate (0-1).
        avg_actions_to_allowance:
          type: number
        top_rejection_bases:
          type: array
          items:
            type: string
        interview_success_rate:
          type: number
        total_cases_analyzed:
          type: integer
    ErrorResponse:
      type: object
      description: Structured error with agent_suggestion for LLM consumers.
      properties:
        error:
          type: boolean
          const: true
        error_code:
          type: string
          description: Machine-readable error code.
        message:
          type: string
          description: Human-readable error message.
        agent_suggestion:
          type: string
          description: Actionable suggestion for AI agents consuming this API.
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: >-
        API key for paid endpoints. Create in your account Settings at
        https://abigail.app

````