> ## Documentation Index > Fetch the complete documentation index at: https://docs.lala.ist/llms.txt > Use this file to discover all available pages before exploring further. # Read a deneme ## OpenAPI ````yaml /api-reference/openapi.json get /api/denemeler/{id} openapi: 3.1.0 info: title: Lala Client API description: >- The HTTP API behind Lala, the AI study companion for Turkish YKS and LGS students. This document is generated from the Zod schemas that validate each request at runtime. Do not hand-edit openapi.json. Student-visible text is Turkish. All identifiers are English. version: 1.0.0 servers: - url: https://client-api.lala.ist description: production - url: http://localhost:3000 description: local dev security: - supabaseJwt: [] tags: - name: chat description: The chat stream, the message history, and reactions - name: media description: Upload and read message attachments - name: plan description: The study planner — blocks of work on a day - name: journey description: Deneme results, topic performance, study-hours stats, and the streak - name: profile description: The student profile and onboarding - name: devices description: Push notification devices - name: system description: Health check paths: /api/denemeler/{id}: get: tags: - journey summary: Read a deneme operationId: getApiDenemelerById parameters: - schema: type: string in: path name: id required: true responses: '200': description: The deneme, with subjects and topics content: application/json: schema: $ref: '#/components/schemas/Deneme' '401': description: The token is missing, expired, or invalid content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '404': description: No such deneme for this student content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' components: schemas: Deneme: type: object properties: id: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ examType: $ref: '#/components/schemas/ExamType' field: anyOf: - type: string enum: - EA - Sayısal - Sözel - type: 'null' description: AYT only. Null on TYT and LGS papers. name: anyOf: - type: string - type: 'null' description: '`Bilgi Sarmal Türkiye Geneli`, …' publisher: anyOf: - type: string - type: 'null' takenDate: type: string description: Local Istanbul calendar date, `YYYY-MM-DD`. durationMin: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' totalNet: type: number description: Sum of the subject nets. Recomputed on every write. source: type: string enum: - manual - chat description: '`chat` when Lala logged it from the conversation.' createdBy: type: string enum: - student - lala notes: anyOf: - type: string - type: 'null' subjects: type: array items: $ref: '#/components/schemas/DenemeSubjectResult' description: Booklet order. topics: type: array items: $ref: '#/components/schemas/DenemeTopicResult' createdAt: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ updatedAt: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ required: - id - examType - field - name - publisher - takenDate - durationMin - totalNet - source - createdBy - notes - subjects - topics - createdAt - updatedAt ErrorResponse: type: object properties: error: type: string issues: description: >- Present only on a 400 raised by request validation, capped at 10 entries. Every other error carries `error` alone. type: array items: $ref: '#/components/schemas/ValidationIssue' required: - error description: Error body. `error` is a short English string. ExamType: type: string enum: - TYT - AYT - LGS description: One scored paper. TYT and AYT nets are never summed. DenemeSubjectResult: type: object properties: subject: type: string description: >- Canonical subject key — exam-prefixed, e.g. `tyt_matematik`, `ayt_tarih1`, `lgs_fen`. label: type: string description: Turkish display name. Read-only. short: type: string description: 'Short code for dense views: `TÜR`, `MAT`. Read-only.' dogru: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' yanlis: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' bos: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' net: type: number description: >- TYT/AYT: doğru − yanlış/4. LGS: doğru − yanlış/3. Computed when the counts are known. required: - subject - label - short - dogru - yanlis - bos - net DenemeTopicResult: type: object properties: subject: type: string description: >- Canonical subject key — exam-prefixed, e.g. `tyt_matematik`, `ayt_tarih1`, `lgs_fen`. topic: type: string description: 'Free text: `Paragraf`, `Türev`, …' dogru: type: integer minimum: -9007199254740991 maximum: 9007199254740991 yanlis: type: integer minimum: -9007199254740991 maximum: 9007199254740991 bos: type: integer minimum: -9007199254740991 maximum: 9007199254740991 required: - subject - topic - dogru - yanlis - bos ValidationIssue: type: object properties: path: type: string description: Dotted path to the offending field, empty at the root. message: type: string required: - path - message securitySchemes: supabaseJwt: type: http scheme: bearer bearerFormat: JWT description: 'Supabase access token: `Authorization: Bearer `' ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.