From ef6ee8d8ec0b9a6e75ac8f0ab1521578be6698bc Mon Sep 17 00:00:00 2001
From: Whaletrucker Reef Architect <scutua.tua@icloud.com>
Date: Fri, 28 Nov 2025 08:57:22 +0000
Subject: [PATCH] get-file-by-id.mdx

---
 api-reference/endpoint/get-file-by-id.mdx | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/api-reference/endpoint/get-file-by-id.mdx b/api-reference/endpoint/get-file-by-id.mdx
index 109cd2d..718303f 100644
--- a/api-reference/endpoint/get-file-by-id.mdx
+++ b/api-reference/endpoint/get-file-by-id.mdx
@@ -1,3 +1,19 @@
 ---
 openapi: get /files/{network}/{id}
 ---
+Retrieves a file by its unique ID on a given network.
+
+### Path Parameters
+- `network` (string): The network name (e.g., `ipfs`, `arweave`)
+- `id` (string): The unique file ID
+
+### Response
+Returns a JSON object containing file metadata and access URL.
+
+```json
+{
+  "id": "abc123",
+  "network": "ipfs",
+  "name": "reef-nft-042.json",
+  "url": "https://gateway.pinata.cloud/ipfs/QmABC123..."
+}