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

# List waybills

> Lists waybills page by page.

Waybills are returned newest first and **without their lines**; use [Get waybill](/en/v1/waybills/get) for the lines.

* `waybillType` returns only inbound (`2`) or outbound (`-2`) waybills.
* `search` looks in the waybill number, document number and customer name.
* Paging works like the other lists: `page` starts at 1, `pageSize` is at most 50.

## Error codes

This endpoint has no endpoint-specific error codes. The [general errors](/en/v1/guides/result-codes) that apply to every endpoint (authentication, permissions, request headers, daily limit) still apply.


## OpenAPI

````yaml api-reference/openapi.json GET /api/v1/waybills
openapi: 3.1.1
info:
  title: Noyax API
  description: Server-to-server API for integrations to access Noyax data.
  version: '1.0'
servers:
  - url: https://dev.noyax.com/services/noyax_api
security:
  - Bearer: []
tags:
  - name: Waybills
  - name: Sections
  - name: Warehouses
  - name: Quotes
  - name: Product Critical Stock
  - name: Product groups
  - name: Product Parameter Definitions
  - name: Product Parameters
  - name: Product Prices
  - name: Products
  - name: Orders
  - name: Cities
  - name: Countries
  - name: Currencies
  - name: Districts
  - name: Line Groups
  - name: Shipment Definitions
  - name: Units
  - name: VAT rates
  - name: Customer Addresses
  - name: Customer Bank Accounts
  - name: Customer Definitions
  - name: Customer Group Members
  - name: Customer Links
  - name: Customer Parameters
  - name: Customer Representatives
  - name: Customers
  - name: Customer Statement
  - name: Customer Telephones
paths:
  /api/v1/waybills:
    get:
      tags:
        - Waybills
      summary: List waybills
      description: >-
        Returns waybills page by page, newest first, without their lines. Use
        Get waybill to read the lines.
      parameters:
        - name: page
          in: query
          description: Page number, starting from 1.
          schema:
            type: integer
            format: int32
            default: 1
        - name: pageSize
          in: query
          description: Records per page (maximum 50).
          schema:
            type: integer
            format: int32
            default: 50
        - name: search
          in: query
          description: Searches in WaybillNumber, DocumentNumber and the customer name.
          schema:
            type: string
        - name: waybillType
          in: query
          description: 'Returns only waybills of this type: 2 inbound, -2 outbound.'
          schema:
            type: integer
            format: int32
        - name: X-UserID
          in: header
          description: >-
            ID of the Noyax user the request is made on behalf of. Written to
            the audit fields of created, updated and deleted records.
          required: true
          schema:
            minimum: 1
            type: integer
            format: int32
        - name: X-CompanyID
          in: header
          description: >-
            ID of the company. The user must be assigned to this company. All
            reads and writes are limited to this company.
          required: true
          schema:
            minimum: 1
            type: integer
            format: int32
        - name: X-PeriodID
          in: header
          description: >-
            ID of the accounting period. Optional for customer endpoints; if
            sent, it is written to created records.
          schema:
            minimum: 1
            type: integer
            format: int32
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DataResultOfPagedResultDtoOfWaybillDto'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResult'
              example:
                Success: false
                ResultCode: '0201'
                Message: X-UserID header is required.
                Errors:
                  - Code: '0201'
                    Message: X-UserID header is required.
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResult'
              example:
                Success: false
                ResultCode: '0102'
                Message: Token has expired. Obtain a new token using the refresh token.
                Errors:
                  - Code: '0102'
                    Message: >-
                      Token has expired. Obtain a new token using the refresh
                      token.
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResult'
              example:
                Success: false
                ResultCode: '0110'
                Message: You do not have permission for this operation.
                Errors:
                  - Code: '0110'
                    Message: You do not have permission for this operation.
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResult'
              example:
                Success: false
                ResultCode: '0120'
                Message: Daily request limit (10000) exceeded.
                Errors:
                  - Code: '0120'
                    Message: Daily request limit (10000) exceeded.
