> For the complete documentation index, see [llms.txt](https://pondwadermc.gitbook.io/cubed-api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://pondwadermc.gitbook.io/cubed-api/documentation/files/read.md).

# read

.read() will read a file and return it's contents and name.

**.read(SessionID, path)**

Gets the contents of a file.

| Parameter | Type   | Required | Description                                            |
| --------- | ------ | -------- | ------------------------------------------------------ |
| SessionID | string | true     | The session ID that you want to perform this action on |
| path      | string | true     | The path of the file you wish to read                  |

**Example:**

```javascript
// Dependencies
const CubedCraft = require('cubed-api');

// Reading the file
CubedCraft.files.read('SessionID', '/plugins/Skript/scripts/hi.sk').then(file => {
    console.log(file);
});
```

{% hint style="info" %}
Read the guide on session IDs: <https://pondwadermc.gitbook.io/cubed-api/tutorials-and-guides/sessions>
{% endhint %}

**Example Response:**

```javascript
{
  title: 'hi.sk',
  content: 'command /hi:\r\n  trigger:\r\n    send "hi"'
}
```