> ## Documentation Index > Fetch the complete documentation index at: https://platform.doodocs.kz/llms.txt > Use this file to discover all available pages before exploring further. # List Document Types > Returns the document types (templates catalog) visible to the key's owner. Required scope: documents:read Error Codes: - DEVELOPER.SCOPE_INSUFFICIENT: The key lacks the documents:read scope. - INVALID_ARGUMENT: A malformed page_token. ## OpenAPI ````yaml /api-reference/openapi.yaml get /developer/v1/document_types openapi: 3.0.3 info: description: >- Публичный Developer API Doodocs People. Аутентификация — заголовок X-API-Key. title: Doodocs People API version: 1.0.0 servers: - description: Production url: https://app.doodocs.kz/api security: - ApiKeyAuth: [] tags: - description: ApiKeyService exposes Developer API key utilities. name: ApiKeyService - description: >- DocumentService is the public Developer API for documents: reading, creating, downloading, routing, and signing. Authentication: X-API-Key. Every call runs as the key's owner within the key's tenant — the owner's document permissions decide what is visible and which actions are allowed, exactly as they would in the web app. Fields that carry personal data of other participants (names, IIN, positions) are never exposed; participants are identified by id only. Typical flow: discover a template with ListDocumentTemplates / GetDocumentTemplate (to learn its variable_schema), create a draft with CreateDocument, set its route with SetDocumentRoute, launch it with SendDocument, then apply signatures with SignDocument as slots become active. To circulate a document produced elsewhere, upload it with FileService and pass the confirmed file_id to CreateDocument instead of a template. name: DocumentService - description: |- EmployeeService is the public Developer API for reading employees. Authentication: X-API-Key. The key's tenant and the key owner's data scope determine which employees and fields are visible; sensitive fields the caller may not view are omitted and listed in `redacted_fields`. name: EmployeeService - description: |- FileService uploads the files documents are created from. Authentication: X-API-Key. An upload belongs to the key's owner, and only their key can attach it to a document. Flow: CreateFileUpload reserves the file and returns a presigned POST form, the client sends the bytes straight to storage, ConfirmFileUpload marks the upload complete, and CreateDocument attaches it by id. name: FileService - description: IngestService accepts batches of external records into the tenant. name: IngestService - name: LoginService - description: |- WebhookService lets a tenant manage subscriptions to Developer API events. Authentication: X-API-Key with the webhooks:manage scope. name: WebhookService paths: /developer/v1/document_types: get: tags: - DocumentService summary: List Document Types description: >- Returns the document types (templates catalog) visible to the key's owner. Required scope: documents:read Error Codes: - DEVELOPER.SCOPE_INSUFFICIENT: The key lacks the documents:read scope. - INVALID_ARGUMENT: A malformed page_token. operationId: DocumentService_ListDocumentTypes parameters: - description: Maximum items to return. Default 100, capped at 1000. in: query name: limit schema: format: int32 type: integer - description: Opaque continuation token from a previous response. in: query name: page_token schema: type: string - description: Filter by category id. in: query name: category_id schema: type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/ListDocumentTypesResponse' description: OK default: content: application/json: schema: $ref: '#/components/schemas/Status' description: Default error response components: schemas: ListDocumentTypesResponse: properties: document_types: description: The page of document types. items: $ref: '#/components/schemas/DocumentType' readOnly: true type: array next_page_token: description: >- Continuation token for the next page; empty when there are no more results. readOnly: true type: string type: object Status: description: >- The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). properties: code: description: >- The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code]. format: int32 type: integer details: description: >- A list of messages that carry the error details. There is a common set of message types for APIs to use. items: $ref: '#/components/schemas/GoogleProtobufAny' type: array message: description: >- A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client. type: string type: object DocumentType: description: >- DocumentType is a catalog entry documents are created under: it names the kind of document and carries its policies. properties: allow_api: description: The Developer API may create documents of this type. readOnly: true type: boolean allow_upload: description: Documents of this type may be created from an uploaded file. readOnly: true type: boolean category_id: description: Category the type is grouped under (see ListDocumentTypeCategories). readOnly: true type: string confidential: description: Documents of this type have restricted visibility. readOnly: true type: boolean create_time: description: When the type was created. format: date-time readOnly: true type: string id: description: Document type id (UUID). readOnly: true type: string status: description: Catalog lifecycle status of the type. readOnly: true type: string subject_type: description: What kind of subject the type expects (who the document is about). readOnly: true type: string template_id: description: >- Template documents of this type are generated from; empty when the type has no template. readOnly: true type: string title: description: Human-readable type name. readOnly: true type: string update_time: description: When the type last changed. format: date-time readOnly: true type: string type: object GoogleProtobufAny: additionalProperties: true description: >- Contains an arbitrary serialized message along with a @type that describes the type of the serialized message. properties: '@type': description: The type of the serialized message. type: string type: object securitySchemes: ApiKeyAuth: in: header name: X-API-Key type: apiKey ````