components:
  schemas:
    DataResultOfPagedResultDtoOfWaybillDto:
      required:
        - Success
        - ResultCode
        - Data
      type: object
      properties:
        Success:
          type: boolean
          description: Whether the operation succeeded.
          example: true
        ResultCode:
          type: string
          description: >-
            "0000" on success. On failure, the code of the first error; all
            errors are listed in Errors.
          example: '0000'
        Message:
          type:
            - 'null'
            - string
          description: >-
            Error message when Success is false. Messages of all errors are
            joined into a single text.
        Data:
          $ref: '#/components/schemas/PagedResultDtoOfWaybillDto'
    ErrorResult:
      type: object
      properties:
        Success:
          type: boolean
          description: Whether the operation succeeded.
          example: false
        ResultCode:
          type:
            - 'null'
            - string
          description: >-
            "0000" on success. On failure, the code of the first error; all
            errors are listed in Errors.
        Message:
          type:
            - 'null'
            - string
          description: >-
            Error message when Success is false. Messages of all errors are
            joined into a single text.
        Errors:
          type:
            - 'null'
            - array
          items:
            $ref: '#/components/schemas/ResultError'
          description: All errors with their codes. Only present when Success is false.
    PagedResultDtoOfWaybillDto:
      type: object
      properties:
        Page:
          type: integer
          description: Current page number.
          format: int32
          example: 1
        PageSize:
          type: integer
          description: Records per page.
          format: int32
          example: 50
        TotalCount:
          type: integer
          description: Total number of records matching the query.
          format: int32
          example: 128
        Items:
          type: array
          items:
            $ref: '#/components/schemas/WaybillDto'
          description: Records on this page.
      description: Response data. Null when Success is false.
    ResultError:
      required:
        - Code
        - Message
      type: object
      properties:
        Code:
          type: string
          description: Error code. See the result codes page for the full list.
        Message:
          type: string
          description: Error description.
    WaybillDto:
      type: object
      properties:
        Id:
          type: string
          description: Waybill ID.
          format: uuid
        CustomerId:
          type:
            - 'null'
            - string
          format: uuid
        CurrencyId:
          type:
            - 'null'
            - string
          format: uuid
        CustomerName:
          type:
            - 'null'
            - string
          description: Customer name.
        ShipmentDefinitionId:
          type:
            - 'null'
            - string
          description: Shipment definition ID.
          format: uuid
        Address:
          type:
            - 'null'
            - string
          description: >-
            Customer's full address at the moment the waybill was saved (a
            snapshot; not taken from the request).
        CustomerTitle:
          type:
            - 'null'
            - string
          description: >-
            Customer's invoice title at the moment the waybill was saved (a
            snapshot).
        TaxNumber:
          type:
            - 'null'
            - string
          description: >-
            Customer's tax number at the moment the waybill was saved (a
            snapshot).
        TaxOffice:
          type:
            - 'null'
            - string
          description: >-
            Customer's tax office at the moment the waybill was saved (a
            snapshot).
        WaybillType:
          type: integer
          description: >-
            Required. 2: Inbound waybill (goods receipt), -2: Outbound waybill
            (dispatch). Cannot be changed after the waybill is created.
          format: int32
          example: -2
        WaybillNumber:
          type:
            - 'null'
            - string
          description: >-
            Required. Waybill number, unique within the company for the same
            WaybillType. Send "Next" on create to generate it automatically:
            from the company's waybill number series for the type, or, for an
            outbound waybill when the company uses e-Waybill, from the e-Waybill
            numbering. At most 20 characters.
          example: 9446A4D834
        DocumentNumber:
          type:
            - 'null'
            - string
          description: Document number (free text). At most 100 characters.
          example: 2026-15
        Date:
          type:
            - 'null'
            - string
          description: >-
            Required. Waybill date. The date part is stored as the waybill date;
            if a time is sent it is stored as the waybill time, otherwise the
            current time is used.
          format: date-time
          example: '2026-09-21T10:30:00'
        ActualDispatchDate:
          type:
            - 'null'
            - string
          description: Actual dispatch date.
          format: date-time
        Description:
          type:
            - 'null'
            - string
          description: Description. At most 1000 characters.
        CustomerCode:
          type:
            - 'null'
            - string
          description: >-
            Required. Customer code (the customer's CustomerCode from GET
            /api/v1/customers). The waybill's address, title and tax fields are
            copied from the customer at the moment it is saved (the invoice
            address when the customer has one, otherwise the first address) and
            are not accepted in the request.
          example: C-0001
        CurrencyCode:
          type:
            - 'null'
            - string
          description: Required. Currency code from GET /api/v1/definitions/currencies.
          example: TRY
        DueDays:
          type: integer
          description: Payment term in days. Cannot be less than 0.
          format: int32
          example: 30
        SharingCode:
          type:
            - 'null'
            - string
          description: >-
            Sharing code that limits who can see the waybill. Empty means
            visible to everyone; otherwise it must be one of the user's sharing
            codes.
        ShipmentDefinitionCode:
          type:
            - 'null'
            - string
          description: >-
            Shipment definition code from GET
            /api/v1/definitions/shipment-definitions.
        DiscountTotal:
          type: number
          description: >-
            Total discount amount. Sent by the integrator, not calculated by the
            API.
          format: double
          example: 0
        SubTotal:
          type: number
          description: >-
            Subtotal (sum of the line amounts excluding taxes). Sent by the
            integrator, not calculated by the API.
          format: double
          example: 1000
        VatTotal:
          type: number
          description: Total VAT amount. Sent by the integrator, not calculated by the API.
          format: double
          example: 200
        AdditionalTaxTotal:
          type: number
          description: >-
            Total additional tax amount. Sent by the integrator, not calculated
            by the API.
          format: double
          example: 0
        WithholdingTotal:
          type: number
          description: >-
            Total withholding (tevkifat) amount. Sent by the integrator, not
            calculated by the API.
          format: double
          example: 0
        GrandTotal:
          type: number
          description: Grand total. Sent by the integrator, not calculated by the API.
          format: double
          example: 1200
        AverageExchangeRate:
          type: number
          description: >-
            Weighted average exchange rate of the lines. Sent by the integrator,
            not calculated by the API. Use 1 when everything is in the company's
            default currency.
          format: double
          example: 1
        CreateDate:
          type:
            - 'null'
            - string
          description: Creation date.
          format: date-time
        ModifyDate:
          type:
            - 'null'
            - string
          description: Last modification date.
          format: date-time
  securitySchemes:
    Bearer:
      type: http
      description: Access token obtained from the Noyax auth service with your API key.
      scheme: bearer
      bearerFormat: JWT

````