---
title: "Returns files associated with products (of level PRODUCT) based on their full or partial names."
method: GET
path: "/products/byname/{productName}"
tags: ["products"]
---

# Returns files associated with products (of level PRODUCT) based on their full or partial names.

`GET /products/byname/{productName}`

Use this GET to search for bulk data services by product name or description. An error message will be returned if the product cannot be found by name. Note that product name is not case sensitive. You can enter full or partial name of an existing product to receive bulk data services. Default values for field names are as follows
- if both years are not defined, toYear will be set equal to current year, fromYear will be set equal to previous year
- if fromYear is defined, toYear will be set equal to fromYear+1
- if fromMonth not defined, current month will be used
- if toMonth not defined, it will be set equal to fromMonth
- if fromDay is not defined, it will be set equal to current day (today)
- if toDay is not defined, it will be set to the last day of toMonth/toYear

## Path parameters

- `productName` string, required

## Query parameters

- `fromYear` integer
- `toYear` integer
- `fromMonth` integer
- `toMonth` integer
- `fromDay` integer
- `toDay` integer
- `hierarchy` string
- `maxFiles` integer

## Response `200`

Successful operation.

## Other responses

- `404` — Unexpected error accessing metadata.
- `500` — Internal server error.

---

[API](https://skmtc.net/uspto/apis/bdss.md) · [All operations](https://skmtc.net/uspto/apis/bdss/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/uspto/bdss/versions/151d5f315aa4/schema)