> ## 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 purchase return invoices

> Lists purchase return invoices page by page.

Purchase return invoices are returned newest first and **without their lines**; use [Get purchase return invoice](/en/v1/purchase-return-invoices/get) for the lines.

* `search` looks in the invoice 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/purchase-return-invoices
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: Product Stock Status
  - 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: Purchase Invoices
  - name: Purchase Return Invoices
  - name: Sales Invoices
  - name: Sales Return Invoices
  - name: Bank Accounts
  - name: Bank Internal Transfers
  - name: Bank Openings
  - name: Banks
  - name: Bank Transfers
  - name: Credit Card Collections
  - name: Customer Balances
  - name: Customer Transactions
  - name: Repayment Plans
  - name: Despatches
  - 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 Telephones
paths:
  /api/v1/purchase-return-invoices:
    get:
      tags:
        - Purchase Return Invoices
      summary: List purchase return invoices
      description: >-
        Returns purchase return invoices page by page, newest first, without
        their lines. Use Get purchase return invoice 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 InvoiceNumber, DocumentNumber and the customer name.
          schema:
            type: string
        - 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/DataResultOfPagedResultDtoOfInvoiceDto'
        '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:
    DataResultOfPagedResultDtoOfInvoiceDto:
      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/PagedResultDtoOfInvoiceDto'
    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.
    PagedResultDtoOfInvoiceDto:
      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/InvoiceDto'
          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.
    InvoiceDto:
      type: object
      properties:
        Id:
          type: string
          description: Invoice ID.
          format: uuid
        CustomerId:
          type:
            - 'null'
            - string
          format: uuid
        CurrencyId:
          type:
            - 'null'
            - string
          format: uuid
        CustomerName:
          type:
            - 'null'
            - string
          description: Customer name.
        CurrencyCode:
          type:
            - 'null'
            - string
          description: >-
            Invoice currency, derived from the lines: when every line uses the
            same currency, that is the invoice currency; otherwise it is the
            company's default currency. Not accepted in the request.
          example: TRY
        ShipmentDefinitionId:
          type:
            - 'null'
            - string
          description: Shipment definition ID.
          format: uuid
        Address:
          type:
            - 'null'
            - string
          description: >-
            Customer's full address at the moment the invoice was saved (a
            snapshot; not taken from the request).
        CustomerTitle:
          type:
            - 'null'
            - string
          description: >-
            Customer's invoice title at the moment the invoice was saved (a
            snapshot).
        TaxNumber:
          type:
            - 'null'
            - string
          description: >-
            Customer's tax number at the moment the invoice was saved (a
            snapshot).
        TaxOffice:
          type:
            - 'null'
            - string
          description: >-
            Customer's tax office at the moment the invoice was saved (a
            snapshot).
        EInvoiceType:
          type: integer
          description: >-
            e-Invoice classification of this invoice record: 0 not an
            e-document, 2 e-Archive. Determined by the API from whether the
            company uses e-Invoice (0 when it does not; for a sales or
            purchase-return invoice, 2 when it does); not accepted in the
            request.
          format: int32
          example: 2
        InvoiceNumber:
          type:
            - 'null'
            - string
          description: >-
            Required. Invoice number, unique within the company for this invoice
            type. Send "Next" on create to generate it automatically from the
            relevant number series or, when applicable, from the e-Invoice
            numbering. At most 20 characters.
          example: 9446A4D834
        DocumentNumber:
          type:
            - 'null'
            - string
          description: Document number (free text). At most 100 characters.
        Date:
          type:
            - 'null'
            - string
          description: >-
            Required. Invoice date. The date part is stored as the invoice date;
            if a time is sent it is stored as the invoice time, otherwise the
            current time is used.
          format: date-time
          example: '2026-09-21T10:30:00'
        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 invoice's address, title and tax fields are
            copied from the customer at the moment it is saved and are not
            accepted in the request.
          example: C-0001
        DueDays:
          type: integer
          description: Payment term in days. Cannot be less than 0.
          format: int32
        SharingCode:
          type:
            - 'null'
            - string
          description: >-
            Sharing code that limits who can see the invoice. 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
        SubTotal:
          type: number
          description: >-
            Subtotal (sum of the line amounts excluding taxes). Sent by the
            integrator, not calculated by the API.
          format: double
        VatTotal:
          type: number
          description: Total VAT amount. Sent by the integrator, not calculated by the API.
          format: double
        GrandTotal:
          type: number
          description: Grand total. Sent by the integrator, not calculated by the API.
          format: double
        Consolidated:
          type: boolean
          description: >-
            Whether the invoice consolidates several despatches/orders.
            Free-form flag, not validated by the API.
        PrintDescription:
          type: boolean
          description: Whether the description should be printed on the invoice document.
        Cancelled:
          type: boolean
          description: Whether the invoice has been cancelled.
        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
        ApplyWithholding:
          type: boolean
          description: Whether withholding (tevkifat) applies to this invoice.
        WithholdingCode:
          type:
            - 'null'
            - string
          description: Withholding (tevkifat) code. At most 10 characters.
        WithholdingNumerator:
          type: integer
          description: Numerator of the withholding share (e.g. 9 in 9/10).
          format: int32
        WithholdingDenominator:
          type: integer
          description: Denominator of the withholding share (e.g. 10 in 9/10).
          format: int32
        WithholdingTotal:
          type: number
          description: >-
            Total withheld VAT amount. Calculated by the API as the sum of the
            lines' withheld VAT.
          format: double
        AdditionalTaxTotal:
          type: number
          description: >-
            Total additional tax amount. Sent by the integrator, not calculated
            by the API.
          format: double
        ProfileId:
          type:
            - 'null'
            - string
          description: >-
            UBL profile ID of the e-document (e.g. "TEMELFATURA",
            "TICARIFATURA"). Required when the company uses e-Invoice. When both
            ProfileId and InvoiceTypeCode are sent, InvoiceTypeCode must be one
            of the values allowed for this ProfileId.
        InvoiceTypeCode:
          type:
            - 'null'
            - string
          description: >-
            UBL invoice type code of the e-document (e.g. "SATIS", "IADE").
            Required when the company uses e-Invoice.
        WithholdingTaxRate:
          type: number
          description: >-
            Withholding tax rate (stopaj), used for
            self-employment/producer-receipt style invoices. Stored as sent.
          format: double
        SocialSecurityRate:
          type: number
          description: >-
            Social security (Bağ-Kur) rate, used for
            self-employment/producer-receipt style invoices. Stored as sent.
          format: double
        MarketRate:
          type: number
          description: >-
            Market (borsa) rate, used for producer-receipt style invoices.
            Stored as sent.
          format: double
        ReturnedInvoiceNumber:
          type:
            - 'null'
            - string
          description: >-
            Number of the invoice this one returns goods against (Alış/Satış
            İade). Free text, not validated against an existing invoice.
        ReturnedInvoiceDate:
          type:
            - 'null'
            - string
          description: Date of the invoice this one returns goods against.
          format: date-time
        OrderReferenceNumber:
          type:
            - 'null'
            - string
          description: Reference order number (free text, informational only).
        OrderReferenceDate:
          type:
            - 'null'
            - string
          description: Date of the reference order.
          format: date-time
        BranchNumber:
          type:
            - 'null'
            - string
          description: Branch number (informational).
        BranchTitle:
          type:
            - 'null'
            - string
          description: Branch title (informational).
        BranchAddress:
          type:
            - 'null'
            - string
          description: Branch address (informational).
        InvestmentIncentiveDocumentNumber:
          type:
            - 'null'
            - string
          description: Investment incentive certificate number.
        InvestmentIncentiveDocumentDate:
          type:
            - 'null'
            - string
          description: Investment incentive certificate date.
          format: date-time
        EnergyPeriodStart:
          type:
            - 'null'
            - string
          description: Energy period start date/time, for energy sector invoices.
          format: date-time
        EnergyPeriodEnd:
          type:
            - 'null'
            - string
          description: Energy period end date/time, for energy sector invoices.
          format: date-time
        DeliveryInfo:
          oneOf:
            - type: 'null'
            - $ref: '#/components/schemas/InvoiceDeliveryInfoDto'
        PaymentMeans:
          type: array
          items:
            $ref: '#/components/schemas/InvoicePaymentMeansDto'
          description: Payment methods. Stored and returned as sent, not validated.
        ReferencedDespatches:
          type: array
          items:
            $ref: '#/components/schemas/InvoiceDespatchReferenceDto'
          description: Referenced despatches. Stored and returned as sent, not validated.
        CustomerIdentitySchemes:
          type: array
          items:
            $ref: '#/components/schemas/InvoicePartyIdentificationDto'
          description: >-
            Customer identity schemes. Stored and returned as sent, not
            validated.
        PublicSectorSpendingUnit:
          oneOf:
            - type: 'null'
            - $ref: '#/components/schemas/InvoiceKamuHarcamaBirimiDto'
        SgkInfo:
          oneOf:
            - type: 'null'
            - $ref: '#/components/schemas/InvoiceSgkInfoDto'
        CreateDate:
          type:
            - 'null'
            - string
          description: Creation date.
          format: date-time
        ModifyDate:
          type:
            - 'null'
            - string
          description: Last modification date.
          format: date-time
    InvoiceDeliveryInfoDto:
      type: object
      properties:
        DeliveryTerm:
          type:
            - 'null'
            - string
          description: Delivery term code.
        TransportModeCode:
          type:
            - 'null'
            - integer
          description: 'Transport mode code: 1 maritime, 2 rail, 3 road, 4 air.'
          format: int32
        Country:
          type:
            - 'null'
            - string
          description: Delivery country.
        CityName:
          type:
            - 'null'
            - string
          description: Delivery city.
        CitySubdivisionName:
          type:
            - 'null'
            - string
          description: Delivery city subdivision (district).
        StreetName:
          type:
            - 'null'
            - string
          description: Delivery street name.
        BuildingName:
          type:
            - 'null'
            - string
          description: Delivery building name.
        BuildingNumber:
          type:
            - 'null'
            - string
          description: Delivery building number.
        PostalZone:
          type:
            - 'null'
            - string
          description: Delivery postal code.
        TransportMeans:
          type:
            - 'null'
            - string
          description: >-
            Transport means identifier (vessel name, train number, license plate
            or aircraft number, depending on TransportModeCode).
        DeclaredForCarriageValueAmount:
          type:
            - 'null'
            - number
          description: Declared value for carriage.
          format: double
        DeliveryInsuranceValue:
          type:
            - 'null'
            - number
          description: Delivery insurance value.
          format: double
      description: Export delivery information. Stored and returned as sent, not validated.
    InvoicePaymentMeansDto:
      type: object
      properties:
        PaymentMeansCode:
          type:
            - 'null'
            - string
          description: >-
            Payment means code (UN/EDIFACT 4461, e.g. "1" cash, "42" wire
            transfer).
        PayeeFinancialAccountID:
          type:
            - 'null'
            - string
          description: IBAN or account number.
        CurrencyCode:
          type:
            - 'null'
            - string
          description: Currency code of the account.
    InvoiceDespatchReferenceDto:
      type: object
      properties:
        ID:
          type:
            - 'null'
            - string
          description: Despatch number.
        IssueDate:
          type:
            - 'null'
            - string
          description: Despatch issue date.
          format: date-time
    InvoicePartyIdentificationDto:
      type: object
      properties:
        SchemeID:
          type:
            - 'null'
            - string
          description: >-
            Scheme ID (e.g. "MUSTERINO", "BAYINO", "TICARETSICILNO", "MERSISNO",
            "HIZMETNO", "TESISATNO").
        Value:
          type:
            - 'null'
            - string
          description: Value for this scheme.
    InvoiceKamuHarcamaBirimiDto:
      type: object
      properties:
        BCP_Name:
          type:
            - 'null'
            - string
          description: Spending unit name.
        BCP_VKN:
          type:
            - 'null'
            - string
          description: Spending unit tax number.
        BCP_Country:
          type:
            - 'null'
            - string
          description: Spending unit country.
        BCP_CityName:
          type:
            - 'null'
            - string
          description: Spending unit city.
        BCP_CitySubdivisionName:
          type:
            - 'null'
            - string
          description: Spending unit city subdivision (district).
      description: >-
        Public sector (Kamu) payer spending unit. Stored and returned as sent,
        not validated.
    InvoiceSgkInfoDto:
      type: object
      properties:
        StartDate:
          type:
            - 'null'
            - string
          description: Period start date.
          format: date-time
        EndDate:
          type:
            - 'null'
            - string
          description: Period end date.
          format: date-time
        MukellefKodu:
          type:
            - 'null'
            - string
          description: Taxpayer code.
        MukellefAdi:
          type:
            - 'null'
            - string
          description: Taxpayer name.
        DosyaNo:
          type:
            - 'null'
            - string
          description: File number.
        FaturaAltTipi:
          type:
            - 'null'
            - string
          description: Invoice sub-type.
      description: >-
        SGK (social security) invoice information. Stored and returned as sent,
        not validated.
  securitySchemes:
    Bearer:
      type: http
      description: Access token obtained from the Noyax auth service with your API key.
      scheme: bearer
      bearerFormat: JWT

````