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

# Us Pds Submission

> Return a bounded exact-byte range from a published SEC PDS Feed submission.

This is a provenance-explicit dissemination read, not a canonical filing-content fallback.
Absence from the active PDS publication view is a 404 even when canonical filing metadata or
content exists. The internal Blob pointer is never returned. ``sha256`` identifies the whole
immutable CAS object; ``content_chunk_sha256`` authenticates the returned byte range.


## OpenAPI

````yaml /openapi.json get /us/pds/submissions/{accession_number}
openapi: 3.1.0
info:
  title: Corpus API
  description: >-
    Point-in-time financial and governed-document data for the US, India, and
    China.
  version: '2026-07-20'
servers:
  - url: https://corpus-api.onera.app
    description: Production
security: []
paths:
  /us/pds/submissions/{accession_number}:
    get:
      tags:
        - US · SEC PDS
      summary: Us Pds Submission
      description: >-
        Return a bounded exact-byte range from a published SEC PDS Feed
        submission.


        This is a provenance-explicit dissemination read, not a canonical
        filing-content fallback.

        Absence from the active PDS publication view is a 404 even when
        canonical filing metadata or

        content exists. The internal Blob pointer is never returned. ``sha256``
        identifies the whole

        immutable CAS object; ``content_chunk_sha256`` authenticates the
        returned byte range.
      operationId: us_pds_submission_us_pds_submissions__accession_number__get
      parameters:
        - name: accession_number
          in: path
          required: true
          schema:
            type: string
            title: Accession Number
        - name: start_byte
          in: query
          required: false
          schema:
            type: integer
            minimum: 0
            default: 0
            title: Start Byte
        - name: max_bytes
          in: query
          required: false
          schema:
            type: integer
            maximum: 75000
            minimum: 1
            default: 50000
            title: Max Bytes
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PdsSubmissionResponse'
        '400':
          description: Invalid parameter combination
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Missing or invalid API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Insufficient jurisdiction or scope
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Unknown resource
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '416':
          description: Byte range starts past EOF
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: Request schema validation failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: Rate limit exceeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '503':
          description: Source content is unavailable or still processing
          content:
            application/json:
              schema:
                oneOf:
                  - $ref: '#/components/schemas/FilingProcessingErrorResponse'
                  - $ref: '#/components/schemas/ErrorResponse'
      security:
        - X-API-KEY: []
components:
  schemas:
    PdsSubmissionResponse:
      properties:
        resource:
          type: string
          const: sec_pds_submission
          title: Resource
          default: sec_pds_submission
        accession_number:
          type: string
          title: Accession Number
        filing_type:
          type: string
          title: Filing Type
        filing_date:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: Filing Date
        document_count:
          anyOf:
            - type: integer
            - type: 'null'
          title: Document Count
        member_name:
          type: string
          title: Member Name
        member_kind:
          type: string
          const: submission
          title: Member Kind
          default: submission
        member_ordinal:
          type: integer
          title: Member Ordinal
        member_validation_status:
          type: string
          const: active_valid
          title: Member Validation Status
          default: active_valid
        member_validation_status_at_extraction:
          type: string
          title: Member Validation Status At Extraction
        archive_id:
          type: string
          title: Archive Id
        archive_family:
          type: string
          title: Archive Family
        archive_url:
          type: string
          title: Archive Url
        archive_date:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: Archive Date
        source_kind:
          type: string
          title: Source Kind
        archive_status:
          type: string
          enum:
            - available
            - needs_review
          title: Archive Status
        archive_complete:
          type: boolean
          const: true
          title: Archive Complete
          default: true
        archive_needs_review_count:
          type: integer
          title: Archive Needs Review Count
        sha256:
          type: string
          title: Sha256
        byte_size:
          type: integer
          title: Byte Size
        parser_version:
          type: string
          title: Parser Version
        content_type:
          type: string
          const: application/octet-stream
          title: Content Type
          default: application/octet-stream
        encoding:
          type: string
          const: base64
          title: Encoding
          default: base64
        content:
          type: string
          title: Content
        content_start_byte:
          type: integer
          minimum: 0
          title: Content Start Byte
        returned_bytes:
          type: integer
          minimum: 0
          title: Returned Bytes
        total_bytes:
          type: integer
          minimum: 0
          title: Total Bytes
        content_truncated:
          type: boolean
          title: Content Truncated
        next_start_byte:
          anyOf:
            - type: integer
              minimum: 0
            - type: 'null'
          title: Next Start Byte
        content_chunk_sha256:
          type: string
          title: Content Chunk Sha256
        provenance:
          $ref: '#/components/schemas/PdsSubmissionProvenance'
      type: object
      required:
        - accession_number
        - filing_type
        - member_name
        - member_ordinal
        - member_validation_status_at_extraction
        - archive_id
        - archive_family
        - archive_url
        - source_kind
        - archive_status
        - archive_needs_review_count
        - sha256
        - byte_size
        - parser_version
        - content
        - content_start_byte
        - returned_bytes
        - total_bytes
        - content_truncated
        - content_chunk_sha256
        - provenance
      title: PdsSubmissionResponse
    ErrorResponse:
      properties:
        error:
          type: string
          title: Error
        message:
          type: string
          title: Message
        request_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Request Id
      type: object
      required:
        - error
        - message
      title: ErrorResponse
    FilingProcessingErrorResponse:
      properties:
        error:
          type: string
          title: Error
        message:
          type: string
          title: Message
        request_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Request Id
        accession_number:
          type: string
          title: Accession Number
        retry_after_seconds:
          type: integer
          title: Retry After Seconds
      type: object
      required:
        - error
        - message
        - accession_number
        - retry_after_seconds
      title: FilingProcessingErrorResponse
    PdsSubmissionProvenance:
      properties:
        provider:
          type: string
          const: SEC
          title: Provider
          default: SEC
        system:
          type: string
          const: EDGAR PDS
          title: System
          default: EDGAR PDS
        representation:
          type: string
          const: official_dissemination_submission
          title: Representation
          default: official_dissemination_submission
        canonical_filing_content:
          type: boolean
          const: false
          title: Canonical Filing Content
          default: false
        source_url:
          type: string
          title: Source Url
        active_source_generation_id:
          type: string
          title: Active Source Generation Id
        inventory_generation_id:
          type: string
          title: Inventory Generation Id
        validated_generation_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Validated Generation Id
      type: object
      required:
        - source_url
        - active_source_generation_id
        - inventory_generation_id
      title: PdsSubmissionProvenance
  securitySchemes:
    X-API-KEY:
      type: apiKey
      in: header
      name: X-API-KEY
      description: >-
        Provisioned Corpus API key with the required jurisdiction and operation
        scopes.

````