---
title: "GetDocumentTemplatesForListingPage"
url: "https://devportal.jilson.dev/apis/document-generator-pkce-flow-1/versions/c7bf5731-4982-4310-bcfe-512415c7d543/operations/GetDocumentTemplatesForListingPage"
---

> Full API specification: https://devportal.jilson.dev/apis/document-generator-pkce-flow-1/versions/c7bf5731-4982-4310-bcfe-512415c7d543.md

# GetDocumentTemplatesForListingPage

`GET` `/v1/template-provider/readTemplates`

Operation ID: `GetDocumentTemplatesForListingPage`

## Responses

- `200` - Success
- `400` - Bad Request
- `401` - Unauthorized
- `404` - Not Found
- `503` - Server Error

## OpenAPI definition

```yaml
openapi: 3.0.1
info:
  title: Document Generator API
  version: "1.0"
paths:
  /v1/template-provider/readTemplates:
    get:
      tags:
        - TemplateProvider
      operationId: GetDocumentTemplatesForListingPage
      responses:
        "200":
          description: Success
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TemplateProviderResponse"
        "400":
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProblemDetails"
        "401":
          description: Unauthorized
        "404":
          description: Not Found
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProblemDetails"
        "503":
          description: Server Error
security:
  - https://auth.sharefiletest.io:
      - docgen:all.full
      - docgen:doctemplate.packaging
      - docgen:doctemplate.template-provider
      - docgen:doctemplate.permanentdelete
components:
  schemas:
    TemplateProviderResponse:
      type: object
      properties:
        actions:
          $ref: "#/components/schemas/UIAction"
        resources:
          type: array
          items:
            $ref: "#/components/schemas/Template"
          nullable: true
      additionalProperties: false
    ProblemDetails:
      type: object
      properties:
        type:
          type: string
          nullable: true
        title:
          type: string
          nullable: true
        status:
          type: integer
          format: int32
          nullable: true
        detail:
          type: string
          nullable: true
        instance:
          type: string
          nullable: true
      additionalProperties: {}
    UIAction:
      type: object
      properties:
        details:
          type: string
          nullable: true
      additionalProperties: false
    Template:
      type: object
      properties:
        id:
          type: string
          nullable: true
        name:
          type: string
          nullable: true
        description:
          type: string
          nullable: true
        RID:
          type: string
          nullable: true
        rootType:
          type: string
          nullable: true
        containerRID:
          type: string
          nullable: true
        creator:
          type: string
          nullable: true
        created:
          type: string
          format: date-time
          nullable: true
        policies:
          $ref: "#/components/schemas/TemplatePermissions"
      additionalProperties: false
    TemplatePermissions:
      type: object
      properties:
        CanRead:
          type: boolean
          nullable: true
        CanWrite:
          type: boolean
          nullable: true
        CanDelete:
          type: boolean
          nullable: true
        CanShare:
          type: boolean
          nullable: true
      additionalProperties: false
  securitySchemes:
    https://auth.sharefiletest.io:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: https://auth.sharefiletest.io/connect/authorize
          tokenUrl: https://auth.sharefiletest.io/connect/token
          scopes:
            docgen:all.full: Full access to Doc Gen APIs.
            docgen:doctemplate.packaging: Doc Template Packaging APIs Access
            docgen:doctemplate.template-provider: Document Templates full access to template provider
            docgen:doctemplate.permanentdelete: Access to permanently delete document template and metadata
```
