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

# List Orders

> List orders, newest first by default, with pagination.



## OpenAPI

````yaml GET /v1/orders
openapi: 3.1.0
info:
  title: NitroTranslate API
  description: Human Translation API
  version: 0.1.1
servers:
  - url: https://api.nitrotranslate.com
    description: NitroTranslate
security:
  - BasicAuth: []
  - BearerAuth: []
  - PaymentAuth: []
paths:
  /v1/orders:
    get:
      summary: ListOrders
      description: List orders, newest first by default, with pagination.
      operationId: OrderService_ListOrders
      parameters:
        - name: sort
          in: query
          description: 'Sort by creation time: "asc" or "desc" (default).'
          schema:
            type: string
            title: sort
            enum:
              - asc
              - desc
        - name: page
          in: query
          description: Zero-based page index. Defaults to 0.
          schema:
            type: integer
            title: page
            minimum: 0
            format: int32
        - name: per_page
          in: query
          description: Page size. Defaults to 20.
          schema:
            type: integer
            title: per_page
            minimum: 1
            format: int32
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/nitrotranslate.v1.OrderSummary'
                title: orders
components:
  schemas:
    nitrotranslate.v1.OrderSummary:
      type: object
      properties:
        id:
          type:
            - integer
            - string
          title: id
          format: int64
        status:
          type:
            - string
            - 'null'
          title: status
          enum:
            - QUEUE
            - PROGRESS
            - DONE
            - REVISION
          description: >-
            Lifecycle status: QUEUE -> PROGRESS -> DONE. REVISION marks a
            completed
             order pending revision; active rework reports as PROGRESS again.
        source_language:
          type: string
          title: source_language
        target_language:
          type: string
          title: target_language
        snippet:
          type: string
          title: snippet
          description: Short preview of the source text. ListOrders only.
        volume:
          type: integer
          title: volume
          format: int32
          description: Billable character volume.
        price:
          type: number
          title: price
          format: double
          description: Order price in US dollars. Always returned.
        created_at:
          $ref: '#/components/schemas/google.protobuf.Timestamp'
          title: created_at
      title: OrderSummary
      additionalProperties: false
      description: |-
        A lightweight order projection shared by the ListOrders and Translate
         responses. `price` is always returned; `status`/`snippet` are set by
         ListOrders only, and proto3 omits them from the Translate JSON when unset.
         Because status is absent on the Translate projection, it is constrained but
         not required here (it is required on the full Order, which always carries it).
    google.protobuf.Timestamp:
      type: string
      format: date-time
  securitySchemes:
    BasicAuth:
      type: http
      scheme: basic
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: opaque
    PaymentAuth:
      type: http
      description: >-
        MPP payment authorization, sent as `Authorization: Payment
        <credential>`.
      scheme: payment

````