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

# Get apidatasets versions arrowsample

> GET /datasets/{dataset_id}/versions/{version_id}/arrow/sample

Returns a sample of the version's tabular data. JSON envelope by
default. Requesting the Arrow IPC stream via ``Accept:
application/vnd.apache.arrow.stream`` currently returns 503 with a
``Retry-After`` header — Arrow output is unavailable on this
server; request ``application/json`` for the JSON envelope.

Query params:
  size    int   1..100_000   default 1000
  offset  int   ≥ 0          default 0
  columns CSV   subset       default = all columns



## OpenAPI

````yaml /api-reference/openapi.yaml get /api/datasets/{dataset_pk}/versions/{version_pk}/arrow/sample/
openapi: 3.0.3
info:
  title: Console API
  version: 1.0.0
  description: Central control plane API for the Dataerai platform.
servers:
  - url: https://{server}
    description: Your Dataerai deployment (the API is served under /api)
    variables:
      server:
        default: your-deployment.dataerai.com
        description: Host of your Dataerai deployment
security: []
paths:
  /api/datasets/{dataset_pk}/versions/{version_pk}/arrow/sample/:
    get:
      tags:
        - api
      description: |-
        GET /datasets/{dataset_id}/versions/{version_id}/arrow/sample

        Returns a sample of the version's tabular data. JSON envelope by
        default. Requesting the Arrow IPC stream via ``Accept:
        application/vnd.apache.arrow.stream`` currently returns 503 with a
        ``Retry-After`` header — Arrow output is unavailable on this
        server; request ``application/json`` for the JSON envelope.

        Query params:
          size    int   1..100_000   default 1000
          offset  int   ≥ 0          default 0
          columns CSV   subset       default = all columns
      operationId: api_datasets_versions_arrow_sample_retrieve
      parameters:
        - in: query
          name: columns
          schema:
            type: string
        - in: path
          name: dataset_pk
          schema:
            type: string
            format: uuid
          required: true
        - in: query
          name: format
          schema:
            type: string
            enum:
              - arrow
              - json
        - in: query
          name: offset
          schema:
            type: integer
        - in: query
          name: size
          schema:
            type: integer
        - in: path
          name: version_pk
          schema:
            type: string
            format: uuid
          required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ArrowSampleJSON'
            application/vnd.apache.arrow.stream:
              schema:
                $ref: '#/components/schemas/ArrowSampleJSON'
          description: ''
        '400':
          description: No response body
        '413':
          description: No response body
        '503':
          description: No response body
      security:
        - cookieAuthCsrfExempt: []
components:
  schemas:
    ArrowSampleJSON:
      type: object
      properties:
        rows:
          type: array
          items: {}
        columns:
          type: array
          items:
            type: string
        total:
          type: integer
        returned:
          type: integer
        offset:
          type: integer
      required:
        - columns
        - offset
        - returned
        - rows
        - total

````