Updated API docs for import retrieval

Author: ciminelli

docs/api-reference/download-import.mdx

@@ -2,3 +2,5 @@
 title: "Download Import CSV"
 openapi: "GET /import/{id}/download"
 ---
+
+Retrieve an import as a CSV file.

docs/api-reference/get-import-rows.mdx

@@ -3,8 +3,31 @@ title: "Get Import Rows"
 openapi: "GET /import/{id}/rows"
 ---
 
-Retrieve the rows of an import as JSON. This endpoint supports pagination by using a limit/offset. If the limit and offset are not provided, it will return the first 1000 rows of the import.
+Retrieve the rows of an import as JSON. This endpoint supports pagination by using a limit/offset. If the limit and offset are not provided, it will return the first 1,000 rows of the import.
 
 To use the limit/offset, start by setting the offset to 0 and the limit to 100 to get the first 100 rows of data. To get the next 100 rows, set the offset to 100 while keeping the limit the same. Continue increasing the offset by 100 until no more rows are returned.
 
-Note: the max limit is 1000.
+<Info>The maximum `limit` is 1000.</Info>
+
+### Example Response
+
+```json
+[
+  {
+    "index": 0,
+    "values": {
+      "email": "[email protected]",
+      "first_name": "Laura",
+      "last_name": "Smith"
+    }
+  },
+  {
+    "index": 1,
+    "values": {
+      "email": "[email protected]",
+      "first_name": "Craig",
+      "last_name": "Johnson"
+    }
+  }
+]
+```

docs/api-reference/get-import.mdx

@@ -2,3 +2,57 @@
 title: "Get Import"
 openapi: "GET /import/{id}"
 ---
+
+Retrieve the row data, column definitions, and other information about the import.
+
+<Info>The number of rows included is limited to 10,000. If there are more than 10,000 rows, an `error` will be set and
+  the data should be retrieved using the [/rows](/api-reference/get-import-rows) endpoint.</Info>
+
+### Example Response
+
+```json
+{
+  "id": "da5554e3-6c87-41b2-9366-5449a2f15b53",
+  "importer_id": "6de452a2-bd1f-4cb3-b29b-0f8a2e3d9353",
+  "created_at": 1703791355,
+  "num_columns": 3,
+  "num_processed_values": 5,
+  "num_rows": 2,
+  "metadata": {},
+  "columns": [
+    {
+      "data_type": "string",
+      "key": "email",
+      "name": "Email"
+    },
+    {
+      "data_type": "string",
+      "key": "first_name",
+      "name": "First Name"
+    },
+    {
+      "data_type": "string",
+      "key": "last_name",
+      "name": "Last Name"
+    }
+  ],
+  "rows": [
+    {
+      "index": 0,
+      "values": {
+        "email": "[email protected]",
+        "first_name": "Laura",
+        "last_name": "Smith"
+      }
+    },
+    {
+      "index": 1,
+      "values": {
+        "email": "[email protected]",
+        "first_name": "Craig",
+        "last_name": "Johnson"
+      }
+    }
+  ]
+}
+```