> ## Documentation Index > Fetch the complete documentation index at: https://docs.case.dev/llms.txt > Use this file to discover all available pages before exploring further. # Search federal dockets and filings > Search federal court dockets or retrieve a specific docket with optional filing entries. Use legal.listCourts() to resolve court slugs for filtering. ## OpenAPI ````yaml /openapi.json post /legal/v1/docket openapi: 3.1.0 info: title: Case.dev API description: >- The AI-native platform for legal technology. Build smarter legal applications with our suite of AI-powered APIs. version: 1.0.0 contact: name: Case.dev Support email: support@casemark.com url: https://case.dev license: name: Proprietary url: https://case.dev/terms servers: - url: https://api.case.dev description: Production security: - bearerAuth: [] tags: - name: Vaults description: Secure document storage with semantic search and GraphRAG - name: Memory description: >- Persistent memory for AI agents with semantic search and 12 generic indexed tag fields - name: OCR description: Extract text from PDFs, images, and scanned documents - name: Voice description: Audio transcription and text-to-speech - name: LLMs description: Access 40+ language models through a unified API - name: Search description: Web search, AI answers, and deep research - name: Mail description: Managed inboxes for agent email workflows - name: Media description: Transcript retrieval and captioned media clip generation - name: Legal description: Legal research tools including citation verification - name: Privilege description: Privilege detection for e-discovery and litigation workflows - name: Compute description: Serverless GPU and CPU infrastructure - name: Format description: Document formatting and template rendering (MD/JSON to PDF/DOCX) - name: SuperDoc description: Document conversion and template automation - name: Webhooks description: Webhook endpoint management - name: System description: Public system metadata and discovery endpoints - name: Usage description: Usage reporting and webhook subscriptions - name: Database description: Serverless PostgreSQL databases with instant branching - name: Translation description: Language detection and translation for multilingual legal workflows - name: Skills description: Search and read legal AI skills for agents - name: Agents description: >- Create, manage, and execute AI agents with tool access, sandbox environments, and async run workflows - name: Matters description: Matter-native legal workspaces and orchestration primitives - name: Applications Projects description: Web application project management - name: Applications Deployments description: Web application deployment management - name: Applications Domains description: Custom domain configuration for applications - name: Applications Env Vars description: Environment variable management for applications paths: /legal/v1/docket: post: tags: - Legal summary: Search federal dockets and filings description: >- Search federal court dockets or retrieve a specific docket with optional filing entries. Use legal.listCourts() to resolve court slugs for filtering. operationId: legalDocket requestBody: description: Docket query parameters required: true content: application/json: schema: type: object required: - type properties: type: type: string enum: - search - lookup description: Search dockets or look up a docket by ID query: type: string description: Case name or party name search query (required for search) minLength: 2 maxLength: 500 court: type: string description: >- Optional court slug for filtering (e.g. "nysd", "ca9", "cafc"). Use legal.listCourts() to find slugs. dateFiledAfter: type: string format: date description: Optional lower bound for filing date (YYYY-MM-DD) dateFiledBefore: type: string format: date description: Optional upper bound for filing date (YYYY-MM-DD) docketId: type: string description: Docket ID (required for lookup) includeEntries: type: boolean default: false description: Include docket entries/filings in lookup responses. live: type: boolean default: false description: >- Trigger a live PACER fetch for dockets not yet in the RECAP archive. Requires acknowledgePacerFees: true. PACER charges up to $3.00 per docket sheet plus a $0.05 service fee. Only valid with type: "lookup". acknowledgePacerFees: type: boolean default: false description: >- Required when live: true. Acknowledges that PACER fees (up to $3.00 per docket) plus a $0.05 service fee will be charged to your account. limit: type: integer minimum: 1 maximum: 100 default: 25 description: >- Page size for search results or entry list (default 25 for search, 50 for lookup) offset: type: integer minimum: 0 maximum: 200 default: 0 description: >- Offset for search results or entry list (maximum 200 when including lookup entries) responses: '200': description: Docket query completed successfully content: application/json: schema: type: object properties: type: type: string enum: - search - lookup query: type: string nullable: true description: Echo of search query (search mode only) court: type: string nullable: true description: Echo of court filter (search mode only) dateFiledAfter: type: string format: date nullable: true description: Echo of date filter dateFiledBefore: type: string format: date nullable: true description: Echo of date filter found: type: integer dockets: title: DocketSearchResults type: array description: Search results (search mode) items: title: DocketSearchResult type: object properties: id: type: string caseName: type: string nullable: true docketNumber: type: string nullable: true court: type: string nullable: true courtId: type: string nullable: true dateFiled: type: string format: date nullable: true dateTerminated: type: string format: date nullable: true cause: type: string nullable: true natureOfSuit: type: string nullable: true parties: type: array items: type: string assignedTo: type: string nullable: true url: type: string pacerCaseId: type: string nullable: true includeEntries: type: boolean description: Whether entries were requested (lookup mode only) docket: title: DocketDetail type: object nullable: true description: Full docket record (lookup mode) properties: id: type: string caseName: type: string nullable: true docketNumber: type: string nullable: true court: type: string nullable: true courtId: type: string nullable: true dateFiled: type: string format: date nullable: true dateTerminated: type: string format: date nullable: true cause: type: string nullable: true natureOfSuit: type: string nullable: true parties: type: array items: type: string assignedTo: type: string nullable: true url: type: string pacerCaseId: type: string nullable: true entries: type: array nullable: true description: Docket entries/filings (lookup mode with includeEntries) items: type: object properties: entryNumber: type: integer nullable: true date: type: string format: date nullable: true description: type: string nullable: true documents: type: array items: type: object properties: id: type: string documentNumber: type: string nullable: true attachmentNumber: type: integer nullable: true description: type: string nullable: true pdfUrl: type: string nullable: true pageCount: type: integer nullable: true isAvailable: type: boolean pagination: type: object nullable: true description: >- Pagination info for entry list (lookup mode with includeEntries) properties: limit: type: integer offset: type: integer returned: type: integer live: type: boolean description: Whether this was a live PACER fetch (lookup mode only) pacerFees: type: object nullable: true description: 'PACER fee information (present when live: true)' properties: serviceFee: type: number description: CaseMark service fee in USD maxPacerCost: type: number description: Maximum PACER charge per docket in USD currency: type: string enum: - USD fetchDurationMs: type: integer description: Time taken for PACER fetch in milliseconds '400': description: Bad request - invalid parameters '401': description: Unauthorized - invalid API key '403': description: Forbidden - insufficient permissions '404': description: Docket not found '429': description: Too many requests - daily PACER spend cap exceeded '502': description: Bad gateway - upstream provider error '503': description: Service unavailable - docket data source not configured components: securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: API Key description: API key starting with `sk_case_` ````