> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://developer-stage.shipbob.dev/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developer-stage.shipbob.dev/_mcp/server. # Get Taxonomies GET https://sandbox-api.shipbob.com/2026-01/taxonomy Retrieves all available product taxonomies for categorizing products. Reference: https://developer-stage.shipbob.dev/api/products/get-taxonomies ## OpenAPI Specification ```yaml openapi: 3.1.0 info: title: api-2026-01 version: 1.0.0 paths: /2026-01/taxonomy: get: operationId: get-taxonomies summary: Get Taxonomies description: Retrieves all available product taxonomies for categorizing products. tags: - subpackage_products parameters: - name: search in: query description: '' required: false schema: $ref: '#/components/schemas/Products.Get.Api.V5.Taxonomy.Search.String' - name: Authorization in: header description: Authentication using Personal Access Token (PAT) token required: true schema: type: string responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/Products.TaxonomyViewModelArray' '401': description: Unauthorized content: application/json: schema: $ref: >- #/components/schemas/Products.Get.Api.V5.Taxonomy.Unauthorized.OneOf.ProblemDetails.HttpValidationProblemDetails '403': description: Forbidden content: application/json: schema: $ref: >- #/components/schemas/Products.Get.Api.V5.Taxonomy.Forbidden.OneOf.ProblemDetails.HttpValidationProblemDetails '500': description: Server Error content: application/json: schema: description: Any type '503': description: Server Error content: application/json: schema: description: Any type servers: - url: https://sandbox-api.shipbob.com description: https://sandbox-api.shipbob.com components: schemas: Products.Get.Api.V5.Taxonomy.Search.String: type: string title: Products.Get.Api.V5.Taxonomy.Search.String Products.ChildTaxonomyViewModel: type: object properties: id: type: integer description: Unique identifier for the taxonomy node name: type: string description: Display name of the taxonomy category path: type: string description: >- Full hierarchical path of the taxonomy (e.g., 'Electronics > Computers > Laptops') has_children: type: boolean title: Products.ChildTaxonomyViewModel Products.TaxonomyViewModel: type: object properties: id: type: integer description: Unique identifier for the taxonomy node name: type: string description: Display name of the taxonomy category path: type: string description: >- Full hierarchical path of the taxonomy (e.g., 'Electronics > Computers > Laptops') children: type: array items: $ref: '#/components/schemas/Products.ChildTaxonomyViewModel' description: Child taxonomy nodes that belong to this category parent: description: Parent taxonomy node in the category hierarchy title: Products.TaxonomyViewModel Products.TaxonomyViewModelArray: type: array items: $ref: '#/components/schemas/Products.TaxonomyViewModel' title: Products.TaxonomyViewModelArray Products.ProblemDetails: type: object properties: detail: type: string instance: type: string status: type: integer title: type: string type: type: string title: Products.ProblemDetails Products.HttpValidationProblemDetails: type: object properties: detail: type: string instance: type: string status: type: integer title: type: string type: type: string errors: type: object additionalProperties: type: array items: type: string title: Products.HttpValidationProblemDetails Products.Get.Api.V5.Taxonomy.Unauthorized.OneOf.ProblemDetails.HttpValidationProblemDetails: oneOf: - $ref: '#/components/schemas/Products.ProblemDetails' - $ref: '#/components/schemas/Products.HttpValidationProblemDetails' title: >- Products.Get.Api.V5.Taxonomy.Unauthorized.OneOf.ProblemDetails.HttpValidationProblemDetails Products.Get.Api.V5.Taxonomy.Forbidden.OneOf.ProblemDetails.HttpValidationProblemDetails: oneOf: - $ref: '#/components/schemas/Products.ProblemDetails' - $ref: '#/components/schemas/Products.HttpValidationProblemDetails' title: >- Products.Get.Api.V5.Taxonomy.Forbidden.OneOf.ProblemDetails.HttpValidationProblemDetails securitySchemes: PAT: type: http scheme: bearer description: Authentication using Personal Access Token (PAT) token OAuth2: type: http scheme: bearer description: OAuth2 authentication using JWT tokens ``` ## Examples **Response** ```json [ { "children": [ { "has_children": true, "id": 0, "name": "string", "path": "string" } ], "id": 0, "name": "string", "parent": null, "path": "string" } ] ``` **SDK Code** ```python default import requests url = "https://sandbox-api.shipbob.com/2026-01/taxonomy" querystring = {"search":"string"} headers = {"Authorization": "Bearer "} response = requests.get(url, headers=headers, params=querystring) print(response.json()) ``` ```javascript default const url = 'https://sandbox-api.shipbob.com/2026-01/taxonomy?search=string'; const options = {method: 'GET', headers: {Authorization: 'Bearer '}}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go default package main import ( "fmt" "net/http" "io" ) func main() { url := "https://sandbox-api.shipbob.com/2026-01/taxonomy?search=string" req, _ := http.NewRequest("GET", url, nil) req.Header.Add("Authorization", "Bearer ") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby default require 'uri' require 'net/http' url = URI("https://sandbox-api.shipbob.com/2026-01/taxonomy?search=string") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["Authorization"] = 'Bearer ' response = http.request(request) puts response.read_body ``` ```java default import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.get("https://sandbox-api.shipbob.com/2026-01/taxonomy?search=string") .header("Authorization", "Bearer ") .asString(); ``` ```php default request('GET', 'https://sandbox-api.shipbob.com/2026-01/taxonomy?search=string', [ 'headers' => [ 'Authorization' => 'Bearer ', ], ]); echo $response->getBody(); ``` ```csharp default using RestSharp; var client = new RestClient("https://sandbox-api.shipbob.com/2026-01/taxonomy?search=string"); var request = new RestRequest(Method.GET); request.AddHeader("Authorization", "Bearer "); IRestResponse response = client.Execute(request); ``` ```swift default import Foundation let headers = ["Authorization": "Bearer "] let request = NSMutableURLRequest(url: NSURL(string: "https://sandbox-api.shipbob.com/2026-01/taxonomy?search=string")! 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() ```