# Get Uploaded File

<mark style="color:blue;">`GET`</mark> `/api/v1/{entity-type}/{entity-id}/{property}/documents/{document-id}`

#### Path Parameters

| Name                                          | Type   | Description                                             |
| --------------------------------------------- | ------ | ------------------------------------------------------- |
| entity-type<mark style="color:red;">\*</mark> | String | Entity for which file was uploaded                      |
| entity-id<mark style="color:red;">\*</mark>   | String | Entity ID of corresponding entity                       |
| property<mark style="color:red;">\*</mark>    | String | any String for eg templates for uploading html template |
| document-id<mark style="color:red;">\*</mark> | String | ID of document that was uploaded                        |

#### Headers

| Name                                            | Type   | Description                                                                                        |
| ----------------------------------------------- | ------ | -------------------------------------------------------------------------------------------------- |
| content-type<mark style="color:red;">\*</mark>  | String | Set to `application/octet-stream`                                                                  |
| authorization<mark style="color:red;">\*</mark> | String | Set to `Bearer {access-token}` if `roles` in schema config is not anonymous else this can be empty |

{% tabs %}
{% tab title="200: OK Success response of uploaded file" %}

```javascript
{file contents that was uploaded}
```

{% endtab %}
{% endtabs %}

## Usage

### cURL

```shell
curl --location \
    --request GET '{registry-url}/api/v1/{entity-type/{entity-id}/{property}/documents/{document-id}' \
    --header 'Authorization: Bearer {access-token}'
```

### HTTPie

```shell
http '{registry-url}/api/v1/{entity-type/{entity-id}/{property}/documents/{document-id}' \
 Authorization:'Bearer {access-token}'
```

> `{registry-url}` is usually [http://localhost:{port}](https://docs.sunbirdrc.dev/~/changes/ADw6FieYgLmHh8a9Loem/api-reference/file-storage-api/http:/localhost:{port}). The port can be found under the `registry` section in the `docker-compose.yml` file and is usually `8081`.