> ## Documentation Index > Fetch the complete documentation index at: https://docs.azalt.co/llms.txt > Use this file to discover all available pages before exploring further. # Formları listele > Kullanıcının organizasyon ve tesis yetkileri kapsamında erişebildiği tüm formları listeler. **Opsiyonel filtreler**: - `siteId`: Belirli bir tesis için kullanılabilir formları döndürür - `year`: Belirli bir yıl için yapılandırılmış formları sınırlar - `status`: Form durumuna göre filtreler (aktif, taslak, arşiv) **Yanıt şunları içerir**: - Form özetleri ve temel meta veriler - Öğelerin sayısı ve tiplerine dair genel bakış - Tesis dağıtımları ve yayın durumu - Oluşturulma/güncellenme zaman damgaları - Genel erişim ve parola ayarları - Gönderim istatistikleri ve tamamlama oranları **Form kategorileri**: - Çevresel veri toplama (enerji, su, atık, emisyon) - Uyum raporlamaları ve sertifikasyon - ESG/sürdürülebilirlik anketleri - Operasyonel metrikler (tesis performansı, kaynak tüketimi) **Kullanım senaryoları**: - Yönetişim panoları ve yönetim arayüzleri - Veri girişi iş akışlarında form seçimi - Raporlama ve analitik hazırlıkları - Denetim izi ve uyum dokümantasyonu ## OpenAPI ````yaml https://app.azalt.co/api/v1/openapi.tr.json get /forms openapi: 3.0.3 info: title: Erguvan Genel API version: 1.0.0 description: Erguvan platformuna entegrasyon için REST API referansının Türkçe sürümü. servers: - url: https://app.azalt.co/api/v1 security: [] tags: - name: Activity x-displayName: Aktiviteler - name: ActivityDefinition x-displayName: Aktivite Tanımları - name: ApiKey x-displayName: API Anahtarları - name: Dashboard x-displayName: Panolar - name: DashboardWidget x-displayName: Pano Bileşenleri - name: Dataset x-displayName: Veri Setleri - name: DatasetItem x-displayName: Veri Seti Öğeleri - name: File x-displayName: Dosyalar - name: Form x-displayName: Formlar - name: FormElement x-displayName: Form Öğeleri - name: FormElementSubmission x-displayName: Form Öğesi Gönderimleri - name: FormSite x-displayName: Form-Tesis İlişkilendirmeleri - name: FormSubmission x-displayName: Form Gönderimleri - name: Indicator x-displayName: Göstergeler - name: Organization x-displayName: Organizasyonlar - name: Site x-displayName: Tesisler - name: Target x-displayName: Hedefler - name: Unit x-displayName: Birimler - name: User x-displayName: Kullanıcılar paths: /forms: get: tags: - Form summary: Formları listele description: >- Kullanıcının organizasyon ve tesis yetkileri kapsamında erişebildiği tüm formları listeler. **Opsiyonel filtreler**: - `siteId`: Belirli bir tesis için kullanılabilir formları döndürür - `year`: Belirli bir yıl için yapılandırılmış formları sınırlar - `status`: Form durumuna göre filtreler (aktif, taslak, arşiv) **Yanıt şunları içerir**: - Form özetleri ve temel meta veriler - Öğelerin sayısı ve tiplerine dair genel bakış - Tesis dağıtımları ve yayın durumu - Oluşturulma/güncellenme zaman damgaları - Genel erişim ve parola ayarları - Gönderim istatistikleri ve tamamlama oranları **Form kategorileri**: - Çevresel veri toplama (enerji, su, atık, emisyon) - Uyum raporlamaları ve sertifikasyon - ESG/sürdürülebilirlik anketleri - Operasyonel metrikler (tesis performansı, kaynak tüketimi) **Kullanım senaryoları**: - Yönetişim panoları ve yönetim arayüzleri - Veri girişi iş akışlarında form seçimi - Raporlama ve analitik hazırlıkları - Denetim izi ve uyum dokümantasyonu operationId: listForms responses: '200': description: Successful response content: application/json: schema: type: array items: type: object properties: formId: type: string name: type: string description: type: string nullable: true isPublic: type: boolean metadata: {} settings: nullable: true updatedAt: type: string nullable: true tags: type: array items: type: string totalElements: type: number totalPossibleDataPoints: type: number totalExpectedDataPoints: type: number totalActivityCount: type: number formSiteCount: type: number formSites: type: array items: type: object properties: formSiteId: type: string siteId: type: string siteName: type: string year: type: number submissionCount: type: number dataCount: type: number filledElements: type: number activityCount: type: number progress: type: number required: - formSiteId - siteId - siteName - year - submissionCount - dataCount - filledElements - activityCount - progress overallProgress: type: number totalSubmissions: type: number totalDataCount: type: number years: type: array items: type: number sites: type: array items: type: string yearsText: type: string sitesText: type: string siteSearchText: type: string yearsMoreCount: type: number sitesMoreCount: type: number assignments: type: array items: type: object properties: id: type: string organizationUserId: type: string createdAt: type: string userId: type: string name: type: string nullable: true email: type: string image: type: string nullable: true role: type: string accessibleSiteIds: type: array items: type: string required: - id - organizationUserId - createdAt - userId - name - email - image - role - accessibleSiteIds required: - formId - name - description - isPublic - updatedAt - tags - totalElements - totalPossibleDataPoints - totalExpectedDataPoints - totalActivityCount - formSiteCount - formSites - overallProgress - totalSubmissions - totalDataCount - years - sites - yearsText - sitesText - siteSearchText - yearsMoreCount - sitesMoreCount - assignments '401': description: Authorization not provided content: application/json: schema: $ref: '#/components/schemas/error.UNAUTHORIZED' '403': description: Insufficient access content: application/json: schema: $ref: '#/components/schemas/error.FORBIDDEN' '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/error.INTERNAL_SERVER_ERROR' security: - Authorization: [] components: schemas: error.UNAUTHORIZED: type: object properties: message: type: string description: The error message example: Authorization not provided code: type: string description: The error code example: UNAUTHORIZED issues: type: array items: type: object properties: message: type: string required: - message description: An array of issues that were responsible for the error example: [] required: - message - code title: Authorization not provided error (401) description: The error information example: code: UNAUTHORIZED message: Authorization not provided issues: [] error.FORBIDDEN: type: object properties: message: type: string description: The error message example: Insufficient access code: type: string description: The error code example: FORBIDDEN issues: type: array items: type: object properties: message: type: string required: - message description: An array of issues that were responsible for the error example: [] required: - message - code title: Insufficient access error (403) description: The error information example: code: FORBIDDEN message: Insufficient access issues: [] error.INTERNAL_SERVER_ERROR: type: object properties: message: type: string description: The error message example: Internal server error code: type: string description: The error code example: INTERNAL_SERVER_ERROR issues: type: array items: type: object properties: message: type: string required: - message description: An array of issues that were responsible for the error example: [] required: - message - code title: Internal server error error (500) description: The error information example: code: INTERNAL_SERVER_ERROR message: Internal server error issues: [] securitySchemes: Authorization: type: http scheme: bearer ````