---
title: "Info for a specific file"
method: GET
path: "/letter/{letterId}/file/{fileId}"
tags: ["file"]
---

# Info for a specific file

`GET /letter/{letterId}/file/{fileId}`

## Request

- Base URL: `https://small-eod.siecobywatelska.pl/v1`
- URL: `https://small-eod.siecobywatelska.pl/v1/letter/{letterId}/file/{fileId}`
- Auth: API key in cookie `session`
- TypeScript: <https://skmtc.dev/watchdogpolska/apis/small-eod/docs/letter/:letterId/file/:fileId/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `letterId` number, required
- `fileId` number, required

## Response `200`

Expected response to a valid request

- Letter
  - `id` string, letterId, required
  - `name` string, required
  - `direction` 'received' | 'send', required: Direction
  - `channel` string, channelId, required: Channel
  - `final` boolean: The status of the letter, e.g. deciding about visibility in the collection
  - `data` string, date-time: Date of receipt / Date of dispatch
  - `identifier` string: External identifier of letter / case
  - `description` number: Description ID choose by content creator
  - `institution` number[]
  - `address` AddressData
    - `email` string, email
    - `epuap` string, epuapId
    - `street` string
    - `postal_code` string
    - `city` string
    - `voivodeship` string
    - `house_no` string
    - `flat_no` string
  - `case` string, caseId
  - `attachment` File[]
    - `id` string, fileId, required
    - `path` string, required
    - `name` string, required
  - `ordering` number
  - `comment` string
  - `excerpt` string
  - `tags` string[]
  - `createdOn` string, datetime, required
  - `createdBy` string, required: User ID responsible for creating the content
  - `modifiedOn` string, datetime, required
  - `modifiedBy` string, required

## Other responses

- `default`: unexpected error

## Changes

> 16 revisions in range; 1 not diffed.

- **2020-01-10** `09067c6a6587`: 1 info
  - added the optional property `description` to the response with the `200` status
- **2020-01-09** `019c3da29e4d`: 1 warning
  - removed the optional property `description` from the response with the `200` status
- **2020-01-09** `652992eaa7d9`: 1 breaking
  - the `description` response's property type changed from `descriptionId` to `number` for status `200`
- **2020-01-07** `d1aec2d6c45b`: 1 info
  - added the optional property `description` to the response with the `200` status
- **2019-10-10** `f16566c7c7ef`: 7 info
  - the response property `attachment/items/id` became required for the status `200`
  - the response property `attachment/items/name` became required for the status `200`
  - the response property `attachment/items/path` became required for the status `200`
  - the response property `createdBy` became required for the status `200`
  - …3 more

[Operation history](https://skmtc.dev/watchdogpolska/apis/small-eod/changes/letter/:letterId/file/:fileId/get.md)

---

[API](https://skmtc.dev/watchdogpolska/apis/small-eod.md) - [All operations](https://skmtc.dev/watchdogpolska/apis/small-eod/llms.txt) - [OpenAPI document](https://skmtc.dev/watchdogpolska/apis/small-eod/revisions/1c5ac40bf412?raw)