> For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://learning.postman.com/llms.txt. For full content including API reference and SDK examples, see https://learning.postman.com/llms-full.txt. # Get a version tag GET https://api.getpostman.com/specs/{specId}/version-tags/{tagId}/files Gets information about a specification's version tag. The response returns a snapshot of a specification at a point in time that lets you track changes to your specifications over time. Reference: https://learning.postman.com/api-docs/api-reference/specs/get-spec-version-tag ## OpenAPI Specification ```yaml openapi: 3.1.0 info: title: Postman API version: 1.0.0 paths: /specs/{specId}/version-tags/{tagId}/files: get: operationId: getSpecVersionTag summary: Get a version tag description: >- Gets information about a specification's version tag. The response returns a snapshot of a specification at a point in time that lets you track changes to your specifications over time. tags: - specs parameters: - name: specId in: path description: The spec's ID. required: true schema: $ref: '#/components/schemas/specId' - name: tagId in: path description: The version tag's ID. required: true schema: $ref: '#/components/schemas/tagId' - name: x-api-key in: header required: true schema: type: string responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/getSpecVersionTag' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/commonErrorTypeTitleDetailStatus' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/GetSpecVersionTagRequestForbiddenError' '404': description: Not Found content: application/json: schema: $ref: '#/components/schemas/commonErrorTypeTitleDetailStatus' '500': description: Internal Server Error content: application/json: schema: $ref: >- #/components/schemas/GetSpecVersionTagRequestInternalServerError servers: - url: https://api.getpostman.com description: https://api.getpostman.com - url: https://api.eu.postman.com description: https://api.eu.postman.com components: schemas: specId: type: string title: specId tagId: type: string title: tagId GetSpecVersionTagDataItemsType: type: string enum: - FILE - FOLDER description: The file's type. title: GetSpecVersionTagDataItemsType GetSpecVersionTagDataItemsFileType: type: string enum: - ROOT - DEFAULT description: > The type of file: - `ROOT` β€” The file containing the full OpenAPI structure. This serves as the entry point for the API spec and references other (`DEFAULT`) spec files. Multi-file specs can only have one root file. - `DEFAULT` β€” A file referenced by the `ROOT` file. This file contains a subset of the OpenAPI structure, such as specific components or paths. This value doesn't return for folders. title: GetSpecVersionTagDataItemsFileType GetSpecVersionTagDataItems: type: object properties: id: type: string description: The file's ID. name: type: string description: The file's name. updatedBy: type: string description: The ID of the user who updated the file. createdAt: type: string format: date-time description: The date and time at which the file was created. updatedAt: type: string format: date-time description: The date and time at which the file was updated. createdBy: type: string description: The user ID of the user that created the file. type: $ref: '#/components/schemas/GetSpecVersionTagDataItemsType' description: The file's type. path: type: string description: The file's path. fileType: $ref: '#/components/schemas/GetSpecVersionTagDataItemsFileType' description: > The type of file: - `ROOT` β€” The file containing the full OpenAPI structure. This serves as the entry point for the API spec and references other (`DEFAULT`) spec files. Multi-file specs can only have one root file. - `DEFAULT` β€” A file referenced by the `ROOT` file. This file contains a subset of the OpenAPI structure, such as specific components or paths. This value doesn't return for folders. content: type: string description: The file's content. Folders don't return this property. parentId: type: string description: >- The file's parent folder ID. This property is absent for ROOT-level files. description: Information about the element. title: GetSpecVersionTagDataItems getSpecVersionTag: type: object properties: data: type: array items: $ref: '#/components/schemas/GetSpecVersionTagDataItems' description: A list of the version tag's files and folders. title: getSpecVersionTag CommonErrorTypeTitleDetailStatusType: oneOf: - type: string format: uri-reference - type: string title: CommonErrorTypeTitleDetailStatusType commonErrorTypeTitleDetailStatus: type: object properties: type: $ref: '#/components/schemas/CommonErrorTypeTitleDetailStatusType' title: type: string description: A short summary of the problem. detail: type: string description: Information about the error. status: type: integer description: The error's HTTP status code. title: commonErrorTypeTitleDetailStatus commonErrorTypeTitleDetailStatusInstance: type: object properties: type: type: string format: uri-reference description: >- The [URI reference](https://www.rfc-editor.org/rfc/rfc3986) that identifies the type of problem. title: type: string description: A short summary of the problem. detail: type: string description: An explanation about the problem. status: type: integer description: The HTTP status code generated by the origin server. instance: type: string description: >- The URI reference that identifies the specific occurrence of the problem. title: commonErrorTypeTitleDetailStatusInstance GetSpecVersionTagRequestForbiddenError: oneOf: - $ref: '#/components/schemas/commonErrorTypeTitleDetailStatus' - $ref: '#/components/schemas/commonErrorTypeTitleDetailStatusInstance' title: GetSpecVersionTagRequestForbiddenError CommonErrorTypeTitleDetailDetail: oneOf: - type: string - type: object additionalProperties: description: Any type description: Information about the error. title: CommonErrorTypeTitleDetailDetail commonErrorTypeTitleDetail: type: object properties: type: type: string description: The type of error. title: type: string description: A short summary of the problem. detail: $ref: '#/components/schemas/CommonErrorTypeTitleDetailDetail' description: Information about the error. title: commonErrorTypeTitleDetail CommonErrorNameMessageError: type: object properties: name: type: string description: The error name. message: type: string description: The error message. description: Information about the error. title: CommonErrorNameMessageError commonErrorNameMessage: type: object properties: error: $ref: '#/components/schemas/CommonErrorNameMessageError' description: Information about the error. title: commonErrorNameMessage GetSpecVersionTagRequestInternalServerError: oneOf: - $ref: '#/components/schemas/commonErrorTypeTitleDetail' - $ref: '#/components/schemas/commonErrorTypeTitleDetailStatus' - $ref: '#/components/schemas/commonErrorNameMessage' title: GetSpecVersionTagRequestInternalServerError securitySchemes: PostmanApiKey: type: apiKey in: header name: x-api-key scimApiKey: type: apiKey in: header name: Authorization description: >- A valid [SCIM API key](https://learning.postman.com/docs/administration/scim-provisioning/scim-provisioning-overview/#generating-scim-api-key) for calls to SCIM endpoints. basicAuth: type: http scheme: basic ``` ## Examples ### Successful Response **Response** ```json { "data": [ { "id": "158bd551-4e3d-4397-a27f-4034ac33f1f6", "name": "index.yaml", "updatedBy": "12345678", "createdAt": "2026-03-10T17:05:11.000Z", "updatedAt": "2026-04-29T19:38:29.000Z", "createdBy": "12345678", "type": "FILE", "path": "index.yaml", "fileType": "ROOT", "content": "swagger: '2.0'\ninfo:\n title: 'REST API basics: CRUD, test & variable'\n description: >-\n # πŸš€ Get started here\n\n\n This template guides you through CRUD operations (GET, POST, PUT, DELETE),\n variables, and tests.\n\n\n ## πŸ”– **How to use this template**\n\n\n #### **Step 1: Send requests**\n\n\n RESTful APIs allow you to perform CRUD operations using the POST, GET, PUT,\n and DELETE HTTP methods.\n\n\n This collection contains each of these\n [request](https://learning.postman.com/docs/sending-requests/requests/)\n types. Open each request and click \"Send\" to see what happens.\n\n\n #### **Step 2: View responses**\n\n\n Observe the response tab for status code (200 OK), response time, and size.\n\n\n #### **Step 3: Send new Body data**\n\n\n Update or add new data in \"Body\" in the POST request. Typically, Body data\n is also used in PUT request.\n\n\n ```\n\n {\n \"name\": \"Add your name in the body\"\n }\n\n ```\n\n #### **Step 4: Update the variable**\n\n\n Variables enable you to store and reuse values in Postman. We have created a\n [variable](https://learning.postman.com/docs/sending-requests/variables/)\n called `base_url` with the sample request\n [https://postman-api-learner.glitch.me](https://postman-api-learner.glitch.me).\n Replace it with your API endpoint to customize this collection.\n\n\n #### **Step 5: Add tests in the \"Scripts\" tab**\n\n\n Adding tests to your requests can help you confirm that your API is working\n as expected. You can write test scripts in JavaScript and view the output in\n the \"Test Results\" tab.\n\n\n \n\n\n ## πŸ’ͺ Pro tips\n\n\n - Use folders to group related requests and organize the collection.\n \n - Add more\n [scripts](https://learning.postman.com/docs/writing-scripts/intro-to-scripts/)\n to verify if the API works as expected and execute workflows.\n \n\n ## πŸ’‘Related templates\n\n\n [API testing\n basics](https://go.postman.co/redirect/workspace?type=personal&collectionTemplateId=e9a37a28-055b-49cd-8c7e-97494a21eb54&sourceTemplateId=ddb19591-3097-41cf-82af-c84273e56719) \n\n [API\n documentation](https://go.postman.co/redirect/workspace?type=personal&collectionTemplateId=e9c28f47-1253-44af-a2f3-20dce4da1f18&sourceTemplateId=ddb19591-3097-41cf-82af-c84273e56719) \n\n [Authorization\n methods](https://go.postman.co/redirect/workspace?type=personal&collectionTemplateId=31a9a6ed-4cdf-4ced-984c-d12c9aec1c27&sourceTemplateId=ddb19591-3097-41cf-82af-c84273e56719)\n version: 1.0.0\npaths:\n /info:\n get:\n summary: Get data\n description: >-\n This is a GET request and it is used to \"get\" data from an endpoint.\n There is no request body for a GET request, but you can use query\n parameters to help specify the resource you want data on (e.g., in this\n request, we have `id=1`).\n\n\n A successful GET response will have a `200 OK` status, and should\n include some kind of response body - for example, HTML web content or\n JSON data.\n consumes:\n - application/json\n parameters:\n - name: id\n in: query\n type: integer\n responses: {}\n post:\n summary: Post data\n description: >-\n This is a POST request, submitting data to an API via the request body.\n This request submits JSON data, and the data is reflected in the\n response.\n\n\n A successful POST request typically returns a `200 OK` or `201 Created`\n response code.\n consumes:\n - application/json\n parameters:\n - name: body\n in: body\n schema:\n type: object\n properties:\n name:\n type: string\n responses: {}\n put:\n summary: Update data\n description: >-\n This is a PUT request and it is used to overwrite an existing piece of\n data. For instance, after you create an entity with a POST request, you\n may want to modify that later. You can do that using a PUT request. You\n typically identify the entity being updated by including an identifier\n in the URL (eg. `id=1`).\n\n\n A successful PUT request typically returns a `200 OK`, `201 Created`, or\n `204 No Content` response code.\n consumes:\n - application/json\n parameters:\n - name: id\n in: query\n type: integer\n - name: body\n in: body\n schema:\n type: object\n properties:\n name:\n type: string\n responses: {}\n delete:\n summary: Delete data\n description: >-\n This is a DELETE request, and it is used to delete data that was\n previously created via a POST request. You typically identify the entity\n being updated by including an identifier in the URL (eg. `id=1`).\n\n\n A successful DELETE request typically returns a `200 OK`, `202\n Accepted`, or `204 No Content` response code.\n consumes:\n - application/json\n parameters:\n - name: id\n in: query\n type: integer\n - name: body\n in: body\n schema:\n type: object\n responses: {}\nhost: template.postman-echo.com\nschemes:\n - https\n" } ] } ``` **SDK Code** ```python Successful Response import requests url = "https://api.getpostman.com/specs/73e15000-bc7a-4802-b80e-05fff18fd7f8/version-tags/97d2c74e-19de-426d-9763-8e7400429759/files" headers = {"x-api-key": ""} response = requests.get(url, headers=headers) print(response.json()) ``` ```javascript Successful Response const url = 'https://api.getpostman.com/specs/73e15000-bc7a-4802-b80e-05fff18fd7f8/version-tags/97d2c74e-19de-426d-9763-8e7400429759/files'; const options = {method: 'GET', headers: {'x-api-key': ''}}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Successful Response package main import ( "fmt" "net/http" "io" ) func main() { url := "https://api.getpostman.com/specs/73e15000-bc7a-4802-b80e-05fff18fd7f8/version-tags/97d2c74e-19de-426d-9763-8e7400429759/files" req, _ := http.NewRequest("GET", url, nil) req.Header.Add("x-api-key", "") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Successful Response require 'uri' require 'net/http' url = URI("https://api.getpostman.com/specs/73e15000-bc7a-4802-b80e-05fff18fd7f8/version-tags/97d2c74e-19de-426d-9763-8e7400429759/files") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["x-api-key"] = '' response = http.request(request) puts response.read_body ``` ```java Successful Response import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.get("https://api.getpostman.com/specs/73e15000-bc7a-4802-b80e-05fff18fd7f8/version-tags/97d2c74e-19de-426d-9763-8e7400429759/files") .header("x-api-key", "") .asString(); ``` ```php Successful Response request('GET', 'https://api.getpostman.com/specs/73e15000-bc7a-4802-b80e-05fff18fd7f8/version-tags/97d2c74e-19de-426d-9763-8e7400429759/files', [ 'headers' => [ 'x-api-key' => '', ], ]); echo $response->getBody(); ``` ```csharp Successful Response using RestSharp; var client = new RestClient("https://api.getpostman.com/specs/73e15000-bc7a-4802-b80e-05fff18fd7f8/version-tags/97d2c74e-19de-426d-9763-8e7400429759/files"); var request = new RestRequest(Method.GET); request.AddHeader("x-api-key", ""); IRestResponse response = client.Execute(request); ``` ```swift Successful Response import Foundation let headers = ["x-api-key": ""] let request = NSMutableURLRequest(url: NSURL(string: "https://api.getpostman.com/specs/73e15000-bc7a-4802-b80e-05fff18fd7f8/version-tags/97d2c74e-19de-426d-9763-8e7400429759/files")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "GET" request.allHTTPHeaderFields = headers let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Multi-File Response **Response** ```json { "data": [ { "id": "6993ec3e-677b-4586-8856-169cc95030a2", "name": "components", "updatedBy": "12345678", "createdAt": "2025-07-08T19:32:48.000Z", "updatedAt": "2025-07-08T19:32:49.000Z", "createdBy": "12345678", "type": "FOLDER", "path": "components" }, { "id": "aa2d66e5-079a-4786-8a85-72770fac5967", "name": "parameters", "updatedBy": "12345678", "createdAt": "2025-07-08T19:33:02.000Z", "updatedAt": "2025-07-08T19:33:09.000Z", "createdBy": "12345678", "type": "FOLDER", "path": "components/parameters", "parentId": "6993ec3e-677b-4586-8856-169cc95030a2" }, { "id": "a2074528-e9fa-400d-b343-9deab40c02b8", "name": "spacecrafts.yaml", "updatedBy": "12345678", "createdAt": "2025-07-08T19:33:27.000Z", "updatedAt": "2025-07-08T19:35:58.000Z", "createdBy": "12345678", "type": "FILE", "path": "components/parameters/spacecrafts.yaml", "fileType": "DEFAULT", "content": "SpacecraftId:\n name: spacecraftId\n description: The unique identifier of the spacecraft\n in: path\n required: true\n schema:\n $ref: ../schemas/spacecrafts.yaml#/SpacecraftId\n", "parentId": "aa2d66e5-079a-4786-8a85-72770fac5967" }, { "id": "2647f42c-3307-414f-b949-9a9b07b4cbd9", "name": "responses", "updatedBy": "12345678", "createdAt": "2025-07-08T19:33:18.000Z", "updatedAt": "2025-07-08T19:33:20.000Z", "createdBy": "12345678", "type": "FOLDER", "path": "components/responses", "parentId": "6993ec3e-677b-4586-8856-169cc95030a2" }, { "id": "7a65e696-76fe-462d-a374-b4de06cac805", "name": "spacecrafts.yaml", "updatedBy": "12345678", "createdAt": "2025-07-08T19:33:39.000Z", "updatedAt": "2025-07-08T20:03:33.000Z", "createdBy": "12345678", "type": "FILE", "path": "components/responses/spacecrafts.yaml", "fileType": "DEFAULT", "content": "SuccessfulResponse:\n description: The spacecraft corresponding to the provided `spacecraftId`\n content:\n application/json:\n schema:\n $ref: ../schemas/spacecrafts.yaml#/Spacecraft\n\nNotFound:\n description: No spacecraft found for the provided `spacecraftId`\n content:\n application/problem+json:\n schema:\n $ref: ../schemas/spacecrafts.yaml#/Error\n\nUnexpectedError:\n description: Unexpected error\n content:\n application/problem+json:\n schema:\n $ref: ../schemas/spacecrafts.yaml#/Error", "parentId": "2647f42c-3307-414f-b949-9a9b07b4cbd9" }, { "id": "597e7c88-fd2d-482d-a667-e7881629eaa8", "name": "schemas", "updatedBy": "12345678", "createdAt": "2025-07-08T19:33:24.000Z", "updatedAt": "2025-07-08T19:33:25.000Z", "createdBy": "12345678", "type": "FOLDER", "path": "components/schemas", "parentId": "6993ec3e-677b-4586-8856-169cc95030a2" }, { "id": "cfdb32f1-f028-446f-9da6-ddeaa2a53b48", "name": "spacecrafts.yaml", "updatedBy": "12345678", "createdAt": "2025-07-08T19:33:46.000Z", "updatedAt": "2025-07-08T20:04:28.000Z", "createdBy": "12345678", "type": "FILE", "path": "components/schemas/spacecrafts.yaml", "fileType": "DEFAULT", "content": "SpacecraftId:\n description: The unique identifier of a spacecraft\n type: string\n\nSpacecraft:\n type: object\n required:\n - id\n - name\n - type\n properties:\n id:\n $ref: \"#/SpacecraftId\"\n name:\n type: string\n type:\n type: string\n enum:\n - capsule\n - probe\n - satellite\n - spaceplane\n - station\n description:\n type: string\n\nError:\n type: object\n properties:\n type:\n type: string\n description: The type of error.\n example: https://api.postman.com/problems/forbidden\n title:\n type: string\n description: A short summary of the problem.\n example: You are not permitted to perform the action.\n status:\n type: integer\n description: The error's HTTP status code.\n example: 403\n detail:\n type: string\n description: Information about the error.\n example: Please ensure that you have required permissions\n", "parentId": "597e7c88-fd2d-482d-a667-e7881629eaa8" }, { "id": "71c6f91f-5813-4800-a5fc-bea764b4a5d1", "name": "index.yaml", "updatedBy": "12345678", "createdAt": "2025-07-08T19:31:57.000Z", "updatedAt": "2026-04-29T20:07:11.000Z", "createdBy": "12345678", "type": "FILE", "path": "index.yaml", "fileType": "ROOT", "content": "openapi: '3.0.0'\ninfo:\n version: '1.0.0'\n title: Sample API\n description: Buy or rent spacecrafts\n contact:\n name: Taylor Lee\n\nservers:\n - url: https://example.com\n\nsecurity:\n - ApiKey: []\n\npaths:\n /spacecrafts/{spacecraftId}:\n parameters:\n - $ref: ./components/parameters/spacecrafts.yaml#/SpacecraftId\n get:\n summary: Read a spacecraft\n description: Gets information about a spacecraft.\n operationId: getSpacecraft\n tags:\n - Spacecrafts\n responses:\n '200':\n $ref: ./components/responses/spacecrafts.yaml#/SuccessfulResponse\n '404':\n $ref: ./components/responses/spacecrafts.yaml#/NotFound\n '500':\n $ref: ./components/responses/spacecrafts.yaml#/UnexpectedError\n\ntags:\n - name: Spacecrafts\n\ncomponents:\n securitySchemes:\n ApiKey:\n type: apiKey\n in: header\n name: X-Api-Key\n" } ] } ``` **SDK Code** ```python Multi-File Response import requests url = "https://api.getpostman.com/specs/73e15000-bc7a-4802-b80e-05fff18fd7f8/version-tags/97d2c74e-19de-426d-9763-8e7400429759/files" headers = {"x-api-key": ""} response = requests.get(url, headers=headers) print(response.json()) ``` ```javascript Multi-File Response const url = 'https://api.getpostman.com/specs/73e15000-bc7a-4802-b80e-05fff18fd7f8/version-tags/97d2c74e-19de-426d-9763-8e7400429759/files'; const options = {method: 'GET', headers: {'x-api-key': ''}}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Multi-File Response package main import ( "fmt" "net/http" "io" ) func main() { url := "https://api.getpostman.com/specs/73e15000-bc7a-4802-b80e-05fff18fd7f8/version-tags/97d2c74e-19de-426d-9763-8e7400429759/files" req, _ := http.NewRequest("GET", url, nil) req.Header.Add("x-api-key", "") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Multi-File Response require 'uri' require 'net/http' url = URI("https://api.getpostman.com/specs/73e15000-bc7a-4802-b80e-05fff18fd7f8/version-tags/97d2c74e-19de-426d-9763-8e7400429759/files") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["x-api-key"] = '' response = http.request(request) puts response.read_body ``` ```java Multi-File Response import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.get("https://api.getpostman.com/specs/73e15000-bc7a-4802-b80e-05fff18fd7f8/version-tags/97d2c74e-19de-426d-9763-8e7400429759/files") .header("x-api-key", "") .asString(); ``` ```php Multi-File Response request('GET', 'https://api.getpostman.com/specs/73e15000-bc7a-4802-b80e-05fff18fd7f8/version-tags/97d2c74e-19de-426d-9763-8e7400429759/files', [ 'headers' => [ 'x-api-key' => '', ], ]); echo $response->getBody(); ``` ```csharp Multi-File Response using RestSharp; var client = new RestClient("https://api.getpostman.com/specs/73e15000-bc7a-4802-b80e-05fff18fd7f8/version-tags/97d2c74e-19de-426d-9763-8e7400429759/files"); var request = new RestRequest(Method.GET); request.AddHeader("x-api-key", ""); IRestResponse response = client.Execute(request); ``` ```swift Multi-File Response import Foundation let headers = ["x-api-key": ""] let request = NSMutableURLRequest(url: NSURL(string: "https://api.getpostman.com/specs/73e15000-bc7a-4802-b80e-05fff18fd7f8/version-tags/97d2c74e-19de-426d-9763-8e7400429759/files")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "GET" request.allHTTPHeaderFields = headers let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```