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

# List document types



## OpenAPI

````yaml get /v1/document-types
openapi: 3.0.0
info:
  title: Settings APIs Specification
  description: Section for description
  version: '1.0'
  contact: {}
servers:
  - url: https://staging.api.us.aptlydone.com/settings
  - url: https://staging.api.eu.aptlydone.com/settings
  - url: https://api.us.aptlydone.com/settings
  - url: https://api.eu.aptlydone.com/settings
security: []
tags: []
paths:
  /v1/document-types:
    get:
      tags:
        - document-types
      summary: List document types
      operationId: TenantDocumentTypeController_getDocumentTypes_v1
      parameters:
        - name: page
          required: false
          in: query
          description: Page number
          schema:
            type: number
            example: 1
            minimum: 1
        - name: limit
          required: false
          in: query
          description: Number of items per page
          schema:
            minimum: 1
            maximum: 100
            example: 10
            type: number
        - name: tenantId
          required: true
          in: query
          description: Tenant ID
          schema:
            example: b0aeaaab-5169-4941-8cde-1ee3f3c78576
            type: string
        - name: documentTypeIds
          required: false
          in: query
          description: Document Type IDs (comma separated)
          schema:
            example: >-
              aa2f2bf5-1562-4b9d-8881-2ae421e7ae16,
              9d8bbd2a-0619-45af-9acc-600f0c2e2aa4
            type: string
        - name: search
          required: false
          in: query
          description: Search by type name
          schema:
            example: Invoice
            type: string
        - name: sortBy
          required: false
          in: query
          description: Field to sort by
          schema:
            example: id
            type: string
        - name: sortOrder
          required: false
          in: query
          description: Sort order (asc/desc)
          schema:
            default: asc
            example: asc
            type: string
            enum:
              - asc
              - desc
      responses:
        '200':
          description: Document types list retrieved successfully
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/PaginatedTenantDocumentTypeResponseDtoResponse
      security:
        - accessToken: []
components:
  schemas:
    PaginatedTenantDocumentTypeResponseDtoResponse:
      type: object
      properties:
        statusCode:
          type: number
          example: 200
        timestamp:
          type: string
          example: '2026-01-08T06:33:21.195Z'
        message:
          type: string
          example: Success
        data:
          type: object
          required:
            - page
            - limit
            - total
            - data
          properties:
            page:
              type: number
              example: 1
              minimum: 1
            limit:
              type: number
              example: 10
              minimum: 1
            total:
              type: number
              example: 100
              minimum: 0
            data:
              type: array
              items:
                $ref: '#/components/schemas/TenantDocumentTypeResponseDto'
      required:
        - statusCode
        - timestamp
        - message
    TenantDocumentTypeResponseDto:
      type: object
      properties:
        id:
          type: string
          example: 88287498-ed7a-482a-9a5a-d645adf3025a
          description: Unique identifier
        tenantId:
          type: string
          example: 5148e3a6-193b-4922-93c2-16d2a399ec1f
          description: Tenant ID
        typeName:
          type: string
          description: Document type name
          example: Invoice
        status:
          type: boolean
          description: Status
          example: true
        isDefault:
          type: boolean
          example: false
          description: Is default flag
        isDeleted:
          type: boolean
          example: false
          description: Is deleted flag
        createdAt:
          format: date-time
          type: string
          example: '2024-01-12T00:00:00.000Z'
          description: Created date
        updatedAt:
          format: date-time
          type: string
          example: '2024-01-12T00:00:00.000Z'
          description: Updated date
      required:
        - id
        - tenantId
        - typeName
        - status
        - isDefault
        - isDeleted
        - createdAt
        - updatedAt
  securitySchemes:
    accessToken:
      scheme: bearer
      bearerFormat: JWT
      type: http

````